同步日报-汇总数据
1. 简介
1.1 插件简介
同步日报数据汇总,可以将企业微信中的日报数据汇总后同步到简道云表单中。
1.2 适用对象
企业微信集成模式 的用户,想要使用企业微信打卡同步插件进行日报汇总。
1.3 预期效果
以同步汇总 2024 年 1 月的日报数据为例,效果如下所示:
2. 企业微信平台配置
2.1 查看企业corp ID
登录简道云工作台,在「账户中心 >> 基本信息 >> 企业信息 >> 基础信息」中,即可查看企业的 CorpID。
2.2 配置打卡权限
1)企业微信管理员登录 企业微信应用管理后台,在「应用管理 >> 应用 」中,点击「简道云 」。
2)进入简道云应用的详情页,在「功能 >> 授权信息 」处,点击「查看 」。
3)在「授权信息 >> 打卡 」处,点击「编辑权限 」,勾选「打卡」和「考勤机打卡原始数据」权限。
注:
1)若无法在企业微信管理后台处配置打卡权限,表示您的简道云不是企业微信代开发模式,则无法使用企业微信打卡同步插件。
2)如需将简道云转为企业微信代开发模式,可通过以下 2 种方式进行授权绑定:
3. 插件配置
3.1 安装插件
1)直接安装
- 您可点击右方链接直接安装插件:企业微信打卡同步插件安装。
- 安装成功后,可参考本文【3.2 配置插件】,前往「开放平台 >> 插件管理」处配置并启用插件。
2)插件市场处安装
在简道云「插件市场」处,安装「企业微信打卡同步」插件。插件市场处安装方法可参见文档:插件市场中【2.3 插件安装】。
3.2 配置插件
安装后,点击插件右侧的设置按钮,将【2.1 查看企业 CorpID】中获取到的企业微信 CorpID 配置进去。
注:历史已配置打卡应用 Secret 的简道云用户可继续使用,新用户仅需配置企业微信 CorpID 即可。
3.3 数据简介
「日报数据-汇总数据」函数获取到的企业微信日报数据如下表所示:
名称 | 内容含义 | 支持赋值的表单字段类型 |
日报日期 | 日报填写的日期 | 日期时间 |
日期类型 | 记录日报日期为工作日还是休息日 | 单行文本 |
记录类型 | 记录类型:
| 单行文本 |
打卡成员 | 接收企业微信打卡数据中的成员信息 | 成员单选、单行文本 |
打卡规则名 | 打卡规则的名称 | 单行文本 |
当日所属班次名称 | 仅按班次上下班才有值,显示在打卡日报-班次列 | 单行文本 |
标准工时 | 当日标准工作时长 | |
实际工时 | 当日实际工作时长 | |
最早打卡时间 | 当日最早打卡时间 | 日期时间 |
最晚打卡时间 | 当日最晚打卡时间 | |
打卡次数 | 当日打卡次数 | 数字 |
标准打卡时间表 | 标准打卡时间,指此次打卡时间对应的标准上班时间或标准下班时间 | 多行文本 |
加班信息 | 加班状态,如下所示:
| |
异常信息 | 记录当日异常状态的次数和时长:
| |
假勤审批信息 | 记录假勤审批信息,如审批单号、标题等 | |
假勤统计信息 | 记录假勤相关信息,如请假类型、请假次数、请假时长。 |
4. 表单搭建
新建「企业微信打卡日报(概览)」表,所需要的打卡日报信息及字段设置如下所示:
字段名称 | 字段类型 |
日报日期 | 日期时间 |
日期类型 | 单行文本 |
记录类型 | |
打卡成员 | 成员单选 |
打卡规则名 | 单行文本 |
当日所属班次名称 | |
标准工时 | |
实际工时 | |
最早打卡时间 | 日期时间 |
最晚打卡时间 | |
打卡次数 | 数字 |
标准打卡时间表 | 多行文本 |
加班信息 | |
异常信息 | |
假勤审批信息 | |
假勤统计信息 |
注:进行表单搭建时,需要同步的字段类型需与 【3.3 数据简介】中的类型保持一致,否则无法使用。
5. 智能助手设置
在同步数据时,若历史数据的周期过长且数据较多,可先使用「定时单次」将历史周期数据同步成功后,再使用「定时重复」定期导入数据。
两种触发方式的设置方法基本一致,本文将以定时重复触发为例,并对定时单次触发的设置差别进行详细描述。
5.1 新建智能助手
设计完表单并保存后,切换到「扩展功能」处新建智能助手,并修改智能助手的名称为「日报同步(概览)」:
5.2 设置触发动作
1)智能助手设置如下所示:
- 触发动作:定时重复触发
- 触发时间:2024-01-01 00:00:00
- 重复类型:每天
- 重复触发结束时间:2023-01-31 23:59:59
2)定时重复触发与定时单次触发的设置项不完全相同,具体设置如下表所示:
触发方式 | 设置项 | 简介 |
定时重复触发 | 触发时间 | 定义:何时开始触发智能助手任务 规则:必填项,精确到秒 |
重复类型 | 选项:「每天」/「每周」/「每两周」/「每月」/「每年」/「自定义重复」 规则:必填项,默认值为「每天」 | |
重复触发结束时间 | 定义:何时结束触发智能助手任务 规则,必填项,精确到秒,「重复触发结束时间」不可早于「触发时间」 | |
定时单次触发 | 触发时间 | 定义:何时触发一次智能助手任务 规则:必填项,精确到秒 |
5.3 设置执行动作
1)设置执行动作如下所示:
- 执行动作:选择「企业微信打卡同步 >> 同步日报-汇总数据」;
- 表单:选择「企业微信打卡日报(概览)」;
- 同步方式:默认值,为仅新增;
- 同步打卡数据日期范围起始时间:设置为自定义,可自定义起始时间。如设置为2024-01-01 10:06:25;
- 同步打卡数据日期范围结束时间:设置为字段值,选择为当次运行时间;
- 同步员工范围:设置为自定义,自定义选择需要同步日报数据的员工。
2)添加同步内容。企业可根据所需数据添加企业微信中的日报数据进行同步,如日报日期、日期类型、记录类型、打卡成员、打卡规则名等等。以添加日报日期为例,如下所示:
3)定时重复触发与定时单次触发的设置项不完全相同,具体设置如下表所示:
设置项 | 简介 |
表单 | 内容同步的目标表单。
|
同步方式 | 同步方式为「仅新增」,即有新数据推送时,只做增量更新,不做覆盖更新。 |
同步打卡数据日期起始时间 | 1)定时重复触发:设置其为「字段值」,下拉框需选择「上次运行时间」。 2)定时单次触发:可以选择起始日期和结束日期,均使用日期时间字段,精确到具体时分秒;系统将根据用户设定的时间跨度来同步数据。 |
同步打卡数据日期结束时间 | 1)定时重复触发:设置其为「字段值」,下拉框需选择「当次运行时间」。 2)定时单次触发:可以选择起始日期和结束日期,均使用日期时间字段,精确到具体时分秒;系统将根据用户设定的时间跨度来同步数据。 |
同步员工范围 | 默认为空,可选择组织架构、角色、成员。 最多可选择 1500 个成员,同步时仅同步前 1500 个成员 |
同步内容 | 可将【3.3 数据简介】中展示的字段数据同步到表单对应字段中。 若表单字段不符合字段类型需求,则无法正常同步,可能无法得到同步内容。 |
6. 效果演示
效果参见本文【1.3 预期效果】。