RosettaNet 文档

本部分概述了 RosettaNet 文档,并演示了如何为这些文档设置文档流定义和交互。

概述

RosettaNet 是一个为支持贸易伙伴之间进行业务消息交换而提供开放标准的组织。 有关 RosettaNet 的更多信息,请参阅http://www.rosettanet.org。这些标准中包括 RosettaNet 实现框架(RosettaNet Implementation Framework,RNIF)规范以及合作伙伴接口过程(Partner Interface Process,PIP)规范。 RNIF 通过提供一个消息封装、传输协议和安全性的框架,来定义贸易伙伴如何交换消息。 RNIF 有两个发行版: 1.1 和 2.0。PIP 定义了一个公共业务流程以及支持该流程的基于 XML 的消息格式。

WebSphere Partner Gateway 支持使用 RNIF 1.1 和 2.0 进行 RosettaNet 消息传递。 当中心接收 PIP 消息时,会验证并转换该消息,以将其发送到相应的后端系统。WebSphere Partner Gateway 提供协议,用于将已转换的消息封装成后端系统可处理的 RosettaNet 服务内容(RosettaNet Service Content,RNSC)消息。请参阅企业集成指南,了解如何对这些消息进行封装以提供路由信息。

中心还可以接收来自后端系统的 RNSC 消息,然后创建相应的 PIP 消息并将其发送给 相应的贸易伙伴(参与者)。 您要为所使用的 RNIF 版本和 PIP 提供文档流定义。

除了能够路由 RosettaNet 消息之外,WebSphere Partner Gateway 还维护其处理的每条消息的状态。 这使得它能够重新发送任何失败的消息,直至尝试次数达到指定的阈值为止。 “事件通知”机制在无法传递 PIP 消息时会向后端系统报警。另外,中心在收到来自后端系统的某些“事件通知”时会 自动生成 0A1 PIP,以将其发送至相应的参与者。 请参阅企业集成指南,了解关于“事件通知”的更多信息。

RNIF 和 PIP 文档流包

为支持 RosettaNet 消息传递,WebSphere Partner Gateway 提供了两组称为包的压缩文件。RNIF 包支持 RNIF 协议的文档流定义组成。这两个包位于 B2BIntegrate 目录下。

对于 RNIF V1.1,包是:

对于 RNIF V02.00,包是:

这一对包中的第一个提供与参与者进行 RosettaNet 通信所需的文档流定义, 第二个提供与后端系统进行 RosettaNet 通信所需的文档流定义。

第二组包由 PIP 文档流包组成。 每个 PIP 文档流包都有包含一个 XML 文件的 Packages 目录和包含 XSD 文件的 GuidelineMaps 目录。 XML 文件指定文档流定义,它们定义 WebSphere Partner Gateway 如何处理 PIP,并定义所交换的消息和信号。XSD 文件指定 PIP 消息的格式,并定义消息中 XML 元素的可接收值。0A1 PIP 的压缩文件还包含一个 XML 文件,中心将该文件作为模板来创建 0A1 文档。

WebSphere Partner Gateway 提供 PIP 文档流包的 PIP 是:

对于每个 PIP,有四个 PIP 文档流包:

每个 PIP 文档流包都遵循一个特定的命名约定, 您可以用它来标识包是用于 WebSphere Partner Gateway 和参与者之间的消息, 还是用于 WebSphere Partner Gateway 和后端系统之间的消息。命名约定还标识包支持的 RNIF 版本、PIP 和 PIP 版本。 用于 WebSphere Partner Gateway 和参与者之间消息传递的 PIP 文档流包的格式是:

BCG_Package_RNIF<RNIF_version>_<PIP><PIP_version>.zip

用于 WebSphere Partner Gateway 和后端系统之间消息传递的 PIP 文档流包的格式是:

BCG_Package_RNSC<Backend_Integration_version>_RNIF<RNIF_version>_
 <PIP><PIP_version>.zip

例如,BCG_Package_RNIF1.1_3A4V02.02.zip 用于验证使用 RNIF 1.1 协议在参与者和 WebSphere Partner Gateway 之间 发送的 3A4 PIP V02.02 的文档。 对于与后端系统进行通信的 PIP 文档流包,包名还必须标识向后端系统发送 RosettaNet 内容所用的协议。 请参阅企业集成指南,以了解有关用于这些消息的封装信息。

创建文档流定义

为进行 RosettaNet 消息传递,WebSphere Partner Gateway 需要 RNIF 包用于发送消息所用的 RNIF 版本。 对于 WebSphere Partner Gateway 支持的每个 PIP,它需要将两个 PIP 文档流包用于 RNIF 版本。 例如,为支持采用 RNIF 2.0 的 3A4 PIP,WebSphere Partner Gateway 需要下列包:

第一个包支持与参与者之间进行 RosettaNet 消息传递, 第二个包支持与后端系统进行 RosettaNet 消息传递。 第三个包和第四个包支持 WebSphere Partner Gateway 在参与者和后端系统之间使用 RNIF 2.0 传递 3A4 消息。

要上载 RosettaNet 包:

  1. 单击中心管理 > 中心配置 > 文档流定义
  2. 单击上载/下载包
  3. WSDL 包选择
  4. 单击浏览,然后选择 RNIF 包,以与参与者通信。

    缺省情况下,RNIF 包位于安装介质上的 B2BIntegrate/Rosettanet 目录中。 例如,如果上载 RNIF V2.00 包,则应浏览到 B2BIntegrate/Rosettanet 目录并选择:Package_RNIF_V0200.zip。

  5. 落实到数据库设置成
  6. 单击上载
  7. 再次单击浏览,然后选择 RNIF 包,以与后端应用程序通信。

    例如,如果上载 RNIF V2.00 包,则应浏览到 B2BIntegrate/Rosettanet 目录并选择:Package_RNSC_1.0_RNIF_V02.00.zip。

  8. 单击上载

    现在,在系统上安装了与参与者或后端系统进行通信所需的包。 如果选中“管理文档定义”页面,会看到包:RNIF/协议:RosettaNet 项(这表示用于与参与者通信的封装) 和 包:后端集成/协议:RNSC 项(这表示用于与后端应用程序通信的封装)。

  9. 对于要支持的每个 PIP,请上载用于您支持的 PIP 和 RNIF 版本的 PIP 文档流包。 例如,要上载 3A6 PIP(汇款通知)以发送到参与者,请执行下列步骤:
    1. 单击浏览,然后从 B2BIntegrate/Rosettanet 目录选择 BCG_Package_RNIFV02.00_3C6V02.02。
    2. 落实到数据库设置成
    3. 单击上载

    现在,3C6V02.02 PIP 作为文档流出现在“管理文档定义”页面上包:RNIF/协议:RosettaNet 的下面。 还显示了活动、操作和两个信号。它们包括在 PIP 的上载中。

    要上载 3A6 PIP 以发送到后端应用程序,请执行下列步骤:

    1. 单击浏览,然后选择 BCG_Package_RNSC1.0_RNIFV02.00_3C6V02.02.zip。
    2. 落实到数据库设置成
    3. 单击上载

    现在,3C6V02.02 PIP 作为文档流出现在“管理文档流定义”页面上包:后端集成/协议:RNSC 的下面。

    如果 WebSphere Partner Gateway 没有为您想使用的 PIP 或 PIP 版本提供包,您可以创建自己的包并上载它。 请参阅创建 PIP 文档流包以了解更多信息。

配置属性值

对于 PIP 文档流定义,大多数属性的值都已设置,无需配置。 但是,您需要设置以下属性:

RNIF(1.0)包

RNIF(V02.00)包

请注意,WebSphere Partner Gateway 为其提供了 PIP 文档流包的 PIP 不支持同步交换。 因此,您无需更改这些 PIP 的“需要同步确认”和“支持同步”属性。

注: 单向 PIP 和双向 PIP 的“需要同步确认”属性的行为有区别。 对于双向 PIP,当把“需要同步确认”设置成“否”时,该设置优先于设置成“是”的“NonRep of Rec”。例如,假设您发送具有以下设置的 3A7:

对于双向 PIP,您会收到一条关于该入站文档的错误消息。 但是,对于单向 PIP,您将在控制台看到接收的文档,返回给参与者 OKB 200。

要设置属性,请执行下列步骤:

  1. 单击中心管理 > 中心配置 > 文档流定义
  2. 单击展开图标以将节点逐次展开至相应的文档流定义级别,或选择全部以展开所有已显示的文档流定义节点。
  3. 操作列中,对于您希望编辑的包(例如,包:RNIF(1.1)或包:RNIF(V02.00)), 单击编辑属性值图标。
  4. 文档流上下文属性部分,转至要设置的属性的更新列, 选择或输入新值。对每个要设置的属性,重复以上步骤。
  5. 单击保存

注: 您还可以在连接级别更新 RosettaNet 属性,具体操作如下:单击源或目标的属性, 然后在更新列中输入或更改值。请参考指定或更改属性

创建交互

以下过程描述如何创建后端系统和参与者之间的交互。请注意,您必须为每个要发送的 PIP 创建一个交互,为每个要接收的 PIP 也创建一个交互。

开始之前,请确保已上载了合适的 RNIF 文档流定义和要使用的 PIP 的包。 如果要能够生成 0A1 PIP(故障通知),请确保上载了该 PIP,如步骤 9 中所述。

要创建特定 PIP 的交互,请执行下列步骤:

  1. 单击中心管理 > 中心配置 > 文档流定义
  2. 单击管理交互
  3. 单击创建交互
  4. 树展开至操作级别, 并将目标树展开至操作级别。
  5. 在树结构中,选择用于源上下文和目标上下文的文档流定义。 例如,如果参与者是 3C6 PIP(由一个操作组成的 PIP)的发送方,则选择以下文档流定义:
    表 5. 由参与者发送的 3C6 PIP
    目标
    包:RNIF(V02.00) 包:后端集成(1.0)
    协议:RosettaNet(V02.00) 协议:RNSC(1.0)
    文档流:3C6(V01.00) 文档流:3C6(V01.00)
    活动:汇款通知 活动:汇款通知
    操作:汇款通知操作 操作:汇款通知操作

    如果后端系统是 3C6 PIP 的发送方,则选择以下文档流定义:

    表 6. 由后端系统发送的 3C6 PIP
    目标
    包:后端集成(1.0) 包:RNIF(V02.00)
    协议:RNSC(1.0) 协议:RosettaNet(V02.00)
    文档流:3C6(V01.00) 文档流:3C6(V01.00)
    活动:汇款通知 活动:汇款通知
    操作:汇款通知操作 操作:汇款通知操作

    对于由两个操作组成的 PIP(如参与者发送的 3A4),为第一个操作选择下列文档流定义:

    表 7. 参与者发送的 3A4 PIP
    目标
    包:RNIF(V02.00) 包:后端集成(1.0)
    协议:RosettaNet(V02.00) 协议:RNSC(1.0)
    文档流:3A4(V02.02) 文档流:3A4(V02.02)
    活动:请求采购订单 活动:请求采购订单
    活动:采购订单请求操作 活动:采购订单请求操作

    如果后端系统发送由两个操作组成的 3A4 PIP,则为第一个操作选择下列文档流定义:

    表 8. 后端系统发送的 3A4 PIP
    目标
    包:后端集成(1.0) 包:RNIF(V02.00)
    协议:RNSC(1.0) 协议:RosettaNet(V02.00)
    文档流:3A4(V02.02) 文档流:3A4(V02.02)
    活动:请求采购订单 活动:请求采购订单
    活动:采购订单请求操作 活动:采购订单请求操作
  6. 在“操作”字段中,选择带验证的 RosettaNet 与 RosettaNet 服务内容的双向转换
  7. 单击保存
  8. 如果您正在设置由两个操作组成的 PIP,则重复为第二个操作创建交互所需的步骤。 例如,对于参与者发送的 3A4 PIP,对第二个操作选择下列文档流定义。 这是后端系统用于发送响应的操作。
    表 9. 参与者发送的 3A4 PIP(第二个操作)
    目标
    包:后端集成(1.0) 包:RNIF(V02.00)
    协议:RNSC(1.0) 协议:RosettaNet(V02.00)
    文档流:3A4(V02.02) 文档流:3A4(V02.02)
    活动:请求采购订单 活动:请求采购订单
    活动:采购订单确认操作 活动:采购订单确认操作

    对于后端系统发送的 3A4 PIP,为第二个操作选择下列文档流定义:

    表 10. 后端系统发送的 3A4 PIP(第二个操作)
    目标
    包:RNIF(V02.00) 包:后端集成(1.0)
    协议:RosettaNet(V02.00) 协议:RNSC(1.0)
    文档流:3A4(V02.02) 文档流:3A4(V02.02)
    活动:请求采购订单 活动:请求采购订单
    活动:采购订单确认操作 活动:采购订单确认操作
  9. 如果要生成 0A1 故障通知,则为 XMLEvent 创建一个交互。
    1. 单击中心管理 > 中心配置 > 文档流定义
    2. 单击管理交互
    3. 单击创建交互
    4. 树展开至文档流级别, 并将目标树展开至文档流级别。
    5. 选择下列文档流定义:
      表 11. XML 事件文档流定义
      目标
      包:后端集成(1.0) 包:后端集成(1.0)
      协议:XMLEvent(1.0) 协议:XMLEvent(1.0)
      文档流:XMLEvent(1.0) 文档流:XMLEvent(1.0)
    6. 在“操作”字段中,选择传递
    7. 单击保存
  10. 创建 XMLEvent 到 0A1 RNSC 的交互。
    1. 单击中心管理 > 中心配置 > 文档流定义
    2. 单击管理交互
    3. 单击创建交互
    4. 树展开至文档流级别, 并将目标树展开至活动级别。
    5. 选择下列文档流定义:
      表 12. XML 事务到 0A1 文档流定义
      目标
      包:后端集成(1.0) 包:后端集成(1.0)
      协议:XMLEvent(1.0) 协议:RNSC(1.0)
      文档流:XMLEvent(1.0) 文档流:0A1 (V02.00)
      活动:分发失败通知。
    6. 在“操作”字段中,选择带验证的 RosettaNet 和 XML 的双向转换
    7. 单击保存

Copyright IBM Corp. 2003, 2005