同步部门信息

1. 简介

1.1 插件简介

智能考勤数据对接插件是一款基于得力云开放平台 API 开发的部门管理工具,实现第三方系统与得力考勤系统间的部门数据双向同步。该插件提供完整的部门信息管理能力,包括查询、创建、更新和删除等操作。

1.2 应用场景

适用于组织架构与考勤系统自动同步的场景,保障组织信息一致性,提升管理效率。典型场景包括:

  • 组织架构初始化:首次接入自动同步 HR/OA 组织数据
  • 日常组织变更同步:部门新增合并撤销实时同步
  • 多系统集成:通过外部 ID 建立部门映射关系

1.3 预期效果

以查询得力部门信息为例,效果如下所示:

2. 插件安装及配置

2.1 安装插件

1)直接安装

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

文档内容是否对您有帮助?
有帮助
没帮助没帮助
如需获取即时帮助,请联系技术支持
咨询
扫码领取100+零代码资料简道云官方微信号400-111-0890
图标在线咨询
立即体验