1. 简介

1.1 功能简介

考勤数据同步插件可以通过定时业务规则将企业微信、钉钉考勤相关数据同步到搭贝表单中（插件在「业务规则」中作为执行动作使用）。

• 钉钉签到记录同步：将钉钉中的考勤签到数据同步到搭贝的表单中。
• 钉钉考勤请假同步：将钉钉中的考勤请假数据同步到搭贝的表单中。
• 钉钉考勤打卡同步：将钉钉中的考勤打卡数据同步到搭贝的表单中。
• 钉钉用户考勤数据同步：将钉钉的用户考勤打卡数据，包含了用户 打卡地址 和 备注信息 同步到搭贝的表单中 。
• 钉钉每日考勤统计同步：将钉钉考勤统计「每日汇总」中的数据同步到搭贝的表单。
• 企微打卡同步：将企业微信中的考勤打卡数据同步到搭贝的表单中。

2. 同步数据介绍

2.1 钉钉签到记录同步

插件获取到的钉钉签到记录数据如下图所示：

2.2 钉钉考勤请假同步

插件获取到的钉钉考勤打卡数据如下图所示：

2.3 钉钉考勤打卡同步

钉钉考勤打卡结果记录同步插件，用于获取企业内员工的实际打卡结果。

注意：

• 企业给一个员工设定的排班是上午9点和下午6点各打一次卡，即使员工在这期间打了多次，本接口也只会返回两条记录，包括上午的打卡结果和下午的打卡结果，结果中不包含用户打卡地址和备注信息，如果需要包含请使用「钉钉用户考勤数据统计」。

插件获取到的钉钉考勤打卡数据如下图所示：

2.4 钉钉用户考勤数据同步

获取用户的考勤打卡数据，获取的打卡信息中包含用户 打卡地址 和 备注信息 。

插件获取到的钉钉考勤打卡数据如下图所示：

2.5 钉钉每日考勤统计同步

钉钉考勤统计同步插件，获取钉钉智能考勤报表「每日汇总」的列值数据，包含一定时间段内报表某一列的数据，及相关的列信息。

注意：

• 获取到考勤报表列的应出勤天数本不该为0，却获取到0，是因为钉钉上只支持获取距今天 15天 内的值。
• 一次性最多同步 20 列的数据。

插件获取到的钉钉每日考勤统计数据如下表所示：

2.6 企微打卡同步

插件获取到的企业微信打卡数据如下图所示：

3. 使用前的配置

3.1 钉钉考勤类插件使用

在安装钉钉考勤类插件之后，需要配置「钉钉企业CorpID」「AppKey」「AppSecret」

• 钉钉企业CorpID：同步的钉钉企业 CorpID，默认为当前账号所在的企业。
• AppKey：在钉钉开放平台中创建钉钉自建应用，内有 AppKey。
• AppSecret：在钉钉开放平台中创建的钉钉自建应用，内有 AppSecret。

钉钉自建应用的创建步骤：

1、首先管理员需要 PC 端登录  钉钉开发者后台 ，选择「应用开发  >> 钉钉应用 」，选择「H5微应用」，点击「创建应用」。填写应用名称和应用描述。如下图所示：

2、打开该应用，点击「权限管理」，为该应用申请「考勤」下的所有权限，如下图所示：

3、点击「权限管理」，为该应用申请「签到」下的所有权限，如下图所示：

4、记录下创建的应用的 Appkey 和 AppSecret和组织的 CorpId ，插件配置时需要填写。如下图所示：

5、在首页中记录下组织的 CorpId ，在暗安装完插件之后需要填写在插件配置中，如下图：

3.2 企微考勤插件

在企微上使用考勤插件无需配置，只需要安装开启即可。

4. 使用方法

业务规则触发动作增加「定时重复」「定时单次」，根据设置的触发时间自动触发业务规则进行考勤数据同步。

注意：

• 一个业务规则只能使用一个考勤类插件。
• 触发时间：设定第一次同步的时间。
• 重复周期：则按照设定的周期进行重复触发。
• 结束时间：按周期重复同步，直到结束时间为止。

4.1 定时重复触发

「定时重复触发」会按照「触发时间、重复类型、重复触发结束时间」计算业务规则「触发时间」，按照「重复类型、同步签到数据起始日期」计算同步的数据周期。

场景一：「同步考勤数据起始日期」小于「触发时间」

例如「触发时间」为 2022-05-20 9:00，「重复触发结束时间」为 2022-05-23 9:00，「重复类型」为每天，「同步考勤数据起始日期」为 2022-05-01 9:00。 那么：

• 2022 年 5 月 20 日 9:00 将首次同步【2022-05-1～2022-05-20 9:00 】的数据，之后的数据同步走定时同步：
• 2022-05-21 9:00 业务规则将「2022-05-20 9:00～2022-05-21 9:00」的钉钉签到数据同步至表单中。
• 2022-05-22 9:00 业务规则将「2022-05-21 9:00～2022-05-22 9:00」的钉钉签到数据同步至表单中。
• 2022-05-23 9:00 业务规则将「2022-05-22 9:00～2022-05-23 9:00」的钉钉签到数据同步至表单中。

场景二：「同步考勤数据起始日期」大于「触发时间」

例如「触发时间」为 2022-05-20 9:00，「重复触发结束时间」为 2022-06-23 9:00，「重复类型」为每天，「同步考勤数据起始日期」为 2022-05-22 9:00。那么：

• 2022 年 5 月 22 日 9:00 将首次同步【2022-05-22 9:00 】的数据，之后的数据同步走定时同步：
• 2022-05-23 9:00 业务规则将「2022-05-22 9:00～2022-05-23 9:00」的钉钉签到数据同步至表单中。
• 2022-05-24 9:00 业务规则将「2022-05-23 9:00～2022-05-24 9:00」的钉钉签到数据同步至表单中。
• 2022-05-25 9:00 业务规则将「2022-05-24 9:00～2022-05-25 9:00」的钉钉签到数据同步至表单中。

4.2 定时单次触发

「定时单次触发」会在「触发时间」将「签到数据起始日期」-「签到数据结束日期」的数据导入表单中。 例如「触发时间」为 2022-05-01 零点，「签到数据起始日期」为 2022-01-01，「签到据结束日期」为 2022-04-01。 那么 2022-05-01 零点业务规则将「2022-01-01~2022-04-01」的钉钉签到数据导入表单中。

4.3 添加插件

• 同步方式：选择“仅新增”或“仅更新”。
• 同步数据日期范围：时间范围选择，精确到秒。触发动作为“定时单次”的时候此处是时间范围选择，即需要将「起始日期」-「结束日期」的数据导入表单中。
• 同步数据起始日期：触发动作为“定时重复”的时候此处是时间选择，即需要将「起始日期」后的数据导入表单中。
• 同步人员范围：人员多选框，只同步选中的人员信息且在系统里必须是开启的用户。
• 同步至表单：暂时不可选择其他的表单，显示当前表单。
• 添加同步内容： 需要同步的内容与表单字段对应关系。

5. 注意事项

• 考勤类数据最多一次性同步 5万 条数据，超出会中断执行。
• 最多同步 半年前 的数据，超出半年无法同步。