同步日报-假勤列表

1. 简介

1.1 插件简介

日报数据假勤列表，可以将企业微信中的请假、考勤等信息同步到简道云表单中。

1.2 适用对象

企业微信集成模式的用户，想要使用企业微信打卡同步插件进行请假、考勤信息查看。

1.3 预期效果

以同步 2024 年 1 月的假勤数据为例，效果如下所示：

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 数据简介

「日报数据-假勤列表」函数获取到的企业微信日报数据如下表所示：

字段名称	内容含义	支持赋值的表单字段类型
日期	日报日期	日期时间
日期类型	记录日报日期为工作日还是休息日	单行文本
成员	接收企业微信打卡数据中的成员信息	成员单选
假勤类型	假勤类型如下所示：请假补卡出差外出外勤	单行文本
假勤名称	记录请假考勤名称，如下所示：小时假日假年假
请假类型ID	具体请假类型，当type为1请假时，具体的请假类型ID
假勤时长	当日假勤时长
请假单位	时长单位，如下所示：天小时
假勤次数	当日假勤次数	数字

4. 表单搭建

新建「企业微信打卡日报（假勤）」表，所需要的打卡日报信息及字段设置如下所示：

字段名称	字段类型
日期	日期时间
日期类型	单行文本
成员	成员单选
假勤类型	单行文本
假勤名称
请假类型ID
假勤时长
请假单位
假勤次数	数字

注：进行表单搭建时，需要同步的字段类型需与【3.3 数据简介】中的类型保持一致，否则无法使用。

5. 智能助手设置

在同步数据时，若历史数据的周期过长且数据较多，可先使用「定时单次」将历史周期数据同步成功后，再使用「定时重复」定期导入数据。
两种触发方式的设置方法基本一致，本文将以定时重复触发为例，并对定时单次触发的设置差别进行详细描述。

5.1 新建智能助手

表单设计完成后，在「扩展功能 >> 智能助手」处，点击「新建智能助手」，进行如下设置：

修改智能助手的名称为「日报同步（数据）」；
触发方式：选择「定时触发」。

5.2 设置触发动作

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

触发时间类型：选择「自定义时间」，如 2024-01-18 00:00；
重复触发：设置为「每周触发一次」；
结束触发时间：2025-09-10 00:00。

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

触发方式	设置项	简介
定时重复触发	触发时间	定义：何时开始触发智能助手任务规则：必填项，精确到秒
	重复类型	选项：「每天」/「每周」/「每两周」/「每月」/「每年」/「自定义重复」规则：必填项，默认值为「每天」
	重复触发结束时间	定义：何时结束触发智能助手任务规则，必填项，精确到秒，「重复触发结束时间」不可早于「触发时间」
定时单次触发	触发时间	定义：何时触发一次智能助手任务规则：必填项，精确到秒

5.3 添加并设置插件节点

1）点击节点连接线上的加号按钮，添加插件节点，并设置插件节点如下所示：

插件读写表单：选择「企业微信打卡日报（假勤）」；
执行动作：选择「企业微信打卡同步 >> 同步日报-假勤列表」；
同步方式：默认值，为仅新增；
同步打卡数据日期范围起始时间：设置为自定义，可自定义起始时间。如设置为2024-01-01 10:27:31；
同步打卡数据日期范围结束时间：设置为字段值，选择为当次运行时间；
同步员工范围：设置为自定义，自定义选择需要同步日报数据的员工；
同步内容：赋值方式选择「逐行赋值」，点击添加按钮后，企业可根据所需数据添加企业微信中的日报数据进行同步，如日报日期、日期类型、成员、假勤类型、假勤名称等等。

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

设置项	简介
表单	内容同步的目标表单。在应用设置创建的智能助手，可选择本应用内其他表单（不支持跨应用表单），默认不选中任何表单；在表单扩展功能中创建的智能助手，表单为当前表单，不可修改。
同步方式	同步方式为「仅新增」，即有新数据推送时，只做增量更新，不做覆盖更新。
同步打卡数据日期起始时间	1）定时重复触发：设置其为「字段值」，下拉框需选择「上次运行时间」。 2）定时单次触发：可以选择起始日期和结束日期，均使用日期时间字段，精确到具体时分秒；系统将根据用户设定的时间跨度来同步数据。注：开始时间不能晚于结束时间
同步打卡数据日期结束时间	1）定时重复触发：设置其为「字段值」，下拉框需选择「当次运行时间」。 2）定时单次触发：可以选择起始日期和结束日期，均使用日期时间字段，精确到具体时分秒；系统将根据用户设定的时间跨度来同步数据。注：同步范围不能超过366天。
同步员工范围	默认为空，可选择组织架构、角色、成员。最多可选择 1500 个成员，同步时仅同步前 1500 个成员
同步内容	可将【3.3 数据简介】中展示的字段数据同步到表单对应字段中。若表单字段不符合字段类型需求，则无法正常同步，可能无法得到同步内容。

6. 效果演示

效果参见本文【1.3 预期效果】。