# 北森人员同步套件

来源快照：`result_data_new_260518.json`

- 来源 ID：`1203362524011708465`
- 模块：低代码平台e-builder
- 目录：集成 - 连接器 - 三方连接器 - 人力资源
- space ID：`1157961794811633670`
- 原文链接：未提供
- 产品基线：未提供

## 正文

一、

# 功能介绍

注意：需购买集成中心HR同步非标

北森的组织架构、岗位、人员信息同步到OA系统中，实现OA系统和北森系统组织人事系统间数据一致。

配置新建提供两个入口（功能相同），建议选择入口1：

入口1：

【集成中心】-【HR同步】

![](https://weapp.eteams.cn/papi/file/preview?fileId=1203362614254288897&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

 

入口2：【只是一个快捷新建入口，功能都在集成中心HR同步中】

此入口需购买ESB中心非标

【ESB中心】-【连接器】-【人力资源】-【内置】-【北森】-【套件】-【HR同步】

![](https://weapp.eteams.cn/papi/file/preview?fileId=1203362609911357442&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

二、

# 功能使用说明

## 场景案例

北森的组织架构、岗位、人员信息同步到OA系统

## 操作步骤

### 1.北森系统配置

进入管理者后台：

https://open.italent.cn/#/open-document?menu=develop-guide&id=0

![](https://weapp.eteams.cn/papi/file/preview?fileId=1203362618607976448&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

1、创建连接器

![](https://weapp.eteams.cn/papi/file/preview?fileId=1203362610034819078&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

点击上一步新建的连接器，查看详情

![](https://weapp.eteams.cn/papi/file/preview?fileId=1203362614336348164&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

![](https://weapp.eteams.cn/papi/file/preview?fileId=1203362614374096898&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

组织员工 员工与任职（New）  根据时间窗滚动查询变动的员工与单条任职信息  根据时间窗滚动查询变动的员工与多条任职信息  根据员工UserID集合获取未删除的员工相关信息  根据员工UserID集合获取指定条件的任职记录相关信息组织单元（New）  根据时间窗滚动查询变动的组织单元信息  根据组织Code获取组织信息职位（New）  根据时间窗滚动查询变动的职位信息  根据职位OId集合获取的职位相关信息职务（New）  根据时间窗滚动查询变动的职务信息  根据职位OId集合获取的职务相关信息  职等（New）  根据时间窗滚动查询变动的职等信息  职级（New）  根据时间窗滚动查询变动的职级信息  
---  
  
添加OA同步北森数据需要调用到的北森的接口【点击黄色圈中的添加接口】 ![](https://weapp.eteams.cn/papi/file/preview?fileId=1203362614254288902&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

 

记录下appkey和appsecret以便于在OA配置中使用

2、配置受信IP白名单，将OA的出口外网ip在受信ip白名单中添加

![](https://weapp.eteams.cn/papi/file/preview?fileId=1203362614336348163&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

 

### 2.集成中心-HR同步

【集成中心】-【HR同步】新建

![](https://weapp.eteams.cn/papi/file/preview?fileId=1203362614336348169&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

也可以到ESB连接器中，此处只是提供一个快捷新建入口，功能需要在【集成中心】-【HR同步】查看

 

![](https://weapp.eteams.cn/papi/file/preview?fileId=1203362609911357442&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

点击北森新建，

![](https://weapp.eteams.cn/papi/file/preview?fileId=1203362614374096899&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

 

配置项| 说明  
---|---  
启用| 默认开启，控制整个功能是否可用的开关  
名称| 任意  
类型| 北森  
所属机构| 开启分权时显示，根据实际  
北森接口地址| 默认https://openapi.italent.cn即可  
北森系统接口调用appkey(appKey)| 第1步骤，获取的北森接口参数  
北森系统接口调用appSecreet(appSecret)| 第1步骤，获取的北森接口参数  
  
点击完成，生成默认配置，可点击”HR同步设置“查看详情

![](https://weapp.eteams.cn/papi/file/preview?fileId=1203362609911357441&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

### 3.【HR同步】点击手动同步或自动同步

打开集成中心-HR同步配置，可在手动同步页面点击同步，拉取北森组织和人员同步至OA，

![](https://weapp.eteams.cn/papi/file/preview?fileId=1203362618677452802&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

集成中心-HR同步基础设置中打开设置定时时间，按照设置的时间将北森数据同步更新至OA

![](https://weapp.eteams.cn/papi/file/preview?fileId=1203362610034819080&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

三、

# 常见问题

调用接口同步北森人员接口返回如下java.lang.Exception: >>>>>>>>>根据时间窗滚动查询变动的员工与单条任职信息; href：https://openapi.italent.cn/TenantBaseExternal/api/v5/Employee/GetByTimeWindow; param:{"serviceType":[0],"enableTranslate":true,"isWithDeleted":false,"scrollId":"","capacity":200,"employType":[0,2],"withDisabled":true,"timeWindowQueryType":2,"isGetLatestRecord":false,"startTime":"2024-12-01T00:00:00","stopTime":"2025-02-13T17:32:57","approvalStatuses":[4,2]} result:{"message":"un-authorized"}

解决方案：

步骤1中在北森需要添加的接口未正确添加
