得力APP信息同步
1. 简介
1.1 场景简介
得力 APP 数据同步场景是指每日定时将新入职员工信息、新增的部门信息及新增的设备信息同步至简道云系统,实现数据自动更新。
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. 表单搭建
插件使用可先安装:考勤管理插件应用模板。本文将按照示例表单进行讲解。
3.1 创建表单
插件配置需要使用 3 张表单,分别是:
- 打卡人员信息同步:用于定时同步得力APP人员信息。
- 打卡部门信息同步:用于定时同步得力APP部门信息。
- 打卡设备信息同步:用于定时同步得力APP设备信息。
3.2 设置字段别名
1)进入「 打卡人员信息同步」表单中,在「扩展功能 >> 数据推送」处,点击「设置字段别名」,如下所示:
- 员工 ID:deli_unique_id
- 外部系统 ID:「dy_member_id
- 姓名:name
- 部门ID:dept_id
- 手机号:mobile
- 工号:job_number
2)进入「打卡部门信息同步」表单中,在「扩展功能 >> 数据推送」处,点击「设置字段别名」,如下所示:
- 部门 ID:deli_dept_id
- 外部系统部门 ID:jdy_dept_id
- 部门名称:dept_name
- 父级部门 ID:parent_dept_id
3)进入「打卡设备信息同步」表单中,在「扩展功能 >> 数据推送」处,点击「设置字段别名」,如下所示:
- 设置「SN码」的字段别名为「sn_code」
- 设置「设备名」的字段别名为「device_name」
- 设置「在线状态」的字段别名为「online_status」
4. 智能助手配置
4.1 打卡人员信息同步
4.1.1 新建智能助手
进入「打卡人员信息同步」表单,在「扩展功能 >> 智能助手」处,点击「新建智能助手」,并修改智能助手的名称为「定时导入人员信息」,选择触发方式为「定时触发」。
4.1.2 配置触发动作
定时触发设置如下:
- 触发时间类型:选择「自定义时间」,如 2025-07-22 11:51;
- 重复触发:下拉框选择重复类型,如「每天触发一次」;
- 结束触发时间:选择结束触发的具体时间,如 2051-07-02 18:11。
4.1.3 配置插件节点
1)获取配置参数
在「开放平台 >> 开发文档 >> 参数说明」处,将应用切换至「考勤管理插件模板 >> 2.2 打卡人员信息同步」,查看并复制应用 ID、表单 ID 以及各字段的字段别名。
2)配置插件节点
点击节点连接线上的加号按钮,添加插件节点,进行如下设置:
- 插件读写表单:选择「2.2 打卡人员信息同步」;
- 执行插件:选择「智能考勤数据对接 >> 2_同步人员数据」;
- 应用 id-appld:设置为「自定义」,将【4.1.3-1)获取配置参数】中获取到的应用 ID 复制过来;
- 表单 id-entryld:设置为「自定义」,将【4.1.3-1)获取配置参数】中获取到的表单 ID 复制过来;
- 得力唯一 id:设置为「自定义」,将【4.1.3-1)获取配置参数】中获取到的「员工 ID」的字段别名复制过来;
- 得力部门 id:设置为「自定义」,将【4.1.3-1)获取配置参数】中获取到的「部门 ID」的字段别名复制过来;
- 工号 id:设置为「自定义」,将【4.1.3-1)获取配置参数】中获取到的「工号」的字段别名复制过来;
- 成员简道云 id:设置为「自定义」,将【4.1.3-1)获取配置参数】中获取到的「外部系统 ID」的字段别名复制过来;
- 姓名 id:设置为「自定义」,将【4.1.3-1)获取配置参数】中获取到的「姓名」的字段别名复制过来;
- 手机号 id:设置为「自定义」,将【4.1.3-1)获取配置参数】中获取到的「手机号」的字段别名复制过来。
4.2 打卡部门信息同步
4.2.1 新建发智能助手
进入「打卡部门信息同步」表单,在「扩展功能 >> 智能助手」处,点击「新建智能助手」,并修改智能助手的名称为「定时导入部门信息」,选择触发方式为「定时触发」。
4.2.2 配置触发动作
定时触发设置如下:
- 触发时间类型:选择「自定义时间」,如 2025-07-22 11:51;
- 重复触发:下拉框选择重复类型,如「每天触发一次」;
- 结束触发时间:选择结束触发的具体时间,如 2051-07-02 18:11。
4.2.3 配置插件节点
1)获取配置参数
在「开放平台 >> 开发文档 >> 参数说明」处,将应用切换至「考勤管理插件模板 >> 2.3 打卡部门信息同步」,查看并复制应用 ID、表单 ID 以及各字段的字段别名。
2)配置插件节点
点击节点连接线上的加号按钮,添加插件节点,进行如下设置:
- 插件读写表单:选择「2.3 打卡部门信息同步」;
- 执行插件:选择「智能考勤数据对接 >> 3_同步部门数据」;
- 应用 id-appld:设置为「自定义」,将【4.2.3-1)获取配置参数】中获取到的应用 ID 复制过来;
- 表单 id-entryld:设置为「自定义」,将【4.2.3-1)获取配置参数】中获取到的表单 ID 复制过来;
- 简道云部门字段 id:设置为「自定义」,将【4.2.3-1)获取配置参数】中获取到的「外部系统部门 ID」的字段别名复制过来;
- 得力 app 部门 id:设置为「自定义」,将【4.2.3-1)获取配置参数】中获取到的「部门 ID」的字段别名复制过来;
- 得力部门名称 id:设置为「自定义」,将【4.2.3-1)获取配置参数】中获取到的「部门名称」的字段别名复制过来;
- 父级部门名称 id:设置为「自定义」,将【4.2.3-1)获取配置参数】中获取到的「父级部门名称」的字段别名复制过来。
4.3 打卡设备信息同步
4.3.1 新建智能助手
进入「打卡设备信息同步」表单,在「扩展功能 >> 智能助手」处,点击「新建智能助手」,并修改智能助手的名称为「定时导入设备信息」,选择触发方式为「定时触发」。
4.3.2 配置触发动作
定时触发设置如下:
- 触发时间类型:选择「自定义时间」,如 2025-07-03 09:50;
- 重复触发:下拉框选择重复类型,如「每天触发一次」;
- 结束触发时间:选择结束触发的具体时间,如 2050-07-03 10:01。
4.3.3 配置插件节点
1)获取配置参数
在「开放平台 >> 开发文档 >> 参数说明」处,将应用切换至「考勤管理插件模板 >> 2.4 打卡设备信息同步」,查看并复制应用 ID、表单 ID 以及各字段的字段别名。
2)配置插件节点
点击节点连接线上的加号按钮,添加插件节点,进行如下设置:
- 插件读写表单:选择「2.4 打卡设备信息同步」;
- 执行插件:选择「智能考勤数据对接 >> 3_同步部门数据」;
- 应用 id-appld:设置为「自定义」,将【4.3.3-1)获取配置参数】中获取到的应用 ID 复制过来;
- 表单 id-entryld:设置为「自定义」,将【4.3.3-1)获取配置参数】中获取到的表单 ID 复制过来;
- 设备名 id:设置为「自定义」,将【4.3.3-1)获取配置参数】中获取到的「设备名」的字段别名复制过来;
- sn 码 id:设置为「自定义」,将【4.3.3-1)获取配置参数】中获取到的「SN 码」的字段别名复制过来;
- 在线状态 id:设置为「自定义」,将【4.3.3-1)获取配置参数】中获取到的「在线状态」的字段别名复制过来;
5. 注意事项
1)设置智能助手时非必填请求参数可不填。
2)得力 App 上生成的人员 ID 和部门 ID 均不可更改,简道云 ID 只能算是外部 ID 。
3)在得力 APP 上录入员工信息时,必须录入员工工号。
6. 联系方式
若您在使用过程中有任何疑问,可通过以下方式咨询,我们将提供免费的技术指导和技术落地方案:
- 公司:摇火软件科技(无锡)有限公司
- 联系人:吕金窈
- 联系电话:13376219931