公司项目整体分为两类：一类是产品加交付类项目，另一类为产品加培训类项目。公司所有的解决方案都离不开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项目培训样例说明相关推荐

ESB+MDM预置样例测试总结
大多数企业随着企业规模扩大.业务发展,信息化建设也随之不断推进,在信息化建设不断深入的过程中,很多企业都面临着业务系统之间的整合问题,应用系统间数据共享与功能集成需求日趋强烈,如:系统功能整合.跨系统 ...
计算机专业毕业生、求职升学面试项目亮点，算法原理双语介绍思路与样例
文章大纲项目亮点样例背景背景(简洁版) 技术上的亮点业务上的亮点算法工程师自我介绍与评价样例中文英文项目经历口述DEMO 工作描述项目描述面试算法原理叙述逻辑举例 KMea ...
fpga开发教程 labview_LabVIEW项目样例 - NI VST FPGA软件编程使用步骤与实例教程
3. LabVIEW项目样例 NI VST仪器设计库的能力强大,但是并不能单枪匹马地完全满足软件设计仪器实现默认功能的要求,也不能提供大多数VSA和VSG仪器编程人员所熟悉的简单主机接口. LabVI ...
【COCOS2D-HTML5 开发之三】演示样例项目附源代码及执行的GIF效果图
本站文章均为李华明Himi 原创,转载务必在明显处注明:(作者新浪微博: @李华明Himi ) 转载自[黑米GameDev街区] 原文链接: http://www.himigame.com/coc ...
shell脚本模拟键盘输入完成程序交互（定时重启docker部署的项目样例）
shell脚本模拟键盘输入完成程序交互(定时从起docker部署的项目样例) 背景最近有一个利用docker部署的组件(test1)每天晚上12-1点总是会停止工作,但又找不到异常原因,重启后恢复正 ...
个人作业项目报告（三）输出结果及测试样例的结果（附代码）
代码调用图代码调用图的图例:(感谢刘泽@kfk的vs2015企业版的强大功能) 输出结果因为助教给的程序是在WIndows平台上运行代码得到的结果,所以主要放出的是Windows平台下的结果,Li ...
需求分析说明书、详细设计说明书、概要设计说明书样例
以下是需求分析说明书.详细设计说明书.概要设计说明书样例需要详细资料的去 http://bbs.csai.cn/BBS/view.asp?ID={CA9329C0-93C5-4417-9170-45 ...
在Ubuntu下构建Bullet以及执行Bullet的样例程序
在Ubuntu下构建Bullet以及执行Bullet的样例程序 1.找到Bullet的下载页,地址是:https://code.google.com/p/bullet/downloads/list 2 ...
JDBC连接MySQL数据库及演示样例
JDBC是Sun公司制定的一个能够用Java语言连接数据库的技术. 一.JDBC基础知识 JDBC(Java Data Base Connectivity,java数据库连接)是一种用 ...

ESB项目培训样例说明