云之家同步工具

【更新日志】

8.8版本发布新特性，如下：

1、云之家同步工具【参数配置】、【同步数据范围设置】客户端新增上机日志，后续变更此2处的设置，会被系统记录。

2、简化【同步日志查看】日期控件

3、同步日志支持通过后台事务定义设置自动清理

4、【异常数据处理】-【数据更新】支持通过后台事务定义自动进行数据更新

【业务概述】

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

云之家同步工具功能特性

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

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

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

【操作路径】

云之家同步工具-功能路径：【移动门户】-【EAS云之家】-【初始化设置】-【参数配置】、【同步数据范围设置】、【同步执行】、【同步日志查看】、【异常数据处理】、【帮助指引】

【使用指引】

使用前提：

【使用同步工具同步之前的注意事项】https://vip.kingdee.com/article/97632263021756160

云之家同步工具使用流程说明

云之家管理中心获取key文件

在使用云之家同步工具前，需要建立云之家与EAS Cloud之间的联系。该联系，通过云之家的系统集成密钥来实现。

1）获取key文件

①访问https://www.yunzhijia.com/，登录进入云之家管理中心，通过路径【管理中心】-【系统集成】-【通讯录同步】下，找到旧版系统集成密钥并下载，即可在本地获得以企业注册EID命名的key文件，保存该文件待用。

通过上述步骤，云之家端的准备工作已准备完成

EAS Cloud 配置同步信息

1）参数配置

① 配置环境参数

将获取key文件过程中获得的key文件对应上传至【KEY文件】处，【企业注册号】不需要填写，【云之家地址】填写 https://kingdee.yunzhijia.com（当前部署环境需支持正常访问该网址）

② 配置EAS Cloud 同步参数

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

a、人员手机号支持有条件的双向同步，双向同步指EAS手机号同步至云之家，同时云之家手机号变更也可反向同步至EAS。

从EAS更新手机到云之家：如有职员有关联用户，请修改用户的手机号，此时如修改职员的手机号，无法同步到云之家；如职员无法关联用户，可修改职员的手机号，可同步到云之家。

另外，对于目标手机号在云之家端也需要满足如下任意条件方可修改成功：

a1、目标手机号未注册云之家账户可成功修改

a2、如目标手机号已注册云之家账号，该用户须满足当前账号只有一个工作圈或所在圈都有一个相同的管理员，才可修改成功

从云之家更新手机到EAS：EAS用户手机号修改时间需晚于云之家修改的时间，则不做更新。

b、当云之家管理中心-通讯录-人员属性中添加其他属性时，也需要通过EAS将这类其他属性同步至云之家，则需要使用自定义人员信息。例如，需要把人员的用工关系状态同步到云之家，因云之家的人员属性中没有【用工状态类型】的字段，所以只能作为自定义人员属性进行同步。

2）同步数据范围设置

同步数据范围设置，设置不同步到云之家的组织和人员数据。

3）同步执行

点击开始同步，系统会自动开始执行同步数据程序，在每个步骤页内，可看到具体数据同步情况。当前设置了2个同步模式可选，分别是快速同步（增量模式）、全量同步（全量模式）。增量与全量的区别在于增量仅是同步之后的更新数据。

4）同步日志查看

在执行同步过程中或同步完成后，发现数据同步异常的，可通过同步日志来排查同步问题，至此同步流程已全部完成。

5）异常数据处理

当在同步日志中查看发现同步失败的数据情况，可在此功能上手工处理，如删除中间表人员，重新建立人员绑定等，这里一般是一些异常数据对接的情况。

6）后台事务配置云之家自动同步

访问菜单路径：【系统平台】-【后台事务定义】-【后台事务管理】，找到【企业建模】-【安全管理】-【用户管理】-【云之家同步】，修改调度计划。

7）启用【云之家同步】后台事务

修改后台事务配置完毕，访问菜单路径：【系统平台】-【后台事务定义报表】启用云之家同步事务，即完成程序自动同步数据流程。

以上9个步骤，即可完成云之家同步工具的配置流程