在 Azure Logic Apps 的使用量工作流程中追蹤 B2B 訊息的結構描述

適用於:Azure Logic Apps (使用量)

備註

本文僅適用於消耗型邏輯應用程式工作流程。 如需監視標準邏輯應用程式的相關資訊,請參閱下列檔:

Azure Logic Apps 包含內建追蹤可讓您啟用工作流程的各個部分。 為了協助您監視企業對企業 (B2B) 訊息之成功傳遞或接收、錯誤和屬性,您可以在企業整合帳戶中建立和使用 AS2、X12 和自訂追蹤結構描述。 本參考指南說明這些追蹤結構描述的語法和屬性。

AS2

AS2 訊息 - 追蹤結構描述

下列語法描述追蹤 AS2 訊息的架構:

{
   "agreementProperties": {
      "senderPartnerName": "",
      "receiverPartnerName": "",
      "as2To": "",
      "as2From": "",
      "agreementName": ""
   },
   "messageProperties": {
      "direction": "",
      "messageId": "",
      "dispositionType": "",
      "fileName": "",
      "isMessageFailed": "",
      "isMessageSigned": "",
      "isMessageEncrypted": "",
      "isMessageCompressed": "",
      "incomingHeaders": {},
      "outgoingHeaders": {},
      "correlationMessageId": "",
      "isNrrEnabled": "",
      "isMdnExpected": "",
      "mdnType": ""
    }
}

AS2 訊息 - 協議屬性 (agreementProperties)

房產 為必填項目 類型 說明
senderPartnerName 否 繩子 AS2 訊息寄件者的合作夥伴名稱
receiverPartnerName 否 繩子 AS2 訊息接收者的合作夥伴名稱
as2To 是的 繩子 AS2 標頭中 AS2 訊息接收者的名稱
as2From 是的 繩子 AS2 訊息標頭中 AS2 訊息寄件者的名稱
agreementName 否 繩子 解析訊息之 AS2 合約的名稱

AS2 訊息 - messageProperties

房產 為必填項目 類型 說明
direction 是的 繩子 訊息流程方向 (send 或 receive)
messageId 否 繩子 AS2 訊息標頭中的 AS2 訊息識別碼
dispositionType 否 繩子 郵件處置通知 (MDN) 的處置類型
fileName 否 繩子 AS2 訊息標頭中的檔案名稱
isMessageFailed 是的 布林值 AS2 訊息是否失敗
isMessageSigned 是的 布林值 AS2 訊息是否已簽署
isMessageEncrypted 是的 布林值 AS2 訊息是否已加密
isMessageCompressed 是的 布林值 AS2 訊息是否已壓縮
incomingHeaders 否 JToken 字典 傳入 AS2 訊息標頭的詳細資料
outgoingHeaders 否 JToken 字典 外寄 AS2 訊息標頭的詳細資料
correlationMessageId 否 繩子 訊息識別碼,用於將 AS2 訊息與訊息處置通知 (MDN) 產生關聯
isNrrEnabled 是的 布林值 是否啟用不可否認性收據 (NRR)
isMdnExpected 是的 布林值 是否使用預設值 (如果未知)
mdnType 是的 例舉 允許的值:NotConfigured、Sync、及 Async

AS2 MDN - 追蹤架構

下列語法描述追蹤 AS2 MDN 的架構:

{
   "agreementProperties": {
      "senderPartnerName": "",
      "receiverPartnerName": "",
      "as2To": "",
      "as2From": "",
      "agreementName": ""
   },
   "messageProperties": {
      "direction": "",
      "messageId": "",
      "originalMessageId": "",
      "dispositionType": "",
      "isMessageFailed": "",
      "isMessageSigned": "",
      "isNrrEnabled": "",
      "statusCode": "",
      "micVerificationStatus": "",
      "correlationMessageId": "",
      "incomingHeaders": {},
      "outgoingHeaders": {}
   }
}

AS2 MDN - 協議屬性(agreementProperties)

房產 為必填項目 類型 說明
senderPartnerName 否 繩子 AS2 訊息寄件者的合作夥伴名稱
receiverPartnerName 否 繩子 AS2 訊息接收者的合作夥伴名稱
as2To 是的 繩子 AS2 標頭中 AS2 訊息接收者的名稱
as2From 是的 繩子 AS2 訊息標頭中 AS2 訊息寄件者的名稱
agreementName 否 繩子 解析訊息之 AS2 合約的名稱

AS2 MDN - messageProperties(訊息屬性)

房產 為必填項目 類型 說明
direction 是的 繩子 訊息流程方向 (send 或 receive)
messageId 否 繩子 AS2 訊息標頭中的 AS2 訊息識別碼
originalMessageId 否 繩子 原始 AS2 訊息標識碼
dispositionType 否 繩子 郵件處置通知 (MDN) 的處置類型
isMessageFailed 是的 布林值 AS2 訊息是否失敗
isMessageSigned 是的 布林值 AS2 訊息是否已簽署
isNrrEnabled 是的 布林值 是否啟用不可否認性收據 (NRR)
statusCode 是的 例舉 允許的值:Accepted、Rejected、及 AcceptedWithErrors
micVerificationStatus 是的 例舉 允許的值:NotApplicable、Succeeded、及 Failed
correlationMessageId 否 繩子 相互關聯識別碼,其為已設定 MDN 的原始訊息識別碼
incomingHeaders 否 JToken 字典 傳入 AS2 訊息標頭的詳細資料
outgoingHeaders 否 JToken 字典 外寄 AS2 訊息標頭的詳細資料

X12

X12 交易集 - 追蹤架構描述

下列語法描述追蹤 X12 交易集的架構:

{
   "agreementProperties": {
      "senderPartnerName": "",
      "receiverPartnerName": "",
      "senderQualifier": "",
      "senderIdentifier": "",
      "receiverQualifier": "",
      "receiverIdentifier": "",
      "agreementName": ""
   },
   "messageProperties": {
      "direction": "",
      "interchangeControlNumber": "",
      "functionalGroupControlNumber": "",
      "transactionSetControlNumber": "",
      "correlationMessageId": "",
      "messageType": "",
      "isMessageFailed": "",
      "isTechnicalAcknowledgmentExpected": "",
      "isFunctionalAcknowledgmentExpected": "",
      "needAk2LoopForValidMessages": "",
      "segmentsCount": ""
   }
}

X12 交易集 - agreementProperties

房產 為必填項目 類型 說明
senderPartnerName 否 繩子 合作夥伴 X12 訊息寄件者的名稱
receiverPartnerName 否 繩子 合作夥伴 X12 訊息接收者的名稱
senderQualifier 是的 繩子 合作夥伴 X12 訊息寄件人的限定詞
senderIdentifier 是的 繩子 合作夥伴 X12 訊息寄件者的識別碼
receiverQualifier 是的 繩子 合作夥伴 X12 訊息接收者的限定詞
receiverIdentifier 是的 繩子 合作夥伴 X12 訊息接收者的識別碼
agreementName 否 繩子 解析訊息之 X12 合約的名稱

X12 交易集 - 訊息屬性

房產 為必填項目 類型 說明
direction 是的 例舉 訊息流程方向 (send 或 receive)
interchangeControlNumber 否 繩子 功能通知的交換控制編號
functionalGroupControlNumber 否 繩子 功能通知的功能群組控制編號
transactionSetControlNumber 否 繩子 交易集的控制編號
correlationMessageId 否 繩子 訊息相互關聯識別碼,結合這些值:{agreementName}{interchange-or-functionalGroup-ControlNumber}{transactionSetControlNumber}
messageType 否 繩子 交易集或文件類型
isMessageFailed 是的 布林值 X12 訊息是否失敗
isTechnicalAcknowledgmentExpected 是的 布林值 X12 合約中是否設定技術通知
isFunctionalAcknowledgmentExpected 是的 布林值 X12 合約中是否設定功能通知
needAk2LoopForValidMessages 是的 布林值 有效的訊息是否需要 AK2 迴圈
segmentsCount 否 整數 X12 交易集的區段數目

X12 交易集通知 - 追蹤結構描述

下列語法描述追蹤 X12 交易集通知的架構:

{
   "agreementProperties": {
      "senderPartnerName": "",
      "receiverPartnerName": "",
      "senderQualifier": "",
      "senderIdentifier": "",
      "receiverQualifier": "",
      "receiverIdentifier": "",
      "agreementName": ""
   },
   "messageProperties": {
      "direction": "",
      "interchangeControlNumber": "",
      "functionalGroupControlNumber": "",
      "isaSegment": "",
      "gsSegment": "",
      "respondingFunctionalGroupControlNumber": "",
      "respondingFunctionalGroupId": "",
      "respondingTransactionSetControlNumber": "",
      "respondingTransactionSetId": "",
      "statusCode": "",
      "processingStatus": "",
      "correlationMessageId": "",
      "isMessageFailed": "",
      "ak2Segment": "",
      "ak3Segment": "",
      "ak5Segment": ""
   }
}

X12 交易集通知 - agreementProperties

房產 為必填項目 類型 說明
senderPartnerName 否 繩子 合作夥伴 X12 訊息寄件者的名稱
receiverPartnerName 否 繩子 合作夥伴 X12 訊息接收者的名稱
senderQualifier 是的 繩子 合作夥伴 X12 訊息寄件人的限定詞
senderIdentifier 是的 繩子 合作夥伴 X12 訊息寄件者的識別碼
receiverQualifier 是的 繩子 合作夥伴 X12 訊息接收者的限定詞
receiverIdentifier 是的 繩子 合作夥伴 X12 訊息接收者的識別碼
agreementName 否 繩子 解析訊息之 X12 合約的名稱

X12 交易集通知 - messageProperties

房產 為必填項目 類型 說明
direction 是的 例舉 訊息流程方向 (send 或 receive)
interchangeControlNumber 否 繩子 功能通知的交換控制編號。 只有在收到傳送給合作夥伴之訊息的功能通知時,才會為寄件者填入此值。
functionalGroupControlNumber 否 繩子 功能通知的功能群組控制編號。 只有在收到傳送給合作夥伴之訊息的功能通知時,才會為寄件者填入此值。
isaSegment 否 繩子 X12 訊息的交換控制標頭 (ISA) 區段。 只有在收到傳送給合作夥伴之訊息的功能通知時,才會為寄件者填入此值。
gsSegment 否 繩子 GS 區段在 X12 訊息中。 只有在收到傳送給合作夥伴之訊息的功能通知時,才會為寄件者填入此值。
respondingFunctionalGroupControlNumber 否 繩子 回應功能組的控制號碼
respondingFunctionalGroupId 否 繩子 對應至通知中 AK101 之回應功能群組的識別碼
respondingTransactionSetControlNumber 否 繩子 回應交易集的控制編號
respondingTransactionSetId 否 繩子 對應至通知中 AK201 之回應交易集的識別碼
statusCode 是的 布林值 交易集的確認狀態碼
processingStatus 是的 例舉 具有下列允許值的確認處理狀態: Received、Generated及 Sent
correlationMessageId 否 繩子 訊息相互關聯識別碼,結合這些值:{agreementName}{interchange-or-functionalGroup-ControlNumber}{transactionSetControlNumber}
isMessageFailed 是的 布林值 X12 訊息是否失敗
ak2Segment 否 繩子 已接收功能群組中交易集的通知
ak3Segment 否 繩子 報告資料區段中的錯誤
ak5Segment 否 繩子 報告是否接受或拒絕 AK2 區段中識別的交易集,以及原因

X12 交換 - 追蹤結構描述

下列語法描述追蹤 X12 交換的架構:

{
   "agreementProperties": {
      "senderPartnerName": "",
      "receiverPartnerName": "",
      "senderQualifier": "",
      "senderIdentifier": "",
      "receiverQualifier": "",
      "receiverIdentifier": "",
      "agreementName": ""
   },
   "messageProperties": {
      "direction": "",
      "interchangeControlNumber": "",
      "isaSegment": "",
      "isTechnicalAcknowledgmentExpected": "",
      "isMessageFailed": "",
      "isa09": "",
      "isa10": "",
      "isa11": "",
      "isa12": "",
      "isa14": "",
      "isa15": "",
      "isa16": ""
   }
}

X12 交換 - agreementProperties

房產 為必填項目 類型 說明
senderPartnerName 否 繩子 合作夥伴 X12 訊息寄件者的名稱
receiverPartnerName 否 繩子 合作夥伴 X12 訊息接收者的名稱
senderQualifier 是的 繩子 合作夥伴 X12 訊息寄件人的限定詞
senderIdentifier 是的 繩子 合作夥伴 X12 訊息寄件者的識別碼
receiverQualifier 是的 繩子 合作夥伴 X12 訊息接收者的限定詞
receiverIdentifier 是的 繩子 合作夥伴 X12 訊息接收者的識別碼
agreementName 否 繩子 解析訊息之 X12 合約的名稱

X12 交換 - messageProperties

房產 為必填項目 類型 說明
direction 是的 例舉 訊息流程方向 (send 或 receive)
interchangeControlNumber 否 繩子 交換控制編號
isaSegment 否 繩子 X12 訊息的 ISA 區段
isMessageFailed 是的 布林值 X12 訊息是否失敗
isTechnicalAcknowledgmentExpected 是的 布林值 X12 合約中是否設定技術通知
isa09 否 繩子 X12 文件交換日期
isa10 否 繩子 X12 文件交換時間
isa11 否 繩子 X12 交換控制標準識別碼
isa12 否 繩子 X12 交換控制版本號碼
isa14 否 繩子 已要求 X12 通知
isa15 否 繩子 用於測試或生產的指標
isa16 否 繩子 元素分隔符號

X12 交換通知 - 追蹤結構描述

下列語法描述追蹤 X12 交換通知的架構:

{
   "agreementProperties": {
      "senderPartnerName": "",
      "receiverPartnerName": "",
      "senderQualifier": "",
      "senderIdentifier": "",
      "receiverQualifier": "",
      "receiverIdentifier": "",
      "agreementName": ""
   },
   "messageProperties": {
      "direction": "",
      "interchangeControlNumber": "",
      "isaSegment": "",
      "respondingInterchangeControlNumber": "",
      "isMessageFailed": "",
      "statusCode": "",
      "processingStatus": "",
      "ta102": "",
      "ta103": "",
      "ta105": ""
   }
}

X12 交換通知 - agreementProperties

房產 為必填項目 類型 說明
senderPartnerName 否 繩子 合作夥伴 X12 訊息寄件者的名稱
receiverPartnerName 否 繩子 合作夥伴 X12 訊息接收者的名稱
senderQualifier 是的 繩子 合作夥伴 X12 訊息寄件人的限定詞
senderIdentifier 是的 繩子 合作夥伴 X12 訊息寄件者的識別碼
receiverQualifier 是的 繩子 合作夥伴 X12 訊息接收者的限定詞
receiverIdentifier 是的 繩子 合作夥伴 X12 訊息接收者的識別碼
agreementName 否 繩子 解析訊息之 X12 合約的名稱

X12 交換通知 - messageProperties

房產 為必填項目 類型 說明
direction 是的 例舉 訊息流程方向 (send 或 receive)
interchangeControlNumber 否 繩子 從合作夥伴接收之技術通知交換控制編號
isaSegment 否 繩子 從合作夥伴接收之技術通知的 ISA 區段
respondingInterchangeControlNumber 否 繩子 從合作夥伴接收之技術通知交換控制編號
isMessageFailed 是的 布林值 X12 訊息是否失敗
statusCode 是的 例舉 具有這些允許值的交換通知狀態碼:Accepted、Rejected 和 AcceptedWithErrors
processingStatus 是的 例舉 具有下列允許值的確認處理狀態: Received、Generated及 Sent
ta102 否 繩子 交換日期
ta103 否 繩子 交換時間
ta105 否 繩子 交換說明碼

X12 功能群組 - 追蹤模式

下列語法結構描述用於追蹤 X12 功能群組的結構:

{
   "agreementProperties": {
      "senderPartnerName": "",
      "receiverPartnerName": "",
      "senderQualifier": "",
      "senderIdentifier": "",
      "receiverQualifier": "",
      "receiverIdentifier": "",
      "agreementName": ""
   },
   "messageProperties": {
      "direction": "",
      "interchangeControlNumber": "",
      "functionalGroupControlNumber": "",
      "gsSegment": "",
      "isTechnicalAcknowledgmentExpected": "",
      "isFunctionalAcknowledgmentExpected": "",
      "isMessageFailed": "",
      "gs01": "",
      "gs02": "",
      "gs03": "",
      "gs04": "",
      "gs05": "",
      "gs07": "",
      "gs08": ""
   }
}

X12 功能群組 - 協議屬性

房產 為必填項目 類型 說明
senderPartnerName 否 繩子 合作夥伴 X12 訊息寄件者的名稱
receiverPartnerName 否 繩子 合作夥伴 X12 訊息接收者的名稱
senderQualifier 是的 繩子 合作夥伴 X12 訊息寄件人的限定詞
senderIdentifier 是的 繩子 合作夥伴 X12 訊息寄件者的識別碼
receiverQualifier 是的 繩子 合作夥伴 X12 訊息接收者的限定詞
receiverIdentifier 是的 繩子 合作夥伴 X12 訊息接收者的識別碼
agreementName 否 繩子 解析訊息之 X12 合約的名稱

X12 功能群組 - messageProperties

房產 為必填項目 類型 說明
direction 是的 例舉 訊息流程方向 (send 或 receive)
interchangeControlNumber 否 繩子 交換控制編號
functionalGroupControlNumber 否 繩子 功能群體控制號碼
gsSegment 否 繩子 X12 訊息中的 GS 區段
isTechnicalAcknowledgmentExpected 是的 布林值 X12 合約中是否設定技術通知
isFunctionalAcknowledgmentExpected 是的 布林值 X12 合約中是否設定功能通知
isMessageFailed 是的 布林值 X12 訊息是否失敗
gs01 否 繩子 功能群組識別碼代碼
gs02 否 繩子 應用程式寄件者程式碼
gs03 否 繩子 應用程式接收者程式碼
gs04 否 繩子 功能群組的日期
gs05 否 繩子 功能群組的時間
gs07 否 繩子 負責單位的代碼
gs08 否 繩子 版本、發行版本或產業的識別碼

X12 功能群組通知 - 追蹤結構描述

下列語法描述追蹤 X12 功能群組通知的架構:

{
   "agreementProperties": {
      "senderPartnerName": "",
      "receiverPartnerName": "",
      "senderQualifier": "",
      "senderIdentifier": "",
      "receiverQualifier": "",
      "receiverIdentifier": "",
      "agreementName": ""
   },
   "messageProperties": {
      "direction": "",
      "interchangeControlNumber": "",
      "functionalGroupControlNumber": "",
      "isaSegment": "",
      "gsSegment": "",
      "respondingFunctionalGroupControlNumber": "",
      "respondingFunctionalGroupId": "",
      "isMessageFailed": "",
      "statusCode": "",
      "processingStatus": "",
      "ak903": "",
      "ak904": "",
      "ak9Segment": ""
   }
}

X12 功能群組通知 - agreementProperties

房產 為必填項目 類型 說明
senderPartnerName 否 繩子 合作夥伴 X12 訊息寄件者的名稱
receiverPartnerName 否 繩子 合作夥伴 X12 訊息接收者的名稱
senderQualifier 是的 繩子 合作夥伴 X12 訊息寄件人的限定詞
senderIdentifier 是的 繩子 合作夥伴 X12 訊息寄件者的識別碼
receiverQualifier 是的 繩子 合作夥伴 X12 訊息接收者的限定詞
receiverIdentifier 是的 繩子 合作夥伴 X12 訊息接收者的識別碼
agreementName 否 繩子 解析訊息之 X12 合約的名稱

X12 函數群組確認 - messageProperties

房產 為必填項目 類型 說明
direction 是的 例舉 訊息流程方向 (send 或 receive)
functionalGroupControlNumber 否 繩子 技術通知的功能群組控制編號。 合作夥伴發出技術確認後,系統會自動為寄件者填入此值。
interchangeControlNumber 否 繩子 交換控制編號。 合作夥伴發出技術確認後,系統會自動為寄件者填入此值。
isaSegment 否 繩子 與 interchangeControlNumber 相同,但只會在特定情況下填入
gsSegment 否 繩子 與 functionalGrouControlNumber相同,但只會在特定情況下填入
respondingFunctionalGroupControlNumber 否 繩子 原始功能群組的控制編號
respondingFunctionalGroupId 否 繩子 在通知功能群組識別碼中對應至 AK101
isMessageFailed 是的 布林值 X12 訊息是否失敗
statusCode 是的 例舉 具有這些允許值的通知狀態碼:Accepted、Rejected 和 AcceptedWithErrors
processingStatus 是的 例舉 具有下列允許值的確認處理狀態: Received、Generated及 Sent
ak903 否 繩子 收到的交易集數目
ak904 否 繩子 已識別功能群組中接受的交易集數目
ak9Segment 否 繩子 是否接受或拒絕 AK1 區段中識別的功能群組,以及原因

習慣

您可以設定自訂追蹤,以記錄邏輯應用程式工作流程的開頭到結尾的事件。 例如,您可以從包括工作流程、SQL Server、BizTalk Server 的層或任何其他層記錄事件。 下一節提供自訂追蹤結構描述程式碼,您可以在工作流程外部的層中使用。

下列語法描述自訂追蹤的模式:

{
   "sourceType": "",
   "source": {
      "workflow": {
         "systemId": ""
      },
      "runInstance": {
         "runId": ""
      },
      "operation": {
         "operationName": "",
         "repeatItemScopeName": "",
         "repeatItemIndex": ,
         "trackingId": "",
         "correlationId": "",
         "clientRequestId": ""
      }
   },
   "events": [
      {
         "eventLevel": "",
         "eventTime": "",
         "recordType": "",
         "record": {}
      }
   ]
}
房產 為必填項目 類型 說明
sourceType 是的 繩子 具有下列允許值的執行來源類型: Microsoft.Logic/workflows, custom**
source 是的 JToken 字串 如果來源類型是 Microsoft.Logic/workflows,則來源資訊必須遵循所描述的綱目。 如果來源類型是 custom,則綱目具有 JToken 類型。
systemId 是的 繩子 邏輯應用程式的系統識別碼
runId 是的 繩子 邏輯應用程式的執行識別碼
operationName 是的 繩子 作業的名稱,例如動作或觸發程序
repeatItemScopeName 是的 繩子 如果動作位於foreach 或 until 迴圈中,請重複項目名稱。
repeatItemIndex 是的 整數 重複的項目索引編號,以指出動作位於foreach或until迴圈中
trackingId 否 繩子 追蹤識別碼,使訊息相互關聯
correlationId 否 繩子 相互關連識別碼,使訊息相互關聯
clientRequestId 否 繩子 用戶端可以填入此屬性,以使訊息相互關聯
eventLevel 是的 繩子 事件層級
eventTime 是的 Datetime UTC 格式的事件時間:YYYY-MM-DDTHH:MM:SS.00000Z
recordType 是的 繩子 僅具有此允許值的追蹤記錄類型: custom
record 是的 JToken 僅限於 JToken 格式的自訂記錄類型