钉钉签到记录同步插件

1. 简介

1.1 功能简介

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

1.2 适用对象

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

2. 钉钉平台配置

2.1 创建钉钉应用

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

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

2.2 记录Appkey和AppSecret

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

3. 插件安装及配置

3.1 安装插件

1）直接安装

2）插件市场处安装

在简道云「插件市场」处，安装「钉钉签到记录同步」插件。插件市场处安装方法可参见文档：插件市场中【2.3 插件安装】。

3.2 配置插件

1）安装后，在「插件管理」处，点击插件右侧的「设置」按钮，根据【2.3 记录 Appkey 和 AppSecret 】，将「钉钉CorpID」、「AppKey」和「AppSecret」等信息配置进去，配置完成后点击确定。

2）登录简道云，在「账号中心 >> 企业管理 >> 企业信息 >> 账号模式」处，获取钉钉 CorpID。

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）公共模式使用钉钉签到记录同步插件时需注意：简道云通讯录中的成员编号应与钉钉中的成员编号保持一致。如下所示：

简道云通讯录中的成员编号，可在「通讯录 >> 内部成员 >> 全部成员」中，点击单条成员数据后，进入成员数据详情页查看并修改。