得力基础数据维护
1. 简介
1.1 场景简介
得力基础数据维护场景,支持人员信息动态更新、配置员工外部系统 ID 、删除人员信息,支持企业部门档案新增/修改、修改部门外部 ID,删除企业部门,同时实现根据自定义值修改得力云平台内组织根 ID 的效果,全面提升人员管理的准确性,确保组织架构数据的实时性和一致性。
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. 表单搭建
插件使用可先安装:考勤管理插件应用模板。本文将按照示例表单进行讲解。
插件配置需用到「得力基础数据维护」表单,表单信息如下所示:
- 维护人员信息:对人员信息进行增删改查,以及设置员工外部 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