# 同步设置

来源快照：`result_data_new_260518.json`

- 来源 ID：`1182104587747155978`
- 模块：集成中心
- 目录：HR同步 - 管理员操作指南
- space ID：`1158011075224911873`
- 原文链接：未提供
- 产品基线：未提供

## 正文

# 一、功能背景

用户对HR同步功能进行配置管理，配置同步数据接口参数，字段映射规则，过滤规则以及相关的高级设置。

# 二、功能价值

避免重复的切换系统维护数据，降低企业组织架构管理成本，提升企业协调工作效率

# 三、功能说明

功能入口：后台管理中心-集成中心-HR同步-同步设置；

功能说明：对HR同步功能进行参数和个性化设置。

![](https://weapp.eteams.cn/papi/file/preview?fileId=1207380865372069892&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

## **1.基础设置**

启用:控制功能是否启用

同步方式包括手动同步和自动同步

手动同步: 需要配置完成后手动在第五步点击同步

手动同步和自动同步: 选择自动同步, 显示Cron表达式, 根据配置的频率进行同步(需要注意: 当前表达式暂不支持秒级别的配置)

![](https://weapp.eteams.cn/papi/file/preview?fileId=1180597350542934033&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

**同步频率****:** 默认值为0 0 1 * * ? 表示每天凌晨一点自动执行同步; 点击【设置】按钮出现设置窗，设置完成后，**需点击【确定】按钮** ;点击【重置】按钮将设置的cron表达式重置为默认值0 0 1 * * ?

## **2.同步设置**

![](https://weapp.eteams.cn/papi/file/preview?fileId=1180597367629496326&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

选择需要同步的数据来源和数据目标, 如同步分部, 数据来源选择数据源的接口, 数据目标选择分部的接口,同步内容文本框不允许设置纯数字。

需要注意的是: 数据目标若要选择分部, 需要在下面的位置启用分部, 否则数据目标的浏览框选择不到分部的接口

![](https://weapp.eteams.cn/papi/file/preview?fileId=1180597389289914394&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

## **3.接口参数**

 配置数据源连接信息及数据来源的参数

![](https://weapp.eteams.cn/papi/file/preview?fileId=1180597380637933572&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

     参数值:设置的数据源名称

数据库表名:本次同步的数据库表名

增量标识字段目前只支持值为日期的字段

增量标识值为日期

## **4.映射与过滤**

点击【字段对应设置】icon，进入对应的字段设置页面，如下图:

![](https://weapp.eteams.cn/papi/file/preview?fileId=1180597354837401604&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

内部的字段对应设置需要点击保存后，在设置icon后显示√；否则不显示；

字段对应设置：配置数据来源和数据目标的字段映射关系, 相当于把外部表的数据某个字段同步到OA的某个字段

   ![](https://weapp.eteams.cn/papi/file/preview?fileId=1180597350676652034&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

    

    来源字段：选择的是接口参数里这组配置的表名里的字段或数据源设置字段

    目标字段：同步设置中选择的接口对应的OA的表字段

    操作类型：无限制、仅添加、仅修改（根据实际同步的数据选择）

    转换规则：根据实际需要进行配置

主键为单选, 支持所有字段作为主键进行同步, 需要注意: 主键字段不要重复, 否则会导致后面同步的数据更新上面同步的数据.

 

(1)字段映射支持字段排序，可拖拽进行排序

![](https://weapp.eteams.cn/papi/file/preview?fileId=1180597372041904133&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

 

(2)字段映射处选择目标字段为人力接口,保存后可进行分部，部门，岗位，人员系统字段以及分部，部门，人员自定义字段的同步:

 

人事档案字段设置:

![](https://weapp.eteams.cn/papi/file/preview?fileId=1180597397787074572&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

自定义字段设置:

![](https://weapp.eteams.cn/papi/file/preview?fileId=1180597346372763653&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

分部,部门自定义字段设置:

![](https://weapp.eteams.cn/papi/file/preview?fileId=1180597380631838730&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

系统字段：

![](https://weapp.eteams.cn/papi/file/preview?fileId=1180597397787074566&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

![](https://weapp.eteams.cn/papi/file/preview?fileId=1180597363516784650&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

![](https://weapp.eteams.cn/papi/file/preview?fileId=1180597363516784641&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

![](https://weapp.eteams.cn/papi/file/preview?fileId=1180597384868085761&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

 

自定义字段:

![](https://weapp.eteams.cn/papi/file/preview?fileId=1180597376321126413&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

![](https://weapp.eteams.cn/papi/file/preview?fileId=1180597359087599621&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

![](https://weapp.eteams.cn/papi/file/preview?fileId=1180597397787074561&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

(3)字段对应设置里，转换规则支持选择类型：转换规则、函数公式与固定值

![](https://weapp.eteams.cn/papi/file/preview?fileId=1180597367739580423&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

若转换规则选择【转换规则】，则后方为【转换规则选择浏览框】，内容为转换规则库中的内容，支持浏览框快速新建转换规则；

![](https://weapp.eteams.cn/papi/file/preview?fileId=1180597363377004560&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

 

点击新建转换规则跳转到新建转换规则页面

![](https://weapp.eteams.cn/papi/file/preview?fileId=1180597372134711310&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

若转换规则选择【固定值】，则后方为【输入框】，直接可输入固定值；

![](https://weapp.eteams.cn/papi/file/preview?fileId=1180597372041904129&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

若转换规则选择【函数公式】，则后方为【函数公式选择浏览框】，内容为函数库中公式列表的内容，支持浏览框快捷新建公式.

![](https://weapp.eteams.cn/papi/file/preview?fileId=1180597393598332937&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

点击新建公式跳转到新建函数公式页面,可新建函数公式及变量

![](https://weapp.eteams.cn/papi/file/preview?fileId=1180597350676652037&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

 

（4）数据过滤规则根据【同步设置】中配置的【同步内容】配置对应的数据过滤规则，例如，【同步设置】中配置的【同步内容】为E9套件API同步分部、E9套件API同步部门、同E9套件API同步岗位，则支持分别配置这三项内容的数据过滤规则：

![](https://weapp.eteams.cn/papi/file/preview?fileId=1180597393618436097&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

![](https://weapp.eteams.cn/papi/file/preview?fileId=1180597359190556674&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

数据过滤规则浏览框支持新建，新建数据过滤时：

1）默认带出【业务数据】

2）根据业务数据默认带出【同步方向】

3）默认带出【数据来源】

4) 根据业务数据，配置接口展示对应的数据来源及数据来源字段

![](https://weapp.eteams.cn/papi/file/preview?fileId=1180597372098330629&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)![](https://weapp.eteams.cn/papi/file/preview?fileId=1180597393558683655&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

## **5.手动同步**

![](https://weapp.eteams.cn/papi/file/preview?fileId=1180597350542934027&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

 同步内容选择的是同步设置中开启的数据

封存组织效验下级开关默认开启，提示文案：关闭后，封存组织架构将取消是否存在下级、非封存下级组织以及在职人员的校验。

 全量同步开启, 不走增量标识, 全量同步数据

 同步情况, 记录同步进度, 显示同步详情, 点击同步详情可跳转至同步日志页面

## 6.迁入迁出

点击迁入可选择压缩包迁入同步设置

![](https://weapp.eteams.cn/papi/file/preview?fileId=1211104391682048012&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

点击行菜单迁出可将当前配置

![](https://weapp.eteams.cn/papi/file/preview?fileId=1211105259311570952&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

可迁入迁出配置说明：

配置项| 说明  
---|---  
同步配置| 支持迁入迁出，迁入时新建同步设置  
数据过滤规则| 251201基线支持迁入迁出，迁入时新建对应过滤规则  
转换规则库| 用户级别转换规则：同租户支持迁入迁出，不同租户或不同系统间不支持系统级别转换规则：支持迁入迁出  
自定义SQL| 251201基线支持迁入迁出，迁入时新建对应自定义SQL，SQL中使用的数据源也同时新建，注意：此数据源的用户名和密码需要手动维护后使用  
函数公式| 251201基线支持迁入迁出，迁入时新建函数公式  
动作流| HR同步配置中引用的动作流支持迁入迁出，迁入时，新建对应动作流、连接器
