搭贝--钉钉、企微考勤数据获取

1、 功能介绍

考勤数据同步插件可以通过定时业务规则将企业微信、钉钉考勤相关数据同步到搭贝表单中。

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

2、同步数据介绍

2.1 钉钉签到记录同步

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

2.2 钉钉考勤请假同步

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

2.3 钉钉考勤打卡同步

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

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

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

2.4 钉钉用户考勤数据同步

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

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

2.5 钉钉每日考勤统计同步

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

注意：

• 1、如果获取考勤报表列值，返回的应出勤天数为0，则是因为应出勤天数字段，目前只支持获取距今天15内的值。
• 2、一次性最多同步20 列的数据。

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

2.6 企微打卡同步

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

3、使用前的配置

3.1 钉钉考勤类插件使用

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

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

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

1、首先管理员需要 PC 端登录 钉钉开发者后台 ，选择「应用开发 >> 企业内部开发 >> 钉钉应用」，点击「创建应用」。如下图所示：

2、选择应用类型为「H5微应用」，填写应用名称和应用描述，选择开发方式为「企业自助开发」。如下图所示：

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

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

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

3.2 企微考勤插件

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

4、使用方法

业务规则触发动作增加「定时重复」「定时单次」，根据设置的触发时间自动触发业务规则进行考勤数据同步。一个业务规则只能使用一个考勤类插件。

• 触发时间：设定第一次同步的时间。
• 重复周期：则按照设定的周期进行重复触发。
• 结束时间：按周期重复同步，直到结束时间为止。