配置 InterChange Server

对于 WebSphere Partner Gateway 和 InterChange Server 之间的交互,您必须在“系统管理器”工具中创建一个“集成组件库(ICL)”。该 ICL 将包含以下构件:

还必须创建一个用户产品,并且从 ICL 中选择在 InterChange Server 和 WebSphere Partner Gateway 之间进行特定交互所需的那些构件。

注: 要获取更多有关如何创建 ICL 和配置 InterChange Server 的信息,请参阅 WebSphere InterChange Server 文档集中的系统实施指南

创建业务对象定义

WebSphere Partner Gateway 将您的消息发送到适配器,该适配器然后以一个或多个业务对象的形式将其路由到 InterChange Server。为使 InterChange Server 能识别该业务对象,它必须首先找到一个模板(名为业务对象定义)以描述该业务对象中消息的结构。业务对象定义中的每条信息都保存在属性中。因此,必须创建业务对象定义以表示消息中的信息。要创建业务对象定义,请使用“业务对象设计器”工具。

注: “业务对象设计器”包含在 WebSphere InterChange Server 和 WebSphere Business Integration Adapter 产品中。有关如何使用该工具的更多信息,请参阅业务对象开发指南

InterChange Server 使用业务对象来保存以下信息:

用于文档的业务对象

要保存WebSphere Partner Gateway 文档或消息的有效内容 ,您必须定义一个业务对象定义以描述负载业务对象。 适配器以有效内容业务对象的形式与 InterChange Server 相互传输文档。本部分提供了下列关于有效内容业务对象的信息:

业务对象结构

必须设计有效内容业务对象,以便您要传输的文档中的每条信息在其相关联的有效内容业务对象定义中都有一个属性。 如表 30 所示,有效内容业务对象内容取决于文档结构和文档所用的封装类型。

表 30. 封装与有效内容业务对象结构的关系
文档结构 封装类型 有效内容业务对象定义
仅限有效内容 保存文档的有效内容信息。
仅限有效内容 后端集成

包含:

  • 文档的有效内容信息
  • 传输层消息头
有效内容和附件 不适用。如果文档包含附件则必须使用“后端集成”封装类型。
有效内容和附件

文档包含 XML 名为传输包络的包装器,其中包装了有效内容和附件。

后端集成

包含:

  • 文档的有效内容信息
  • 传输层消息头
  • 附件容器,它包含附件数据和任何附件业务对象

WebSphere Partner Gateway 提供了名为“附件数据处理程序”的数据处理程序,在处理传输包络时这是必需的。要了解更多信息,请参阅处理带附件的文档

还必须根据用于与 WebSphere Partner Gateway 集成的特定适配器的需求来设计有效内容业务对象。表 31 提供了关于在何处可以找到有关创建有效内容业务对象的详细信息,以使用特定的传输协议进行传输。

表 31. 为不同的传输协议创建有效内容业务对象
传输协议 注意事项和限制 了解更多信息
HTTP 为使用 HTTP 的 ICS 创建业务对象定义
JMS 如果文档使用“后端集成”封装类型 创建 JMS 的业务对象定义
全部 如果文档有附件 创建与附件关联的业务对象定义
业务对象变换

通常,适配器使用数据处理程序在文档格式和文档的业务对象表示之间进行转换。 该数据处理程序名为有效内容数据处理程序。 必须配置适配器以调用与有效内容内容类型相对应的数据处理程序。通常,由于用于 XML 的 WebSphere Business Integration 使 XML 消息和业务对象间进行相互转换,因此将它配置成有效内容数据处理程序。然而,您可以为任何消息格式创建定制的数据处理程序,WebSphere Business Integration Server 没有为它们提供相应数据处理程序。

注: 对于 XML 消息的处理,请确保您正在使用 WebSphere Business Integration Data Handler for XML V2.3.1 或更高版本。对于 cXML 消息,您必须使用 Data Handler for XML V2.4.1 或更高版本。

您必须确保所使用的有效内容数据处理程序可以忽略您正使用的传输协议所需的子元对象。在使用数据处理程序(不管它是由 WebSphere Business Integration 提供还是一个定制的数据处理程序)之前,请确保它提供了对子元对象的支持。请参阅关于业务对象的特定于应用程序信息中的 cw_mo_label 标记,在针对传输协议相应的章节中讲述了该信息(请参阅表 31)。

要指出使用哪种数据处理程序来转换有效内容,必须采取下列步骤:

  1. 标识数据处理程序为转换有效内容而必须支持的 MIME 类型并查找可以处理该 MIME 类型的数据处理程序。

    在 WebSphere Business Integration Adapter 文档集的数据处理程序指南中描述了 IBM 提供的数据处理程序。如果这些数据处理程序都不适用,那么可以创建一个定制的数据处理程序。

  2. 在“业务对象设计器”里,为您需要使用的数据处理程序创建一个子元对象。如果您正在使用 IBM 提供的数据处理程序, 请参阅数据处理程序指南以获取关于子元对象结构的信息。
  3. 在“业务对象设计器”里,更新连接器的顶级数据处理程序元对象以包含受支持的 MIME 类型的属性。 该属性的属性类型是数据处理程序的子元对象。
  4. 在“连接器适配器”里,设置相应的连接器配置属性以标识要使用的数据处理程序:
    注: 可以设置 DataHandlerConfigMODataHandlerMimeType 属性,也可以设置 DataHandlerClassName 属性。
  5. 在“连接器配置器”里,在受支持的业务对象列表中包含顶级数据处理程序元对象。
InterChange Server 术语

对于 InterChange Server,有效内容业务对象的名称取决于通信的方向,如下所示:

用于配置信息的业务对象

对于许多适配器,您创建业务对象定义来保存配置信息。这样的业务对象通常被称为元对象

至于如何创建数据业务对象,以通过某个特定的传输协议进行传输,表 32 提供了有关在何处查找此类详细说明的信息。

表 32. 以下部分描述了业务对象的创建
传输协议 相关组件 了解更多信息
HTTP Adapter for HTTP 为 ICS 创建 HTTP 传输级头信息
JMS Adapter for JMS 创建 JMS 头信息
全部 附件数据处理程序 创建附件子元对象

创建连接器

您必须为即将使用的适配器创建连接器对象。这个连接器对象表示适配器在运行时的一个实例。您可以在InterChange Server 的“系统管理器”工具中创建连接器对象。

注: 有关如何创建连接器对象的信息,请参阅 WebSphere InterChange Server 文档集中的系统工具指南

表 33 概括了何处可发现有关如何创建连接器对象的信息,基于您正在使用的传输协议。

表 33. 创建用于不同传输协议的连接器对象
传输协议 适配器 了解更多信息
HTTP Adapter for HTTP 创建 HTTP 连接器对象
JMS Adapter for JMS 创建 JMS 连接器对象

创建协作

在 InterChange Server 中,由协作执行所需的实际业务流程。因此,要使 InterChange Server 能正确处理您的 WebSphere Partner Gateway 文档,相应的协作必须存在。请务必执行下列步骤,以便在运行时能使用相应的协作:

  1. 确保有能提供您所需业务流程的协作模板:
  2. 创建协作对象并绑定其端口,如下所示:

表 34 总结了根据正在使用的传输协议去何处查找关于如何创建连接器对象的信息。

表 34. 针对不同传输协议的协作绑定
传输协议 适配器 了解更多信息
HTTP Adapter for HTTP 绑定协作以与 Adapter for HTTP 进行通信
JMS Adapter for JMS 绑定协作以与 Adapter for JMS 通信

部署项目

在您的用户项目包含了定义运行时组件所需的构件之后,您必须将它部署到 InterChange Server 存储库。 您要用“系统管理器”部署一个用户项目。

Copyright IBM Corp. 2003, 2005