RosettaNet 文件

本節提供 RosettaNet 文件概觀,並教您如何設定文件流程定義和這些文件的互動。

概觀

RosettaNet 為一個組織,它提供開放式標準以支援各交易夥伴間的商業訊息交換。有關 RosettaNet 的詳細資訊, 請見 http://www.rosettanet.org。這些標準包括「RosettaNet 實作架構 (RosettaNet Implementation Framework, RNIF)」 和「夥伴介面程序 (Partner Interface Process, PIP)」等規格。 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)」訊息, 讓後端系統可以處理。 有關為了提供遞送資訊而對這些訊息所用的包裝方式說明, 請參閱 Enterprise Integration Guide

中心也可接收後端系統傳來的 RNSC 訊息, 並建立適當的 PIP 訊息,然後將訊息傳給適當的交易夥伴(參與者)。您將提供您要使用的 RNIF 版本和 PIP 的文件流程定義。

除了提供 RosettaNet 訊息的遞送功能外, WebSphere Partner Gateway 會維護它所處理之每一個訊息的狀態。這可讓它重送任何失敗的訊息, 直到嘗試次數已達指定的臨界值為止。如果 PIP 訊息無法遞送,「事件通知」機制會警示後端系統。 此外,當中心收到後端系統傳來的某些「事件通知」訊息時, 它會自動產生 0A1 PIP,以傳給適當的參與者。有關「事件通知」的進一步資訊, 請參閱 Enterprise Integration Guide

RNIF 和 PIP 文件流程資料包

為了支援 RosettaNet 傳訊,WebSphere Partner Gateway 提供兩組名為資料包的 ZIP 檔。RNIF 資料包 由一些支援 RNIF 通訊協定所需的文件流程定義組成。 這些資料包位於 B2BIntegrate 目錄。

以 RNIF V1.1 來說,資料包為:

以 RNIF V02.00 來說,資料包為:

每一對中第一個資料包所提供的文件流程定義, 是支援和參與者間進行 RosettaNet 通訊所需, 第二個資料包所提供的文件流程定義, 則是支援和後端系統間進行 RosettaNet 通訊所需。

第二組資料包由 PIP 文件流程資料包組成。每一個 PIP 文件流程資料包各有一個 Packages 目錄(內含一個 XML 檔)和一個 GuidelineMaps 目錄(內含 XSD 檔)。XML 檔是指定文件流程定義, 以定義 WebSphere Partner Gateway 如何處理 PIP, 以及定義所交換的訊息和信號。XSD 檔是指定 PIP 訊息的格式, 以及定義訊息中之 XML 元素的有效值。0A1 PIP 的 ZIP 檔也有一個 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 02.02 版文件。如果是用於和後端系統通訊的 PIP 文件流程資料包, 則資料包名稱也必須識別當傳送 RosettaNet 內容給後端系統時所用的通訊協定。有關這些訊息所用的包裝方式說明, 請參閱 Enterprise Integration Guide

建立文件流程定義

為了進行 RosettaNet 傳訊, WebSphere Partner Gateway 需使用傳送訊息時所用之 RNIF 版本的 RNIF 資料包。以 WebSphere Partner Gateway 所支援的每一項 PIP 來說, 它會要求 RNIF 版本需有兩個 PIP 文件流程資料包。舉例來說, 若要支援經由 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 2.00 資料包,請瀏覽至 B2BIntegrate/Rosettanet 目錄,並選取 Package_RNIF_V0200.zip。

  5. 確定確定到資料庫是設為
  6. 按一下上傳
  7. 再按一下瀏覽,並選取和後端應用程式通訊時所要使用的 RNIF 資料包。

    比方說,如果您要上傳的是 RNIF 2.00 資料包, 請瀏覽至 B2BIntegrate/Rosettanet 目錄,並選取 Package_RNSC_1.0_RNIF_V02.00.zip。

  8. 按一下上傳

    此時,和參與者或後端系統通訊時所需使用的資料包已安裝在系統中。如果您檢查「管理文件定義」頁面, 您會看到資料包:RNIF/通訊協定:RosettaNet 項目(代表和參與者通訊時所用的包裝方式) 和資料包:後端整合/通訊協定:RNSC 項目(代表和後端應用程式通訊時所用的包裝方式)。

  9. 針對每一項您想支援的 PIP, 上傳您想支援之 PIP 和 RNIF 版本的 PIP 文件流程資料包。 例如,若要上傳 3A6 PIP (Notify of Remittance Advice),以傳給某個參與者,請執行下列步驟:
    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 來說, 當「需要同步確認」設為「否」,此設定會比「回條的無可否認性」設為「是」優先採用。舉例來說, 假設您傳送內含下列設定的 3A7:

以雙向 PIP 來說,您會在送入的文件中收到錯誤訊息。不過, 在單向 PIP 中,您會在主控台中看到送入的文件,且會傳回 0KB 200 給參與者。

若要設定屬性,請執行下列步驟:

  1. 按一下中心管理 > 中心配置 > 文件流程定義
  2. 按一下展開圖示,個別將某個節點展開到適當的文件流程定義層次, 或選取全部,展開所有顯示的文件流程定義節點。
  3. 動作直欄中,按一下您想編輯之資料包 (如「資料包:RNIF (1.1)」或「資料包:RNIF (V02.00)」)的編輯屬性值圖示。
  4. 文件流程環境定義屬性區段中,移至您想設定之屬性的更新直欄, 並選取(或輸入)新值。針對您想設定的每一個屬性,重複此步驟。
  5. 按一下儲存

註: 您也可以更新連線層次的 RosettaNet 屬性, 做法是按一下來源或目標的屬性, 然後在更新直欄中輸入或變更值。相關資訊請參閱指定或變更屬性

建立互動

下列程序說明如何在後端系統和參與者間建立互動。請注意, 您必須為每一個您想傳送的 PIP 以及為您想接收的 PIP, 各建一項互動。

開始之前請確定您已上傳適當的 RNIF 文件流程定義, 以及已上傳您想使用之 PIP 的資料包。 如果您希望能夠產生 0A1 PIP (Notification of Failure),請確定您已上傳該 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)
    活動:Request Purchase Order 活動:Request Purchase Order
    動作:「要求採購單」動作 動作:「要求採購單」動作

    如果雙動作 3A4 PIP 的起始者是後端系統,請針對第一個動作選取下列的文件流程定義:

    表 8. 由後端系統起始的 3A4 PIP
    來源 目標
    資料包:後端整合 (1.0) 資料包:RNIF (V02.00)
    通訊協定:RNSC (1.0) 通訊協定:RosettaNet (V02.00)
    文件流程:3A4 (V02.02) 文件流程:3A4 (V02.02)
    活動:Request Purchase Order 活動:Request Purchase Order
    動作:「要求採購單」動作 動作:「要求採購單」動作
  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)
    活動:Request Purchase Order 活動:Request Purchase Order
    動作:「確認採購單」動作 動作:「確認採購單」動作

    在後端系統起始之 3A4 PIP 的第二個動作方面, 請選取如下的文件流程定義:

    表 10. 由後端系統起始的 3A4 PIP(第二個動作)
    來源 目標
    資料包:RNIF (V02.00) 資料包:後端整合 (1.0)
    通訊協定:RosettaNet (V02.00) 通訊協定:RNSC (1.0)
    文件流程:3A4 (V02.02) 文件流程:3A4 (V02.02)
    活動:Request Purchase Order 活動:Request Purchase Order
    動作:「確認採購單」動作 動作:「確認採購單」動作
  9. 如果您想產生 0A1 Notification of Failure,請建立 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)
      活動:Distribute Notification of Failure
    6. 在「動作」欄位中, 選取RosettaNet 和 XML 的雙向轉換和驗證
    7. 按一下儲存

Copyright IBM Corp. 2003, 2005