同步部门信息
1. 简介
1.1 插件简介
智能考勤数据对接插件是一款基于得力云开放平台 API 开发的部门管理工具,实现第三方系统与得力考勤系统间的部门数据双向同步。该插件提供完整的部门信息管理能力,包括查询、创建、更新和删除等操作。
1.2 应用场景
适用于组织架构与考勤系统自动同步的场景,保障组织信息一致性,提升管理效率。典型场景包括:
- 组织架构初始化:首次接入自动同步 HR/OA 组织数据
- 日常组织变更同步:部门新增合并撤销实时同步
- 多系统集成:通过外部 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部门id | 子表单-单行文本 | |
部门名称 | 子表单-单行文本 | |
父级部门id | 子表单-单行文本 | |
初始化得力组织内根id | 按钮 | |
部门得力App对应id | 单行文本 | |
要添加或修改的简道云id | 单行文本 |
4. 智能助手配置
4.1 添加或修改部门
4.1.1 启用表单触发智能助手
进入「部门信息表」表单,在「扩展功能 >> 智能助手」处,点击「新建智能助手」,并修改智能助手的名称为「添加或修改部门」,选择触发方式为「表单触发」。
4.1.2 配置触发动作
定时触发参考设置:
- 触发动作:选择「新增数据时」和「修改数据时 >> 任意字段」修改时。
- 触发条件:设置「添加条件 >> 状态」等于「启用」。
4.1.3 配置插件节点
添加插件节点,进行如下设置:
- 节点名称:填写节点名称;
- 执行插件:选择「智能考勤数据对接 >>4.添加或修改部门信息」;
- 字段存储关系:在设置字段存储关系处,设置为「字段值」,并分别回填至如下所示的表单字段中。
4.2 删除部门
4.2.1 启用表单触发智能助手
进入「部门信息表」表单,在「扩展功能 >> 智能助手」处,点击「新建智能助手」,并修改智能助手的名称为「删除部门」,设置触发方式为「表单触发」。
4.2.2 配置触发动作
表单触发参考设置:
- 触发动作:选择「修改数据时 >> 任意字段」修改时。
- 触发条件:设置「添加条件 >> 状态」等于「停用」。
4.2.3 配置插件节点
添加插件节点,进行如下设置:
- 节点名称:填写节点名称;
- 执行插件:选择「智能考勤数据对接 >>5.删除部门」;
- 字段存储关系:在设置字段存储关系处,设置为「字段值」,并分别回填至如下所示的表单字段中。
5. 前端事件配置
5.1 查询得力App部门信息
5.1.1 添加按钮执行动作
进入「部门信息表」表单中,点击「查询得力部门信息」按钮字段,在「字段属性 >> 执行动作」处,点击「添加执行动作」:
5.1.2 设置事件名称和说明
在「前端事件 >> 名称信息」处,设置事件名称和事件说明,用于区分前端事件。设置完成后,点击「下一步」。
5.1.3 设置执行动作
在「触发与执行」处,设置执行动作如下:
- 执行动作:选择「智能考勤数据对接 >> 2.查询部门」;
- 字段存储关系:点击「添加」按钮,并选择全部字段后进行如下设置:
- 将得力部门.简道云部门id 存储到「得力部门信息.简道云部门id」中。
- 将得力部门.得力app部门id名称存储到「得力部门信息.得力app部门id」中。
- 将得力部门.部门名称存储到「得力部门信息.部门名称」中。
- 将得力部门.父级部门id到「得力部门信息.父级部门id」中。
全部设置完成后,点击「保存」。
5.2 设置部门外部ID
5.2.1 添加按钮执行动作
进入「部门信息表」表单中,点击「修改部门id」按钮字段,在「字段属性 >> 执行动作」处,点击「添加执行动作」:
5.2.2 设置事件名称和说明
在「前端事件 >> 名称信息」处,设置事件名称和事件说明,用于区分前端事件。设置完成后,点击「下一步」。
5.2.3 设置执行动作
在「触发与执行」处,设置执行动作如下:
- 执行动作:选择「智能考勤数据对接 >> 3.设置部门外部ID」;
- departmentId:设置为「字段值」,即「部门得力对应id」字段;
- extId:设置为「字段值」,即「要添加或修改的简道云id」字段;
5.3 初始化根部门ID
5.3.1 添加按钮执行动作
进入「部门信息表」表单中,点击「初始化得力组织内根id」按钮字段,在「字段属性 >> 执行动作」处,点击「添加执行动作」:
5.3.2 设置事件名称和说明
在「前端事件 >> 名称信息」处,设置事件名称和事件说明,用于区分前端事件。设置完成后,点击「下一步」。
5.3.3 设置执行动作
在「触发与执行」处,设置执行动作如下:
- 执行动作:选择「智能考勤数据对接 >> 1.初始化组织内根部门外部id」;
- 得力组织内根id:设置为「字段值」,即「初始化根id」字段;
6. 注意事项
1)设置智能助手时非必填请求参数可不填。
2)得力 App 上生成的人员 ID 和部门 ID 均不可更改,简道云 ID 只能算是外部 ID 。
7. 联系方式
该插件为官方合作的服务商开发,若您在使用过程中有任何疑问,可通过以下方式咨询:
- 公司:摇火软件科技(无锡)有限公司
- 联系人:吕金窈
- 联系电话:13376219931