HR 同步

发布于 2026-07-09

HR 同步

使用动作流进行正向同步

包含的知识

  • HR 同步中如何使用动作流进行正向同步(调用第三方系统接口获取人员同步到本系统)
  • 动作流的配置
  • 同步人员时,如何根据编号同步人员的岗位和部门字段(根据编号进行匹配)
  • 同步时如何使用分页获取数据进行同步

场景

调用第三方接口获取人员数据,同步到 E10 系统

动作流配置

触发选择 HR 同步,人员数据获取通过 Action 获取,在后端调用第三方接口获取数据,Action 输出如下:

在终止中需要将人员数据配置到参数设置中,才能将人员数据同步到本系统的组织架构中

终止组件参数设置

data 取获取人力资源数据中的数组,在此案例中取 Action 输出的 data 数组,下面的子参数取数组中对应的值

岗位与部门同步

只在人员同步的动作流中赋值部门和岗位字段为编号是不行的,会提示部门或岗位不存在,需要在 HR 同步中添加部门和岗位的同步配置,并在字段对应关系中选择编号字段为主键。

另外还得添加岗位和部门同步的动作流,这并不表示你必需要同步岗位和部门,你可以选择只执行同步人员

使用分页进行同步

调用第三方接口不会一次性返回所有数据,需要使用分页进行调用,在 HR 同步中支持使用分页调用动作流进行同步。

在接口参数中需指定分页大小:

在动作流中调用接口获取数据时,可通过系统参数获取当前的页码以及分页大小

在终止组件的参数设置中,pageSize、pageNum、count 这 3 个参数必需进行赋值,否则无法进行分页循环(只会获取1页的数据)。 count 为数据总数,可通过人力资源数据接口返回的总数字段获取,如果接口没有返回总数,则可以设定一个固定值,固定值需大于数据总数,比如需要同步的人员总共有 1000,则固定值可以设定为 2000(为后续人员增长提供冗余),在进行同步时动作流不会根据总数一直调用,在获取不到数据时就会结束分页循环,所以 count 大于实际数量多少没有关系。