同步员工信息
1. 简介
1.1 插件简介
智能考勤数据对接插件是基于得力云开放平台 API 开发的员工数据管理工具,实现第三方HR系统与得力考勤系统间员工数据的双向同步与统一管理。该插件提供完整的员工信息全生命周期管理能力。
1.2 应用场景
适用于企业人事信息与考勤系统自动同步的场景,确保员工全生命周期数据实时更新,提升管理效率与数据一致性。典型场景包括:
- 员工信息变更:岗位变更实时更新考勤权限
- 多系统数据整合:外部ID打通考勤与业务
- 系统批量初始化:批量导入员工信息高效便捷
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. 表单搭建
插件使用可先安装: 考勤管理插件应用模板 。本文将按照示例表单进行讲解。
新建「考勤管理」应用,所需表单信息及字段设置如下:
表单名称 | 字段名称 | 字段类型 |
人员信息表 | 成员单选 | 成员单选 |
成员姓名 | 单行文本 | |
成员id | ||
所在部门 | 部门单选 | |
部门id | 单行文本 | |
电话 | ||
职位 | ||
工号 | ||
操作 | 下拉框 | |
查询得力App人员信息 | 按钮 | |
得力App人员信息 | 子表单 | |
得力App部门id | 子表单-单行文本 | |
工号 | ||
成员简道云id | ||
成员得力Appid | ||
姓名 | ||
设置人员id | 按钮 | |
人员得力App对应id | 单行文本 | |
要添加的简道云id |
4. 智能助手配置
4.1 修改或增添人员信息
4.1.1 启用表单触发智能助手
进入「人员信息表」表单,在「扩展功能 >> 智能助手」处,点击「新建智能助手」,并修改智能助手的名称为「修改或增添人员信息」,选择触发方式为「表单触发」。
4.1.2 配置触发动作
定时触发参考设置:
- 触发动作:选择「新增数据时」和「修改数据时 >> 任意字段」修改时。
- 触发条件:设置「添加条件 >> 操作」等于「修改或增添信息」。
4.1.3 配置插件节点
添加插件节点,进行如下设置:
- 节点名称:填写节点名称;
- 执行插件:选择「智能考勤数据对接 >>6.添加或修改员工信息」;
- 字段存储关系:在设置字段存储关系处,设置为「字段值」,并分别回填至如下所示的表单字段中。
4.2 删除人员信息
4.2.1 启用表单触发智能助手
进入「人员信息表」表单,在「扩展功能 >> 智能助手」处,点击「新建智能助手」,并修改智能助手的名称为「删除人员信息」,选择触发方式为「表单触发」。
4.2.2 配置触发动作
表单触发参考设置:
- 触发动作:选择「新增数据时」和「修改数据时 >> 任意字段」修改时。
- 触发条件:设置「添加条件 >> 操作」等于「删除信息」。
4.2.3 设置插件节点
添加插件节点,进行如下设置:
- 节点名称:填写节点名称;
- 执行插件:选择「智能考勤数据对接 >>9.删除员工」;
- 字段存储关系:在设置字段存储关系处,设置为「字段值」,并分别回填至如下所示的表单字段中。
5.前端事件配置
5.1 查询得力App人员信息
5.1.1 添加按钮执行动作
打开「人员信息表」表单,点击「查询得力app人员信息」按钮字段,在「字段属性 >> 执行动作」处,点击「设置」:
5.1.2 设置事件名称和说明
在「前端事件 >> 名称信息」处,设置事件名称和事件说明,用于区分前端事件。设置完成后,点击「下一步」。
5.1.3 设置执行动作
在「触发与执行」处,设置执行动作如下:
- 执行动作:选择「智能考勤数据对接 >> 7.批量获取员工信息」;
- 字段存储关系:在设置字段存储关系处,点击「添加」按钮,添加「全选」,并分别回填至如下所示的表单字段中。
5.2 设置人员外部ID
5.2.1 添加按钮执行动作
打开「人员信息表」表单,点击「设置人员信息id」按钮字段,在「字段属性 >> 执行动作」处,点击「设置」:
5.2.2 设置事件名称和说明
在「前端事件 >> 名称信息」处,设置事件名称和事件说明,用于区分前端事件。设置完成后,点击「下一步」。
5.2.3 设置执行动作
在「触发与执行」处,设置执行动作如下:
- 执行动作:选择「智能考勤数据对接 >> 8.为员工设置外部id」;
- 字段存储关系:以「字段值」方式选择:「人员得力app对应id」「要添加的简道云id」。
6. 注意事项
1)设置智能助手时非必填请求参数可不填。
2)得力 App 上生成的人员 ID 和部门 ID 均不可更改,简道云 ID 只能算是外部 ID 。
7. 联系方式
该插件为官方合作的服务商开发,若您在使用过程中有任何疑问,可通过以下方式咨询:
- 公司:摇火软件科技(无锡)有限公司
- 联系人:吕金窈
- 联系电话:13376219931