1. 数据集成配置指导

1.1 公共配置

1.1.1 创建外部系统数据

页面路径： HR 交付工具云 -> HR数据集成服务 -> 集成基础配置 -> 外部系统

外部系统：描述外部系统的基础数据，配置HR集成关系需要用到，后续的集成数据也会用来区分 数据来源，只需要填写编码、名称，字段“苍穹API连接配置”只适用于集成的外部系统也是苍穹的基础上才需要配置。

例如： 某集团使用星瀚 HR，集团下有 A 、B 、C 三个子公司，子公司数据都要集成到集团，则需 要在集团这边创建这三个子公司（A 、B 、C）对应的外部系统基础数据。

1.1.2 导入服务流程

标准产品针对行政组织、岗位、人员主数据、人员附表（人员地址、服务年限）做了一套 服务流程 demo（下面的zip0附件中的dts文件可以直接导入到系统中），现场将标准产品的服务流程 demo导入到系统，再简单修改下配置即可使用这 些业务的数据向外集成。

页面路径： HR 交付工具云 -> HR数据集成服务 -> 集成服务配置 -> 服务流程

服务流程(isc_service_flow)_DA93.zip

1.1.3 配置数据连接

HR数据集成服务向外集成需要用到集成服务云的相关能力，首先需要配置连接配置。

一、   创建连接配置

页面路径： HR交付工具云 ->HR数据集成服务 -> 集成服务配置 -> 连接管理

创建目标系统的连接配置，根据目标系统的类型选择对应的连接类型，并配置好对应的连接信息。

注：如果发现外部系统的连接在上述预置的连接类型中找不到，那么就需要现场自定义开发一个支持该系统的连接类型。（可参考 连接配置（类型）动态加载 (kingdee.com)）

假设外部系统也是星瀚，连接类型选择苍穹API-2.0，则弹出配置界面，填写配置信息；

二、   配置数据源管理

页面路径： HR交付工具云 -> HR数据集成服务 -> 集成服务配置 -> 数据源管理

配置服务流程使用的数据源管理，其中（数据集成中心分组）数据源为当前系统数据源，将系 统连接改为当前账套；（sit环境api2.0连接）数据源为外部系统数据源，改为上面步骤配置的系统连接，编码和名称可改为现场环境对应编码名称。

1.2 集成中心配置

1.2.1 主数据集成配置

页面路径： HR 交付工具云 -> HR数据集成服务 -> 集成治理 -> HR 集成关系

主数据：HR领域核心基础数据，包含行政组织、岗位、人员主数据、人员附表

HR集成关系： 描述星瀚 HR 系统与外部系统之间的数据集成关系， 包括：集成方向、集成方式、 集成类型等。

1、 新增HR集成关系,维护相关的字段

1) HR集成资源：选择需要集成的业务对应的资源，如果同一个集成资源需要集成到多个外部系统，则需要创建多条HR集成关系。

2) 集成方向：根据数据流向选择集成方向(OUTBOUND表示星瀚HR往外部系统集成，INBOUND表示外部系统往星瀚HR集成)。

3) 目标系统：选择1.1.1 创建的外部系统，如果集成方向为INBOUND,则该字段显示为来源系统

4) 时效性：根据需求选择对应的时效性（定时、实时），如果选择时效性为实时，可实时监听主数据的变动，并将变动数据通过集成方案推送到第三方系统。

5) 集成方式：选择集成方式，主数据标品提供了服务流程demo，集成方式可选服务流程，集成方案选公共配置中导入的服务流程，其中人员附表标品提供了人员地址和服务年限服务流程demo，其他人员附表需要参照着两个流程配置。

2、 服务流程调整（星瀚HR集成到非星瀚HR需要）

标准产品的服务流程 demo 是星瀚 HR 到星瀚 HR 集成的样例，如果现场是星瀚 HR 到其他非星瀚系统的集成，则需要调整相应的服务流程。

• 外部系统 API 登记

页面路径：HR交付工具云 -> HR数据集成服务 -> 集成服务配置 -> 外部系统 API 登记

将外部系统的 API 登记进来，供服务流程相关节点调用。

• 调整服务流程

在导入的服务流程中，新增外部系统 API 作为依赖资源。

根据外部系统 API 的入参，调整对应的字段映射节点

调整 API 调用节点，改为调用外部系统 API

调整通用字段赋值节点，该节点处理一些通用字段的赋值 。

如果是星瀚 HR 集成到非星瀚系统，则根据外部系统 API 入参调整对应通用字段的赋值逻辑 。

1.2.2基础资料集成配置

1、 配置实时集成配置

页面路径：HR 交付工具云 -> HR数据集成服务 -> 集成治理 -> 实时集成配置（hrdi_realtimeintconf）

预览打开实时集成配置列表页面。

新增实时集成配置，选择需要集成的实体对象，配置对应的需要监听的操作（会影响数据变动的操作，比如保存、启用、禁用等）

普通基础资料监听：保存、删除、审核、反审核、禁用、启用、提交、撤销

带历史基础资料监听：保存、删除、审核、反审核、启用、提交、撤销、确认变更（confirmchange、confirmchangenoaudit）、禁用（his_disable）

2、 配置HR集成资源

页面路径：HR交付工具云 -> HR数据集成服务 -> 集成治理 -> HR集成资源

新增HR集成资源，选择需要集成的基础资料实体对象，并保存

支持批量引入，引入功能下载引入模板，维护引入模板数据。

3、 配置HR集成关系

页面路径：HR交付工具云 -> HR数据集成服务 -> 集成治理 -> HR集成关系

新增集成关系，集成关系选OUTBOUND（星瀚HR向外集成），维护对应集成资源，时效性选实时，如果外部系统为星瀚，则集成方式选基础资料API，如果外部系统不是星瀚，则集成方式选服务流程，集成方案选做好的服务流程。

支持批量引入，引入功能下载引入模板（可在列表上选其他基础资料集成的集成关系，引出，并基于引出模板修改），维护引入模板，维护集成资源编码，集成方向选OUTBOUND，维护对应的外部系统编码，时效性选实时，集成方式选服务流程，集成方案编码选已经开发好的服务流程 (如果是往星瀚集成，则集成方式选基础资料API，集成方案编码填hrdi_basedata/sync)

2.  扩展字段数据集成配置指导

2.1 扩展字段数据集成配置步骤

2.1.1 业务实体添加扩展字段

在对应实体上，根据需求加上扩展字段

2.1.2 重新保存集成字段配置

打开对应的集成字段配置，根据现场需要，打开或关闭对应扩展字段是否集成字段开关

2.1.3 重新发布API

2.1.4 重新同步集成对象

同步集成对象，将新加的扩展字段同步到集成对象中

2.1.5 服务流程中字段重新映射

修改服务流程节点中的取数节点，将集成对象的字段加入到取数配置中，可手动新增，也可自动填充（会清空之前字段重新填充）

修改字段映射节点，将新加的扩展字段映射到对应变量上

3. 人员附表数据集成配置指导

3.1 人员附表数据集成配置步骤

3.1.1 人员附表数据向外集成

1、 创建集成资源

页面路径：HR交付工具云 -> HR数据集成服务 -> 集成治理 -> HR集成资源

新增页面填入编码、名称、实体对象（对应人员附表的实体），集成中间表配置为向内集成需要，向外集成可不填。

2、 创建服务流程

页面路径：HR交付工具云 -> HR数据集成服务 -> 集成服务配置 -> 服务流程

复制一份标准产品服务流程demo（服务年限数据同步）

调整依赖资源的集成对象、外部系统API

根据现场需要，调整服务流程中的取数、映射、数据转换、调用API等节点

3、 创建HR集成关系

页面路径：HR交付工具云 -> HR数据集成服务 -> 集成治理 -> HR集成关系

创建HR集成关系，选OUTBOUND（星瀚人力云 -> 外部系统），维护对应集成资源，时效性选实时，如果外部系统为星瀚，则集成方式选基础资料API，如果外部系统不是星瀚，则集成方式选服务流程，集成方案选上一步创建的服务流程。

3.1.2 人员附表数据向内集成

1、 集成字段配置

页面路径：HR交付工具云 -> HR数据集成服务 -> 集成基础配置 -> 集成字段配置

新增集成字段配置，实体对象选择对应人员附表实体，如果该实体有做过初始化，初始化实体对象字段选择对应的初始化实体对象，这里配置是为了获取初始化的数据映射关系。字段选择中，根据现场需要选择对应的集成字段、必录字段、以及是否需要校验存在性。

2、 配置集成资源

创建集成资源，选择集成中间表配置

保后发布写入API

外部系统可调用发布的写入API，将数据向内集成到星瀚HR。外部写入API可去开放平台查看。

页面路径：HR交付工具云 -> HR数据集成服务-> OpenAPI-> API

左侧树选HR交付工具云，树节点：HR数据集成服务 -> 同步接口