「EDI 至 XML」範例
本節提供的範例說明如何將 EDI 交易(放在封套中)傳給中心,
以便在中心中轉換成 XML 文件並傳給「社群管理員」。
本例會假設 Data Interchange Services 對映專家已建立一項轉換對映,
而此項對映會擷取標準 EDI 879 交易
(以相當於 X12 5010 版的 X12V5R1 字典定義而成),
並將它轉換成 XML 文件,
以供「社群管理員」後端應用程式處理。在本例中,
此對映的名稱為 S_DT_EDI_TO_XML.eif。
Data Interchange Services 對映專家可將轉換對映直接匯出到 WebSphere Partner Gateway 資料庫中。或者,
Data Interchange Services 對映專家可傳送檔案給您;在此情況下,
您將使用 bcgDISImport 公用程式來將它匯入至 WebSphere Partner Gateway 中。本附錄是假設第二種情況。
匯入轉換對映
本節說明您在匯入轉換對映時所要採取的步驟;
此項對映會擷取 EDI 輸入,
並將它轉換成 XML 格式。在匯入轉換對映程序中,
您也會匯入對映的相關聯文件定義。
Data Interchange Services 對映專家必須先傳送轉換對映給您,
您才能匯入。這組步驟會假設您的系統已有 S_DT_EDI_TO_XML.eif 檔。
- 開啟命令視窗。
- 輸入下列指令或 Script:
- UNIX 系統:
<ProductDir>/bin/bcgDISImport.sh <database_user_ID>
<password> S_DT_EDI_TO_XML.eif
- Windows 系統:
<ProductDir>\bin\bcgDISImport.bat <database_user_ID>
<password> S_DT_EDI_TO_XML.eif
其中 <database_user_ID> 和 <password> 為資料庫隨 WebSphere Partner Gateway
安裝期間您所用的值。
驗證轉換對映和文件流程定義
若要驗證「社群主控台」有提供您所匯入的轉換對映和文件定義,
請執行下列步驟:
- 按一下中心管理 > 中心配置 > 對映 > 轉換對映。
此時會顯示 S_DT_EDI_TO_XML 對映。
- 按一下對映旁的檢視詳細資料圖示。
您會看到此對映的相關聯文件流程定義:
表 26. 和對映相關聯的文件流程定義
來源 |
目標 |
資料包:N/A
通訊協定:X12V5R1
文件流程:879(全部) |
資料包:無
通訊協定:FVT-XML-TEST(全部)
文件流程:WWRE_ITEMCREATIONINTERNAL(全部) |
S_DT_EDI_TO_XML 對映已定義成會擷取
X12 879 交易(遵循 X12V5R1 標準),並將它轉換成自訂通訊協定。
配置目標
在本節中,您將為中心建立一個檔案系統目錄目標:
- 按一下中心管理 > 中心配置 > 目標,
然後按一下建立目標。
- 在「目標名稱」方面,輸入 EDIFileTarget。
- 從「傳輸」清單,選取檔案目錄。
- 在「根路徑」方面,輸入 /Data/Manager/editarget
- 按一下儲存。
社群參與者將 EDI 交換傳給此目標。
建立互動
您將建立兩項互動 -- 一項是針對 EDI 封套,另一項是針對 EDI 封套中的交易。
建立一項代表 EDI 封套的互動。
- 按一下中心管理 > 中心配置 > 文件流程定義。
- 按一下管理互動,然後按一下建立互動。
- 展開資料包:無和通訊協定:EDI-X12,
並選取文件流程:ISA。
- 展開資料包:N/A和通訊協定:EDI-X12,
並選取文件流程:ISA。
- 從「動作」清單中選取 EDI 解除封裝。
註: 在這項互動中不會發生任何轉換。EDI 交換將解除封裝,並產生個別的交易 (879)。因此,
在這項互動中不需要轉換對映。
- 按一下儲存。
建立一項互動,其中有一個代表 879 交易的來源,一個代表轉換後文件的目標。
- 按一下中心管理 > 中心配置 > 文件流程定義。
- 按一下管理互動,然後按一下建立互動。
- 展開資料包:N/A和通訊協定:X12V5R1,
並選取文件流程:879。
- 展開資料包:無和通訊協定:FVT-XML-TEST,
並選取文件流程:WWRE_ITEMCREATIONINTERNAL。
- 從「轉換對映」清單中選取 S_DT_EDI_TO_XML。
- 從「動作」清單中,選取 EDI 驗證和 EDI 轉換。
- 按一下儲存。
這項互動代表標準
EDI X12 879 交易至另一種格式的轉換,
因此,您必須選取一項轉換對映。
建立參與者
在本例中,您有兩個參與者:「社群管理員」(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 功能。在本例中,
EDI 交換起自社群參與者 (TP1) ,並將遞送給「社群管理員」。
- 按一下帳戶管理 > 設定檔 > 社群參與者,
然後按一下搜尋。
- 按一下本例之來源參與者 (TP1) 的檢視詳細資料圖示。
- 按一下 B2B 功能。
- 針對來源參與者啟用兩組功能。
- 首先,先啟用代表 EDI 封套的文件流程定義:
- 針對資料包:無,
在設定來源下,按一下角色不在作用中,以便啟用它。
- 展開資料包:無。
- 針對通訊協定 EDI-X12(全部),
在設定來源下,按一下角色不在作用中。
- 展開通訊協定 EDI-X12(全部)。
- 針對文件流程:ISA(全部),
在設定來源下,按一下角色不在作用中。
- 接著,請啟用代表交易的文件流程定義:
- 針對資料包:N/A,
在設定來源下,按一下角色不在作用中,以便啟用它。
- 展開資料包:N/A。
- 針對通訊協定:X12V5R1(全部),
在設定來源下,按一下角色不在作用中。
- 展開通訊協定:X12V5R1(全部)。
- 針對文件流程:879,
在設定來源下,按一下角色不在作用中。
- 按一下帳戶管理 > 設定檔 > 社群參與者,
然後按一下搜尋。
- 按一下本例之目標參與者(Manager)
的檢視詳細資料圖示。
- 按一下 B2B 功能。
- 針對目標參與者啟用兩組功能。
- 首先,啟用文件流程定義:
- 針對資料包:N/A,
在設定目標下,按一下角色不在作用中,以便啟用它。
- 展開資料包:N/A。
- 針對通訊協定:EDI-X12(全部),
在設定目標下,按一下角色不在作用中。
- 展開通訊協定:EDI-X12(全部)。
- 針對文件流程:ISA(全部),
在設定目標下,按一下角色不在作用中。
- 接著,請啟用代表轉換後之文件的文件流程定義:
- 針對資料包:無,
在設定目標下,按一下角色不在作用中,以便啟用它。
- 展開資料包:無。
- 針對通訊協定:FVT-XML-TEST(全部),
在設定目標下,按一下角色不在作用中。
- 展開通訊協定:FVT-XML-TEST(全部)。
- 針對文件流程:WWRE_ITEMCREATIONINTERNAL(全部),
在設定目標下,按一下角色不在作用中。
啟動連線
若要啟動連線,請執行下列動作:
- 按一下帳戶管理 > 參與者連線。
- 從「來源」清單中選取 TP1。
- 從「目標」清單中選取 Manager。
- 按一下搜尋。
- 針對代表封套的連線,按一下啟動:
表 27. 「封套」連線
來源 |
目標 |
資料包:無 (N/A)
通訊協定:EDI-X12(全部)
文件流程:ISA(全部) |
資料包:N/A (N/A)
通訊協定:EDI-X12(全部)
文件流程:ISA(全部) |
- 針對代表 879 交易至轉換後文件的連線,按一下啟動:
表 28. 「EDI 交易至 XML 文件」連線
來源 |
目標 |
資料包:N/A (N/A)
通訊協定:X12V5R1(全部)
文件流程:879(全部) |
資料包:無 (N/A)
通訊協定:FVT-XML-TEST(全部)
文件流程:WWRE_ITEMCREATIONINTERNAL(全部) |
此時,如果 TP1 已傳送內含 879 交易的 EDI 交換給「社群管理員」,
EDI 交換將解除封裝,以產生 879 交易。然後將轉換 879 交易,
並將轉換後的文件傳給「社群管理員」的閘道。
