X12 端口 - 知行之桥文档

X12 端口支援從 XML 生成 X12 檔案以及將 X12 檔案轉換為 XML。

核心功能

完整的雙向 EDI X12 與 XML 文件處理，支援所有交易集
交換頭和功能群組頭的驗證與生成
支援 997/999 功能確認（ACK）及自動路由
提供 HIPAA 合規性所需的 SNIP 驗證等高階功能

概覽

接收 X12 報文時，X12 端口會驗證 X12 互動標頭並將 X12 報文轉換為 XML。這是一個非常有用的準備步驟，因為 XML 是用於處理工作流程中資料的主要格式。X12 端口自動讀取輸入檔案以確定與報文相匹配的 X12 Schema，然後根據該 Schema 解析報文。生成 X12 報文時，X12 端口將 XML 檔案轉化為符合 X12 語法規則的 X12 報文，並應用此端口配置的 X12 交換頭資訊。這對於建立 X12 報文非常重要，此步驟發生在 XML 資料已在工作流程其他位置完成取得和轉換之後。

可以透過在端口的測試指示符設定中選擇 Test Data 來跳過交換頭驗證。

X12 端口還可以自動為傳入的 X12 報文生成 ACK。有關更多資訊，請參閱 X12 ACK 部分。

必要條件

開始之前，請確保已為需要處理的文件型別安裝了正確的 Schema。X12 端口本身支援以下 Schema 定義：00401、00403 和 00501。可以在安裝目錄的 app_data/x12_schemas 目錄中找到它們。下載並解壓 zip 存檔後，將整個資料夾放入 app_data/x12_schemas 目錄下適當命名的子目錄中。

端口配置

本節包含所有可配置的端口屬性。

設定索引標籤

轉換配置

與端口核心操作相關的設定。

設定	描述
端口 ID	端口的靜態唯一識別碼。
端口型別	顯示端口名稱及其功能描述。
端口描述	可選欄位，用於對端口及其在流中的角色進行自由描述。
轉換型別	端口是將 X12 報文轉換為 XML 檔案，還是將 XML 檔案轉換為 X12 報文。
動態處理交易夥伴	啟用後，端口自動從 EDI 交易中識別並跟蹤交易夥伴關係。停用後，您必須手動定義夥伴關係。更多資訊請參閱 EDI 交易夥伴索引標籤。

EDI 交易夥伴

設定	描述
交易夥伴識別碼 (ISA06)	標識 X12 通訊中的傳送方（生成 X12 文件時，此處應為您自己的識別碼）。僅在未勾選動態處理交易夥伴時適用。
個人識別碼 (ISA08)	標識 X12 通訊中的接收方（生成 X12 文件時，此處應為您交易夥伴的識別碼）。僅在未勾選動態處理交易夥伴時適用。

交換頭配置

與 X12 文件的交換頭相關的設定。生成文件時，這些設定將作為交換頭應用到生成的文件中。解析文件時，交換頭設定用於驗證傳入文件。

設定	描述
交易夥伴 ID 限定符 (ISA05)	透過為該值提供上下文來限定交易夥伴識別碼。
個人 ID 限定符 (ISA07)	透過為該值提供上下文來限定個人識別碼。
控制版本號 (ISA12)	標識交換的控制版本。
使用指示符 (ISA15)	交換的資料是否代表測試資料、生產資料或常規資訊。當此項設定為 Test Data 時，交換頭不會被驗證。
功能群組	選中此選項可自動將傳送者和接收者識別碼新增到高階索引標籤上的功能群組配置。

ACK

與生成和請求確認相關的設定。

設定	描述
TA1 ACK	是否傳送 TA1 交換確認。
功能 ACK	是否應傳回（接收時）和請求（傳送時）功能性 ACK。功能性 ACK 標識接收或拒絕已收到的交換和交換集。
功能 ACK 型別	選中此項以指定是否使用 997 或 999 功能確認。

範例檔案索引標籤

進階設定索引標籤

EDI 分隔符號

指定哪些字元作為元素、段等的分隔符號。

設定	描述
資料元素分隔符號	分隔文件中各個資料元素的字元。
元件元素分隔符號	分隔文件中元件資料結構內元素的字元。
段終止字元	指示文件中段結尾的字元。
字尾	附加到段終止字元中以區分段。

交換頭配置

與 X12 交換頭相關的其他設定。

設定	描述
授權限定符 (ISA01)	透過提供值的上下文來限定授權 ID 設定。
授權 ID (ISA02)	標識與交換關聯的授權級別。
安全限定符 (ISA03)	透過提供值的上下文來限定安全密碼設定。
安全密碼 (ISA04)	表示有關交換的安全資訊。
控制標準識別碼 (ISA11)	標識 X12 標準。唯一有效的值是 U。

功能群組配置

與 X12 文件的功能群組頭相關的設定。這些可選識別碼可以幫助對類似的交換進行分組或促進組織中的子定址。

設定	描述
交易夥伴識別碼 (GS02)	標識 X12 通訊中的傳送方。
個人識別碼 (GS03)	標識 X12 通訊中的接收方。
日期格式 (GS04)	日期戳的格式。
時間格式 (GS05)	時間戳的格式。
負責機構程式碼 (GS07)	標識 X12 標準的發行者。
識別碼程式碼 (GS08)	標識 X12 標準的版本、發行版和行業。

進階設定

先前類別中未包含的設定。

設定	描述
批次處理交易	一個交換（Interchange）可以包含多個交易。如果未選中，端口將為交換中的每個交易建立單獨的輸出檔案。如果選中，端口將同一個交換中的所有交易組織輸出在一個檔案中。僅當轉換型別為 X12 轉換為 XML 時適用。
使用引用 Id	選中後，將 X12 轉換為 XML 時，引用 Id 將用於命名 XML 元素。僅當轉換型別為 X12 轉換為 XML 時適用。例如：`<_143>value</_143>`。如果未選中，則引用指示符將用於命名 XML 元素：`<BEG03>value</BEG03>`
編碼	指定字元編碼（例如 ASCII 或 UTF-8）。
擴充套件限定符值	選中時，包含 EDI 限定符的 XML 元素包括包含限定符程式碼和值的子元素。例如： `<N101>` `<Code>ST</Code>` `<Value>Ship To</Value>` `</N101>`
功能 ACK	預設情況下，所有功能確認（997、999）都會路由到流程圖中選擇的端口，並且交易索引標籤中不會接收 XML 轉換。選中此項可使轉換後的 ACK 也包含在交易索引標籤中。除了新的 EDI 文件之外，這還允許將功能確認整合到目標源中。
生成描述為	將 X12 轉換為 XML 時，可以提供 X12 段和元素的描述作為 X12 資料的上下文。使用此下拉式清單可以選擇是否將此上下文新增為 XML 註釋或 XML 屬性。
HIPAA Schema	選中後，端口將使用一組單獨的 EDI Schema，並在轉換和驗證文件時應用 HIPAA 約束。對於除受 HIPAA 約束的醫療保健文件之外的 EDI 文件，此設定將被忽略。
HIPAA 278	兩個單獨的 Schema 可用於 278 文件，具體取決於這些文件是否應解釋為請求或回應。選中後，將使用請求 Schema；否則使用回應 Schema。
本地檔名方案	用於為端口輸出訊息分配檔名的方案。可在檔名中使用宏動態包含識別碼和時間戳等資訊。更多資訊請參閱宏。
巢狀迴圈	選中後，端口會檢測 EDI 資料中嵌入了層次關係的 EDI 結構，並生成 XML，其中這些層次關係表示為父子關係。有關詳細資訊，請參閱主從層次結構：轉換 HLLoop。
處理延遲	放置在交易索引標籤中的檔案的處理延遲時間（以秒為單位）。這是一項遺留設定。最佳做法是使用 File 端口來管理本地檔案系統，而不是使用此設定。
SNIP 驗證	啟用後，端口將執行前三個級別的 SNIP 驗證以確保 HIPAA 合規性：(1) 文件的語法完整性，(2) 是否存在所需的段以及重複段的適當重複，以及 (3) 索賠行專案和索賠總額之間正確的數學關係。更高階別的 SNIP 驗證 (4+) 可能需要 Validate 端口或自定義指令碼。
嚴格 Schema 驗證	當檢測到以下情況時，端口是否應忽略、警告或失敗：重複計數超過允許的數量、缺少必需的元素或段、無效的限定符和程式碼值、不允許的元素長度以及無效的元素值。選擇”停用”會關閉 Schema 驗證檢查。
跟蹤 ISA06	是否將 ISA06 值作為跟蹤頭新增到已處理的訊息中。
跟蹤 ISA08	是否將 ISA08 值作為跟蹤頭新增到已處理的訊息中。
跟蹤交易型別	是否將交易型別作為跟蹤頭新增到已處理的訊息中。
驗證識別碼	選中此項以確保已翻譯文件中的識別碼與端口配置中的識別碼匹配。
重複檔案操作	端口在收到控制編號曾經出現過的訊息（重複訊息）時應如何處理。設定為 `Ignore` 時，端口靜默跳過重複訊息並繼續處理。設定為 `Warn` 時，端口處理檔案但傳回警告。設定為 `Fail` 時，端口不接受檔案並傳回錯誤。
上傳 Schema	用於上傳 Schema 並將其安裝到端口的 Schema 資料夾中。如果 Schema 已存在，系統將詢問是否要覆蓋。
重置狀態	EDI 端口會跟蹤已使用的控制編號並遞增該數字，以確保未來的執行不會重複資料。使用此按鈕可在不更改任何已配置設定的情況下將計數器重置為初始狀態。

訊息

日誌

其他

EDI 交易夥伴索引標籤

自動化索引標籤

自動化設定

與端口自動處理檔案有關的設定。

設定	描述
傳送	指示端口在檔案就緒時自動傳送檔案的開關。
重發間隔	端口在重新傳送收到負面 ACK 的檔案之前等待的時間間隔。例如，如果交易夥伴收到檔案但檔案存在問題並行回負面 ACK，此設定指定在再次傳送檔案前等待多長時間。
最大嘗試次數 (async)	當請求功能性 ACK 時，端口處理輸入檔案的最大次數。是否成功基於在重發間隔內收到功能性 ACK。如果未傳回成功的功能性 ACK，端口將重新傳送檔案直到達到最大嘗試次數。如果設定為 0，則端口將無限次重新傳送檔案。

效能

告警索引標籤

SLA 索引標籤

轉換格式

以下各節詳細介紹了將 X12 轉換為 XML 的過程，以及將 XML 轉換為 X12 的過程。

X12 轉換為 XML

將轉換型別設定為 X12 轉換為 XML 指示端口將傳入的 X12 文件解析為 XML。端口首先讀取文件”交換”和”功能群組”部分的所有標頭資訊，並根據配置的端口設定驗證它們（除非測試指示符設定為 Test Data）。然後，端口解析文件中使用的特定 X12 Schema，並從磁碟上的 x12_schemas 資料夾載入 Schema。使用該 Schema，端口生成表示文件 X12 結構的 XML，使用文件中的值填充 XML，並以 XML 註釋或 XML 元素屬性（基於生成描述為的值）的形式為每個值提供上下文。要使用一組測試 X12 文件檢視此過程，請導航到 X12 端口的交易索引標籤（將轉換型別設定為 X12 轉換為 XML）並選擇更多 > 建立測試檔案。發票、採購訂單、採購訂單確認和發貨通知的 X12 文件會自動生成並放置在交易目錄中。端口處理這些測試檔案後，導航到交易索引標籤以檢視生成的 XML。一旦 X12 報文被轉換成 XML，資料就可以透過多種方式進行轉換和操作。通常，X12 資料需要儲存在資料庫或其他後端應用系統中。因為使用 XML 來表示這些後端系統中的插入，所以儲存 X12 資料就變成了簡單地將一個 XML 結構對映到另一個 XML 的問題。通常是用視覺化設計器驅動 XML Map 端口。

XML 轉換為 X12

將轉換型別設定為 XML 轉換為 X12 指示端口根據文件的 XML 表示形式生成 X12 文件。端口根據從 XML 解析的資料構建 X12 訊息後，會根據配置的端口設定新增功能群組和交換標頭。要使用一組測試 XML 檔案檢視此過程，請導航到 X12 端口的交易索引標籤（將轉換型別設定為 XML 轉換為 X12）並選擇更多 > 建立測試檔案。發票、採購訂單、採購訂單確認和發貨通知的 XML 檔案將自動生成並放置在交易目錄中。端口處理這些測試檔案後，導航到交易索引標籤以檢視生成的 X12 文件。

列印檢視

與 XML Map 端口配合使用

上傳測試檔案

X12 ACK

以下章節詳細介紹了三種 X12 ACK，以及期待、處理和生成 ACK 的方式。

交換 ACK、997 和 999

TA1 是一種普遍接受的交換確認形式。這表明雙方之間已經發生了資料交換，儘管不一定交換了具體報文。這作為接收方發給發件人的收據，表明接收方已成功收到 EDI 訊息，但未指定在處理訊息內容時是否存在任何問題。 997（版本 4010）、997（版本 5010）或 999 確認被視為功能性 ACK，即單個訊息（例如發票或採購訂單）已被接受的確認。這些是根據雙方的雙向協議生成的。

期待 ACK、處理 ACK 和生成 ACK

期待 ACK

X12 端口在 XML 轉換為 X12 模式下執行時，可以進行配置，以便可以要求交換和功能確認。在”設定”索引標籤的 ACK 部分中選中 TA1 ACK 或 功能 ACK 時，端口將保持傳輸的”Pending ACK”狀態，直到傳回並處理相應的 ACK。這意味著端口狀態可用於確定收件人是否已確認他們收到了交換。下圖顯示了從發票文件期待 ACK 時涉及的邏輯流程：

上圖中，以 XML 轉換為 X12 模式執行的 X12 端口生成要交換的文件 （1），在文件傳輸到交易夥伴時保持為 Pending ACK 狀態。交易夥伴根據其業務邏輯處理傳輸，並根據配置的交換參數建立確認 （2）。當確認傳回後，將根據下一部分 （3） 中的資訊進行處理。

處理 ACK

在典型的工作流程中，X12 ACK 將到達以 X12 轉換為 XML 模式執行的 X12 端口。可以將該 X12 端口配置為自動將所有收到的 ACK 路由到最初生成被確認文件的 X12 端口。在流畫布上，可以透過將 X12 轉換為 XML 模式下 X12 端口底部的灰色點拖動到 XML 轉換為 X12 模式下的 X12 端口上，來視覺化配置 X12 端口之間的 ACK 路由。一旦 XML 轉換為 X12 模式下的 X12 端口接收到路由的 ACK，會將 ACK 與原始訊息進行匹配，並將其狀態從 “Pending ACK” 更新為 “Sent”。

生成 ACK

當處於 X12 轉換為 XML 模式的 X12 端口收到一條訊息並生成相應的 XML 時，它可以自動為收到的訊息生成確認。為此，請在”設定”索引標籤的 ACK 部分中啟用 TA1 ACK 和/或Functional ACK expected。必須將這些確認路由到另一個 X12 端口（處於 XML 轉換為 X12 模式）以最終確定 ACK。ACK 路由到的端口將應用交換標頭，並將 ACK 傳遞到工作流程中的下一個端口，就像其他 X12 訊息一樣。要適當路由 ACK，請將 X12 轉換為 XML 模式下 X12 端口底部邊緣的灰色點拖動到 XML 轉換為 X12 模式下的 X12 端口上。下圖顯示了為收到的發票文件建立 ACK 時涉及的邏輯流程：

如上圖所示，在交易夥伴傳送了一條要求確認的訊息後 （1），X12 轉換為 XML 模式下的 X12 端口解析文件會自動生成一個 ACK （2）。該 ACK 是一個 XML 檔案，其中包含與交易相關的交易資訊。然後，此 XML ACK 將以 XML 轉換為 X12 模式 （3） 路由至 X12 端口，以便在將 ACK 傳送至交易夥伴之前使用交換標頭（和其他 EDI 方協議設定）。

主從層次結構：轉換 HLLoop

在 EDI 文件中，大多數層次結構關係由 EDI 段的順序表示。但一些 EDI 結構，例如 HLLoop（見於_預先裝運通知_或 X12 856s 中）不遵循此約定，而是將層次結構關係嵌入到 EDI 元素資料本身中，這使得將 EDI 資料轉換為 XML 時保留這些層次關係變得困難。 X12 端口透過高階索引標籤進階設定中的巢狀主從細節迴圈設定支援在 HLLoop 中保留層次結構關係。啟用後，端口將解析 HLLoop 段中的元素，以確定哪些段”屬於”層次關係中的其他段。這些層次結構關係在輸出的 XML 中反映為”父子關係”。換句話說，此設定將 EDI 內容隱含的層次結構轉換為 XML 結構表示的層次結構。本節將簡要說明如何在 HLLoop 資料中編碼層次結構，以及在啟用巢狀主從細節迴圈時如何將此層次結構轉換為 XML。

HLLoop 層次結構

所有 HL 段均具有兩個有助於建立層次結構的值：

ID 值，它標識當前的 HL 段（此值儲存在 HL01 或 HL 段中的第一個元素中）
父 ID 值，標識當前 HL 段的層次結構父級（此值儲存在 HL02 或 HL 段中的第二個元素中）

例如，假設 HL 段的 ID 值為 ‘2’。如果下一個 HL 段以分層關係”屬於”該段，則下一個 HL 段的父 ID 應為 “2”。如果 HL 段的父 ID 為 “0”，則表示該段沒有父級（即位於層次結構的頂層）。

HLLoop 範例

為了進一步闡明 HLLoop 資料中的層次結構關係，請使用以下 EDI 程式碼段作為樣本輸入（僅以 HL 開頭的行與確定資料層次結構相關；其餘段被包括在內以更緊密地代表實際的 EDI 資料）：

HL*1*0*S      // First HL loop, the shipment loop
TD3*RR*SEAU*1234567
HL*2*1*O      // Second HL loop, the order loop
PRF*PO111111
HL*3*2*P      // Third HL loop, the first package loop
MAN*UC*PACKAGE1
HL*4*3*I      // Fourth HL loop, the first item loop
MAN*UC*ITEM_1
HL*5*3*I      // Fifth HL loop, the second item loop
MAN*UC*ITEM_2
HL*6*2*P      // Sixth HL loop, the second package loop
MAN*UC*PACKAGE_2
HL*7*6*I      // Seventh HL loop, the third item loop
MAN*UC*ITEM_1
HL*8*6*I      // Eighth HL loop, the fourth item loop
MAN*UC*ITEM_3

在此資料中，第二個 HL 段以分層關係”屬於”第一個 HL 段。可以透過檢視以下段的 HL01 和 HL02 的值來確定：

第一個 HL 段的 HL01（ID）的值為 “1”
第二個 HL 段的 HL02（父 ID）的值也為 “1”

將父 ID 值與 ID 值進行匹配相同的過程可用於確定資料中的所有層次關係。

將 HLLoop 層次結構轉換為 XML

啟用巢狀主從細節迴圈時，X12 端口會自動處理 HL 層次結構到 XML 層次結構的轉換。端口從 EDI 輸入中解析 HL01 和 HL02 元素值，並確保 XML 元素正確巢狀（縮排）在代表其父元素的元素內。檢視 HL 層次結構如何轉換為 XML 層次結構，啟用巢狀主從細節迴圈時，將從上面的範例 HL 資料生成以下 XML 輸出：

<HLLoop1_S>
  <HL><HL01>1</HL01><HL02>0</HL02><HL03>S</HL03></HL>
  <TD3><TD301>RR</TD301><TD302>SEAU</TD302><TD303>1234567</TD303></TD3>
  <HLLoop1_O>
    <HL><HL01>2</HL01><HL02>1</HL02><HL03>O</HL03></HL>
    <PRF><PRF01>PO111111</PRF01></PRF>
    <HLLoop1_P>
      <HL><HL01>3</HL01><HL02>2</HL02><HL03>P</HL03></HL>
      <MAN><MAN01>UC</MAN01><MAN02>PACKAGE1</MAN02></MAN>
      <HLLoop1_I>
        <HL><HL01>4</HL01><HL02>3</HL02><HL03>I</HL03></HL>
        <MAN><MAN01>UC</MAN01><MAN02>ITEM_1</MAN02></MAN>
      </HLLoop1_I>
      <HLLoop1_I>
        <HL><HL01>5</HL01><HL02>3</HL02><HL03>I</HL03></HL>
        <MAN><MAN01>UC</MAN01><MAN02>ITEM_2</MAN02></MAN>
      </HLLoop1_I>
    </HLLoop1_P>
    <HLLoop1_P>
      <HL><HL01>6</HL01><HL02>2</HL02><HL03>P</HL03></HL>
      <MAN><MAN01>UC</MAN01><MAN02>PACKAGE2</MAN02></MAN>
      <HLLoop1_I>
        <HL><HL01>7</HL01><HL02>6</HL02><HL03>I</HL03></HL>
        <MAN><MAN01>UC</MAN01><MAN02>ITEM_1</MAN02></MAN>
      </HLLoop1_I>
      <HLLoop1_I>
        <HL><HL01>8</HL01><HL02>6</HL02><HL03>I</HL03></HL>
        <MAN><MAN01>UC</MAN01><MAN02>ITEM_3</MAN02></MAN>
      </HLLoop1_I>
    </HLLoop1_P>
  </HLLoop1_O>
</HLLoop1_S>

快速辨別差異有一定難度，但需要注意的關鍵是，HLLoop 段包含在其他段中（即，在 XML 中具有父子關係），這與原始 HL01 和 HL02 的值一致。

宏

範例

X12 操作

除了提供的操作之外，端口還可以提供將功能擴充套件到 ArcScript 中的操作。這些端口操作可以像任何其他 ArcScript 操作一樣呼叫，但必須透過 connector.rsc 端點呼叫，並且必須包含身分驗證權杖。下面列出了 X12 端口特定功能的操作。

x12Scan

從 X12 文件的標題中掃描標題值。

必須的參數

file：X12 檔案的路徑。

可選的參數

format：檔案格式。預設值為 ‘X12’。

輸出屬性

InterchangeSenderIdQualifier：傳送方 ID（ISA05）限定符。
InterchangeSenderId：傳送方 ID（ISA06）。
InterchangeReceiverIdQualifier：接收方 ID（ISA07）限定符。
InterchangeReceiverId：接收方 ID（ISA08）。
InterchangeControlNumber：唯一標識 EDI 交換的值（ISA13）。
FunctionalGroupSenderId：功能群組配置中傳送方 ID（GS02）。
FunctionalGroupReceiverId：功能群組配置中接收方 ID（GS03）。
DocumentType：檔案型別或交易集識別碼程式碼（ST01）。
StandardVersion：此交換中使用的 X12 標準的主要版本（例如 00401、00501）。

常見錯誤

以下列出了常見錯誤，以及原因和建議的解決方案。

錯誤：找不到 Schema 檔案（[schema 主要版本] [schema 文件型別]）

原因解析 X12 檔案時，首先在檔案中掃描 EDI 版本和文件型別，以確定在解析過程中使用哪種 Schema。該應用程式包含一組廣泛的 JSON 格式的 X12 Schema，儲存在應用程式目錄的 schemas 資料夾中（緊鄰 data 資料夾）。此錯誤表明應用程式找不到與檔案報告的主要版本和文件型別相匹配的 Schema 檔案。如果錯誤訊息中缺少 [schema major version] 值或 [schema document type] 值，則表明 EDI 文件不包含主要版本或文件型別。否則，這表明隨附的 Schema 定義集中未包含相應的 Schema。解決如果 EDI 檔案不包含 Schema 主版本或文件型別，請與交易夥伴（或 EDI 文件的其他來源）聯絡，告知他們這些值必須包含在訊息標頭中。否則，請從免費下載頁面取得合適的 Schema 版本。下載 Schema 資料夾並將其放置在以下位置之一：

在磁碟上的 Schema 資料夾內（例如 <ConnectorDirectory>/Resources/Schemas/）
如果一個 Schema 被多個端口使用，建議使用如下資料夾結構：<ApplicationDirectory>/schemas/<type>_schemas/<major version>。在此範例中，<type> 應為 x12。

錯誤：第 [line number] 行中標記為 [segment name] 的段在指定 Schema（[schema 主要版本] [schema 文件型別]）中不處於有效位置。這可能表示輸入檔案包含順序錯誤的段。

原因解析 X12 檔案時，首先在檔案中掃描 EDI 版本和文件型別，以確定在解析過程中使用哪種 Schema。該應用程式包含一組廣泛的 JSON 格式的 X12 Schema，儲存在根安裝目錄的 www\app_data 資料夾中。此錯誤表明剖析器在檔案中遇到的 EDI 段與相關文件 Schema 中定義的段的順序不匹配。這可能表明幾個不同的問題：

交易夥伴生成的 EDI 檔案有誤
EDI 檔案由不同於檔案中指示的 Schema 版本生成
EDI 檔案由自定義 Schema 生成

解決如果 EDI 檔案由自定義 Schema 生成，請將自定義 Schema 檔案（JSON 格式）放在讀取 EDI Schema 的資料夾中。端口透過按順序檢查以下位置來搜尋 Schema：

在磁碟上的 Schema 資料夾內（例如 <ConnectorDirectory>/Resources/Schemas/）
如果一個 Schema 被多個端口使用，建議使用如下資料夾結構：<ApplicationDirectory>/schemas/<type>_schemas/<major version>。在此範例中，<type> 應為 x12。

如果 EDI 檔案不是由自定義 Schema 生成的，則有兩種方法可以解決交易夥伴生成的 EDI 檔案與用於解析該檔案的 EDI Schema 之間的差異。

手動編輯適當的 EDI Schema 檔案（在上面的檔案路徑中找到），以調整段順序，使其與交易夥伴的 EDI 檔案匹配。錯誤訊息指示檔案中段與 Schema 定義不同的行。跟蹤段順序的 JSON 定義，直到找到差異為止，然後對 JSON 中的段重新排序以匹配交易夥伴提供的檔案。
與交易夥伴聯絡瞭解 EDI 檔案情況。確認檔案是根據檔案中報告的主要版本生成的，並說明未識別檔案中段的順序。

使用哪種方法取決於對特定文件型別的 EDI 段的熟悉程度（根據交易夥伴的檔案正確編輯 JSON Schema）和交易夥伴的靈活性（調整 EDI 檔案以回應有關錯誤的資訊）。

​核心功能

​概覽

​必要條件

​端口配置

​設定索引標籤

​轉換配置

​EDI 交易夥伴

​交換頭配置

​ACK

​範例檔案索引標籤

​進階設定索引標籤

​EDI 分隔符號

​交換頭配置

​功能群組配置

​進階設定

​訊息

​日誌

​其他

​EDI 交易夥伴索引標籤

​自動化索引標籤

​自動化設定

​效能

​告警索引標籤

​SLA 索引標籤

​轉換格式

​X12 轉換為 XML

​XML 轉換為 X12

​列印檢視

​與 XML Map 端口配合使用

​上傳測試檔案

​X12 ACK

​交換 ACK、997 和 999

​期待 ACK、處理 ACK 和生成 ACK

​期待 ACK

​處理 ACK

​生成 ACK

​主從層次結構：轉換 HLLoop

​HLLoop 層次結構

​HLLoop 範例

​將 HLLoop 層次結構轉換為 XML

​宏

​範例

​X12 操作

​x12Scan

​必須的參數

​可選的參數

​輸出屬性

​常見錯誤

​錯誤：找不到 Schema 檔案（[schema 主要版本] [schema 文件型別]）

​錯誤：第 [line number] 行中標記為 [segment name] 的段在指定 Schema（[schema 主要版本] [schema 文件型別]）中不處於有效位置。這可能表示輸入檔案包含順序錯誤的段。

核心功能

概覽

必要條件

端口配置

設定索引標籤

轉換配置

EDI 交易夥伴

交換頭配置

ACK

範例檔案索引標籤

進階設定索引標籤

EDI 分隔符號

交換頭配置

功能群組配置

進階設定

訊息

日誌

其他

EDI 交易夥伴索引標籤

自動化索引標籤

自動化設定

效能

告警索引標籤

SLA 索引標籤

轉換格式

X12 轉換為 XML

XML 轉換為 X12

列印檢視

與 XML Map 端口配合使用

上傳測試檔案

X12 ACK

交換 ACK、997 和 999

期待 ACK、處理 ACK 和生成 ACK

期待 ACK

處理 ACK

生成 ACK

主從層次結構：轉換 HLLoop

HLLoop 層次結構

HLLoop 範例

將 HLLoop 層次結構轉換為 XML

宏

範例

X12 操作

x12Scan

必須的參數

可選的參數

輸出屬性

常見錯誤

錯誤：找不到 Schema 檔案（[schema 主要版本] [schema 文件型別]）

錯誤：第 [line number] 行中標記為 [segment name] 的段在指定 Schema（[schema 主要版本] [schema 文件型別]）中不處於有效位置。這可能表示輸入檔案包含順序錯誤的段。