# 数据同步设置

来源快照：`result_data_new_260518.json`

- 来源 ID：`1180226767967977480`
- 模块：出勤
- 目录：后台维护 - 外部集成考勤
- space ID：`4525924050788866030`
- 原文链接：未提供
- 产品基线：未提供

## 正文

# 一、功能背景

可以将外部考勤机打卡时间数据同步到标准产品中来，并且参与考勤报表统计。

# 二、功能概述

数据同步设置是用来设置与外部考勤系统进行自动同步的页面，需要外部考勤数据也是以数据库的形式进行存储的。

![](https://weapp.eteams.cn/papi/file/preview?fileId=1180227197306028044&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、自动同步设置

1) 点击【启用】按钮，按钮呈现开启状态，代表自动同步设置启用成功，系统每天凌晨1点会自动同步外部考勤系统的数据，如若按钮关闭就不会进行同步（目前暂不支持调整同步时间）。

2) 如果不采用自动同步，可以在“同步人员范围”“同步时间范围”内选择同步的开始日期和结束日期，点击【立即同步】按钮，该时间段的外部数据将会同同步至考勤表中。

## 2、 同步对应字段设置

同步对应字段是非常重要的内容，它决定了系统中的哪些数据与系统中的人员考勤情况进行关联，点击![](https://weapp.eteams.cn/papi/file/preview?fileId=1180227197306028035&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=1180227197418405890&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系统中的考勤表（必填）

.

账号：同步数据时根据账号字段取OA系统中的用户ID（账号、工号、姓名必须填写一个）

.

工号：同步数据时根据工号字段取OA系统中的用户ID（账号、工号、姓名必须填写一个）

.

姓名：同步数据时根据姓名字段取OA系统中的用户ID（账号、工号、姓名必须填写一个）

.

签到签退日期：格式，如2022-01-01，如果表中签到日期为长时间格式，如：2022-01-01 09:00:00， 后台自动会将数据长度将数据格式化成：2022-01-01（必填）

.

签到签退时间：格式，如09:00:00，如果表中签到日期为长时间格式，如：2022-01-01 09:00:00，后台自动会将数据长度将数据格式化成：09:00:00，此字段无需设置

.

签到签退IP：签到签退IP地址，用于表示用户在哪台考勤机上签到签退（非必填）

.

增量同步字段：若自动同步时该字段有值，则根据“增量同步字段”采取增量同步方式，若无值，则采取全量同步方式

.

备注：备注项内容填写

## 3、 外部集成考勤同步支持签到和签退类型闸机数据独立同步

前提条件：

通过eb来设置配置表

设置一个配置的eb表，表字段如下

![](https://weapp.eteams.cn/papi/file/preview?fileId=1256009374101356550&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)

下拉框字段true：开启，false：关闭

![](https://weapp.eteams.cn/papi/file/preview?fileId=1256009378371158018&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)

通过ebuild表单触发

![](https://weapp.eteams.cn/papi/file/preview?fileId=1256009365678727181&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=1256009378454577156&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)

通过serverless调用设置

分组标识：ATTEND

版本号：attendConfigurationV1  
参数  
 save_type 0是新增,1是修改,2是删除  
tenantKey 租户  
config_name 配置文件中文名  
config_key  forceSignType  
config_value true开启

![](https://weapp.eteams.cn/papi/file/preview?fileId=1256009374171365381&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个动作流，改下触发时机，改下save_type（0是新增，1是修改，2是删除）

![](https://weapp.eteams.cn/papi/file/preview?fileId=1256009365644648452&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=1256009361185800193&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=1256009369805398017&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)

在eb表创建1条配置数据，控制同步增加强制签到签退配置key：forceSignType，开关开启，配置名称自行设置

![](https://weapp.eteams.cn/papi/file/preview?fileId=1256009378516664328&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、外部数据同步增加：强制签到签退类型，关联数据源的签到签退类型字段

 

![](https://weapp.eteams.cn/papi/file/preview?fileId=1256009378371158022&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)

数据源需要有个签到签退类型的字段，签到：CHECKIN、签退：CHECKOUT

![](https://weapp.eteams.cn/papi/file/preview?fileId=1256009369993838596&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=1256009361266319364&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=1256009374251360261&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=1256009374171365377&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=1256009369805398024&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=1256009374171365388&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=1256009369993838603&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、操作日志

点击页面右上角“三点”即可查看“数据同步设置”的日志，也可通过操作时间、操作人、操作类型、对象和导入结果快速筛选。

![](https://weapp.eteams.cn/papi/file/preview?fileId=1180227197306028040&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)
