钉钉考勤打卡同步插件

1. 简介

1.1 功能简介

钉钉考勤打卡同步插件，可以方便快捷的将钉钉中的考勤打卡数据同步到简道云表单中，让管理员可以使用这些数据计算员工的出勤率和工资等数据。

1.2 适用对象

适用于公共模式和 钉钉集成模式 的账号，不适用于其他模式。

2.钉钉平台配置

2.1 创建钉钉应用

1）管理员需要 PC 端登录 钉钉开放平台，选择「应用开发 >> 应用开发 >> 钉钉应用」，点击「创建应用」。如下图所示：

2）在创建应用详情页中，填写应用名称和应用描述，并上传应用图标后，点击「保存」按钮。如下图所示：

2.2 权限申请

在应用开发详情页中，进入「权限管理 >> 考勤」处，勾选「查询企业考勤数据权限」并点击「申请权限」按钮。如下图所示：

2.3 记录Appkey和AppSecret

在「凭证与基础信息」处，记录下创建的应用的 Appkey 和 AppSecret ，插件配置时需要填写。如下图所示：

2.4 获取企业CorpId

进入钉钉开放平台首页中，在右侧个人信息下获取钉钉的企业 CorpId，如下所示：

3. 插件安装及配置

3.1 安装插件

1）直接安装

2）插件市场处安装

在简道云「插件市场」处，安装「钉钉考勤打卡同步」插件。插件市场处安装方法可参见文档：插件市场中【2.3 插件安装】。

3.2 配置插件

安装后，在「插件管理」处，点击插件右侧的「设置」按钮：

全部配置完成后，点击「确定」按钮。

3.3 启用插件

在插件管理中，打开钉钉考勤打卡同步插件右侧开关，启用插件。

4. 表单搭建

新建「考勤打卡信息表」，所需要的考勤信息及字段设置如下所示：

5. 智能助手同步数据

表单设计完成后，插件获取到的数据，可通过「智能助手」及时同步到表单中。用户可选择以下任一方式推送。

两种触发方式的设置方法基本一致，本文将以定时重复触发为例，并对定时单次触发的设置差别进行详细描述。

5.1 新建智能助手

表单制作完成后，切换至「扩展功能」页面，新建智能助手，如下图所示：

5.2 设置触发动作

1）智能助手设置如下所示：

2）定时重复触发与定时单次触发的设置项不完全相同，具体设置如下表所示：

5.3 设置执行动作

1）选择「钉钉考勤打卡同步」插件，如下图所示：

2）设置表单、同步方式、同步数据起始日期、同步数据结束日期、同步员工范围、同步内容，设置完成后点击「完成」，如下图所示：

3）定时重复触发与定时单次触发的设置项不完全相同，具体设置如下表所示：

6. 效果预览

6.1 触发时间

6.1.1 定时重复触发

「定时重复触发」会按照「触发时间、重复类型、重复触发结束时间」计算智能助手「触发时间」，按照「同步数据起始日期」和「同步数据结束日期」计算导入的数据周期。

例如「触发时间」为 2022-10-11 9:00，「重复触发结束时间」为 2022-10-13 9:00，「重复类型」为每天，「同步数据起始日期」为 「上次运行时间」，「同步数据结束日期」为 「当次运行时间」。

那么，智能助手执行逻辑如下：

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 执行日志

用户可在智能助手处查看任务执行日志，执行日志中可以查看执行时间、执行人、触发动作、执行结果等数据。

当执行失败时可以参照日志进行调整，执行失败的原因如下：

7. 注意事项

1）管理员在 钉钉开放平台 中，创建钉钉应用时，所创建的内部应用会占用钉钉中的 API 调用量。

2）公共模式使用钉钉考勤打卡同步插件时需注意：简道云通讯录中的成员编号应与钉钉中的成员编号保持一致。如下所示：