得力考勤数据同步
1. 简介
1.1 场景简介
企业日常考勤管理中,需实时掌握员工当日出勤情况用于统计与管理,此为定时同步场景;当需补录历史数据、核对特定日期考勤异常或系统数据缺失时,可指定某一具体日期同步,此为按时间同步场景。
1.2 应用场景
适用于企业人力资源数字化转型与精细化管理的场景,提升了考勤数据记录的完整性与准确性,典型场景包括:
- 月度考勤数据补录与核对:可精准补录漏打卡记录或修正错误数据,确保薪资核算时考勤信息的完整性。
- 设备故障后数据补采 :确保考勤记录的连续性,避免因设备问题影响员工考勤统计。
1.3 预期效果
以根据时间同步考勤数据为例,效果如下所示:
2. 插件安装及配置
2.1 安装插件
1)直接安装
- 您可点击右方链接直接安装插件:智能考勤数据对接插件安装。
- 安装成功后,可参考本文【2.3 启用插件】,前往「开放平台 >> 插件管理」处启用插件。
2)插件市场安装
在简道云「插件市场」处,安装「智能考勤数据对接」插件。插件市场处安装方法可参见文档:插件市场中【2.3 插件安装】。
2.2 配置插件
安装后,在插件管理处,点击插件右侧的设置按钮,进行插件配置:
- deliAppkey:将 智能考勤数据对接插件 【2.2 记录授权信息】中获取到的「deliAppkey」填入「deliAppkey」;
- deliAppSecret:将 智能考勤数据对接插件 【2.2 记录授权信息】中获取到的「deliAppSecret」填入「deliAppSecret」;
- jiandaoApiKey:将「开放平台 >> 密钥管理 >> API Key」中获取的简道云「ApiKey」填入「jiandaoApiKey」。
全部配置完成后,点击「保存」。
2.3 启用插件
在插件管理中,打开「智能考勤数据对接插件」右侧开关,启用插件。
3. 表单搭建
- 插件使用可先安装:考勤管理插件应用模板。本文将按照示例表单进行讲解。
- 用户可根据企业需求自行选择同步方式,「每日自动同步」配置方式可参考【4. 智能助手配置】,「根据时间同步」配置方式可参考【5. 前端事件配置】。
插件配置需要使用 2 张表单,分别是:
- 每日自动同步考勤数据:用于每天定时同步打卡数据。
- 根据时间同步考勤数据:用于指定某一具体日期考勤数据同步。
4. 智能助手配置
4.1 新建智能助手
进入「每日自动同步考勤数据」表单,在「扩展功能 >> 智能助手」处,点击「新建智能助手」,并修改智能助手的名称为「定时导入考勤数据」,选择触发方式为「定时触发」。
4.2 配置触发动作
定时触发设置如下所示:
- 触发时间类型:选择「自定义时间」,如 2025-05-07 09:35。
- 重复触发:下拉框选择重复类型,如「每天重复一次」。
- 结束触发时间:选择结束触发的具体时间,如 2151-01-07 17:44。
4.3 添加并配置计算节点
点击节点连接线上的加号按钮,添加计算节点,进行如下设置:
- 节点名称:「考勤类型」;
- 计算方式:选择「公式计算」;
- 计算规则:设置公式为"定时同步";
- 计算结果类型:选择「文本类型」。
4.4 配置插件节点
点击节点连接线上的加号按钮,添加插件节点,进行如下设置:
- 插件读写表单:选择「每日自动同步考勤数据」;
- 执行插件:选择「智能考勤数据对接 >> 1_同步考勤数据」;
- 应用 id:设置为「自定义」,在「开放平台 >> 开发文档 >> 参数说明」处,将应用切换至「考勤管理插件模板 >> 1.1 每日自动同步考勤数据」中,将「应用 ID」复制过来;
- 考勤数据同步表.表单 id:设置为「自定义」,在「开放平台 >> 开发文档 >> 参数说明」处,将应用切换至「考勤管理插件模板 >> 1.1 每日自动同步考勤数据」中,将「表单 ID」复制过来;
- 同步类型:设置为「字段值」,选择「考勤类型—考勤类型」
- 考勤数据同步表.姓名字段 id:设置为「自定义」,在「开放平台 >> 开发文档 >> 参数说明」处,将应用切换至「考勤管理插件模板 >> 1.1 每日自动同步考勤数据」中,将「姓名」的字段 ID 复制过来;
- 考勤数据同步表.部门字段 id:设置为「自定义」,在「开放平台 >> 开发文档 >> 参数说明」处,将应用切换至「考勤管理插件模板 >> 1.1 每日自动同步考勤数据」中,将「部门」的字段 ID 复制过来;
- 考勤数据同步表.打卡位置字段 id:设置为「自定义」,在「开放平台 >> 开发文档 >> 参数说明」处,将应用切换至「考勤管理插件模板 >> 1.1 每日自动同步考勤数据」中,将「打卡位置」的字段 ID 复制过来;
- 考勤数据同步表.打卡时间字段 id:设置为「自定义」,在「开放平台 >> 开发文档 >> 参数说明」处,将应用切换至「考勤管理插件模板 >> 1.1 每日自动同步考勤数据」中,将「打卡时间」的字段 ID 复制过来;
- 考勤数据同步表.员工工号字段 id:设置为「自定义」,在「开放平台 >> 开发文档 >> 参数说明」处,将应用切换至「考勤管理插件模板 >> 1.1 每日自动同步考勤数据」中,将「工号」的字段 ID 复制过来;
- 考勤数据同步表.打卡方式字段 id:设置为「自定义」,在「开放平台 >> 开发文档 >> 参数说明」处,将应用切换至「考勤管理插件模板 >> 1.1 每日自动同步考勤数据」中,将「打卡方式」的字段 ID 复制过来;
- 考勤数据同步表.打卡设备字段 id:设置为「自定义」,在「开放平台 >> 开发文档 >> 参数说明」处,将应用切换至「考勤管理插件模板 >> 1.1 每日自动同步考勤数据」中,将「打卡设备」的字段 ID 复制过来。
5.前端事件配置
5.1 添加按钮执行动作
进入「根据时间同步考勤数据」表单中,点击「同步打卡数据」按钮字段,在「字段属性 >> 执行动作」处,点击「设置」:
5.2 设置事件名称和说明
在「前端事件 >> 名称信息」处,设置事件名称和事件说明,用于区分前端事件。设置完成后,点击「下一步」。
5.3 设置执行动作
在「触发与执行」处,设置执行动作如下:
- 执行动作:选择「智能考勤数据对接 >>1_同步考勤数据」;
- 应用 id:设置为「字段值」,下拉框选择「应用 ID」;
- 考勤数据同步表.表单 id:设置为「字段值」,下拉框选择「表单 ID」;
- 同步类型:设置为「字段值」,即「同步类型」字段;
- 按时间同步表_时间文本:设置为「字段值」,即「时间文本」字段;
- 考勤数据同步表.姓名字段 id:设置为「自定义」,在「开放平台 >> 开发文档 >> 参数说明」处,将应用切换至「考勤管理插件模板 >> 1.1 每日自动同步考勤数据」中,将「姓名」的字段 ID 复制过来;
- 考勤数据同步表.部门字段 id:设置为「自定义」,在「开放平台 >> 开发文档 >> 参数说明」处,将应用切换至「考勤管理插件模板 >> 1.1 每日自动同步考勤数据」中,将「部门」的字段 ID 复制过来;
- 考勤数据同步表.打卡位置字段 id:设置为「自定义」,在「开放平台 >> 开发文档 >> 参数说明」处,将应用切换至「考勤管理插件模板 >> 1.1 每日自动同步考勤数据」中,将「打卡位置」的字段 ID 复制过来;
- 考勤数据同步表.打卡时间字段 id:设置为「自定义」,在「开放平台 >> 开发文档 >> 参数说明」处,将应用切换至「考勤管理插件模板 >> 1.1 每日自动同步考勤数据」中,将「打卡时间」的字段 ID 复制过来;
- 考勤数据同步表.员工工号字段 id:设置为「自定义」,在「开放平台 >> 开发文档 >> 参数说明」处,将应用切换至「考勤管理插件模板 >> 1.1 每日自动同步考勤数据」中,将「工号」的字段 ID 复制过来;
- 考勤数据同步表.打卡方式字段 id:设置为「自定义」,在「开放平台 >> 开发文档 >> 参数说明」处,将应用切换至「考勤管理插件模板 >> 1.1 每日自动同步考勤数据」中,将「打卡方式」的字段 ID 复制过来;
- 考勤数据同步表.打卡设备字段 id:设置为「自定义」,在「开放平台 >> 开发文档 >> 参数说明」处,将应用切换至「考勤管理插件模板 >> 1.1 每日自动同步考勤数据」中,将「打卡设备」的字段 ID 复制过来。
- 字段存储关系:在设置字段存储关系处,点击「添加」按钮,将「返回参数」的值存储到「同步结果」;
- 全部设置完成后,点击「保存」。
5.4 效果演示
效果参见本文【1.3 预期效果】。
6. 注意事项
1)设置智能助手时非必填请求参数可不填。
2)得力 App 上生成的人员 ID 和部门 ID 均不可更改,简道云 ID 只能算是外部 ID 。
3)在得力 APP 上录入员工信息时,必须录入员工工号。
7. 联系方式
该插件为官方合作的服务商开发,若您在使用过程中有任何疑问,可通过以下方式咨询,我们将提供免费的技术指导和技术落地方案:
- 公司:摇火软件科技(无锡)有限公司
- 联系人:吕金窈
- 联系电话:13376219931