通讯录集成-北森

概述

本指南详细说明如何在专属集成平台中配置北森 HR 通讯录集成连接器，实现北森 HR 系统中的组织架构和用户数据与平台的自动同步。

集成价值

价值	说明
数据一致性	确保北森 HR 中组织架构和人员数据与平台保持一致
自动化同步	减少手动维护 HR 数据的工作量
HR 系统打通	将北森 HR 作为身份主数据源，实现多系统身份统一管理

前提条件

北森 HR 系统要求

要求	说明
北森 HR 系统访问权限	具备北森 HR 系统的管理员权限
API 凭证	获取北森 HR 系统 API 调用所需的 App Key 和 App Secret
接口权限	确保 API 账号具备读取组织、人员信息的权限
网络连通性	专属集成平台能够访问北森 HR 系统 API 地址

专属集成平台要求

要求	说明
管理员权限	拥有专属集成平台的管理员权限
通讯录集成权限	具备创建和管理通讯录集成连接器的权限

操作步骤

步骤 1：创建北森集成连接器

使用管理员账号登录专属集成平台

在左侧导航栏选择「用户中心 → 通讯录集成」

点击页面右上角的「新建连接器」按钮

在连接器类型选择界面，找到并选择「北森」选项

步骤 2：配置连接信息

参数名称	说明	填写指南
名称	连接器显示名称	自定义名称，如“北森HR-总部”
API 地址	北森 HR 系统 API 访问地址	从北森 HR 管理后台获取
App Key	北森 HR API 应用 Key	从北森开放平台获取
App Secret	北森 HR API 应用 Secret	从北森开放平台获取

提示：北森 HR 的 API 地址和凭证通常由北森实施团队提供，请联系北森技术支持获取。

步骤 3：配置同步策略

参数名称	说明	建议配置
上游根组织 ID	北森 HR 中同步的起始组织 ID	全部同步可留空
同步范围	同步的数据类型	用户和部门
数据在本地挂载节点	同步数据在平台的挂载位置	HR 认证
挂载方式	组织架构挂载方式	视情况选择
同步方式	数据同步策略	初次配置“手动全量同步”，验证后改为“自动增量同步”
同步周期	自动同步的频率	建议 12 小时
账号关联	用户映射关系	常用“北森员工工号与平台用户名”

重要：首次配置建议选择「手动全量同步」，验证数据准确性后再改为「自动增量同步」。HR 系统数据变更频率较低，同步周期可适当放宽。

步骤 4：配置属性映射

北森 HR 属性与平台属性的核心映射关系：

北森属性	平台属性	映射方式	说明
staffId	username	创建且更新	员工工号
staffName	display_name	创建且更新	员工姓名
mobilePhone	phone_number	创建且更新	手机号码
email	email	创建且更新	电子邮箱
departmentName	department	创建且更新	部门名称
positionName	title	创建且更新	岗位名称
employmentStatus	active	创建且更新	在职状态

重要：北森 HR 字段为示例，实际字段名称可能因北森版本和定制配置而异，请与北森实施团队确认实际接口返回的字段名称。

步骤 5：执行同步并验证

点击「连接测试」输入已知员工信息验证 API 连通性

连接测试通过后，点击「保存」创建连接器

在连接器列表页点击「立即同步」触发手动全量同步

同步完成后，验证人员数据和组织架构是否正确

验证与测试

验证项	操作方法
连接测试	输入北森 HR 中已存在的员工工号或姓名，验证连通性
用户数据验证	在「用户管理」页面筛选北森连接器，抽查员工信息完整性
组织架构验证	在「组织管理」页面检查部门层级和名称是否正确
增量同步验证	在北森 HR 中变更人员后触发同步，验证变更是否同步

常见问题

问题	可能原因	解决方案
连接测试失败	API 地址不正确、凭证无效	联系北森技术支持确认 API 地址和凭证
人员数据同步不完整	接口权限不足或字段缺失	确认 API 账号权限范围，检查接口返回字段
组织架构异常	北森组织层级结构不标准	联系北森实施团队确认组织架构配置

概述#

集成价值#

前提条件#

北森 HR 系统要求#

专属集成平台要求#

操作步骤#

步骤 1：创建北森集成连接器#

步骤 2：配置连接信息#

步骤 3：配置同步策略#

步骤 4：配置属性映射#

步骤 5：执行同步并验证#

验证与测试#

常见问题#

概述