用友ERP UAP平台培训教程Word下载.docx

1、交换组件可以分为三类，分别是BindingIn节点，BindingOut节点，Mediate节点。BindingInIn节点外观上没有In端口，它负责协议相关的消息（如Http请求，web service调用，邮件接收等待）接入，Mediate节点既有In端口又有Out端口，它负责消息转换，BindingInOut节点负责流程退出，他会根据协议相关信息来处理消息流程的结束。消息流：消息流是我们为了支持一定的业务功能，把交换组件有机的组合在一起，安排流程，完成一定的消息接入、交换及传输功能的单位。每个消息流有且只有一个BindingIn节点，各个节点之间由连线连接，可以有一个或多个Binding

2、Out节点，实际上，我们可以把一个流程看做一棵树，树根是一个BindingIn节点，每个叶子节点是BindingOut节点，而中间的节点都是Mediate节点。组件：组件可以类比于工程，它是我们部署的启动用友应用平台的基本单位，在一个组件中，我们可以定义消息流，javaclass，ldapconfig，安全配置，规则映射，简单映射，脚本，测试，类型，web 服务等信息。所有的配置信息都围绕着消息流，为消息流服务。1.3用友集成平台架构从总体来看，该集成平台分为前台与后台。前台是集成开发环境，也就是用户可见的编辑界面，现在已经实现NC版本。后台是集成平台运行环境，由路由、消息处理、传输协议支持组

3、成。并配以安全管理、事务管理、事件通知机制及服务管理。这种前后台分离的架构，使我们可以针对不同的环境开发不同的客户端程序，如开发eclipse版本的管理界面。而后台部分具有良好的可扩展性，根据企业集成需求，我们可以开发更多的路由支持，消息处理机传输协议。在本版本中，消息在应用集成平台上表示为中立的、有强大表达能力的XML形式，这是目前业界比较成熟的一种表达形式，经过外部交换平台多念实践的证明，该方式能够良好的进行异构系统的集成。但是消息本身又不仅仅能够表现为XML的形式，针对比较特殊的系统，我们还能够在消息处理层开发比较特别的消息表达方式，从而使得该系统能够更好的支持异构系统集成。 该平台具有

4、良好的可监控性，在每一条经过消息流的消息及执行成功与否都会被记录。从技术层面看，该平台借鉴了工作流的处理方式，通过组装交换组件，构成流程，来为企业开发新的流程，接入异构系统，实现增值服务。交换组件的设计参考了JBI的BC（Binding Component）及SE （Service Engine）的概念，不同的是本平台的SE也以组件的形式存在。消息是流及交换组件所处理的主要内容，也是ESB产品的核心之一。该平台的消息模型参考了SDO模型，使得其具体实现具有可扩展性。后台管理引擎使用了OSGi框架。具有一定功能的流程、相关资源及配置信息以组件为单位，打包成Bundle部署到OSGi引擎上去，使得

5、生命周期管理有章可循，并能够很好的支持热部署。应用服务器我们现在采用NC中间。 1.4用友集成平台特色用友集成平台具有如下的特色：1）友好的消息流程定制，内置各种消息处理器和消息节点V5x及以前版本的交换平台是固化的流程，当外部的消息到达交换平台后，先分解，再拆分，再转换格式，翻译数据，最后分发给业务插件处理，插件处理完后返回回执，这样的处理顺序，包括整个处理过程中异常信息的收集，都被固化在后台代码中，不同的消息无法自定义处理流程。扩展的地方只是体现在：a）加密解密接口回调b）最终业务插件前置事件和后置事件处理c）交换规则的配置EIP V6提供流程配置功能，使得开发人员和实施人员可以在EIP平

6、台上定制消息处理流程，通过合理组合EIP内置的消息处理器（格式转换EXCEL-XML，数据映射，消息路由，脚本开发，日志记录，文件操作，数据库操作等）和消息节点（HTTPInput，HTTPResponse等），灵活处理系统间传递的消息，实现简单的业务逻辑（注：复杂业务逻辑还是要通过工作流产品解决）。2）数据类型及服务管理增加数据类型管理工具，可以在EIP平台上友好的定义消息格式（注：设计界面屏蔽xsd技术术语,类似元数据的建模工具，是面向模型的），数据类型可以手工创建，也可以导入，支持外部xsd，外部POJO，NC元数据，NCVO，PDM文件等格式的导入。增加服务管理功能，可以控制服务的运行

7、、停止，监控服务运行状态，进行服务查找等。3）更灵活，更易用的交换规则交换组件提供可视化拖拉方式的配置，支持公式，赋值，档案对照，支持顺序化映射，支持上下文相关的转换（注：比如一个文档里不同的字段需要根据不同的上下文翻译）。对于字段数量多的数据，交换组件同时提供表方式，使得操作更加易用。4）安全机制增强内置加密解密算法，支持HTTP/HTTPS,支持验证授权5）稳定性和效率增强支持大数据量xml文件导入（输入流50m）,对服务器的内存要求降低，不会造成server宕机（OutOfMemory异常）。6）增强的前台集成开发环境（Toolkit）包括外部系统注册，辅助信息配置，基础数据对照，手工加

8、载测试，日志查看和分析，流程配置界面，类型管理界面，集成应用开发向导等。7）后台Runtime基于OSGI搭建插件框架，方便开发、实施、产业链扩展EIP内部代码分组件设计，复杂消息流（有自定义代码实现，引用第三方jar包等）也会按照插件方式动态部署到系统中，使得整个EIP平台成为一个可以不断扩展和增强的产品。2.产品简介上图是流程平台的Tookit界面，左侧是资源管理，管理者各种资源，右侧是编辑区域，能够编辑左侧的各种资源。上图的编辑区域显示的是一个流程编辑器，我们可以看到一个简单的消息流程。2.1资源管理资源所涵盖的范围很广，各种脚本、配置文件、类型定义文件、服务定义等都是资源。借助于Too

9、lkit，我们可以很方便的对资源进行增删改查。2.1.1资源创建从本质上来说，流程及流程相关的配置信息、类型信息、映射信息等都是资源，只不过其他资源都是围绕着流程进行的。每种资源在组件下都有一个文件夹与之对应，每种资源都关联一个编辑器，每个编辑器都实现了Undo、Redo。系统统一提供对资源的增删改查。本文以创建流程与管理类型来说明资源的创建。经过如图的四个步骤，我们就创建了一个流，下面，我们就可以打开它在右面的编辑区域去编辑。上图是一个开发界面，我们可以从左面的抽屉里拖拽出图形，来完成流程配置。从本质上讲，在组件中的每个文件夹及文件都是资源，资源的创建，编辑都可以按照上面两幅创建消息流的方式

10、来进行，只不过不同的资源关联的编辑器有所不同。2.2.2资源重构由于资源之间有引用关系（类型会引用其他类型，流会引用类型、规则映射、相关配置信息），因此，对任何一个资源名称的改变都会影响到其他资源。在本系统中，我们实现了类似于eclipse的资源重构，修改任何一个资源，都会自动的修改引用它的资源。如下所示，我们重命名一个资源文件：第一步：重命名文件（资源）第二步：列出影响列表第三步：完成经过这三步，涉及到的资源都会被改变。2.2.3资源删除一个资源只有在没有被别人引用的时候才能够被删除。因此，本系统在删除资源的时候会检查资源是否被引用，如果没有被引用，才会真正删除。如下图所示：如果我们想删除刚

11、才重命名的Company类型，就会提示有其他资源引用Company类型，删除不会成功！2.2.4资源查找各种资源会越来越多，查找起来比较困难，我们参考了Eclipse的参照，开发了我们自己的参照系统，这样可以很方便的定位资源。该参照支持模糊匹配、正则匹配，高亮显示。2.2.5历史记录对任何一个资源重构后，可能在以后的某个时间我们还想对他进行恢复，因此，我们做了历史记录，可以将资源恢复到任何一个状态：2.2运行与监控流程必须以部署之后才能够运行，但是流程的部署并不是以流程为单位组织的，而是以组件为单位组织的，主要考虑到如下两个方面的原因：首先，我们的流程是以业务为驱动的，要支持一种业务，可能需要

12、多个流程协作进行，而这些流程会在同一个组件（也可能是多个组件）中开发。其次，流程要运行，需要借助于很多相关资源，因此，我们以组件为单位进行部署、管理。2.2.1组件的部署与反部署组件的部署非常简单：在组件上单击右键，会看到右键菜单中有“部署组件”与“反部署组件”两个选项，点击就可。部署完了，会在左下角看到已经部署的组件，执行反部署后，左下角相应的组件会消失。2.2.2流程的监控双击左下角已经部署的某个组件，在右面就会打开监控界面，在上面，是该组件中流程的运行状态，我们可以停止、启动该流程。在下面是该流程处理消息的记录。值得注意的是，流程的部署与反部署都是运行态执行的，不需要重启中间件。前台修改

13、流程，只要后台点击部署，就会更新后台的运行状态。2.3数据类型开发数据类型是企业应用系统中流转数据的模板，为了能够更好的支持异构系统数据交换，我们在用友集成平台中是通过XSD来表示数据类型。用户可以通过编辑器创建类型，也可以通过元数据或wsdl文件导入类型。类型的创建过程与流程的创建过程相同。从用户的角度来看，类型管理就是对xsd的管理，编辑界面就是一个xsd编辑器，如下图所示：2.3.1类型编辑在选中某个类型的某个元素后，我们可以通过左边的属性编辑面板编辑它的名称，用通用参照选择类型等。2.3.2关系图由于在一个类型资源中可以定义多个不同的类型，为了方便用户查阅，我们设计了鹰眼图，方便用户来

14、观察类型之间的关系：2.4服务开发 服务是本平台对外提供服务的接口，本质上讲是web service接口定义，借助于本平台提供的编辑器，用户可以完全忽略复杂的逻辑，而感觉上认为自己在定义一个接口（包括接口名称、输入参数、输出参数），编辑界面如下图所示：通过定制服务，我们可以通过交换平台对外发布某个应用系统的服务这样就能够实现服务整合。2.4.1创建方法或参数鼠标右键单击调出菜单，然后选择增加就行2.4.2选择参数类型双击该区域，就会调出类型参照，然后选择类型2.5消息流开发2.5.1消息流与交换组件交换组件是组成消息流的基本单位，它是一段对消息的处理逻辑。从分类上讲，交换组件分为三类：他们是B

15、indingIn组件、BindingOut组件、Mediator组件。BindingIn组件与BindingOut组件是成对出现的，一般来说他们支持了某种特殊的协议，In节点表示基于特定协议的消息的接收与处理，Out组件表示消息处理完毕，根据协议封装返回消息。而中间的mediate组件表示对消息的处理。消息流是由交换组件及交换组件之间的连线构成的。每个消息流都会有一个BindingIn节点，它负责接收并解析消息，而后的交换组件都是Mediator节点负责消息处理，包括计算、赋值、格式转换、请求服务等等，最终根据流程分支的多少会有一个或多个退出节点，也就是BindingOut节点。整个流程在组织

16、上我们可以看做是一个树形结构，根部是BindingIn节点，中间节点是Mediator节点，而叶子节点是BindingOut节点。用友集成平台提供了便捷、友好的流程开发方式。打开一个流程资源，在流程编辑器的左侧有个工具箱，该工具箱里面有各种交换组件可用，用户在使用的时候只需要把相应的组件拖拽到右面的编辑区域，然后在交换组件之间做连线就可以完成一个流程的开发。为了更好的支持集成，我们开发了多种不同的交换组件。下面我们将分类介绍这些交换组件。2.5.2 HTTP 2.5.2.1 Http接入1、负责对外发布一个Http服务2、能够接受用户的Http请3、 支持XML格式消息及流式消息2.5.2.2

17、 Http请求把消息以Http Post的方式发送到指定的地址需要关联类型2.5.2.3 Http响应与“Http接入”成对使用，把处理结果返回给客户端2.5.3 Web ServiceWeb Service是一种工业界的标准簇，利用这套标准簇，我们能够定义各种不同技术开发的系统都能够识别的参数类型、接口类型、接入方式。因此，它是异构系统之间服务调用的桥梁。用友集成平台较好的支持了web service。现已支持：WSDL、WS-Security、WS-Addressing、XOP、WS-Policy能常用的协议。利用web service，我们可以方便地对旧系统进行改造，使之不再孤立，让企业

18、的IT系统之间连结成一个平台。如下所示，可以做一个带web service的流程：在用友集成平台中我们目前内置了下面三个节点来支持Web Service：2.5.3.1服务发布服务发布能够支持以下1、对外发布web service2、处理web service请求3、支持SOAP1.1与SOAP1.24、支持WS-Security5、支持附件传输MTOM（XOP）6、支持生成客户端调用代码7、支持根据请求方法生成路由节点下图是一个服务发布节点的配置信息，我们必须配置wsdl路径名，服务发布地址，可以选择配置安全信息。为了方便区分用户调用的方法，我们做了“生成Stub”，该功能能够根据到来的请求

19、信息，选择路径生成客户端调用代码向导第一页，检查环境，如果检查不成功，就会从服务器上下载环境指定输出目录点击完成生成代码这样我们能够生成Eclipse工程，供客户使用2.5.3.2服务请求服务请求把消息封装成SOAP消息，执行web service服务调用，使用时需要指定wsdl路径名及请求地址。2.5.3.3服务响应与“服务发布”成对使用，把处理结果返回给客户端。该节点没有需要配置的属性，但如果流程以服务发布开始，那么必须要以“服务响应”为结束。在使用的时候，这三个节点需要与wsdl编辑器、类型编辑器、各种Mediator一起配合使用，以完成WS相关的任务。下面我会用一个例子来说明这个问题：

20、2.5.4 JMS2.5.4.1 JMS输入JMS输入节点能够从Queue上接收JMS消息。目前版本针对ActiveMQ做了实现，节点配置如下所示：2.5.4.1 JMS输出JMS输出接点能够把消息上下文以JMS方式发送出去，目前版本针对ActiveMQ做了实现，节点配置如下所示：2.5.5邮件2.5.5.1邮件接收邮件接收节点能够提供如下功能：1、接收邮件2、支持定时接收下图是一个邮件节点及其配置：和前面提到的In节点一样，一个邮件接收节点首先需要配置接收邮件的类型，解析器，安全等相关信息。我们的邮件节点支持标题过滤、定时查收、消息保存与否等属性。2.5.5.2邮件发送邮件发送节点可以把当前

21、消息上下文中的消息以邮件的形式发送给用户。邮件发送节点的配置也很简便，填入发送邮件需要配置的一般参数即可。2.5.6文件2.5.6.1文件接收文件接收节点功能比较强大，它能够从服务器文件系统中或从某个FTP服务器中按照路径条件，定时检查文件，该文件内容不一定是XML格式，也可以是binary的，binary格式的文件将按照流来使用。2.5.6.2文件上传文件上传节点可以把消息上下文中的消息信息，流信息写到本地文件系统或上传到FTP服务器上去。与文件接收配合使用，我们可以实现按时从某个应用服务器上扫描文件并下载到服务器本地。2.5.7数据库访问2.5.7.1数据库写入数据库写入节点用来实现通过数

22、据库信息构造消息内容，包括通过数据库查询重新构造消息内容和通过数据库查询补充消息内容两种方式。配置界面如下图所示：左边为从前一节点流入至此节点的消息数据类型树状结构，右边为配置界面。当选择重新生成消息时，只需配置消息字段映射页签即可；当选择根据条件补充时，则两个页签都需要进行配置。数据表用来指定与已选数据类型树节点对象对应的表，当选择的数据类型树节点为子节点时，需要定义与父节点对应的表的对应附表外键。“消息字段映射”页签用来指定已选择数据类型节点对象字段与选择的表字段之间的映射关系，通过此映射关系把查询结果写入消息中。“补充字段信息查询条件”页签用来定义条件补充时的查询条件。即构造where子

23、句。”请输入查询条件”文本框用来定义附加的查询条件。2.5.7.2数据库查询数据库查询节点用来实现把消息内容进行数据库持久化，包括数据的插入和更新。“数据表”用来指定与已选数据类型树节点对象对应的表，当选择的数据类型树节点为子节点时，需要定义与父节点对应的表的对应附表外键。下面的表格用来定义数据库字段与消息字段的映射关系，根据此映射关系和指定的数据表进行数据的插入或者更新，其中”更新主键”是指定更新的主键即由此构造where子句。“是否启用更新”用来指定是否根据主键进行插入，如果选定了此选项，同时需要指定更新主键，这种情况下写入数据时如果出现主键冲突时，则基于此数据进行数据库更新。2.5.8消

24、息映射规则映射1、将一种类型的消息根据规则映射成另一种类型的消息2、多种转换方式：映射、公式、赋值、过滤、简单对照、脚本、XPath映射3、可扩展映射方式消息映射是用友集成平台的核心功能之一，它能够把一种格式的消息快速映射到另一种格式，从而为异构系统间的不同格式类型的信息交互提供了强有力的保证。如下图所示的一个交换规则定义：2.5.9 脚本开发2.5.9.1脚本开发脚本用于对EIP平台对复杂处理的支持，以解决通过图形化节点难于配置甚至根本不能配置的中间逻辑处理。它囊括了大部分中间处理环节，包括：消息转换、数据库操作、文件操作、Webservice调用等。此节点是基于Groovy脚本语法规则进行

25、开发，所以编写脚本时必须遵守Groovy语法。脚本节点为编辑脚本内容提供了友好的脚本编辑界面，如下图所示：源消息和目标消息都是通过选择数据类型确定消息内容的格式，源消息用于从前一节点接收消息，可以根据路径从中读取消息字段内容；目标消息是通过脚本处理之后的目标消息，根据所选择的数据类型进行构造，处理完毕后，目的消息继续向下一个节点进行消息传递。脚本编辑区用于编写具体脚本，遵守Groovy语法规则。从消息对象取值和为消息对象赋值是基于具体字段路径进行。 通过脚本的返回值决定脚本的后续路由。功能选择区是为脚本编写提供的通用功能，选择需要的功能后双击，此功能会根据定义的内容自动插入脚本编辑区。包括系统

26、函数、自定义函数、路由、数据源。系统函数是平台默认提供的函数库；自定义函数根据具体需求进行自定义；路由包含系统默认的路由，选择路由来决定脚本节点的后续路由；数据源提供了EIP平台配置的所有数据源，在进行数据库操作时需通过此功能进行选择待操作的目标数据源。功能描述区是对功能选择区选择的功能进行的使用方法的描述。校验按钮是对编写的脚本进行正确性校验。如果脚本存在错误，则在日志信息栏中会显示出错误信息。下面详细介绍系统函数：（1）setValuesetValue（String contextParam,Object value）:为context的简单对象类型参数设值,当对象为数组类型时,value

27、需要为值List集合,否则value是java基本类型对象.contextParam是从目标context中选择的参数,value是设置的具体值（2）getValuegetValue（String contextParam）:获得context的简单类型参数对象值,当对象为数组类型时,返回List,否则返回java基本类型对象;如果path对应的类型非简单类型,则抛出异常.contextParam是源或目标context中选择的参数（3）setObjectsetObject（String contextParam,EDOMObject value）:为context的参数设值,当对象为数组类型

28、时,value为构造好的DOMObject对象.contextParam是从目标context中选择的参数,value是设置的具体值（4）getObjectgetObject（String contextParam）:获得context中指定路径的对象,该对象为EDOMObject的子类.contextParam是源或目标context中选择的参数（5）getObjectByXPathgetObjectByXPath（String xpath）:（6）copyObjectcopyObject（String srcContextParam,String destContextParam）:拷贝源context中的参数值到目标context的参数,srcContextParam是源context参数,destContextParam是目标context参数（7）createNotArra