通讯录集成-睿人事
概述
集成价值
| 价值 | 说明 |
|---|---|
| 数据一致性 | 确保睿人事中组织架构和人员数据与平台保持一致 |
| 自动化同步 | 减少手动维护 HR 数据的工作量 |
| HR 系统打通 | 将睿人事作为身份主数据源，实现多系统身份统一管理 |
前提条件
睿人事系统要求
| 要求 | 说明 |
|---|---|
| 睿人事系统访问权限 | 具备睿人事系统的管理员权限 |
| API 凭证 | 获取睿人事系统 API 调用所需的 App Key 和 App Secret |
| 接口权限 | 确保 API 账号具备读取组织、人员信息的权限 |
| 网络连通性 | 专属集成平台能够访问睿人事系统 API 地址 |
专属集成平台要求
| 要求 | 说明 |
|---|---|
| 管理员权限 | 拥有专属集成平台的管理员权限 |
| 通讯录集成权限 | 具备创建和管理通讯录集成连接器的权限 |
操作步骤
步骤 1：创建睿人事集成连接器
1.
2.
3.
4.
步骤 2：配置连接信息
| 参数名称 | 说明 | 填写指南 |
|---|---|---|
| 名称 | 连接器显示名称 | 自定义名称，如“睿人事-总部” |
| API 地址 | 睿人事系统 API 访问地址 | 从睿人事管理后台获取 |
| App Key | 睿人事 API 应用 Key | 从睿人事开放平台获取 |
| App Secret | 睿人事 API 应用 Secret | 从睿人事开放平台获取 |
提示：睿人事的 API 地址和凭证通常由睿人事实施团队提供，请联系睿人事技术支持获取。
步骤 3：配置同步策略
| 参数名称 | 说明 | 建议配置 |
|---|---|---|
| 上游根组织 ID | 睿人事中同步的起始组织 ID | 全部同步可留空 |
| 同步范围 | 同步的数据类型 | 用户和部门 |
| 数据在本地挂载节点 | 同步数据在平台的挂载位置 | HR 认证 |
| 挂载方式 | 组织架构挂载方式 | 视情况选择 |
| 同步方式 | 数据同步策略 | 初次配置“手动全量同步”，验证后改为“自动增量同步” |
| 同步周期 | 自动同步的频率 | 建议 12 小时 |
| 账号关联 | 用户映射关系 | 常用“睿人事员工工号与平台用户名” |
重要：首次配置建议选择「手动全量同步」，验证数据准确性后再改为「自动增量同步」。
步骤 4：配置属性映射
| 睿人事属性 | 平台属性 | 映射方式 | 说明 |
|---|---|---|---|
| employeeId | username | 创建且更新 | 员工工号 |
| name | display_name | 创建且更新 | 员工姓名 |
| mobile | phone_number | 创建且更新 | 手机号码 |
| 创建且更新 | 电子邮箱 | ||
| deptName | department | 创建且更新 | 部门名称 |
| positionName | title | 创建且更新 | 岗位名 称 |
| hireStatus | active | 创建且更新 | 在职状态 |
重要：睿人事字段为示例，实际字段名称可能因睿人事版本和定制配置而异，请与睿人事实施团队确认实际接口返回的字段名称。
步骤 5：执行同步并验证
1.
2.
3.
4.
验证与测试
| 验证项 | 操作方法 |
|---|---|
| 连接测试 | 输入睿人事中已存在的员工工号或姓名，验证连通性 |
| 用户数据验证 | 在「用户管理」页面筛选睿人事连接器，抽查员工信息完整性 |
| 组织架构验证 | 在「组织管理」页面检查部门层级和名称是否正确 |
| 增量同步验证 | 在睿人事中变更人员后触发同步，验证变更是否同步 |
常见问题
| 问题 | 可能原因 | 解决方案 |
|---|---|---|
| 连接测试失败 | API 地址不正确、凭证无效 | 联系睿人事技术支持确认 API 地址和凭证 |
| 人员数据同步不完整 | 接口权限不足或字段缺失 | 确认 API 账号权限范围，检查接口返回字段 |
| 组织架构异常 | 睿人事组织层级结构不标准 | 联系睿人事 实施团队确认组织架构配置 |
修改于 2026-05-06 09:47:57