核心功能
- EANCOM 與 XML 格式的雙向轉換:支援兩種格式之間的完整互轉。
- 全面的交換標頭驗證與生成:確保報文結構的合規性。
- 支援多個 EANCOM 版本:具有自動架構檢測功能。
- 交換確認與功能性確認支援:實現訊息收發的閉環確認。
概覽
接收 EANCOM 檔案時,EANCOM 端口會驗證交換頭並將 EANCOM 檔案轉換為 XML。這作為一個暫存步驟非常有用,因為 XML 是 在流程中處理資料的主要格式。EANCOM 端口會自動讀取輸入檔案以確定合適的架構,然後根據該架構解析檔案。 生成 EANCOM 檔案時,EANCOM 端口會將 XML 轉換為 EANCOM 檔案語法並應用相應的交換頭。在流程的其他位置取得並轉換 XML 資料後,這通常是建立 EANCOM 檔案的最後一步。端口配置
本節包含所有可配置的端口屬性。設定
轉換配置
與端口核心操作相關的設定。EDI 交易夥伴
交換頭配置
與 EANCOM 交換頭相關的設定。將 EANCOM 檔案轉換為 XML 時,會根據這些設定驗證檔案頭;從 XML 生成 EANCOM 檔案時,這些設定用於生成檔案頭。請求確認
與生成和請求確認相關的設定。範例檔案索引標籤
高階頁面
EDI 分隔符號
指定用於分隔元素、段等內容的字元。交換頭配置
與 EANCOM 交換頭相關的其他設定。這些選項會根據“設定”索引標籤上指定的 語法版本 顯示或隱藏。功能群組配置
與 EANCOM 文件功能群組頭相關的設定。這些可選識別碼可以幫助將相似的交換分組在一起,或促進組織內的子地址。進階設定
前面類別中未包含的設定。訊息
日誌
雜項
EDI 交易夥伴索引標籤
自動化
自動化設定
與端口自動處理檔案相關的設定。效能
警示
SLA
XML 轉換為 EANCOM
生成 EANCOM 檔案時,將 轉換型別 選擇為 XML 轉換為 EANCOM。應用程式會從設定索引標籤中配置的設定讀取交換、功能群組和訊息部分的頭資訊。這些設定包括傳送方識別碼和程式碼限定符、接收方識別碼和程式碼限定符等。 使用交易夥伴協議中的設定配置端口後,點選 交易 索引標籤並選擇 More > Create Test Files。應用程式會建立一組測試 XML 檔案,提供範例資料,展示端口生成 EANCOM 文件時 XML 應採用的格式。也可以選擇這些文件並點選 Send 檢視生成的 EANCOM 文件。EANCOM 轉換為 XML
生成 XML 時,將 轉換型別 選擇為 EANCOM 轉換為 XML。選擇此選項後,應用程式僅處理 EANCOM 檔案。你需要在此頁面上配置交易夥伴協議的設定,以便應用程式在處理期間驗證 EANCOM 文件中的資訊。XML 檔案會生成到此端口的 Output 資料夾中。 點選 交易 索引標籤並選擇 More > Create Test Files,為多個 EANCOM 文件建立測試 EANCOM 檔案。可以選擇這些文件並點選 Send 檢視生成的 XML。與 XML Map 端口結合使用
上傳測試檔案
請求確認
確認會路由到流程圖中灰色虛線指定的端口,如下圖所示:
交換請求確認
這表示雙方之間已經發生了交換(但不一定表示已交換任何單獨的訊息)。它們會回應交換中的請求自動生成。功能性請求確認
功能性確認表示已接受單個訊息(如發票或採購訂單)。它們回應雙方的雙向協議生成。訊息發起者
要求回執
可以配置 XML 到 EDI 模式下的 EANCOM 端口,使其為訊息請求交換確認和功能性確認。在設定索引標籤上選擇 Technical acknowledgment (CONTRL) 和 Functional acknowledgment (CONTRL) 核取方塊,指示端口在適當的確認傳回並處理之前,保持傳輸的 Pending ACK 狀態。 ![接收 ACK(/public/images/edifact-ack-receive.png) 上圖從訊息發起者的角度顯示了完整的訊息交換。XML 到 EDI 模式下的 EANCOM 端口生成要交換的文件 (1),並將其保持為 Pending ACK 狀態。交易夥伴在其業務邏輯中處理傳輸,並根據配置的交換參數和雙方的雙向協議建立確認 (2)。確認傳回後,會由 EDI 到 XML 模式下的 EANCOM 端口解析,並路由到原始 EANCOM 端口(XML 到 EDI)以更新傳輸狀態 (3)。處理回執
當 EANCOM 端口在 EDI 到 XML 模式下收到交換和功能性 EANCOM 確認時,可以將該端口配置為自動將檢測到的任何確認路由到最初生成傳輸的 EANCOM 端口。在流程圖中,將接收端(EDI 到 XML)EANCOM 端口上的灰色圓圈拖到發起端(XML 到 EDI)EANCOM 端口上。 配置好的(XML 到 EDI)EANCOM 端口會將確認與原始訊息配對,並解析匹配的訊息。訊息回執
生成回執
當 EDI 到 XML 模式下的 EANCOM 端口處理從發起者收到的訊息並生成 XML 時,可以透過在設定索引標籤中選擇 Acknowledgment 核取方塊,指示端口自動生成 CONTRL 確認。將這些確認路由到 XML 到 EDI 模式下的 EANCOM 端口,以生成 EANCOM 確認。在流程圖中,將灰色圓圈拖到為此夥伴生成 EANCOM 文件的(XML 到 EDI)EANCOM 端口上。 ![生成 ACK(/public/images/edifact-ack-create.png) 如上圖所示,當合作伙伴傳送需要確認的訊息 (1) 時,為該夥伴配置的(EDI 到 XML)EANCOM 端口會自動生成確認 (2),該確認是包含該檔案相關交易資訊的 XML 檔案。此 XML 確認必須路由回(XML 到 EDI)EANCOM 端口 (3),以便在生成傳送回交易夥伴的 EANCOM 檔案時使用所有 EDI 方協議設定。主從層次結構:轉換 CPS 迴圈
在 EDI 文件中,大多數層次關係由 EDI 段的順序表示。某些 EDI 結構(如 DESADV 文件中的 CPS 迴圈)不遵循此約定,而是將層次關係嵌入 EDI 元素資料本身。這會使將 EDI 資料轉換為 XML 時保留這些層次關係變得困難。 EANCOM 端口透過高階頁面上的 巢狀迴圈 設定,支援在 CPS 段中保留層次關係。啟用後,端口會解析 CPS 段中的元素,以確定哪些段在層次關係中“屬於”其他段。這些層次關係會在輸出 XML 中體現為父子關係:換句話說,此設定會將 EDI 內容隱含的層次結構轉換為 XML 結構表示的層次結構。 本節將簡要說明 CPS 資料中如何編碼層次結構,以及啟用 巢狀迴圈 時如何將此層次結構轉換為 XML。CPS 層次結構
所有 CPS 段都有兩個有助於建立層次結構的值:- Id 值,用於標識當前 CPS 段(此值儲存在 CPS01,即 CPS 段中的第一個元素)
- 父 Id 值,用於標識當前 CPS 段的層次父級(此值儲存在 CPS02,即 CPS 段中的第二個元素)
將 CPS 層次結構轉換為 XML
啟用 巢狀迴圈 時,EANCOM 端口會自動處理 CPS 層次結構到 XML 層次結構的轉換。端口解析 CPS 段中的 Id 和父 Id 值,並確保生成的 XML 元素適當地巢狀(縮排)在表示其父元素的元素中。 換句話說,如果segmentA 的父 Id 值等於 segmentB,則生成的 XML 會將 segmentA 作為 segmentB 的子級。這樣,在轉換 EDI 資料時,層次關係會保留在 XML 結構中。