【泛微E9开发】ESB开发3

3.3.5. 事件管理

基本功能介绍：
1、 由ESB1.0的服务方式优化而来，让业务系统集成ESB更容易，复用性更好。业务系统只需要将业务数据、需要返回的数据定义在ESB中进行注册，然后在具体业务时调用ESB提供的接口即可，业务系统几行代码即可实现ESB集成。ESB将提供统一的SDK，封装业务系统调用ESB的执行代码，其中包括通过配置实现不同协议的集成，调用ESB安全认证逻辑等。
2、 事件类型暂时支持业务触发、监听JMS消息、监听AMQP消息。
3、 事件包含发布、维护、封存三种状态
 发布状态：可以正常使用，包括被应用管理和第三方引用，不允许编辑
 维护状态：不可以正常使用，允许编辑
 封存状态：已有的配置可以正常使用，不允许被新的应用管理和第三方引用，不允许编辑
 撤回：只有没有被状态为启用的应用引用才可以撤回

基础信息设置：

1. 事件定义
   1.1 业务触发
   异构系统通过ESB SDK / API集成后主动调用的方式
   
   事件标识：必填，唯一值标识

事件名称：必填，接口的名称

所属产品：必填，只能选择状态为正常的产品；有ESB配置中心-产品管理权限的人员允许新建产品并引用

所属模块：必填，只能选择已选产品下的模块；有ESB配置中心-模块管理权限的人员允许新建模块并引用

数据格式：默认是Json，可以选择 Json、Xml

说明：业务触发的说明性文字

1.2 监听JMS消息
ESB 实时监听指定队列的消息

事件标识：必填，唯一值标识

事件名称：必填，接口的名称

所属产品：必填，只能选择状态为正常的产品；有ESB配置中心-产品管理权限的人员允许新建产品并引用

所属模块：必填，只能选择已选产品下的模块；有ESB配置中心-模块管理权限的人员允许新建模块并引用

所属资源：必填，只能选择类型一致的状态为正常的资源；有ESB配置中心-资源管理权限的人员允许新建模块并引用

消息模型：默认是 点对点，可以选择点对点、主题/订阅

客户端标识：必填，监听 JMS 消息的标识

队列/主题： 必填，输入JMS中的队列/主题名称

数据类型：默认是 TextMessage，可以选择TextMessage、MapMessage
备注：当数据类型为MapMessage时，隐藏数据格式设置项

数据格式：默认是Json，可以选择 Json、Xml
备注：当数据类型为MapMessage时，默认为Key-value

说明：监听JMS消息的说明性文字

1.3 监听AMQP消息
ESB 实时监听指定消息队列的消息

事件标识：必填，唯一值标识

事件名称：必填，接口的名称

所属产品：必填，只能选择状态为正常的产品；有ESB配置中心-产品管理权限的人员允许新建产品并引用

所属模块：必填，只能选择已选产品下的模块；有ESB配置中心-模块管理权限的人员允许新建模块并引用

所属资源：必填，只能选择类型一致的状态为正常的资源；有ESB配置中心-资源管理权限的人员允许新建模块并引用

Exchang名称：必填，输入AMQP中 Exchange的名称

队列：AMQP中的队列名（Queue）

绑定标识：必填，监听AMQP消息的标识。

数据格式：默认是Json，可以选择 Json、Xml

说明：监听AMQP消息的说明性文字

2. 发送数据
   异构系统调用 ESB ESB/API传递的数据内容、MQ 消息的内容
   
   配置规则和发送JMS消息的请求数据一致

3. 接收数据
   异构系统调用 ESB SDK/API，希望ESB 返回的数据内容
   
   业务触发的接受数据配置规则和发送数据一致

JMS和AMQP无响应数据配置

4. 完成
   
   完成：保存事件，事件状态为发布
   新建应用：保存事件，并以当前事件作为基础进入新建应用界面，应用的配置详见应用管理章节

3.4. 应用中心

3.4.1. 类别管理

需要权限：ESB应用中心-类别管理

基本功能介绍：
1、管理ESB中发布的应用分类
2、删除：只有类型不被引用时，才能被删除

基础信息设置：

类别标识：必填，唯一值标识

类别名称：必填，资源的名称

上级类别：可以选择已有的类别作为上级类别

描述：类别的描述性文字

显示顺序：必填，输入范围0~100的自然数

3.4.2. 常量管理

基本功能介绍：
1、 管理调用接口的固定参数，如接口的认证信息，在ESB调用具体接口时直接引用常量即可，不需要在每个接口配置中写死
2、常量包含正常、封存两种状态
 正常状态：可以被新建的应用、接口中的成功标识中引用。
 封存状态：不可被被新建的应用、接口中的成功标识中引用，但是不影响已有的功能正常使用。
3、 删除：只有常量不被引用时，才能被删除.

基础信息设置：

类别标识：必填，唯一值标识

类别名称：必填，资源的名称

所属产品：只能选择状态为正常的产品；有ESB配置中心-产品管理权限的人员允许新建产品并引用。没有填写时，默认为公共常量

常量类型：必填，可以选择：文本、密码、整数、浮点数、日期、时间

常量值：必填，根据常量类型的选择对输入内容有限制，对照表如下：

3.4.3. 转换管理

需要权限：ESB应用中心-转换管理

基本功能介绍：
1、用于不同接口之间的数据处理，如需要执行接口 A、B，A 接口返回用户名，执行B接口需传递用户ID。则可以在调用B接口时，将用户名传给转换规则，转换规则通过相关运算传递给B接口用户 ID，2.0实现了根据SQL转换接口、选项转换接口、自定义方法转换接口
2、转换规则包含正常、封存两种状态
 正常状态：可以被新建的应用、接口中的成功标识中引用。
 封存状态：不可被被新建的应用、接口中的成功标识中引用，但是不影响已有的功能正常使用。
3、删除：只有转换规则不被引用时，才能被删除

基础信息设置：

1. 执行SQL
   
   规则标识：必填，唯一值标识

规则名称：必填，接口的名称

所属产品：只能选择状态为正常的产品；有ESB配置中心-产品管理权限的人员允许新建产品并引用

所属模块：只能选择已选产品下的模块；有ESB配置中心-模块管理权限的人员允许新建模块并引用

所属资源：默认为空，使用OA本身的数据库。只能选择类型一致的状态为正常的资源；有ESB配置中心-资源管理权限的人员允许新建模块并引用。

SQL语句：必填，输入需要执行的SQL语句，可以输入参数名，格式为 ${type}
备注：

1. sql语句有正确性校验，只能输入查询语句。
2. 如果返回数据有多个字段、多条数据时，匹配的值是第一条数据的第一个值。

说明：执行SQL规则的说明性文字

转换规则参数：根据SQL语句中的参数名自动带出参数名称，参数类别、是否必须、明细数据根据实际情况配置

2. 调用接口
   
   规则标识：必填，唯一值标识

规则名称：必填，接口的名称

所属产品：只能选择状态为正常的产品；有ESB配置中心-产品管理权限的人员允许新建产品并引用

所属模块：只能选择已选产品下的模块；有ESB配置中心-模块管理权限的人员允许新建模块并引用

所属资源：默认为空，使用OA运行环境内的资源。只能选择类型一致的状态为正常的资源；有ESB配置中心-资源管理权限的人员允许新建模块并引用。

转换方法：必填，输入类文件路径，允许在线编辑自动生成类
备注：转换方法的类中必须实现public String execute(Map param)方法，转换规则参数名称作为 MAP 的 Key

说明：调用接口规则的说明性文字

转换规则参数：所有信息根据实际情况添加

3. 选项匹配
   将传入的数据与转换原始值比对，如相等返回对应的转换目标值
   
   规则标识：必填，唯一值标识

规则名称：必填，接口的名称

所属产品：只能选择状态为正常的产品；有ESB配置中心-产品管理权限的人员允许新建产品并引用

所属模块：只能选择已选产品下的模块；有ESB配置中心-模块管理权限的人员允许新建模块并引用

说明：选项匹配规则的说明性文字

转换规则参数：
 选项名称：选项别名，无实际意义
 转换原始值：需要被转换的原始值
 转换目标值：转换后的目标值

3.4.4. 应用管理

需要权限：ESB应用中心-应用管理

基本功能介绍：
1、每个应用由一个事件触发（配置中心注册的事件，系统标准事件（计划任务）），执行配置的接口。并返回事件中定义的接收数据。
2、应用管理包含禁用、启用两种状态
禁用：该应用被禁用，无法使用，此时可以把引用的事件、接口的状态变成维护状态
启用：该应用被启用，正常使用，此时不可以把引用的事件、接口的状态变成维护状态【只能变成封存状态】

基础信息设置：

1. 选择事件
   1.1 系统事件
   
   应用标识：必填，唯一值标识

应用名称：必填，接口的名称

所属类别：设置一个类别方便归类

说明：事件的说明性文字

1.2 普通事件

应用标识：必填，唯一值标识

应用名称：必填，接口的名称

所属类别：设置一个类别方便归类

异步执行：默认关闭，一个事件只允许有一个同步执行的应用
 异步执行的应用：无需配置事件的返回数据
说明：异步执行的应用会在新的线程中执行，触发后立即返回触发源，触发源无法得知应用是否执行成功
 同步执行的应用：需要配置事件的返回数据
说明：同步执行的应用会阻止触发源向下执行，直至执行完成

说明：事件的说明性文字

2. 选择接口：
   2.1 系统事件
   
   选择接口：必填，需要从浏览按钮中选择至少一个接口

执行标识：必填，唯一值标识

异步执行：默认关闭。开启后，接口的执行结果不能作为其他服务的配置映射数据

2.2 普通事件

3. 接口配置：
   3.1 系统事件
   
   可以设置接口的执行条件、是否多次执行

执行条件：
符合条件的接口才会执行，默认无条件执行

执行条件的设置逻辑与接口设置中的成功标识基本一致【详见4.1调用Rest接口】

多次执行：

上下文数据：只能选择运行级别比当前接口小的状态为同步运行的接口或当前接口请求数据中数组类型的参数，根据选中的上下文数组的长度，多次执行接口，每次执行可以传递上下文数据对应下标的数据

接口：只能选择运行级别比当前接口小的状态为同步运行的接口，选中的接口多少次，该接口即执行多少次。每次执行可以获取选中接口对应次数的上下文数据

对已有的设置允许进行重置：

3.2 普通事件
和系统事件一致

4. 数据映射：
   4.1 系统事件
   
   对设置的接口的请求参数进行设置对应关系

映射内容：分为 空、固定值、上下文、转换规则、常量、执行接口
空：是否必须状态为否的参数才能选此项
固定值：设置固定值
系统变量：选择预设的系统变量
上下文：从事件的发送数据、运行级别比当前接口小的状态为同步运行的接口的请求数据、响应数据中获取参数内容
转换规则：选择转换规则中的配置，此时需要设置匹配参数【匹配参数的获取逻辑和上下文一致】
执行接口：明细数据为是的参数才能选此项，只能选择运行级别比当前接口小的状态为同步运行的接口

常量：选择常量中的配置

4.2 普通事件
和系统事件一致

5. 响应配置：
   5.1 系统事件
   
   设置一个计划任务
   5.2 普通事件
   
   设置方式与数据映射基本一致

6. 完成
   6.1 系统事件
   
   在集成中心自动生成一个计划任务，计划任务的状态和应用保持一致
   应用默认禁用状态

6.2 普通事件
应用默认禁用状态

7.测试
7.1 系统事件

7.2 普通事件