ESB项目培训样例说明
Posted 数通畅联
tags:
篇首语：本文由小常识网(cha138.com)小编为大家整理，主要介绍了ESB项目培训样例说明相关的知识，希望对你有一定的参考价值。
公司项目整体分为两类：一类是产品加交付类项目，另一类为产品加培训类项目。公司所有的解决方案都离不开ESB企业服务总线，所以不管是技术人员还是研发人员对ESB的产品功能都要非常了解，因为在涉及到ESB项目交付时，需要对合作伙伴或是客户的开发、运维人员进行相关的培训工作。
近期ESB企业服务总线进行了产品的版本升级，新增了API管理、运行监控、监控统计模块，并对应用集成模块进行调整。在对项目ESB升级完成后，需要对用户提供升级手册等相关文件，并对新版本ESB进行产品培训，本篇文档主要针对新版本ESB相关模块的构建核心培训案例进行说明，具体内容如下。
1整体说明
该模块主要针对本次产品升级培训样例的主要背景、升级内容以及配置的相关样例进行说明，具体如下：
配置样例主要对API管理模块的API服务、API代理以及API安全进行配置方面的介绍；接下来基于API管理模块对应用集成的配置进行介绍说明，最后对平台的运行监控、统计分析以及ESB相关的组件进行说明，具体内容如下。
1.1背景说明
本篇文档撰写背景主要是针对某项目ESB的产品升级，在老版本的基础上对API管理模块、监控统计模块以及统计分析模块进行了迭代升级。在对该项目开发环境、测试环境以及生产环境升级后，需要对该项目的开发人员及运维等人员进行培训，在培训之前需要对整体培训样例进行准备工作，基于该培训样例对客户进行培训。
1.2产品说明
本次的产品说明主要是针对ESB的新功能，上文已经提到主要是对个别模块进行了升级，这几个核心模块又存在密切的关联关系，具体关联关系如下：
1.API管理模块主要新增应用管理、服务管理、安全管理、API超市、API代理以及API标签；
a)服务管理：服务管理包括内部开发服务注册、外部服务导入以及服务配置功能，并对服务内部接口的入参、出参信息进行配置，支持服务代理、日志开启及服务安全等配置；
b)安全管理：安全管理模块主要支持IP的限制，包含IP的黑名单、白名单等，也可以进行访问认证，包含token、用户名及密码、拓展流程等，也可以设置预警机制，如微信、短信、邮件等；
c)API超市：对API的分组、应用及调用提供查询功能；
d)API标签：为API服务内的流程绑定标签。
2.应用集成：将原有服务注册模块迁移成API服务的一部分，对集成流程进行调整，支持IP的限制及安全认证；
3.监控统计：对服务、流程的调用情况进行统计分析。
1.3样例说明
本文整体演示样例主要对新版本ESB的相关功能，及ESB设计器内的相关组件如MQ、Excel等组件进行详细说明，为后续项目现场培训做准备。首先对API管理模块的API服务、API代理及API安全进行配置介绍；接下来基于API管理模块对应用集成的配置进行介绍说明，最后对平台的运行监控、统计分析以及ESB相关组件进行说明。
2API管理
API管理模块主要包含：应用管理、API分组、API标签、API服务、API安全、API代理及API超市，其中分组、标签等功能不做过多赘述，主要对API服务、API安全以及API代理模块进行说明。
2.1API服务
API服务有三种导入方式：服务注册、导入以及API配置方式，本次主要以API导入功能进行样例介绍。
首先在API服务模块点击导入功能，接下来选择工程，然后选择该工程下对应的服务信息。
在服务导入后就可以对该服务的API接口入参及出参信息进行配置。
接下来配置其入参信息，例如方法动词为get的接口，可以配置其入参信息，在入参设置处基于模块进行参数解析。
在解析过后，效果如下：
同时也可以在ESB管理控制台进行调用，点击上方调用案例可进行调用。
调用分为HTTP调用、CURL调用及JAVA调用，效果如下：
以同样方式配置对应的出参即可。
2.2API代理
API代理主要对外部导入的服务进行代理，例如主数据管理平台服务可以在服务注册模块配置服务代理。
在代理后可以配置代理的具体信息，接下来进行代理解析。
在服务代理后可以在API代理模块查看具体代理效果，直接使用SoapUI查看效果即可。
2.3API安全
API安全具体分为IP限定、认证方式以及访问上限，具体如下：
1. 访问上限：访问上限是判定该API接口的访问限流，可以设置500、1000或者自定义等；
2. 认证方式：可以设置tokenId、用户名、密码或自定义流程的认证方式，在设置token后需要在应用配置处，设置对应的获取信息，用户名密码及可以直接录入访问的密码；
3. IP限定：IP可以支持IP白名单及黑名单，输入IP支持网段的形式及网端区间的形式。
3应用集成
应用集成模块以常见的集成场景进行说明，基于现有集成场景对其配置方式进行说明，具体包含场景配置、集成流程及生成对应的集成流程，具体配置过程如下。
3.1场景说明
应用集成流程数据走向图如下：
主要集成场景主要是对人力资源管理系统的人员数据进行分析，首先在API服务模块对人力资源系统的服务以及数仓相关服务进行注册，选择对应的应用配置其入参、出参信息，配置完成后在应用集成模块定义应用集成场景，接下来进行场景配置，最终生成对应的应用集成流程。
3.2场景配置
场景配置方式和之前的配置方式一致，输入对应的编码和名称后选择数据来源系统及数据来源系统接口。
在选择目标系统及目标系统接收接口，此处目标系统为数仓系统，所以选择对应的接口。
在保存后进行字段信息的映射。
点击提交按钮，ESB设计器会基于前台场景配置生成对应的集成流程，开发人员可以在该集成流程的基础上进行调试完善，以达到数据实时同步的效果。
3.3集成流程
在ESB设计器内创建对应的集成流程工程，并在MF目录下创建消息流程，接下来点击刷新按钮，会看到我们创建的场景。
找到我们创建的集成场景，创建即可，并在该集成流程上进行调试，调试完成的整体流程效果如下。
集成流程调整点：
1.HttpRequest节点增加code参数；
2.源系统调用增调整请求体，并修改解析策略：解析XML报文(去掉命名空间)；
3.目标接口调用请求设置内容类型为Json格式。
该集成流程可以在集成流程模块设置预警机制、安全机制等。
4组件样例
对于组件样例部分，对一些常规使用的组件已经非常了解，至此不做过多赘述，后续在ESB开发精要中会逐一体现，本次主要对新增的预警服务、Excel相关的读写以及MQ消息队列等进行说明，具体如下。
4.1预警服务
新版本ESB预警机制可以通过ESB设计器直接创建微信、短信、邮件的预警工程，创建过程按照创建ESB Rest服务工程点击下方基于模板创建，选择预警工程即可。
接下来点击Finish按钮，生成对应的服务如下，在该流程的基础上进行调整即可。
其中微信、短信、邮件的API网关以及接收方需要在ESB全局变量处配置对应的信息。
4.2Excel读写
注意云平台模式Excel读写是读取云平台服务器上的文件，根据开发环境在云平台位置进行文件读取，可以通过Excel的文件进行读取，将其进行数据处理，最后调用外部系统的接口将数据写入主数据管理平台当中。
具体配置如下：
接下来将文件进行解析，最终写入主数据平台即可。
4.3消息队列
消息队列（MQ）是一种应用程序对应用程序的通信方法。应用程序通过写和检索出入列队的应用程序数据（消息）来通信，而无需专用链接来连接它们。消息传递指的是程序之间通过在消息中发送数据进行通信，而不是通过直接调用彼此来通信，直接调用通常是用于诸如远程过程调用的技术。排队指的是应用程序通过队列来通信。队列的使用除去了接收和发送应用程序同时执行的要求，接下来对其进行配置，具体MQ发送流程如下：
在Java转换节点定义一个变量信息，通过MQ发送组件进行消息发送；
发送过后在另一个流程进行消息接收即可。
注意在MQ消息队列配置过程中，需要在ESB管理控制台对消息路由等信息进行配置。
5心得体会
随着公司的发展，产品加培训类项目越来越多，我们也应该形成自己的对外培训体系，形成培训标准，甚至是培训考核标准等，不能随心所欲以项目实施的方式进行培训，现从以下三个方面总结。
5.1意识形态
用户培训工作有利于建立个人与客户之间的交情，客户也愿意在后续工作中配合我们开展工作，了解我们的工作流程，按照我们的制度配合，而不是简单埋怨责怪，并且在用户培训过后还需要做好备忘录，和用户部门领导进行反馈，让用户回去对其直属领导有个明确交代。
5.2产品完善
在用户使用产品的过程中也是收集用户需求的一个重要机会，可以通过观察用户的使用习惯及调研，了解产品应该改进的方面，对于客户提出的意见均应记录下来并对公司进行反馈，一个好的产品是不断经过外力打磨而成型的，我们实施人员都要站在产品经理的角度去收集需求，并结合实际企业需要不断完善迭代产品。
5.3总结反思
坦率地说，我们现在整个IT行业培训工作质量是不高的，至少是参丝不齐的，一部分原因是用户不注重培训工作，只当作上级分配的一项任务，完成后就没有下文了。另一部分原因是我们很多软件实施人员强在技术能力，弱在业务理解力和语言表达能力，心里明白但是说不清楚。
之前包括我自身都是这种思维：精力应该放在解决问题上，而不是培训上面上。结果无论人在现场还是不在现场，大量的时间都是一个人在忙碌配置调试，然后请用户检查验证，通过后再去处理下一个事情，这就导致了实施人员根本不能走开，只要走开就出问题。所以培训工作是千方百计想办法让客户会用、好用、爱用软件，这才是一个优秀项目交付人员的价值。
以上是关于ESB项目培训样例说明的主要内容，如果未能解决你的问题，请参考以下文章