金蝶钉钉插件安装部署配置手册

本文介绍金蝶钉钉集成插件安装步骤,以及注意点。

实施环境

实施金蝶钉钉插件主要的流程步骤,(橙色文字标注为需要客户方配合提供

  1. 钉钉管理员登录钉钉后台,建立企业内部开发应用,并配置权限。
  2. 钉钉管理员登录钉钉前台,建立审批流程表单。
  3. 金蝶数据库建立插件数据表。
  4. 远程到金蝶服务器,拷贝插件DLL文件到金蝶安装目录(本文详情中下载)。
  5. 登录金蝶BOS开发平台配置集成单据,添加字段和属性携带。
  6. 提供一名金蝶用户,程序接收钉钉审批结果后,用该用户审核或反审核单据(建议用Administrator),用户密码不修改。
  7. 提供一个数据库账号,用于程序根据审批实例ID,查找对应的金蝶单据,以及写接口访问日志。
  8. 公网IP的服务器建立IIS站点(建议用金蝶服务器)

 

收集配置信息

以下信息钉钉回调接口处理用,如修改需同步修改程序配置文件
数据库IP地址:
数据库名称:
数据库用户名:
数据库密码:
金蝶K3CloudUrl:
接口审核使用金蝶用户名:
接口审核使用金蝶用户密码:
FDATACENTERID:

钉钉配置
aeskey:
Token:GoldNo
CorpId:
AppKey:
AppSecret:
AgentId:

 

以下分步骤详细说明

 

1. 钉钉管理员登录钉钉后台,建立企业内部开发应用,并配置权限。

  • 登录钉钉开发者后台,建立“企业内部开发”,H5微应用
  • 配置应用LOGO,》》点我下载金蝶云图标
  • 保存应用参数:AgentId,AppKey,AppSecret
  • 添加服务器出口IP为金蝶插件服务器IP
  • 添加通讯录管理权限,OA审批权限
  • 配置并保存事件回调,加密 aes_key,签名 token:GoldNo,请求网址:http://******/Gold/ding.aspx,事件订阅:审批实例开始,结束

 

 

2.钉钉管理员登录钉钉前台,建立审批流程表单。

登录钉钉前台,OA审批,建立“流程表单”

 

《销售订单》:订单编号,订单日期,销售组织,销售员,客户,交货方式,收款条件,订单金额,备注,内容

《销售订单》明细:库存组织,物料编码,物料名称,规格型号,含税单价,税率,数量,单位,价税合计,备注

processCode=PROC-D04ACDD5-FC49-4058-905D-533FF0D3A

 

《付款申请单》:付款申请类型,单据编号,申请日期,申请组织,往来单位,收款单位,金额(元),申请付款金额,付款条件,备注,关联审批单

《付款申请单》明细:源单类型,源单编号,费用项目,付款用途,结算方式,期望付款日期,申请付款金额,对方银行账号,对方账户名称,对方开户行,物料名称,含税单价,数量,备注

processCode=PROC-D04ACDD5-FC49-4058-905D-533FF0D3A47E

 

《采购订单》:订单编号,订单日期,采购组织,采购员,供应商,订单金额,所属项目,付款条件,备注,内容,关联采购申请

《采购订单》明细:需求组织,物料编码,物料名称,规格型号,含税单价,税率,数量,单位,价税合计,备注

processCode=PROC-25614E0F-6ED5-46F5-A1B4-79E7646CE195

 

《采购申请单》:订单编号,申请日期,申请组织,申请人,申请金额,所属项目,备注

《采购申请单》明细:需求组织,物料编码,物料名称,规格型号,含税单价,税率,申请数量,单位,价税合计,备注

processCode=PROC-4787F101-2AE3-4D78-9F42-AB5B90028DC2

 

3. 金蝶数据库建立插件数据表

下载SQL语句,建立表:GoldLink_PROCESSCODE、Gold_DingLog

密码保护区域

此区域内容受密码保护,查阅请联系我们(info@zjgkd.cn)

4. 远程到金蝶服务器,拷贝插件DLL文件到金蝶安装目录

dll目录:C:\Program Files (x86)\Kingdee\K3Cloud\WebSite\bin

文件可在文末下载。

5. 金蝶集成单据添加字段和属性携带

《部门》表单,表头新增字段:

钉钉部门ID:标识:FDDeptId,字段名:FDDEPTID,绑定实体属性:FDDeptId

 

《用户》表单,表头增加工作电话字段:(本条适用于金蝶注册用户手机号与钉钉注册手机号不一致的情形)

钉钉电话:标识:F_Gold_Phone,字段名:F_GOLD_PHONE,绑定实体属性:F_Gold_Phone

 

《员工》表单,表体基本信息新增字段:

钉钉ID:标识:FDingUserid,字段名:FDINGUSERID,绑定实体属性:F_Gold_Text(4.0版本后取消本项设置)

 

需要钉钉审批的表单新增字段:

钉钉流程模板,标识:FProcessCode,字段名:FPROCESSCODE,绑定实体属性:FProcessCode(4.0版本后取消本项设置)

钉钉审批实例ID,标识:Fprocess_instance_id,字段名:FPROCESS_INSTANCE_ID,绑定实体属性:Fprocess_instance_id

关联审批实例ID,

钉钉审批人,标识:FDingApprover,字段名:FDINGAPPROVER,绑定实体属性:FDingApprover(4.0版本后新增字段)

 

《销售新变更单》、《采购新变更单》增加字段:新钉钉审批实例ID,标识:Fprocess_instance_idX,字段名:FPROCESS_INSTANCE_IDX,绑定实体属性:Fprocess_instance_idX

 

字段添加引用属性,创建人添加手机号,部门添加钉钉ID

 

6和7 需要配合使用,把金蝶用户信息配置到7的IIS站点配置文件中,并部署站点。

2022年11月22日更新带金蝶单据附件浏览功能。

密码保护区域

此区域内容受密码保护,查阅请联系我们(info@zjgkd.cn)

暂无评论

发表回复

您的电子邮箱地址不会被公开。 必填项已用 * 标注

本站提供金蝶、钉钉等开发实施相关技术文章的发布和转载。如有侵权,联系立删(info@zjgkd.cn) 。
Powered by WordPress · 苏ICP备13058196号-11