钉钉同步工具

钉钉同步工具原创

李鸿运

10人赞赏了该文章 4,087次浏览编辑于2023年02月03日 15:10:19

摘要由AI智能服务提供

钉钉同步工具已发布，支持EAS Cloud 8.6.1版本并需打PT161099补丁。该工具可同步EAS Cloud组织及人员数据到钉钉，支持手动或自动同步，设置同步范围，查看同步日志。使用前需在钉钉开放平台创建应用并获取AppKey和AppSecret，之后在EAS Cloud配置同步信息，包括参数设置、同步数据范围、执行同步、日志查看及配置后台事务实现自动同步。

钉钉同步工具已正式发布，支持版本：EAS Cloud 8.6.1，需要打PT161099补丁后才能正常使用

以下为钉钉同步工具功能详情：

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

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

钉钉同步工具功能特性

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

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

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

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

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

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

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

1）创建应用

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

图 1

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

图 2

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

图 3

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

图 4

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

图 5

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

二、 EAS Cloud 配置同步信息

1）参数设置

① 配置环境参数。

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

https://oapi.dingtalk.com

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

② 配置EAS Cloud 同步参数。

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

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

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

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

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

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

f、部门负责人目前不支持同步，详情见链接https://vip.kingdee.com/article/307472654221813248

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