公司项目类型共分为两类，第一种为产品加交付类项目，需要公司内部出实施人员进行项目交付，而另一种为产品加培训类项目，需要合作商或者客户自身进行项目的开发相关工作，由我方提供产品的培训，本篇文档主要针对数据分发开发场景进行全方位说明。

本文主要针对甘肃某项目数据中台模块与本期建设各业务板块进行主数据集成，本次集成采用主数据系统标准化分发模式，本文核心描述整体数据集成架构、主数据相关接口、集成对接方式、常见问题以及对应解决方案进行说明。

集成方案

针对数据分发集成方案各业务系统需配合进行数据集成改造，主数据采用任务分发的方式保障数据的实时性，同时在数据初始化的过程中需各业务系统调用主数据全量获取接口进行数据的初始化操作，具体集成场景、集成方式以及常见问题如下。

1.集成场景

数据中台分发集成场景主要包含数据初始化以及数据的实时分发同步，每类场景需开发对应的集成流程，具体集成场景如下：

1.数据初始化：各业务系统获取数据中台主数据全量组织、人员、岗位、客户、供应商、项目信息，完成系统基础数据初始化工作；

2.数据实时分发：当数据生产系统产生数据时，数据自动同步至主数据管理平台，主数据管理平台自动分发至数据接收系统中。

2.集成方式

主数据平台集成方式采用基于数据任务分发方式，主数据管理将源业务系统同步过来的一条或者多条数据打包成数据任务并生成任务ID，各数据接收业务系统提供数据接收接口，该接口请求参数为任务ID，主数据管理平台提供任务ID解析接口、接口说明资料，各系统接收接口根据任务ID解析出任务内全部数据信息并将数据同步至各系统中（也可以直接推送Json数据），同时将数据同步状态信息回写至主数据管理平台。

另外在数据初始化过程中需基于主数据published接口开发数据初始化集成流程，该流程一方面是完成数据的初始化工作，同时也便于后期因某些原因导致数据接收方与数据中台数据数据不一致问题的处理。

3.常见问题

在集成过程中应考虑如下问题的处理：

1.推送人员主数据时人员所关联的组织机构等信息因为某些原因未推送成功相关问题的处理；

2.针对于枚举类数据信息应如何同步；

建议解决方案：针对于枚举类数据信息采采用Json拼接发送的方式，参考样例（红色标记）如下：

4.沟通事项

1.与各系统明确主数据集成方式；

2.对中台提供业务系统定义的信息，该信息用于后期各系统token认证，需提供认证用户名及密码（虚拟，并非各系统实际账户密码，只用于token认证），如果未提供由数据中台统一分配；

3.基于数据中台提供数据字典标注各系统需接收的字段信息，如未提供数据中台将默认分发每类主数据全部数据字段信息。

基础配置

基础信息的配置主要是对分发进行字段、系统以及分发权限等进行授权，例如，例如分发财务系统则对该系统需要的某几个重要的字段进行添加字段信息即可，不需要将全部字段信息分发至该系统中，具体配置如下。

1.业务系统注册

在主数据应用管理—应用配置模块，将需要分发的业务系统进行注册，例如注册财务系统。

在该模块点击“新增”按钮。

在编辑页面录入对应信息。

2.分发字段配置

例如要分发物料主数据的信息，双击打开上述注册的应用系统，添加主数据。

选择对应主数据。

接下来配置对应系统需要的元数据字段，在后续通过task接口获取数据时就只能查出当前配置的字段信息。

3.分发权限配置

在配置完成分发字段需要对当前应用系统进行授权，授权功能模块在数据的分类数据建模。

接下来在左侧下拉选找到物料主数据，在分发权限行点击添加按钮，增加分发业务系统权限。

点击保存按钮完成权限操作。

流程调整

本章主要针对标题自动分发场景，自动分发主要时对数据同步集成流程进行调整的基础上为其提供数据审核BPM流程，在审核的节点上调用外部数据接收的接口，将任务的taskId传给外部接口即可，其中还涉及一些全局变量的配置以及流程的配置，具体详见下文。

1.流程模板复制

在主数据管理平台流程建模—流程定义列表点击“复制流程按钮”，可以复制主数据定义好的模板。

选择默认主数据分发流程进行复制。

在模板变量配置模块第一个输入框内输入主数据的编码，在第二个输入框内输入主数据大写编码，样图如下：

接下来点击保存按钮完成流程模板的复制。

2.模板参数调整

在默认流程分组下可以找到刚才所复制的流程。

选择流程点击编辑按钮，调整流程的编码、名称及分组，分组调整到对应主数据下。

点击保存按钮提示流程保存成功。

3.流程参数调整

跟据编码或者名称找到刚才所复制的流程双击打开，流程情况如下：

修改其中调用节点即可，其它节点已配置完成无需修改，调用节点示例图如下：

修改任务设置中的获取许可、初始化分发日志及接收任务接口调用三个节点。

1.获取许可调整：在获取许可处点击编辑按钮，调整appCode和appPwd，此处配置依然和“流程模板复制”标题中提到的录入参数一致。

调整完成点击保存按钮。

2.初始化分发日志调整：调整当前分发主数据的服务地址，下图举例组织主数据地址：

主数据的每个服务可以通过主数据openAPI查看，地址如下：

3.接收任务接口调用调整：此处接口是接收系统提供的外部接口，入参为taskId，在此处直接URL拼接任务参数即可。

调整完成将流程进行保存，并进行流程发布。

接口说明

本次数据分发集成数据中台针对每类主数据均提供一个Rest服务，服务中包含数据全量获取接口、任务解析接口、日志回写接口等，具体服务接口地址如下：

本次数据分发的接口展示均已组织主数据为例进行说明，组织主数据服务调用地址如下:

可以通过SaopUI、Postman等工具进行调用查看接口。

注意：本次提供服务IP地址后续会在客户迁移完成机房后进行调整，建议相关系统将IP地址配置成变量的形式，便于后续更改；

1.获取tokenId

在任何应用系统调用主数据时都需要获取一个密匙，这个密匙为tokenId，其调用服务如下：

调用请求：Get

入参样例：

样例出参：

SoapUI调用样例：

2.全量数据接口

全量数据接口主要针对本期数据接收相关系统进行数据初始化所用，接口地址如下，注意只能获取主数据已发布的数据：

调用请求：Get

入参样例：

出参(Json)：

SoapUI调用样例：

注意：各板块全量数据接口出参均按照各模块需求配置出参信息，所以各系统出参均不相同。

3.任务解析接口

在主数据向接收系统传入taskId时可以通过task进行数据解析，接口地址如下：

调用请求：Get

入参：

出参(Json)，其中data参数是打包好的数据，可以通过key值解析：

出参参数说明：

SoapUI调用样例：

注意：各板块任务解析接口出参均按照各模块需求配置出参信息，所以各系统出参均不相同。

4.日志回写接口

在业务系统解析任务同步数据成功后需要返回成功或者失败日志到主数据内。接口地址为：

调用请求：Post

入参(Json)：

出参：

心得体会

通过本次主数据同步、分发以相关操作让我对主数据治理方案有进一步的了解，也为后续主数据治理项目做了铺垫，在实际项目实施与产品开发完善过程中也有了很多能力提升，现从企业运营、经验积累以及产品开发心得层面总结如下。

1.经验积累

通过近期项目的实施工作，使自身对数据中台项目有了更进一步的了解，清晰地认识到主数据在实施构建过程中的重点，主数据的实施同其它行业一样，实施难点在于对业务的了解程度，只有将企业的整体运营模式吃透后才能对项目实施更加得心应手。

2.企业运营

通过近期的项目实施工作使我发现近些年来企业IT信息部门的角色转变，在国内很长的一段时间内IT部门一直作为企业的支持性部门，但是随着企业的不断发展，信息化系统的不断增多，IT部门已经成为了企业内外部沟通，连接客户、合作伙伴的重要通道，是企业日常运营的重要支撑，也意味着IT信息部门承担着更大的责任，所以在企业信息化不断发展的过程中，对于信息部门的人员素质的要求也随着增高，以便在瞬息万变的数字化市场环境下，迅速为公司及客户创造价值。

3.产品心得

通过近期对项目业务部门的调研使自身在业务方面有了更多的理解和提升，我认为我们主数据管理平台更多是服务于系统的，为各个业务系统技工基础的数据支撑，而在调研过程中往往会遇到客户提出的各种各样的需求，其中让我清晰地认识到各系统均是实现业务的虚拟化载体，技术最终的价值是帮助客户解决业务问题的，当真正帮助客户解决实际问题后我们才会源源不断地产生收益。

作为以集成产品和解决方案为主的技术型公司，产品的研发最终的指向都是解决某个特定业务问题的。如果没有业务，技术的存在就没有意义，二者是密不可分的，渐渐懂得了领导说为什么公司更缺少的是业务专家的含义，IT技术支撑业务运转、促进业务创新，业务模式呼唤更灵活的技术解决方案，深刻理解IT产品技术、深入掌握业务脉搏的复合性人才是21世纪最稀缺的资源。

本文由@数通畅联原创，欢迎转发，仅供学习交流使用，引用请注明出处！谢谢~