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

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

作者：何进刚 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.  等待查看流程示例和流程