本文介绍金蝶钉钉集成插件安装步骤,以及注意点。
实施环境
实施金蝶钉钉插件主要的流程步骤,(橙色文字标注为需要客户方配合提供)
- 钉钉管理员登录钉钉后台,建立企业内部开发应用,并配置权限。
- 钉钉管理员登录钉钉前台,建立审批流程表单。
- 金蝶数据库建立插件数据表。
- 远程到金蝶服务器,拷贝插件DLL文件到金蝶安装目录(本文详情中下载)。
- 登录金蝶BOS开发平台配置集成单据,添加字段和属性携带。
- 提供一名金蝶用户,程序接收钉钉审批结果后,用该用户审核或反审核单据(建议用Administrator),用户密码不修改。
- 提供一个数据库账号,用于程序根据审批实例ID,查找对应的金蝶单据,以及写接口访问日志。
- 有公网IP的服务器建立IIS站点(建议用金蝶服务器)
收集配置信息
以下信息钉钉回调接口处理用,如修改需同步修改程序配置文件
数据库IP地址:
数据库名称:
数据库用户名:
数据库密码:
金蝶K3CloudUrl:
接口审核使用金蝶用户名:
接口审核使用金蝶用户密码:
FDATACENTERID:
钉钉配置
aeskey:
Token:GoldNo
CorpId:
AppKey:
AppSecret:
AgentId:
以下分步骤详细说明
1. 钉钉管理员登录钉钉后台,建立企业内部开发应用,并配置权限。
- 登录钉钉开发者后台,建立“企业内部开发”,H5微应用
- 配置应用LOGO,》》点我下载金蝶云图标
- 保存应用参数:AgentId,AppKey,AppSecret
- 添加服务器出口IP为金蝶插件服务器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
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日更新带金蝶单据附件浏览功能。
暂无评论