【更新日志】

无

【业务概述】

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

钉钉同步工具功能特性

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

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

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

【操作路径】

钉钉同步工具-功能路径：【集成管理】-【移动门户集成】-【钉钉同步工具】-【参数设置】

【操作指引】

此处为钉钉同步工具【参数设置】的详细逻辑说明，如需查看整体的钉钉同步工具的配置流程，详细看【钉钉同步工具操作手册】

参数设置具体说明，详情如下：

1、参数设置

1 配置环境参数。

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

https://oapi.dingtalk.com

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

2 配置EAS Cloud 同步参数。

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

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

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

c、组织和人员同名的情况。当钉钉上存在钉钉独有的组织和人员数据，则同步数据之前，需要现在EAS Cloud上新增这些组织及人员数据，再进行两者的同步，同步后此时系统执行同步成功，同步日志会显示失败，再次执行同步就会把EAS Cloud的组织人员数据和钉钉的绑定关系，并显示同步成功。综上同名的情况，需要在同步工具内执行2次同步。

d、仅同步关联用户的员工。部分人员数据没有关联用户，点选该项，程序会对该类人员数据进行过滤处理，此处和同步数据范围的作用是一致的，效用主要是对于未关联用户的人员数据避免在钉钉创建用户数据。

e、钉钉中没有主职位和兼职职位区分，EAS Cloud兼职暂不支持同步，仅支持主职位同步。

f、部门负责人，目前是同步至钉钉默认角色--负责人，但是钉钉不支持负责人通过接口数据同步，只支持手工设置负责人，这导致EAS Cloud的负责人数据无法在钉钉生效。所以部门负责人虽然是同步成功，但从结果来看实际是失败的。

g、钉钉中没有职位状态字段，故EAS Cloud的禁用和离职状态人员会直接同步到钉钉的删除人员接口。