主数据标准化分发对接说明(数据对接接口方案)

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

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

集成方案

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

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世纪最稀缺的资源。

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

版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌抄袭侵权/违法违规的内容, 请发送邮件至 举报,一经查实,本站将立刻删除。

(0)
上一篇 2022年12月12日 上午8:01
下一篇 2022年12月12日 上午8:03

相关推荐

  • 军工项目

    军工项目是中国政府的重要产业之一,涉及到多个领域,包括航空航天、军事装备、汽车制造等。近年来,随着国家安全的不断提高,军工项目也得到了更多的关注。本文将介绍一个军工项目的历史、现状…

    科研百科 2024年10月30日
    1
  • 教师教科研项目包括哪些

    教师教科研项目包括哪些 作为一名教师,承担科研项目是提高自己学术水平的重要途径之一。科研项目可以帮助学生更好地了解研究领域的前沿动态,提高学生的实践能力和学术素养。同时,科研项目也…

    科研百科 2025年4月7日
    4
  • 市直机关工委到市应急局开展机关党建工作督查调研(市应急管理局机关党委书记)

    12月1日,市委市直机关工委副书记、纪检监察工委书记苟军民带队到市应急局开展机关党委、机关纪委工作督查调研。市政府副秘书长、市应急局党委书记陈登山陪同调研。 督查调研组视察了市应急…

    科研百科 2024年6月28日
    61
  • 答题APP开发,帮助孩子更好学习-广州手机app开发(答题软件开发)

    随着2023年的来临,九三后也正式迈进三十岁的年龄,许多九三后也成为新手父母,因为社会环境影响,九零后对于他们的儿女也承载着较大的期待,希望子女可以学业有成,但生活中传统的应试教育…

    科研百科 2023年3月27日
    215
  • 系统学习项目管理

    系统学习项目管理 项目管理在现代商业中扮演着越来越重要的角色。无论是企业还是个人,都需要掌握项目管理的技能,以便更好地组织、规划和控制项目的进展。本文将介绍项目管理的基本概念、方法…

    科研百科 2025年6月8日
    0
  • 江西赣州市村委会两委干部工资,工龄五年,薪资待遇一言难尽

    在江西省赣州市的某个宁静乡镇,有一位网友小李向我们分享了他的工作经历和工资待遇。 小李,大专学历,已经在当地的村民委员会工作了五个年头,作为村里的一名两委干部,他肩负着多重职责,也…

    科研百科 2024年6月26日
    318
  • 武威市学习贯彻党的二十大精神知识竞赛活动开始啦!诚邀您的参与

    关于组织开展全市学习贯彻党的二十大精神知识竞赛活动的通知 为深入学习宣传贯彻党的二十大精神,推动全市各级党组织迅速掀起学习贯彻热潮,引导广大党员干部群众深刻理解把握党的二十大精神的…

    科研百科 2023年2月2日
    288
  • 中级系统集成项目管理师2024

    中级系统集成项目管理师2024:挑战与机遇 系统集成项目管理师(项目经理)是一个非常重要的职业,主要负责组织、规划和实施系统集成项目,确保项目的成功交付。随着信息技术的不断发展,系…

    科研百科 2025年7月16日
    1
  • 科研项目步骤案例

    科研项目步骤案例 科研项目步骤案例是研究人员在进行研究过程中遵循的一系列明确的步骤和指导,这些步骤可以帮助研究人员确保研究的质量,并提高效率。下面是一个科研项目步骤案例: 步骤一:…

    科研百科 2025年2月3日
    4
  • 环境科学科研项目经费

    环境科学科研项目经费 随着环境污染问题的日益严重,环境科学科研项目经费成为了一个非常重要的话题。这些经费用于研究环境保护和治理的方法和技术,以改善我们的环境和生活质量。本文将探讨环…

    科研百科 2025年5月3日
    1