【钉钉同步工具】操作手册

钉钉同步工具

钉钉同步工具-菜单路径：web端 【集成管理】-【移动门户集成】-【钉钉同步工具】-【参数设置】、【同步数据范围设置】、【同步执行】、【日志查看】

钉钉同步工具使用场景说明：将EAS Cloud端组织及人员数据同步到钉钉端，并建立两者数据的映射关系，以实现EAS Cloud与钉钉端业务融合

钉钉同步工具功能特性

① 支持一次性手工同步也支持通过【后台事务】配置定时程序自动同步数据

② 支持设置同步数据范围，过滤不需要同步到钉钉的数据

③ 支持查看同步日志数据以定位同步问题

钉钉同步工具使用流程说明

钉钉开发平台创建企业内部应用

在使用钉钉同步工具前，需要建立钉钉与EAS Cloud之间的联系。该联系，通过钉钉企业内部应用的开放api接口来实现。

以下通过几个步骤来设置参数

1） 创建应用

1 访问https://open-dev.dingtalk.com/，登录进入钉钉开放平台，通过路径【应用开发】-【小程序】，创建应用。

2 点击图1所示的【创建应用】按钮进入，按要求填写应用类型（选择小程序类型）、应用名称以及应用描述，开发方式选择企业自助开发。

3 点击上图【确定创建】，见下图，进入应用详情页，在路径【凭证与基础信息】-【应用凭证】下找到AppKey和AppSecret字段，将这两个字段内容复制于本地待用。

4 获取通讯录权限。在应用详情页，在路径【权限管理】-【已添加接口权限】下找到按钮【添加接口权限】，点击进入接口权限配置页面

5 在左侧可添加权限树下，找到通讯录类，并将其下的所有权限全部添加，完成情况见下图。

通过以上5个步骤，企业内部应用已创建完成。

EAS Cloud 配置同步信息

1）参数设置

1  配置环境参数。

将创建企业内部应用过程中，凭证与基础信息内复制待用的AppKey和AppSecret两个字段内容，对应企业ID及密钥填写，填写完毕，另外配置钉钉地址，地址：

https://oapi.dingtalk.com

（当前部署环境需支持正常访问该网址）

2  配置EAS Cloud 同步参数。

EAS参数同步设置，包括组织、人员以及部门负责人，此处根据企业的实际情况选取，保存设置后也支持修改，另外，以下有些同步场景的问题需要特别注意：

a、新增人员、仅同步关联用户的职员等场景中，都会发生在钉钉上创建账号的场景，创建手机号涉及手机号码获取，有如下规则：有关联用户的职员，优先从用户获取手机,用户手机为空则获取职员手机；无关联用户的职员，获取职员手机。

b、人员激活钉钉后，钉钉接口不支持更新人员的手机，请检查员工手机是否正确；人员激活钉钉后，若需变更手机号，请个人在钉钉中变更，或管理员在钉钉通讯录界面变更。

c、组织和人员同名的情况。当钉钉上存在钉钉独有的组织和人员数据，则同步数据之前，需要