用处理程序配置文档处理组件

本部分较为详细地描述了 WebSphere Partner Gateway 的组件,并向您显示了在什么时候可以(或必须)更改系统提供的组件行为以处理业务文档。

可以使用处理程序来更改目标、网关、固定工作流步骤以及操作的系统提供行为。 处理程序有两种 — 一种是 WebSphere Partner Gateway 提供的,另一种是用户定义的。如果您希望获取关于创建处理程序的信息,请参阅程序员指南

创建处理程序之后,上载它,以使之可用。 您只上载用户定义的处理程序。WebSphere Partner Gateway 提供的处理程序已经可以使用。

接下来几部分描述您可以指定处理程序的处理点。

目标

目标有三个为处理程序指定的配置点 - “预处理”、“同步检查”和“后处理”。

图 8. 目标配置点
本图显示了文档在被“文档管理器”接收之前如何经历“预处理”和“同步检查”步骤,以及如何在同步事务中对来自“文档管理器”的响应可选地使用“后处理”步骤

处理按以下顺序进行:

  1. “接收器”在接收文档之后,调用“预处理”和“同步检查”步骤。
  2. 然后,它调用“文档管理器”来处理文档。
  3. 在同步流情况下,“文档管理器”提供同步响应。 然后,“接收器”调用“后处理”步骤,并从“文档管理器”返回响应。

下列几部分中描述了这些步骤:

文档管理器

“文档管理器”会从通用文件系统中获取目标所接收的文档以供进一步处理。“文档管理器”使用参与者连接来路由文档。 所有流经“文档管理器”的文档都会经过一系列的工作流:固定的入站工作流、可变的工作流和固定的出站工作流。在入站工作流的末端,会确定参与者连接。参与者连接执行在该文档上要执行的操作。在执行可变工作流之后,“文档管理器”会在该文档上执行固定的出站工作流。

图 9. 固定工作流和操作
本图显示了文档从入站固定工作流步骤开始、经过操作、最后达到出站固定工作流步骤的流程

图 9显示了文档(如 RosettaNet PIP 或 Web Service)将采用的路径。 但是,某些文档需要几个已配置的流。例如,EDI 交换可以由多个事务组成。 第一个流使用某个操作来解包一组单独事务。 其中的每个事务都在其自己的已配置流中重新引入并处理。

图 10. EDI 交换的固定工作流和操作
本图显示了固定入站工作流如何处理 EDI 交换以及解包操作如何创建由固定入站工作流预处理的多个事务。

入站固定工作流

入站固定工作流由一组标准处理步骤组成, 对所有从“接收器”进入“文档管理器”的文档都会执行这些步骤。工作流是固定的,因为步骤数和类型始终是相同的。 但是,通过用户出口,可以为处理下列步骤提供定制的处理程序:协议解包和协议处理。入站固定工作流的最后一步执行参与者连接查找,这可以确定对该业务文档执行的可变工作流。

例如,如果收到 AS2 消息,则对消息进行解密并检索发送方和接收方的企业标识。入站固定工作流步骤将 AS2 文档转换成明文以供 WebSphere Partner Gateway 进一步处理,并抽取信息以确定对消息采取的操作。

图 11. 入站固定工作流步骤
本图显示了在入站固定工作流中流经“协议解包”步骤和“协议处理”步骤的文档流
协议解包

在协议解包期间,会对文档进行解包,以便对它进一步处理。该过程可以包括解密、解压缩、签名验证、抽取路由信息、用户认证或业务文档部件抽取。

WebSphere Partner Gateway 提供 RNIF、AS、“后端集成”和“无”封装的处理程序。如果需要其他封装类型的处理程序,则可以将它们作为用户出口开发。 请参阅编程指南以获取有关编写用户出口的信息。

您不能修改“协议解包”步骤;但是,您可以通过添加处理程序来向该步骤添加业务逻辑。

请参阅配置固定工作流,以获取有关配置该步骤的信息。

协议处理处理程序

“协议处理”涉及确定特定于协议的信息,这可能包括对消息进行解析, 以确定路由信息(如发送方标识和接收方标识)、协议信息和文档流信息。WebSphere Partner Gateway 提供了各种协议的处理,如协议处理处理程序所列。 其他协议的处理 - 例如,CSV(用逗号分隔的值)- 可以与用户出口一起提供。

您不能修改“协议处理”步骤;但是,您可以通过添加处理程序来向该步骤添加业务逻辑。

请参阅配置固定工作流,以获取有关配置该步骤的信息。

您可以使用适用于文档协议的缺省处理程序, 或者也可以为“协议解包”和“协议处理”固定工作流步骤指定其他处理程序。

操作

处理序列中的下一步是根据为文档交换所设置的操作进行的。 操作中包含了各种可对文档执行的步骤。操作示例有:验证文档(以便它符合特定的规则集)以及将文档转换成收件人所需的格式。

如果文档不需要特定的步骤,则可以使用系统提供的“传递”操作,该操作不会对文档进行更改。

图 12. 操作步骤
本图显示了操作如何具有可变的步骤数

您不能修改系统提供的操作。但是,您可以创建操作(并将处理程序添加到已配置的列表中)或复制系统提供的操作, 然后修改处理程序列表。

请参阅配置操作以获取有关创建或复制系统提供的操作或配置用户定义的操作的信息。

出站固定工作流

出站固定工作流包括了一个步骤 — 对文档及其协议信息进行封装。例如,如果已将文档设置成由使用后端集成封装的后端应用程序接收,则会在将该文档传递到网关之前向它添加特定的头信息。

图 13. 出站固定工作流步骤
本图显示了文档在被传递之前如何通过协议封装步骤

WebSphere Partner Gateway 提供了针对各种包和协议的处理程序,如出站工作流所列。如果需要其他封装处理程序,则可以将它们作为用户出口步骤开发。 通常,这些步骤处理下列一个或多个过程:

您不能修改“协议封装”步骤;但是,您可以通过添加处理程序来向该步骤添加业务逻辑。

请参阅配置固定工作流以获取有关配置该工作流步骤的信息。

网关

在文档离开“文档管理器”之后,会将它从网关发送到指定的收件人。网关有两个配置点 — 预处理和后处理。

图 14. 网关配置点
本图显示了文档在被传递之前如何通过“预处理”步骤以及在传递之后和有选择地使用“后处理”步骤

请参阅配置处理程序以获取有关配置预处理和后处理步骤的信息。

Copyright IBM Corp. 2003, 2005