「XML 至 EDI」範例

本節提供的範例說明「社群管理員」如何傳送 XML 文件給中心, 以便在中心中轉換成 EDI 交易、封裝在 EDI 交換中,並傳給參與者。

本例會假設 Data Interchange Services 對映專家已建立一項轉換對映, 而此項對映會擷取 XML 文件, 並將它轉換成標準 EDI 850 交易(以 MX12V3R1 字典定義而成), 以供參與者處理。在本例中, 此對映的名稱為 S_DT_XML_TO_EDI.eif。

Data Interchange Services 對映專家可將轉換對映直接匯出到 WebSphere Partner Gateway 資料庫中。或者, Data Interchange Services 對映專家可傳送檔案給您;在此情況下, 您將使用 bcgDISImport 公用程式來將它匯入至 WebSphere Partner Gateway 中。本附錄是假設第二種情況。

匯入轉換對映

本節說明您在匯入轉換對映時所要採取的步驟; 此項對映會擷取 XML 輸入, 並將它轉換成 EDI 交易。在匯入轉換對映程序中, 您也會匯入對映的相關聯文件定義。

Data Interchange Services 對映專家必須先傳送轉換對映給您, 您才能匯入。這組步驟會假設您的系統已有 S_DT_XML_TO_EDI.eif 檔。

  1. 開啟命令視窗。
  2. 輸入下列指令或 Script:

驗證轉換對映和文件流程定義

若要驗證「社群主控台」有提供您所匯入的轉換對映和文件定義, 請執行下列步驟:

  1. 按一下中心管理 > 中心配置 > 對映 > 轉換對映

    此時會顯示 S_DT_XML_TO_EDI 對映。

  2. 按一下對映旁的檢視詳細資料圖示。

    您會看到此對映的相關聯文件流程定義:

    表 29. 和對映相關聯的文件流程定義
    來源 目標
    資料包:無
    通訊協定:FVT-XML-TEST(全部)
    文件流程:ICGCPO(全部)
    資料包:N/A
    通訊協定:MX12V3R1(全部)
    文件流程:850(全部)

S_DT_XML_TO_EDI 對映是定義成擷取 XML 文件,並將它轉換成 EDI 交易。

配置目標

在本節中,您將為中心建立一個檔案系統目錄目標:

  1. 按一下中心管理 > 中心配置 > 目標, 然後按一下建立目標
  2. 在「目標名稱」方面,輸入 XMLFileTarget
  3. 從「傳輸」清單,選取檔案目錄
  4. 在「根路徑」方面,輸入 /Data/Manager/xmltarget
  5. 從「配置點」清單,選取前處理
  6. 從「可用的清單」中選取 com.ibm.bcg.edi.receiver.preprocesshandler.XMLSplitterHandler, 並按一下新增,將它移至「已配置的清單」。
  7. 按一下儲存

「社群管理員」將 XML 文件傳給此目標。

建立互動

您將建立兩項互動 -- 一項是針對「XML 至 EDI」轉換,另一項是針對 EDI 封套

建立一項互動,其中有一個代表 XML 文件的來源,一個代表轉換後之 850 交易的目標。

  1. 按一下中心管理 > 中心配置 > 文件流程定義
  2. 按一下管理互動,然後按一下建立互動
  3. 展開資料包:無通訊協定:FVT-XML-TEST, 並選取文件流程:ICGCPO
  4. 展開資料包:N/A通訊協定:MX12V3R1, 並選取文件流程:850
  5. 從「轉換對映」清單中選取 S_DT_XML_TO_EDI
  6. 從「動作」清單中,選取 XML 轉換和 EDI 驗證
  7. 按一下儲存

這項互動代表 XML 文件至 EDI 交易的轉換, 因此,您必須選取一項轉換對映。

建立一項代表 EDI 封套的互動。

  1. 按一下中心管理 > 中心配置 > 文件流程定義
  2. 按一下管理互動,然後按一下建立互動
  3. 展開資料包:N/A通訊協定:EDI-X12, 並選取文件流程:ISA
  4. 展開資料包:無通訊協定:EDI-X12, 並選取文件流程:ISA
  5. 從「動作」清單中選取直接遞送
    註: 在這項互動中不會發生任何轉換。
  6. 按一下儲存

建立參與者

在本例中,您有兩個參與者:「社群管理員」(Manager) 和參與者 (TP1)。

建立「社群管理員」設定檔:

  1. 按一下帳戶管理 > 設定檔 > 社群參與者, 然後按一下建立
  2. 在「公司登入名稱」方面,輸入 ComManager
  3. 在「參與者顯示名稱」方面,輸入 Manager
  4. 在「參與者類型」方面,選取社群管理員
  5. 在「商業 ID」方面,按一下新建, 並輸入 000000000 作為「開放式 ID」。
    註: 請確定您所選的是「開放式」而非 DUNS。
  6. 在「商業 ID」方面,按一下新建,並輸入 01-000000000 作為「開放式 ID」。
  7. 按一下儲存

建立第二個參與者:

  1. 按一下帳戶管理 > 設定檔 > 社群參與者, 然後按一下建立
  2. 在「公司登入名稱」方面,輸入 TP1
  3. 在「參與者顯示名稱」方面,輸入 TP1
  4. 在「參與者類型」方面,選取參與者
  5. 在「商業 ID」方面,按一下新建, 並輸入 000000001 作為「開放式 ID」。
    註: 請確定您所選的是「開放式」而非 DUNS。
  6. 再次在「商業 ID」方面,按一下新建, 並輸入 01-000000001 作為「開放式 ID」。
  7. 按一下儲存

建立閘道

為本例中的兩個參與者建立檔案目錄型閘道。首先,請為 Manager 建立閘道:

  1. 按一下帳戶管理 > 設定檔 > 社群參與者, 然後按一下搜尋
  2. 按一下 Manager 設定檔旁的檢視詳細資料圖示。
  3. 按一下閘道,然後按一下建立
  4. 輸入下列的閘道值。請注意,檔案目錄(整個路徑)必須已存在於您的檔案系統中。
    1. 在「名稱」方面,請輸入 ManagerFileGateway
    2. 在「傳輸清單」方面,請選取檔案目錄
    3. 在「位址」方面,請輸入 file:///Data/Manager/filegateway
    4. 按一下儲存
  5. 按一下清單,列出「社群管理員」的所有閘道。
  6. 按一下檢視預設閘道
  7. 正式作業清單中, 選取您在步驟 4 中所建的閘道。
  8. 按一下儲存

接著,為參與者建立閘道。

  1. 按一下帳戶管理 > 設定檔 > 社群參與者, 然後按一下搜尋
  2. 選取您在本例中所建的另一個參與者;其做法是按一下 TP1 旁的檢視詳細資料圖示。
  3. 按一下閘道,然後按一下建立
  4. 輸入下列的閘道值。請注意,檔案目錄(整個路徑)必須已存在。
    1. 在「名稱」方面,請輸入 TP1FileGateway
    2. 從「傳輸」清單,選取檔案目錄
    3. 在「位址」方面,請輸入 file:///Data/TP1/filegateway
    4. 按一下儲存
  5. 按一下清單,列出該參與者的所有閘道。
  6. 按一下檢視預設閘道
  7. 正式作業清單中, 選取您在步驟 4 中所建的閘道。
  8. 按一下儲存

設定 B2B 功能

啟用這項交換中之兩個參與者的 B2B 功能。在本例中, XML 文件起自「社群管理員」,並將遞送給參與者。

  1. 按一下帳戶管理 > 設定檔 > 社群參與者, 然後按一下搜尋
  2. 按一下本例之來源參與者 (ComMan) 的檢視詳細資料圖示。
  3. 按一下 B2B 功能
  4. 針對來源參與者啟用三組功能。
    1. 啟用代表 XML 文件的文件流程定義:
      1. 針對資料包:無, 在設定來源下,按一下角色不在作用中,以便啟用它。
      2. 展開資料包:無
      3. 針對通訊協定:FVT-XML-TEST(全部), 在設定來源下,按一下角色不在作用中
      4. 展開通訊協定:FVT-XML-TEST(全部)
      5. 針對文件流程:ICGCPO(全部), 在設定來源下,按一下角色不在作用中
    2. 接著,請啟用代表轉換後之文件的文件流程定義:
      1. 針對資料包:N/A, 在設定來源下,按一下角色不在作用中,以便啟用它。
      2. 展開資料包:N/A
      3. 針對通訊協定:MX12V3R1(全部), 在設定來源下,按一下角色不在作用中
      4. 展開通訊協定:MX12V3R1(全部)
      5. 針對文件流程:850, 在設定來源下,按一下角色不在作用中
    3. 然後,啟用代表 EDI 封套的文件流程定義:
      1. 針對資料包:N/A, 在設定來源下,按一下角色不在作用中,以便啟用它。
      2. 展開資料包:N/A
      3. 針對通訊協定 EDI-X12(全部), 在設定來源下,按一下角色不在作用中
      4. 展開通訊協定 EDI-X12(全部)
      5. 針對文件流程:ISA(全部), 在設定來源下,按一下角色不在作用中
  5. 按一下帳戶管理 > 設定檔 > 社群參與者, 然後按一下搜尋
  6. 按一下本例之目標參與者 (TP1) 的檢視詳細資料圖示。
  7. 按一下 B2B 功能
  8. 針對目標參與者啟用兩組功能。
    1. 首先,先啟用代表 EDI 850 交易的文件流程定義:
      1. 針對資料包:N/A, 在設定目標下,按一下角色不在作用中,以便啟用它。
      2. 展開資料包:N/A
      3. 針對通訊協定:MX12V3R1(全部), 在設定目標下,按一下角色不在作用中
      4. 展開通訊協定:MX12V3R1(全部)
      5. 針對文件流程:850(全部), 在設定目標下,按一下角色不在作用中
    2. 接著,啟用文件流程定義:
      1. 針對資料包:無, 在設定目標下,按一下角色不在作用中,以便啟用它。
      2. 展開資料包:無
      3. 針對通訊協定:EDI-X12(全部), 在設定目標下,按一下角色不在作用中
      4. 展開通訊協定:EDI-X12(全部)
      5. 針對文件流程:ISA(全部), 在設定目標下,按一下角色不在作用中

建立封套設定檔

接下來,您將為將包含轉換後之 850 交易的封套建立設定檔:

  1. 按一下中心管理 > 中心配置 > EDI > 封套設定檔
  2. 按一下建立
  3. 輸入設定檔名稱:EnvProf1
  4. 從「EDI 標準」清單,選取 X12
  5. 依預設,會選取一般按鈕。請針對封套的「一般」屬性,輸入下列值:
  6. 按一下交換按鈕,並針對「交換」屬性,輸入下列值:
  7. 按一下儲存

建立 XML 格式

在本節中,您將建立自訂 XML 格式。

  1. 按一下中心管理 > 中心配置 > XML 格式
  2. 按一下建立 XML 格式
  3. 在「遞送格式」方面,選取 FVT-XML-TEST(全部)
  4. 在「檔案類型」方面,選取 XML
  5. 在「ID 類型」方面,選取根標示,並輸入 MMDoc
  6. 在「來源商業 ID」方面,選取常數,並輸入 000000000
  7. 在「目標商業 ID」方面,選取常數,並輸入 000000001
  8. 在「來源文件流程」方面,選取常數,並輸入 ICGCPO
  9. 在「來源文件流程版本」方面,選取常數,並輸入全部
  10. 按一下儲存

啟動連線

若要啟動參與者連線,請執行下列動作:

  1. 按一下帳戶管理 > 參與者連線
  2. 從「來源」清單中選取 Manager
  3. 從「目標」清單中選取 TP1
  4. 按一下搜尋
  5. 針對下列連線,按一下啟動
    表 30. 「XML 文件至 EDI 交易」連線
    來源 目標
    資料包:無 (N/A)
    通訊協定:FVT-XML-TEST(全部)
    文件流程:ICGCPO(全部)
    資料包:N/A (N/A)
    通訊協定:MX12V3R1(全部)
    文件流程:850(全部)
  6. 針對代表 EDI 封套的連線,按一下啟動
    表 31. 「EDI 封套」連線
    來源 目標
    資料包:N/A (N/A)
    通訊協定:EDI-X12(全部)
    文件流程:ISA(全部)
    資料包:無 (N/A)
    通訊協定:EDI-X12(全部)
    文件流程:ISA(全部)

配置屬性

配置目標參與者 (TP1) 和來源參與者 (Manager) 的 B2B 功能屬性:

  1. 按一下帳戶管理 > 設定檔 > 社群參與者, 然後按一下搜尋
  2. 按一下 TPI 旁的檢視詳細資料圖示,以選取它。
  3. 按一下 B2B 功能
  4. 按一下資料包:N/A 旁的展開圖示。
  5. 按一下通訊協定:MX12V3R1 旁的編輯圖示。
  6. 指定下列屬性:
    1. 在「封套設定檔」列中,選取清單中的 EnvProf1
    2. 在「交換限定元」列中,輸入 01
    3. 在「交換 ID」列中,輸入 000000001
    4. 在「交換用法指示器」列中,輸入 T
  7. 按一下儲存
  8. 按一下帳戶管理 > 設定檔 > 社群參與者, 然後按一下搜尋
  9. 按一下 Manager 旁的「檢視詳細資料」,以選取它。
  10. 按一下 B2B 功能
  11. 按一下資料包:N/A 旁的展開圖示。
  12. 按一下通訊協定:MX12V3R1(全部)旁的編輯圖示。
  13. 指定下列屬性:
    1. 在「交換限定元」列中,輸入 01
    2. 在「交換 ID」列中,輸入 000000000
    3. 在「交換用法指示器」列中,輸入 T
  14. 按一下儲存

此時,如果來源參與者 (「社群管理員」) 已傳送 XML 文件給參與者, 則會在中心中將它轉換成 EDI 交易並進行封裝,然後傳給參與者的閘道。

Copyright IBM Corp. 2003, 2005