Azure Logic Apps 合約中 X12 訊息設定的參考
適用於:Azure Logic Apps (使用量 + 標準)
本參考描述您可以在 X12 合約中設定的屬性,以指定如何處理貿易夥伴之間的訊息。 根據您與與您交換訊息之合作夥伴的合約來設定這些屬性。
X12 接收設定
識別碼
屬性 | 說明 |
---|---|
ISA1 (授權限定符) | 您想要使用的授權限定符值。 預設值為 00 - 沒有存在授權資訊。 注意:如果您選取其他值,請指定 ISA2 屬性的值。 |
ISA2 | 當 ISA1 屬性不是 00 - 沒有授權資訊存在時要使用的授權資訊值。 這個屬性值必須至少有一個英數位元,且最大值為10。 |
ISA3 (安全性限定符) | 您想要使用的安全性限定符值。 預設值為 00 - 沒有安全性資訊存在。 注意:如果您選取其他值,請指定 ISA4 屬性的值。 |
ISA4 | 當 ISA3 屬性不是 00 - 沒有安全性資訊存在時要使用的安全性資訊值。 這個屬性值必須至少有一個英數位元,且最大值為10。 |
確認
屬性 | 說明 |
---|---|
TA1 必須是 | 將技術通知 (TA1) 傳回給交換傳送者。 |
必須是FA | 將功能通知 (FA) 傳回給交換傳送者。 針對FA Version 屬性,根據架構版本,選取997或999通知。 若要在已接受交易集的功能通知中啟用 AK2 循環的產生,請選取 [包含 AK2 / IK2 迴圈]。 |
結構描述
在本節中,請針對每個交易類型 (ST01) 和寄件者應用程式 (GS02) 從整合帳戶中選取架構。 EDI 接收管線會比對您在本節中設定的值與傳入訊息中的 ST01 和 GS02 值,以及傳入訊息的架構,來反組譯傳入訊息。 完成每個數據列之後,會自動顯示新的空白數據列。
屬性 | 說明 |
---|---|
版本 | 架構的 X12 版本 |
交易類型 (ST01) | 交易類型 |
寄件者應用程式 (GS02) | 寄件者應用程式 |
結構描述 | 您想要使用的架構檔案 |
信封
屬性 | 說明 |
---|---|
ISA11 使用方式 | 交易集中要使用的分隔符: - 標準標識碼:使用句號 (.) 進行小數表示法,而不是EDI接收管線中傳入檔的十進位表示法。 - 重複分隔符:指定重複出現的簡單數據元素或重複數據結構的分隔符。 例如,通常會使用克拉 (^) 作為重複分隔符。 針對 HIPAA 架構,您只能使用克拉。 |
控制編號
屬性 | 說明 |
---|---|
不允許交換控制編號重複專案 | 封鎖重複的交換。 檢查接收的交換控制編號 (ISA13) 的交換控制編號。 如果偵測到相符專案,EDI 接收管線不會處理交換。 若要指定執行檢查的天數,請輸入 [檢查是否有重複 ISA13] 屬性的值。 |
不允許群組控制編號重複專案 | 封鎖具有重複群組控制編號的交換。 |
不允許交易集控制編號重複專案 | 封鎖具有重複交易集控制編號的交換。 |
驗證
[預設] 資料列會顯示用於 EDI 訊息類型的驗證規則。 如果您想要定義不同的規則,請選取您希望規則設定為 true 的每個方塊。 完成每個數據列之後,會自動顯示新的空白數據列。
屬性 | 說明 |
---|---|
訊息類型 | EDI 訊息類型 |
EDI 驗證 | 針對架構的EDI屬性、長度限制、空白數據元素和尾端分隔符所定義的數據類型執行EDI驗證。 |
擴充驗證 | 如果數據類型不是EDI,則驗證會根據數據元素需求進行驗證,並允許重複、列舉和數據元素長度驗證(最小值或最大值)。 |
允許前置/尾端零 | 保留任何其他前置或尾端零和空格字元。 請勿移除這些字元。 |
修剪前置/尾端零 | 拿掉任何前置或尾端零和空格字元。 |
尾端分隔符原則 | 產生尾端分隔符。 - 不允許:禁止輸入交換中的尾端分隔符和分隔符。 如果交換具有尾端分隔符和分隔符,則會宣告交換無效。 - 選擇性:接受具有或不含尾端分隔符和分隔符的交換。 - 必要:輸入交換必須具有尾端分隔符和分隔符。 |
內部設定
屬性 | 說明 |
---|---|
將隱含十進位格式 Nn 轉換為基底 10 數值 | 將以 「Nn」 格式指定的 EDI 數字轉換成 base-10 數值。 |
如果允許尾端分隔符,請建立空的 XML 標記 | 讓交換傳送者包含尾端分隔符的空白 XML 標記。 |
將交換分割為交易集 - 發生錯誤時暫停交易集 | 將適當的信封套用至交易集,將交換中的每個交易集剖析為個別的 XML 檔。 只暫停驗證失敗的交易。 |
將交換分割為交易集 - 發生錯誤時暫停交換 | 藉由套用適當的信封,將交換中的每個交易集剖析成個別的 XML 檔。 當交換中的一或多個交易集失敗驗證時,暫停整個交換。 |
保留交換 - 發生錯誤時暫停交易集 | 讓交換保持不變,並針對整個批次交換建立 XML 檔。 只暫停驗證失敗的交易集,但繼續處理所有其他交易集。 |
保留交換 - 發生錯誤時暫停交換 | 讓交換保持不變,建立整個批次交換的 XML 檔。 當交換中的一或多個交易集失敗驗證時,暫停整個交換。 |
X12 傳送設定
識別碼
屬性 | 說明 |
---|---|
ISA1 (授權限定符) | 您想要使用的授權限定符值。 預設值為 00 - 沒有存在授權資訊。 注意:如果您選取其他值,請指定 ISA2 屬性的值。 |
ISA2 | 當 ISA1 屬性不是 00 - 沒有授權資訊存在時要使用的授權資訊值。 這個屬性值必須至少有一個英數位元,且最大值為10。 |
ISA3 (安全性限定符) | 您想要使用的安全性限定符值。 預設值為 00 - 沒有安全性資訊存在。 注意:如果您選取其他值,請指定 ISA4 屬性的值。 |
ISA4 | 當 ISA3 屬性不是 00 - 沒有安全性資訊存在時要使用的安全性資訊值。 這個屬性值必須至少有一個英數位元,且最大值為10。 |
確認
屬性 | 說明 |
---|---|
TA1 必須是 | 將技術通知 (TA1) 傳回給交換傳送者。 此設定會指定傳送訊息的主機夥伴在合約中向來賓合作夥伴要求通知。 主機合作夥伴會根據合約的接收設定來預期這些通知。 |
必須是FA | 將功能通知 (FA) 傳回給交換傳送者。 針對FA Version 屬性,根據架構版本,選取997或999通知。 此設定會指定傳送訊息的主機夥伴在合約中向來賓合作夥伴要求通知。 主機合作夥伴會根據合約的接收設定來預期這些通知。 |
結構描述
針對本節,請從整合帳戶中為每個交易類型 (ST01) 選取架構。 完成每個數據列之後,會自動顯示新的空白數據列。
屬性 | 說明 |
---|---|
版本 | 架構的 X12 版本 |
交易類型 (ST01) | 架構的交易類型 |
結構描述 | 您想要使用的架構檔案。 如果您先選取架構,系統會自動設定版本和交易類型。 |
信封
屬性 | 說明 |
---|---|
ISA11 使用方式 | 交易集中要使用的分隔符: - 標準標識碼:使用句號 (.) 進行小數表示法,而不是EDI傳送管線中輸出檔的十進位表示法。 - 重複分隔符:指定重複出現的簡單數據元素或重複數據結構的分隔符。 例如,通常會使用克拉 (^) 作為重複分隔符。 針對 HIPAA 架構,您只能使用克拉。 |
控制版本號碼
在本節中,針對每個交換,從整合帳戶中選取架構。 完成每個數據列之後,會自動顯示新的空白數據列。
屬性 | 說明 |
---|---|
控制版本號碼 (ISA12) | X12 標準的版本 |
使用指標 (ISA15) | 交換的內容,也就是 測試 數據、 信息 數據或 生產 數據 |
結構描述 | 要用於產生傳送至 EDI 傳送管線之 X12 編碼交換之 GS 和 ST 區段的架構。 |
GS1 | 選擇性地選取功能程序代碼。 |
GS2 | 選擇性,指定應用程式傳送者。 |
GS3 | 選擇性,指定應用程式接收者。 |
GS4 | 選擇性選取 [CCYYMMDD] 或 [YYMMDD]。 |
GS5 | 選擇性地選取 [HHMM]、[HHMMSS] 或 [HHMMSSdd]。 |
GS7 | 選擇性地選取負責機構的值。 |
GS8 | 選擇性,指定架構檔版本。 |
控制編號
屬性 | 說明 |
---|---|
交換控制編號 (ISA13) | 交換控制編號的值範圍,其最小值為 1,最大值為 999999999 |
群組控制編號 (GS06) | 群組控制編號的值範圍,其最小值可以是 1,最大值為 999999999 |
交易集控制編號 (ST02) | 交易集控制編號的值範圍,其最小值可以是 1,最大值為 999999999 - 前置詞:選擇性,英數位元值 - 後綴:選擇性、英數位元值 |
字元集和分隔符
[預設] 資料列會顯示做為訊息架構分隔符的字元集。 如果您不想使用 預設 字元集,您可以為每個訊息類型輸入不同的分隔符集。 完成每個數據列之後,會自動顯示新的空白數據列。
提示
若要提供特殊字元值,請將合約編輯為 JSON,並提供特殊字元的 ASCII 值。
屬性 | 說明 |
---|---|
要使用的字元集 | X12 字元集,也就是 Basic、 Extended 或 UTF8。 |
結構描述 | 您想要使用的架構。 選取架構之後,請根據下方的分隔符描述,選取要使用的字元集。 |
輸入類型 | 字元集的輸入類型 |
元件分隔符號 | 分隔複合數據元素的單一字元 |
資料元素分隔符號 | 在複合數據中分隔簡單數據元素的單一字元 |
取代字元分隔符 | 取代字元,會在產生輸出 X12 訊息時取代承載數據中的所有分隔符 |
區段結束字元 | 指出EDI區段結尾的單一字元 |
尾碼 | 要與區段標識碼搭配使用的字元。 如果您指定後綴,區段終止符數據元素可以是空的。 如果區段終止符保留空白,您必須指定後綴。 |
驗證
[預設] 資料列會顯示用於 EDI 訊息類型的驗證規則。 如果您想要定義不同的規則,請選取您希望規則設定為 true 的每個方塊。 完成每個數據列之後,會自動顯示新的空白數據列。
屬性 | 說明 |
---|---|
訊息類型 | EDI 訊息類型 |
EDI 驗證 | 針對架構的EDI屬性、長度限制、空白數據元素和尾端分隔符所定義的數據類型執行EDI驗證。 |
擴充驗證 | 如果數據類型不是EDI,則驗證會根據數據元素需求進行驗證,並允許重複、列舉和數據元素長度驗證(最小值或最大值)。 |
允許前置/尾端零 | 保留任何其他前置或尾端零和空格字元。 請勿移除這些字元。 |
修剪前置/尾端零 | 拿掉任何前置或尾端零和空格字元。 |
尾端分隔符原則 | 產生尾端分隔符。 - 不允許:禁止輸出交換中的尾端分隔符和分隔符。 如果交換具有尾端分隔符和分隔符,則會宣告交換無效。 - 選擇性:使用或不使用尾端分隔符和分隔符來傳送交換。 - 必要:輸出交換必須具有尾端分隔符和分隔符。 |
HIPAA 架構和訊息類型
當您使用 HIPAA 架構和 277 或 837 訊息類型時,您需要執行一些額外的步驟。 這些訊息類型的檔版本號碼 (GS8) 有超過九個字元,例如 “005010X222A1”。 此外,某些檔版本號碼會對應至變體訊息類型。 如果您未在架構和合約中參考正確的訊息類型,您會收到此錯誤訊息:
"The message has an unknown document type and did not resolve to any of the existing schemas configured in the agreement."
下表列出受影響的訊息類型、任何變體,以及對應至這些訊息類型的檔版本號碼:
訊息類型或變體 | 描述 | 檔案版本號碼 (GS8) |
---|---|---|
277 | 醫療保健信息狀態通知 | 005010X212 |
837_I | 醫療保健索賠機構 | 004010X096A1 005010X223A1 005010X223A2 |
837_D | 醫療保健索賠牙科 | 004010X097A1 005010X224A1 005010X224A2 |
837_P | 醫療保健索賠專業版 | 004010X098A1 005010X222 005010X222A1 |
當您使用這些檔案版本號碼時,您也需要停用 EDI 驗證,因為它們導致字元長度無效的錯誤。
若要指定這些檔案版本號碼和訊息類型,請遵循下列步驟:
注意
每個具有837_P、837_I或837_D類型的訊息都需要個別的合約。
在您的 HIPAA 架構中,將目前的訊息類型取代為您想要使用之檔版本號碼的 Variant 訊息類型。
例如,假設您想要搭配訊息類型使用檔版本號碼
005010X222A1
837
。 在您的架構中,請改為將每個"X12_00501_837"
值取代為"X12_00501_837_P"
值。若要更新架構,請遵循下列步驟:
在 Azure 入口網站,移至您的整合帳戶。 尋找並下載您的架構。 取代訊息類型並重新命名架構檔案,並將修訂后的架構上傳至整合帳戶。 如需詳細資訊,請參閱 編輯架構。
在合約的訊息設定中,選取修訂的架構。
在合約的物件中
schemaReferences
,新增另一個專案,指定符合您檔版本號碼的變體訊息類型。例如,假設您想要針對
837
訊息類型使用檔版本號碼005010X222A1
。 您的合約有一個schemaReferences
區段,其中包含下列屬性和值:"schemaReferences": [ { "messageId": "837", "schemaVersion": "00501", "schemaName": "X12_00501_837" } ]
編輯您的
schemaReferences
區段,看起來像下列範例:"schemaReferences": [ { "messageId": "837", "schemaVersion": "00501", "schemaName": "X12_00501_837_P" } ]
在合約的訊息設定中,如果您使用的是預設值,請清除每個訊息類型的EDI驗證複選框,或針對所有訊息類型清除EDI驗證。