前言

配置 IM 同步流程如下：

1. 登陆 IM 后台创建应用，拿到对应的 key 与 secret。
2. 配置权限，根据文档说明配置对应的权限。
3. 配置字段关联关系，参考此文档配置关联关系：详情参考
4. 执行同步时：先同步分组，再同步用户。如果同步失败，通过浏览器右键检查，查看失败原因。

再次提醒如下信息：

警告

• 请注意，操作分组或者用户同步之前，请务必检查是否已经添加了对应的字段关系，详情参考
• 手动同步时，需要先同步分组列表，然后再同步员工列表，员工数据依赖分组数据。
• 默认同步到平台上的员工密码为配置文件中 user-init-password: 配置项的值。

感谢

平台当前已集成钉钉的集成能力，使用了如下开源库：

• https://github.com/zhaoyunxing92/dingtalk (opens new window)

历程

详情参考： Change Log (opens new window)

• v0.1.0 ：初步集成了钉钉的同步能力。感谢 @xinyuandd (opens new window) 同学的贡献
• v0.1.1 ：这个版本调整了钉钉同步的架构，将钉钉外部包单独成包，便于后续其他平台扩展。详情参考：

使用

在使用钉钉同步之前，我们先看下需要添加的配置信息：

dingtalk:
  flag: "dingtalk" # 作为钉钉在平台的标识
  app-key: "xxxxxxxxxxxxxxx" # 应用的key
  app-secret: "xxxxxxxxxxxxxxxxxxxxxxxxxxxx" # 应用的secret
  agent-id: "12121212" # 目前agent-id未使用到，可忽略
  enable-sync: false # 是否开启定时同步钉钉的任务

首先要在钉钉管理后台中创建应用。

创建应用

访问 https://open-dev.dingtalk.com/，登录进入钉钉开放平台，通过路径： 应用开发 ---> 创建应用 。

创建成功之后，我们就能拿到该应用的 Key 与 Secret：

拿到之后可以将对应的配置填写到配置文件中，然后就是权限申请，分别需要如下权限：

• 通讯录管理全部权限：获取部门列表，员工列表
• 查询钉钉 HRM 个人信息的权限：获取离职人员列表

如果配置准备完毕之后，就可以启动项目进行同步了。

手动同步

警告

• 请注意，操作分组或者用户同步之前，请务必检查是否已经添加了对应的字段关系，详情参考
• 手动同步时，需要先同步分组列表，然后再同步员工列表，员工数据依赖分组数据。
• 默认同步到平台上的员工密码为配置文件中 user-init-password: 配置项的值。