「ROD 至 EDI」範例
本節提供的範例說明「社群管理員」如何傳送 ROD 文件給中心,
以便在中心中轉換成 EDI 交易、封裝在 EDI 交換中,並傳給參與者。
本例會假設 Data Interchange Services 對映專家已建立一項轉換對映,
而此項對映會擷取「記錄導向文件 (ROD)」,
並將它轉換成標準 EDI 850 交易(以相當於 X12 5010 版的 X12V5R1 字典定義而成),
以供參與者處理。在本例中,
此對映的名稱為 S_DT_ROD_TO_EDI.eif。
Data Interchange Services 對映專家可將轉換對映直接匯出到 WebSphere Partner Gateway 資料庫中。或者,
Data Interchange Services 對映專家可傳送檔案給您;在此情況下,
您將使用 bcgDISImport 公用程式來將它匯入至 WebSphere Partner Gateway 中。本附錄是假設第二種情況。
匯入轉換對映
本節說明您在匯入轉換對映時所要採取的步驟;
此項對映會擷取 ROD 輸入,
並將它轉換成 X12 交易。在匯入轉換對映程序中,
您也會匯入對映的相關聯文件定義。
Data Interchange Services 對映專家必須先傳送轉換對映給您,
您才能匯入。這組步驟會假設您的系統已有 S_DT_ROD_TO_EDI.eif 檔。
- 開啟命令視窗。
- 輸入下列指令或 Script:
- UNIX 系統:
<ProductDir>/bin/bcgDISImport.sh <database_user_ID>
<password> S_DT_ROD_TO_EDI.eif
- Windows 系統:
<ProductDir>\bin\bcgDISImport.bat <database_user_ID>
<password> S_DT_ROD_TO_EDI.eif
其中 <database_user_ID> 和 <password> 為資料庫隨 WebSphere Partner Gateway
安裝期間您所用的值。
驗證轉換對映和文件流程定義
若要驗證「社群主控台」有提供您所匯入的轉換對映和文件定義,
請執行下列步驟:
- 按一下中心管理 > 中心配置 > 對映 > 轉換對映。
此時會顯示 S_DT_ROD_TO_EDI 對映。
- 按一下對映旁的檢視詳細資料圖示。
您會看到此對映的相關聯文件流程定義:
表 32. 和對映相關聯的文件流程定義
來源 |
目標 |
資料包:無
通訊協定:ROD-TO-EDI_DICT(全部)
文件流程:DTROD-TO-EDI_ROD(全部) |
資料包:N/A
通訊協定:X12V5R1(全部)
文件流程:850(全部) |
S_DT_ROD_TO_EDI 對映是定義成會擷取
ROD-TO-EDI_DICT 字典的相關聯 ROD 文件,
並將它轉換成符合 X12V5R1 標準的 X12 850 交易。
配置目標
在本節中,您將為中心建立一個檔案系統目錄目標:
- 按一下中心管理 > 中心配置 > 目標,
然後按一下建立目標。
- 在「目標名稱」方面,輸入 RODFileTarget。
- 從「傳輸」清單,選取檔案目錄。
- 在「根路徑」方面,輸入 /Data/Manager/rodtarget
- 從「配置點」清單,選取前處理。
- 從「可用的清單」中選取 com.ibm.bcg.edi.receiver.preprocesshandler.RODSplitterHandler,
並按一下新增,將它移至「已配置的清單」。
- 從「已配置的清單」中選取 com.ibm.bcg.edi.receiver.preprocesshandler.RODSplitterHandler,
並按一下配置。
- 新增表格中所示的值:
表 33. 「ROD 分割程式」處理常式的屬性
欄位 |
值 |
來源包裝名稱 |
無 |
來源包裝版本 |
N/A |
來源通訊協定名稱 |
ROD-TO-EDI_DICT |
來源通訊協定版本 |
全部 |
來源程序碼 |
DTROD-TO-EDI_ROD |
來源程序版本 |
全部 |
METADICTIONARY |
ROD-TO-EDI_DICT |
METADOCUMENT |
DTROD-TO-EDI_ROD |
METASYNTAX |
rod |
ENCODING |
ascii |
BCG_BATCHDOCS |
ON |
- 按一下設定值。
- 按一下儲存。
「社群管理員」將 ROD 文件傳給此目標。
建立互動
您將建立兩項互動 -- 一項是針對將從中心送出的 EDI 封套,
另一項是針對 ROD 文件至 EDI 的轉換。
建立一項互動,其中有一個代表 ROD 文件的來源,一個代表 X12 文件的目標。
- 按一下中心管理 > 中心配置 > 文件流程定義。
- 按一下管理互動,然後按一下建立互動。
- 展開資料包:無和通訊協定:ROD-TO-EDI_DICT,
並選取 DTROD-TO-EDI_ROD。
- 展開資料包:N/A和通訊協定:X12V5R1,
並選取文件流程:850。
- 從「轉換對映」清單中選取 S_DT_ROD_TO_EDI。
- 從「動作」清單中,選取 ROD 轉換和 EDI 驗證。
- 按一下儲存。
這項互動代表 ROD 文件至標準 X12 交易的轉換,
因此,您必須選取一項轉換對映。
建立一項代表 EDI 封套的互動。
- 按一下中心管理 > 中心配置 > 文件流程定義。
- 按一下管理互動,然後按一下建立互動。
- 展開資料包:N/A和通訊協定:EDI-X12,
並選取文件流程:ISA。
- 展開資料包:無和通訊協定:EDI-X12,
並選取文件流程:ISA。
- 從「動作」清單中選取直接遞送。
註: 在這項互動中不會發生任何轉換。此項互動用來封裝 EDI 交換。
- 按一下儲存。
建立參與者
在本例中,您有兩個參與者:「社群管理員」(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 功能。在本例中,
ROD 文件起自「社群管理員」,並將遞送給參與者 (TP1)。
- 按一下帳戶管理 > 設定檔 > 社群參與者,
然後按一下搜尋。
- 按一下本例之來源參與者 (Manager) 的檢視詳細資料圖示。
- 按一下 B2B 功能。
- 針對來源參與者啟用兩組功能。
- 首先,請啟用代表 ROD 文件的文件流程定義:
- 針對資料包:無,
在設定來源下,按一下角色不在作用中,以便啟用它。
- 展開資料包:無。
- 針對通訊協定:ROD-TO-EDI_DICT(全部),
在設定來源下,按一下角色不在作用中。
- 展開通訊協定:ROD-TO-EDI_DICT(全部)。
- 針對文件流程:DTROD-TO-EDI_ROD(全部),
在設定來源下,按一下角色不在作用中。
- 接著,啟用代表 EDI 封套的文件流程定義:
- 針對資料包:N/A,
在設定來源下,按一下角色不在作用中,以便啟用它。
- 展開資料包:N/A。
- 針對通訊協定 EDI-X12(全部),
在設定來源下,按一下角色不在作用中。
- 展開通訊協定 EDI-X12(全部)。
- 針對文件流程:ISA(全部),
在設定來源下,按一下角色不在作用中。
- 按一下帳戶管理 > 設定檔 > 社群參與者,
然後按一下搜尋。
- 按一下本例之目標參與者
(TP1) 的檢視詳細資料圖示。
- 按一下 B2B 功能。
- 針對目標參與者啟用兩組功能。
- 首先,先啟用代表 EDI 850 交易的文件流程定義:
- 針對資料包:N/A,
在設定目標下,按一下角色不在作用中,以便啟用它。
- 展開資料包:N/A。
- 針對通訊協定:X12V5R1(全部),
在設定目標下,按一下角色不在作用中。
- 展開通訊協定:X12V5R1(全部)。
- 針對文件流程: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: \
- ISA12: 00501
- ISA15: T
- 按一下儲存。
啟動連線
若要啟動連線,請執行下列動作:
- 按一下帳戶管理 > 參與者連線。
- 從「來源」清單中選取 Manager。
- 從「目標」清單中選取 TP1。
- 按一下搜尋。
- 針對代表 ROD 文件至 EDI 交易的連線,按一下啟動:
表 34. 「ROD 至 EDI」連線
來源 |
目標 |
資料包:N/A (N/A)
通訊協定:ROD-TO-EDI_DICT(全部)文件流程:DTROD-TO-EDI_ROD(全部) |
資料包:無 (N/A)
通訊協定:X12V5R1(全部)
文件流程:850 |
- 針對代表封套的連線,按一下啟動:
表 35. 「封套」連線
來源 |
目標 |
資料包:無 (N/A)
通訊協定:EDI-X12(全部)
文件流程:ISA(全部) |
資料包:N/A (N/A)
通訊協定:EDI-X12(全部)
文件流程:ISA(全部) |
配置屬性
若要指定封套設定檔的屬性,請執行下列動作:
- 按一下帳戶管理 > 設定檔 > 社群參與者,
然後按一下搜尋。
- 從清單中選取 TP1。
- 按一下 B2B 功能。
- 按一下資料包:N/A 旁的展開圖示。
- 按一下通訊協定:X12V5R1 旁的編輯圖示。
- 指定下列屬性:
- 在「封套設定檔」列中,選取清單中的 EnvProf1。
- 在「交換限定元」列中,輸入 01。
- 在「交換 ID」列中,輸入 000000001。
- 在「交換用法指示器」列中,輸入 T。
- 按一下儲存。
此時,如果「社群管理員」已傳送 ROD 文件給中心,
則會將文件轉換成 850 交易並進行封裝,以傳給參與者的閘道。
