钉钉（苍穹-钉钉）集成使用手册

作者：何进刚 2021/01/27

注意：该方案已做过DEMO验证，客户现场需要根据实际情况进行必要的调整，并且无论是否调整都必须再次验证才可使用。

一、创建钉钉应用

许可说明：钉钉的连接走WebAPI连接许可，WebAPI有许可的情况下才可以使用

集成方案获取：

方案浏览：https://dev.kingdee.com/dev/solutionlib

方案下载说明：https://vip.kingdee.com/link/s/MizID

注意：先部署到测试环境验证通过后，再导入到正式环境。

注册一个钉钉账号

创建一个团队

输入手机号

点击立即创建团队，输入手机验证码，点击验证并继续

完善企业信息,(企业名后面不能修改)，点击立即创建团队

进入管理控制台

点击工作台，添加自建应用

进入应用开发平台

创建一个应用，首先需要激活

选择技术栈，然后立即激活，并确认提交

企业内部开发，再次创建一个应用

确定创建后，可以看到这个页面，其中我们需要根据AppKey和AppSecret 获取免登录凭证。

点击开发管理设置可接入ip地址，多个ip以逗号隔开，服务器出口IP为用户使用的苍穹平台对应服务器公网IP:公网IP为出口IP并不是本机IP，本机ip获取方式：https://whatismyipaddress.com/。

打开权限管理，添加需要的权限

二、创建连接配置

钉钉应用的创建已经完成，接下来去配置连接类型

说明：预置的钉钉连接类型是禁用的，请先前往连接类型启用钉钉连接类型。

实例参考：

以下配置信息仅为钉钉通用API调用的域名及端口（端口已实际钉钉提供的填写，http默认80，https默认443）示例，请按实际情景灵活填写。

三、组织同步

由于钉钉的组织跟苍穹的组织的id不适配，并且钉钉里面不存在编码，因此使用中间表的方式进行处理；

l  初始化

       初始化过程中，集成方案会自动将苍穹的组织id和其上级id，还有对应的钉钉组织id和钉钉上级组织id保存到苍穹的中间表中，存储操作在集成方案脚本中自动处理。在人员同步的时候，将会从该表中查询。

步骤：

1. 选择组织初始化的服务流程点击发布后再点击立即执行。立即执行提示需要输入number参数，支持输入指定的编码或者*（*代表全部）。

   集成服务流程操作指南：https://developer.kingdee.com/article/98890752746688768 
   

   2.  等待查看流程示例和流程日志

l  事件触发

事件触发：当新增或修改一个组织的时候，配置好的事件触发类型的流程服务会自动将该条记录进行同步。

说明：

• 1、      部门的同步需要先同步上级组织，再同步下级组织，否则钉钉插入该组织会报错，造成同步失败。

• 2、      同步之前需要确认一下苍穹的根组织id，需要在组织事件触发流程服务信息获取脚本节点中修改100000（苍穹默认的根组织ID是100000）为你真实的根组织id。如下图：

  

• 预置的组织事件触发方案，苍穹修改组织编码会在钉钉另外生成一个新的组织，请不要修改苍穹的组织编码。

  
  

四、人员同步

为了避免给其他人造成影响，在人员同步的时候，建议输入在初始化启动方案中添加来源数据过滤条件，比如可以只先同步一个人或者部分人来验证一下方案的正确性。

步骤：

1、 直接点击人员的人工启动方案立即执行按钮

2、 等待查看结果

事件触发：当新增或修改一个人员的时候，配置好的事件触发类型的流程服务会自动将该条记录进行同步。

附

钉钉开发平台：https://open-dev.dingtalk.com/#/index

钉钉管理后台：https://oa.dingtalk.com/?code=2bfb026402aa3196ad20331e7893b293#/welcome

集成服务云使用指南：https://club.kdcloud.com/article/45312

集成服务云新特性发布汇总：https://club.kdcloud.com/article/146134

集成云常见问题处理合集: https://vip.kingdee.com/article/45556