得力基础数据维护

1. 简介

1.1 场景简介

得力基础数据维护场景,支持人员信息动态更新、配置员工外部系统 ID 、删除人员信息,支持企业部门档案新增/修改、修改部门外部 ID,删除企业部门,同时实现根据自定义值修改得力云平台内组织根 ID 的效果,全面提升人员管理的准确性,确保组织架构数据的实时性和一致性。

1.2 应用场景

适用于企业组织架构与资源的数字化管理场景,助力企业实现人员、部门、设备信息的高效管控与组织基础数据的规范化搭建。

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;
  • 查询设备信息:查询设备信息;
  • 初始化得力组织内根 ID:自定义设置得力平台中的组织内根 ID,并进行数据初始化。

4. 前端事件配置

4.1 初始化数据

首次使用该插件时,需要先初始化得力平台中的组织内根 ID。初始化完成后,后续使用时无需重复该步骤。

4.1.1 添加按钮执行动作

在「得力基础数据维护 >> 初始化得力组织内根 id」标签页中,点击「是否初始化」按钮,在「字段属性 >> 执行动作」处,点击「设置」,添加执行动作:

4.1.2 设置事件名称和说明

在「前端事件 >> 名称信息」处,设置事件名称和事件说明,用于区分前端事件。

4.1.3 设置执行动作

在「触发与执行」处,设置执行动作如下:

  • 插件:选择「智能考勤数据对接 >> 5_配置基础信息」;
  • 同步类型设置为「自定义」,选择「初始化根部门 ID」;
  • 部门在外部接入系统中的 id设置为「字段值」,选择「初始化得力组织内根部门外部ID」;
  • 字段存储关系:在设置字段存储关系处,点击添加」按钮,添加「返回参数」的值存储到「初始化得力组织内根 ID 结果」中;

全部设置完成后,点击「保存」。

4.2 基础信息维护

基础信息维护主要对人员/部门信息进行增删改,人员与部门的信息维护配置步骤相似,本文以人员信息的新增/修改为例进行讲解。

4.2.1 添加按钮执行动作

在「得力基础数据维护 >> 人员信息」标签页中,点击「是否新增/修改人员信息」按钮,在「字段属性 >> 执行动作」处,点击「设置」,添加执行动作:

4.2.2 设置事件名称和说明

在「前端事件 >> 名称信息」处,设置事件名称和事件说明,用于区分前端事件。设置完成后,点击「下一步」。

4.2.3 设置执行动作

在「触发与执行」处,设置执行动作如下:

  • 插件:选择「智能考勤数据对接 >> 5_配置基础信息」;
  • 同步类型设置为「自定义」,选择「同步人员」;
  • 人员-文本设置为「字段值」,选择「待新增/修改-人员-文本」;
  • 人员对应的外部系统id设置为「字段值」,选择「待新增/修改人员外部系统ID」;
  • 人员对应部门的外部系统id设置为「字段值」,选择「待新增/修改-人员所在部门ID」;
  • 人员-电话设置为「字段值」,选择「待新增/修改人员电话」;
  • 人员-职位设置为「字段值」,选择「待新增/修改人员职位」;
  • 人员-工号设置为「字段值」,选择「待新增/修改人员工号」;
  • 人员-照片设置为「字段值」,选择「待新增/修改人员照片」;
  • 字段存储关系:在设置字段存储关系处,点击添加」按钮,添加「返回参数」的值存储到「新增/修改人员结果」;

全部设置完成后,点击「保存」。

注:

1)仅需配置人员相关字段,部门相关字段留空。

2)若需删除人员信息,则在执行动作处进行如下设置,其余执行动作配置项留空即可。

  • 插件:选择「智能考勤数据对接 >> 5_配置基础信息」
  • 同步类型:设置为「自定义」,下拉框选择「删除人员」;
  • 人员对应的外部系统id:设置为「字段值」,即「待删除人员 ID」;
  • 字段存储关系:将返回参数的值存储到「删除人员结果」字段中。

4.3 设置外部 ID

「设置外部 ID」函数支持设置员工外部 ID 以及修改部门外部 ID,本文以设置员工外部 ID 为例进行讲解。

4.3.1 添加按钮执行动作

在「得力基础数据维护 >> 人员信息」标签页中,点击「是否设置员工外部 ID」按钮,在「字段属性 >> 执行动作」处,点击「设置」,添加执行动作:

4.3.2 设置事件名称和说明

在「前端事件 >> 名称信息」处,设置事件名称和事件说明,用于区分前端事件。设置完成后,点击「下一步」。

4.3.3 设置执行动作

在「触发与执行」处,设置执行动作如下:

  • 插件:选择「智能考勤数据对接 >> 6_设置外部ID」;
  • operationType设置为「自定义」,选择「employee」;
  • 员工得力ID设置为「字段值」,选择「待设置人员得力系统ID」;
  • 外部 ID设置为「字段值」,选择「待设置人员外部系统ID」;
  • 字段存储关系:在设置字段存储关系处,点击添加」按钮,添加「返回参数」的值存储到「设置人员结果」;

全部设置完成后,点击「保存」。

4.4 效果演示

效果参见本文【1.3 预期效果】。

5. 注意事项

5.1 部门基本信息维护

5.1.1 新增/修改部门数据

若需新增/修改部门数据,则在执行动作处进行如下设置:

  • 插件:选择「智能考勤数据对接 >>5_配置基础信息」;
  • 同步类型设置为「自定义」,选择「同步部门」;
  • 部门-文本设置为「字段值」,选择「待新增/修改-部门-文本」;
  • 部门在外部接入系统中的id设置为「字段值」,选择「待新增/修改-部门外部系统ID」;
  • 父级部门设置为「字段值」,选择「待新增/修改-父级部门外部系统ID」;
  • 字段存储关系:在设置字段存储关系处,点击添加」按钮,添加「返回参数」的值存储到「新增/修改人员结果」;

注:

1)仅需配置部门相关字段,人员相关字段留空。

2)若需删除部门数据,则在执行动作处进行如下设置,其余执行动作配置项留空即可

  • 插件:选择「智能考勤数据对接 >> 5_配置基础信息」;
  • 同步类型设置为「自定义」,选择「删除部门」;
  • 部门在外部接入系统中的id设置为「字段值」,选择「待删除-部门外部ID」;
  • 字段存储关系:在设置字段存储关系处,点击添加」按钮,添加「返回参数」的值存储到「删除部门结果」;

5.1.2 修改部门外部ID

若需修改部门外部 ID,则在插件执行动作处进行如下设置:

  • 执行动作:选择「智能考勤数据对接 >> 6_设置外部ID」;
  • operationType设置为「自定义」,选择「department」;
  • 部门得力 ID设置为「字段值」,选择「待设置-部门得力ID」;
  • 外部 ID设置为「字段值」,选择「待设置-部门外部ID」;
  • 字段存储关系:在设置字段存储关系处,点击添加」按钮,添加「返回参数」的值存储到「修改部门外部ID 结果」;

5.2 查询人员/部门/设备信息

该插件不能直接查询人员/部门/设备信息,但可以在表单中添加查询按钮和查询字段,以查询最新的同步结果。以查询人员信息为例,表单内相关设置如下:

  • 添加查询按钮,设置插件执行动作为「智能考勤数据对接 >> 2_同步人员数据」,详细设置可参考 得力 APP 信息同步;
  • 添加查询字段,查询表设置为「2.2 打卡人员信息同步表」。

设置完成后,每次点击查询按钮,即可在人员信息同步表中同步最新数据,接着通过查询字段即可将信息同步表中的最新数据展示出来。

注:部门和设备信息的设置方法相似。

6. 联系方式

该插件为官方合作的服务商开发,若您在使用过程中有任何疑问,可通过以下方式咨询,我们将提供免费的技术指导和技术落地方案:

  • 公司:摇火软件科技(无锡)有限公司
  • 联系人:吕金窈
  • 联系电话:13376219931

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