「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 檔。
- 開啟命令視窗。
- 輸入下列指令或 Script:
- UNIX 系統:
<ProductDir>/bin/bcgDISImport.sh <database_user_ID>
<password> S_DT_XML_TO_EDI.eif
- Windows 系統:
<ProductDir>\bin\bcgDISImport.bat <database_user_ID>
<password> S_DT_XML_TO_EDI.eif
其中 <database_user_ID> 和 <password> 為資料庫隨 WebSphere Partner Gateway
安裝期間您所用的值。
驗證轉換對映和文件流程定義
若要驗證「社群主控台」有提供您所匯入的轉換對映和文件定義,
請執行下列步驟:
- 按一下中心管理 > 中心配置 > 對映 > 轉換對映。
此時會顯示 S_DT_XML_TO_EDI 對映。
- 按一下對映旁的檢視詳細資料圖示。
您會看到此對映的相關聯文件流程定義:
表 29. 和對映相關聯的文件流程定義
來源 |
目標 |
資料包:無
通訊協定:FVT-XML-TEST(全部)
文件流程:ICGCPO(全部) |
資料包:N/A
通訊協定:MX12V3R1(全部)
文件流程:850(全部) |
S_DT_XML_TO_EDI 對映是定義成擷取 XML 文件,並將它轉換成 EDI 交易。
配置目標
在本節中,您將為中心建立一個檔案系統目錄目標:
- 按一下中心管理 > 中心配置 > 目標,
然後按一下建立目標。
- 在「目標名稱」方面,輸入 XMLFileTarget。
- 從「傳輸」清單,選取檔案目錄。
- 在「根路徑」方面,輸入 /Data/Manager/xmltarget
- 從「配置點」清單,選取前處理。
- 從「可用的清單」中選取 com.ibm.bcg.edi.receiver.preprocesshandler.XMLSplitterHandler,
並按一下新增,將它移至「已配置的清單」。
- 按一下儲存。
「社群管理員」將 XML 文件傳給此目標。
建立互動
您將建立兩項互動 -- 一項是針對「XML 至 EDI」轉換,另一項是針對 EDI 封套。
建立一項互動,其中有一個代表 XML 文件的來源,一個代表轉換後之 850 交易的目標。
- 按一下中心管理 > 中心配置 > 文件流程定義。
- 按一下管理互動,然後按一下建立互動。
- 展開資料包:無和通訊協定:FVT-XML-TEST,
並選取文件流程:ICGCPO。
- 展開資料包:N/A和通訊協定:MX12V3R1,
並選取文件流程:850。
- 從「轉換對映」清單中選取 S_DT_XML_TO_EDI。
- 從「動作」清單中,選取 XML 轉換和 EDI 驗證。
- 按一下儲存。
這項互動代表 XML 文件至 EDI 交易的轉換,
因此,您必須選取一項轉換對映。
建立一項代表 EDI 封套的互動。
- 按一下中心管理 > 中心配置 > 文件流程定義。
- 按一下管理互動,然後按一下建立互動。
- 展開資料包:N/A和通訊協定:EDI-X12,
並選取文件流程:ISA。
- 展開資料包:無和通訊協定:EDI-X12,
並選取文件流程:ISA。
- 從「動作」清單中選取直接遞送。
註: 在這項互動中不會發生任何轉換。
- 按一下儲存。
建立參與者
在本例中,您有兩個參與者:「社群管理員」(Manager) 和參與者 (TP1)。
建立「社群管理員」設定檔:
- 按一下帳戶管理 > 設定檔 > 社群參與者,
然後按一下建立。
- 在「公司登入名稱」方面,輸入 ComManager
- 在「參與者顯示名稱」方面,輸入 Manager
- 在「參與者類型」方面,選取社群管理員。
- 在「商業 ID」方面,按一下新建,
並輸入 000000000 作為「開放式 ID」。
註: 請確定您所選的是「開放式」而非 DUNS。
- 在「商業 ID」方面,按一下新建,並輸入 01-000000000 作為「開放式 ID」。
- 按一下儲存。
建立第二個參與者:
- 按一下帳戶管理 > 設定檔 > 社群參與者,
然後按一下建立。
- 在「公司登入名稱」方面,輸入 TP1
- 在「參與者顯示名稱」方面,輸入 TP1
- 在「參與者類型」方面,選取參與者。
- 在「商業 ID」方面,按一下新建,
並輸入 000000001 作為「開放式 ID」。
註: 請確定您所選的是「開放式」而非 DUNS。
- 再次在「商業 ID」方面,按一下新建,
並輸入 01-000000001 作為「開放式 ID」。
- 按一下儲存。
建立閘道
為本例中的兩個參與者建立檔案目錄型閘道。首先,請為 Manager 建立閘道:
- 按一下帳戶管理 > 設定檔 > 社群參與者,
然後按一下搜尋。
- 按一下 Manager 設定檔旁的檢視詳細資料圖示。
- 按一下閘道,然後按一下建立。
-
輸入下列的閘道值。請注意,檔案目錄(整個路徑)必須已存在於您的檔案系統中。
- 在「名稱」方面,請輸入 ManagerFileGateway。
- 在「傳輸清單」方面,請選取檔案目錄。
- 在「位址」方面,請輸入 file:///Data/Manager/filegateway
- 按一下儲存。
- 按一下清單,列出「社群管理員」的所有閘道。
- 按一下檢視預設閘道。
- 從正式作業清單中,
選取您在步驟 4 中所建的閘道。
- 按一下儲存。
接著,為參與者建立閘道。
- 按一下帳戶管理 > 設定檔 > 社群參與者,
然後按一下搜尋。
- 選取您在本例中所建的另一個參與者;其做法是按一下
TP1 旁的檢視詳細資料圖示。
- 按一下閘道,然後按一下建立。
-
輸入下列的閘道值。請注意,檔案目錄(整個路徑)必須已存在。
- 在「名稱」方面,請輸入 TP1FileGateway。
- 從「傳輸」清單,選取檔案目錄。
- 在「位址」方面,請輸入 file:///Data/TP1/filegateway
- 按一下儲存。
- 按一下清單,列出該參與者的所有閘道。
- 按一下檢視預設閘道。
- 從正式作業清單中,
選取您在步驟 4 中所建的閘道。
- 按一下儲存。
設定 B2B 功能
啟用這項交換中之兩個參與者的 B2B 功能。在本例中,
XML 文件起自「社群管理員」,並將遞送給參與者。
- 按一下帳戶管理 > 設定檔 > 社群參與者,
然後按一下搜尋。
- 按一下本例之來源參與者 (ComMan) 的檢視詳細資料圖示。
- 按一下 B2B 功能。
- 針對來源參與者啟用三組功能。
- 啟用代表 XML 文件的文件流程定義:
- 針對資料包:無,
在設定來源下,按一下角色不在作用中,以便啟用它。
- 展開資料包:無。
- 針對通訊協定:FVT-XML-TEST(全部),
在設定來源下,按一下角色不在作用中。
- 展開通訊協定:FVT-XML-TEST(全部)。
- 針對文件流程:ICGCPO(全部),
在設定來源下,按一下角色不在作用中。
- 接著,請啟用代表轉換後之文件的文件流程定義:
- 針對資料包:N/A,
在設定來源下,按一下角色不在作用中,以便啟用它。
- 展開資料包:N/A。
- 針對通訊協定:MX12V3R1(全部),
在設定來源下,按一下角色不在作用中。
- 展開通訊協定:MX12V3R1(全部)。
- 針對文件流程:850,
在設定來源下,按一下角色不在作用中。
- 然後,啟用代表 EDI 封套的文件流程定義:
- 針對資料包:N/A,
在設定來源下,按一下角色不在作用中,以便啟用它。
- 展開資料包:N/A。
- 針對通訊協定 EDI-X12(全部),
在設定來源下,按一下角色不在作用中。
- 展開通訊協定 EDI-X12(全部)。
- 針對文件流程:ISA(全部),
在設定來源下,按一下角色不在作用中。
- 按一下帳戶管理 > 設定檔 > 社群參與者,
然後按一下搜尋。
- 按一下本例之目標參與者
(TP1) 的檢視詳細資料圖示。
- 按一下 B2B 功能。
- 針對目標參與者啟用兩組功能。
- 首先,先啟用代表 EDI 850 交易的文件流程定義:
- 針對資料包:N/A,
在設定目標下,按一下角色不在作用中,以便啟用它。
- 展開資料包:N/A。
- 針對通訊協定:MX12V3R1(全部),
在設定目標下,按一下角色不在作用中。
- 展開通訊協定:MX12V3R1(全部)。
- 針對文件流程:850(全部),
在設定目標下,按一下角色不在作用中。
- 接著,啟用文件流程定義:
- 針對資料包:無,
在設定目標下,按一下角色不在作用中,以便啟用它。
- 展開資料包:無。
- 針對通訊協定:EDI-X12(全部),
在設定目標下,按一下角色不在作用中。
- 展開通訊協定:EDI-X12(全部)。
- 針對文件流程:ISA(全部),
在設定目標下,按一下角色不在作用中。
建立封套設定檔
接下來,您將為將包含轉換後之 850 交易的封套建立設定檔:
- 按一下中心管理 > 中心配置 > EDI > 封套設定檔。
- 按一下建立。
- 輸入設定檔名稱:EnvProf1。
- 從「EDI 標準」清單,選取 X12。
- 依預設,會選取一般按鈕。請針對封套的「一般」屬性,輸入下列值:
- INTCTLLEN: 9
- GRPCTLLEN: 9
- TRXCTLLEN: 9
- MAXDOCS: 1000
- 按一下交換按鈕,並針對「交換」屬性,輸入下列值:
- ISA01: 01
- ISA02: ISA0000002
- ISA03: 02
- ISA04: ISA0000004
- ISA11: U
- ISA12: 00301
- ISA15: T
- 按一下儲存。
建立 XML 格式
在本節中,您將建立自訂 XML 格式。
- 按一下中心管理 > 中心配置 > XML 格式。
- 按一下建立 XML 格式。
- 在「遞送格式」方面,選取 FVT-XML-TEST(全部)。
- 在「檔案類型」方面,選取 XML。
- 在「ID 類型」方面,選取根標示,並輸入 MMDoc。
- 在「來源商業 ID」方面,選取常數,並輸入
000000000。
- 在「目標商業 ID」方面,選取常數,並輸入
000000001。
- 在「來源文件流程」方面,選取常數,並輸入
ICGCPO。
- 在「來源文件流程版本」方面,選取常數,並輸入全部。
- 按一下儲存。
啟動連線
若要啟動參與者連線,請執行下列動作:
- 按一下帳戶管理 > 參與者連線。
- 從「來源」清單中選取 Manager。
- 從「目標」清單中選取 TP1。
- 按一下搜尋。
- 針對下列連線,按一下啟動:
表 30. 「XML 文件至 EDI 交易」連線
來源 |
目標 |
資料包:無 (N/A)
通訊協定:FVT-XML-TEST(全部)
文件流程:ICGCPO(全部) |
資料包:N/A (N/A)
通訊協定:MX12V3R1(全部)
文件流程:850(全部) |
- 針對代表 EDI 封套的連線,按一下啟動:
表 31. 「EDI 封套」連線
來源 |
目標 |
資料包:N/A (N/A)
通訊協定:EDI-X12(全部)
文件流程:ISA(全部) |
資料包:無 (N/A)
通訊協定:EDI-X12(全部)
文件流程:ISA(全部) |
配置屬性
配置目標參與者 (TP1) 和來源參與者 (Manager) 的 B2B 功能屬性:
- 按一下帳戶管理 > 設定檔 > 社群參與者,
然後按一下搜尋。
- 按一下 TPI 旁的檢視詳細資料圖示,以選取它。
- 按一下 B2B 功能。
- 按一下資料包:N/A 旁的展開圖示。
- 按一下通訊協定:MX12V3R1 旁的編輯圖示。
- 指定下列屬性:
- 在「封套設定檔」列中,選取清單中的 EnvProf1。
- 在「交換限定元」列中,輸入 01。
- 在「交換 ID」列中,輸入 000000001。
- 在「交換用法指示器」列中,輸入 T。
- 按一下儲存。
- 按一下帳戶管理 > 設定檔 > 社群參與者,
然後按一下搜尋。
- 按一下 Manager 旁的「檢視詳細資料」,以選取它。
- 按一下 B2B 功能。
- 按一下資料包:N/A 旁的展開圖示。
- 按一下通訊協定:MX12V3R1(全部)旁的編輯圖示。
- 指定下列屬性:
- 在「交換限定元」列中,輸入 01。
- 在「交換 ID」列中,輸入 000000000。
- 在「交換用法指示器」列中,輸入 T。
- 按一下儲存。
此時,如果來源參與者 (「社群管理員」) 已傳送 XML 文件給參與者,
則會在中心中將它轉換成 EDI 交易並進行封裝,然後傳給參與者的閘道。
