同步记录
1. 简介
1.1 功能简介
同步记录事件，可以方便快捷地将企业微信中的打卡数据同步到简道云表单中，让管理员可以使用这些数据计算员工的出勤率和工资等数据。
1.2 适用对象
1.3 预期效果
以同步 2021 年 7 月考勤数据为例，效果如下所示：
2. 企业微信平台配置
2.1 查看企业CorpID
登录简道云工作台，在「账户中心 >> 基本信息 >> 企业信息 >> 基础信息」中，即可查看企业的 CorpID。
2.2 配置打卡权限
1）企业微信管理员登录 企业微信应用管理后台，在「应用管理 >> 应用 」中，点击「简道云 」。
2）进入简道云应用的详情页，在「功能 >> 授权信息 」处，点击「查看 」。
3）在「授权信息 >> 打卡 」处，点击「编辑权限 」，勾选「打卡」和「考勤机打卡原始数据」权限。
注：
1）若无法在企业微信管理后台处配置打卡权限，表示您的简道云不是企业微信代开发模式，则无法使用企业微信打卡同步插件。
2）如需将简道云转为企业微信代开发模式，可通过以下 2 种方式进行授权绑定：
3. 插件配置
3.1 安装插件
1）直接安装
- 您可点击右方链接直接安装插件：企业微信打卡同步插件安装。
- 安装成功后，可参考本文【3.2 配置插件】，前往「开放平台 >> 插件管理」处配置并启用插件。
2）插件市场处安装
在简道云「插件市场」处，安装「企业微信打卡同步」插件。插件市场处安装方法可参见文档：插件市场中【2.3 插件安装】。
3.2 配置插件
安装后，点击插件右侧的设置按钮，将【2.1 查看企业 CorpID】中获取到的企业微信 CorpID 配置进去。
3.3 数据简介
「企业微信打卡同步」插件获取到的企业微信打卡数据如下表所示：
名称 | 内容含义 | 支持赋值的表单字段类型 |
打卡成员 | 接收企业微信打卡数据中的成员信息 | 成员单选、单行文本 |
打卡组名称 | 接收企业微信打卡规则中的规则名称信息 | 单行文本 |
打卡类型 | 目前有：上班打卡，下班打卡，外出打卡 | 单行文本 |
异常类型 | 包括：时间异常，地点异常，未打卡，wifi异常，非常用设备 | 单行文本 |
打卡时间 | 实际打卡时间 | 日期时间（精确到时分秒） |
标准打卡时间 | 标准打卡时间，指此次打卡时间对应的标准上班时间或标准下班时间 | 日期时间（精确到时分秒） |
打卡地点 | 实际打卡地点名称 | 单行文本 |
打卡地点详情 | 实际打卡地点详细地址 | 地址字段、单行文本 |
打卡WI-FI名称 | 打卡WI-FI名称 | 单行文本 |
打卡的 MAC 地址 | 打卡的 MAC 地址/ bssid | 单行文本 |
打卡备注 | 打卡时添加的备注信息 | 单行文本、多行文本 |
打卡设备 ID | 如果管理员设置了打卡设备，通过设备打卡的成员会同步设备 ID | 单行文本 |
打卡组 ID | 根据打卡组名称生成的唯一识别性打卡组 ID | 数字、单行文本 |
班次 ID | 表示打卡记录所属规则中，所属班次的 ID；如果打卡规则设置的是「按班次上下班」进行打卡的话，每个班次会生成一个唯一性班次 ID | 数字、单行文本 |
时段 ID | 如果打卡规则设置的是「按班次上下班」进行打卡的话，此 ID表示某一班次中的某一时段的ID，如上下班时间为9:00-12:00、13:00-18:00的班次中，9:00-12:00为其中一组时段 | 数字、单行文本 |
4. 表单搭建
新建「同步记录表」，所需要的考勤信息及字段设置如下所示：
字段名称 | 字段类型 |
打卡成员 | 单行文本：默认支持 成员单选：支持进行成员单选，考勤数据即可同步到简道云里 注：选用单行文本字段时，成员信息回填后为一串成员 ID，可读性较差。故建议使用成员单选字段类型 |
打卡组名称 | 单行文本 |
打卡类型 | |
异常类型 | |
打卡时间 | 日期时间 |
标准打卡时间 | |
打卡地点 | 单行文本 |
打卡地点详情 | 下拉框 |
打卡wifi名称 | 单行文本 |
打卡mac地址 | |
打卡备注 | |
打卡设备ID | |
打卡组ID | |
班次ID | |
时段ID |
注：进行表单搭建时，需要同步的字段类型需与 【3.3 数据简介】中的类型保持一致，否则无法使用。
5. 智能助手设置
在同步数据时，若历史数据的周期过长且数据较多，可先使用「定时单次」将历史周期数据同步成功后，再使用「定时重复」定期导入数据。
两种触发方式的设置方法基本一致，本文将以定时重复触发为例，并对定时单次触发的设置差别进行详细描述。
5.1 新建智能助手
设计完表单并保存后，切换到「扩展功能」处新建智能助手。
5.2 设置触发动作
1）智能助手设置如下所示：
- 触发动作：定时重复触发
- 触发时间：2023-11-28 22:04:41
- 重复类型：每天
- 重复触发结束时间：2023-12-31 23:59:59
2）定时重复触发与定时单次触发的设置项不完全相同，具体设置如下表所示：
触发方式 | 设置项 | 简介 |
定时重复触发 | 触发时间 | 定义：何时开始触发智能助手任务 规则：必填项，精确到秒 |
重复类型 | 选项：「每天」/「每周」/「每两周」/「每月」/「每年」/「自定义重复」 规则：必填项，默认值为「每天」 | |
重复触发结束时间 | 定义：何时结束触发智能助手任务 规则，必填项，精确到秒，「重复触发结束时间」不可早于「触发时间」 | |
定时单次触发 | 触发时间 | 定义：何时触发一次智能助手任务 规则：必填项，精确到秒 |
5.3 设置执行动作
1）设置执行动作如下所示：
- 执行动作：选择「企业微信打卡同步 >> 同步记录」；
- 表单：选择「同步记录表」；
- 同步方式：默认值，为仅新增；
- 同步打卡类型：下拉框中选择「全部打卡」；
- 同步数据起始日期：设置为字段值，选择为上次运行时间；
- 同步数据结束日期：设置为字段值，选择为当次运行时间；
- 同步员工范围：设置为自定义，自定义选择需要同步日报数据的员工。
2）添加同步内容。企业可根据所需数据添加企业微信中的打卡数据进行同步，如打卡成员、打卡组名称、打卡类型、异常类型、打卡时间等。以添加打卡成员为例，如下所示：
3）定时重复触发与定时单次触发的设置项不完全相同，具体设置如下表所示：
设置项 | 简介 |
表单 | 内容同步的目标表单。
|
同步方式 | 同步方式为「仅新增」，即有新数据推送时，只做增量更新，不做覆盖更新。 |
同步打卡类型 | 上下班打卡、外出打卡、全部打卡 |
同步数据起始日期 | 1）定时重复触发：设置其为「字段值」，下拉框需选择「上次运行时间」。 2）定时单次触发：可以选择起始日期和结束日期，均使用日期时间字段，精确到具体时分秒；系统将根据用户设定的时间跨度来同步数据。 |
同步数据结束日期 | 1）定时重复触发：设置其为「字段值」，下拉框需选择「当次运行时间」。 2）定时单次触发：可以选择起始日期和结束日期，均使用日期时间字段，精确到具体时分秒；系统将根据用户设定的时间跨度来同步数据。 |
同步员工范围 | 默认为空，可选择组织架构、角色、成员。 最多可选择 1500 个成员，同步时仅同步前 1500 个成员 |
同步内容 | 可将【3.3 数据简介】中展示的字段数据同步到表单对应字段中。 若表单字段不符合字段类型需求，则无法正常同步，可能无法得到同步内容。 |
6. 效果预览
6.1 触发时间
6.1.1 定时重复触发
「定时重复触发」会按照「触发时间、重复类型、重复触发结束时间」计算智能助手「触发时间」，按照「同步数据起始日期」和「同步数据结束日期」计算导入的数据周期。
例如「触发时间」为 2022-10-11 9:00，「重复触发结束时间」为 2022-10-13 9:00，「重复类型」为每天，「同步数据起始日期」为 「上次运行时间」，「同步数据结束日期」为 「当次运行时间」。
那么，智能助手执行逻辑如下：
- 2022 年 10 月 11 日 9:00 首次同步时，其同步数据的起始时间为「上次运行时间」，即 2022 年 10 月 10 日 9:00 （理论上的时间值，实际上该时间点无数据）；同步数据的结束时间为「当次运行时间」，即 2022 年 10 月 11 日 9:00。
- 2022年 10 月 12 日 9:00 同步数据时，智能助手同步数据的起始时间依然为「上次运行时间」，即 2022 年 10 月 11 日 9:00；同步数据的结束时间为「当次运行时间」，即 2022 年 10 月 12 日 9:00。故可将「2022-10-11」全天的企业微信打卡数据同步至简道云表单中。
- 2022年 10 月 13 日 9:00 同步数据时，智能助手同步数据的起始时间仍然为「上次运行时间」，即 2022 年 10 月 12 日 9:00；同步数据的结束时间为「当次运行时间」，即 2022 年 10 月 13 日 9:00。故可将「2022-10-12」全天的企业微信打卡数据同步至简道云表单中。
6.1.2 定时单次触发
「定时单次触发」会在「触发时间」将「考勤数据起始日期」-「考勤数据结束日期」的数据导入表单中。
例如「触发时间」为 2021-05-01 零点，「考勤数据起始日期」为 2021-01-01，「考勤数据结束日期」为 2021-04-01。
那么 2021-05-01 零点智能助手将「2021-01-01~2021-04-01」的企业微信打卡数据导入简道云表单中。
6.2 数据同步效果
设置完成后，智能助手会在指定时间同步数据到表单，可以在数据管理处查看同步的数据。如下图所示：
6.3 执行日志
1）执行日志中可以查询插件的执行结果。
2）当执行失败时可以参照日志进行调整，执行失败的原因如下：
执行结果 | 原因说明 |
执行「企业微信考勤打卡同步」插件（失败-插件已停用） | 插件安装了但未启用 |
执行「企业微信打卡同步」插件（失败-插件已卸载） | 请重新安装「企业微信打卡同步」插件 |
执行「企业微信打卡同步」插件（失败-付费版本过期） | 简道云高级版已到期，请续费 |
执行「企业微信打卡同步」插件 | 插件执行成功，数据成功新增至表单 |
执行「企业微信打卡同步」插件 | 插件执行成功，但是没有数据： - 同步的时间范围内，没有数据; -「同步员工范围」只选择了一级部门（需勾选所有子部门） |
执行「企业微信打卡同步」插件（失败-请检查插件配置） | 插件配置中填写的 Secret 不正确 |
执行「企业微信打卡同步」插件（失败-执行超时） | 插件执行耗时长，请检查智能助手相关配置 |
执行「企业微信打卡同步」插件（失败-同步数据量超过 5W 条） | 智能助手单次同步数据量不可超过 5W 条，若数据量过大，请分批多次导入 |
400-111-0890
在线咨询