在 Azure Logic Apps 中監視 B2B 訊息的追蹤架構

適用於：Azure Logic Apps (使用量 + 標準)

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

AS2

• AS2 訊息追蹤架構
• AS2 訊息處置通知 （MDN） 追蹤架構

AS2 訊息追蹤結構描述

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

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

下表描述 AS2 訊息追蹤架構中的屬性：

屬性	必要	類型​	描述
senderPartnerName	No	String	AS2 訊息傳送者的合作夥伴名稱
receiverPartnerName	No	String	AS2 訊息接收者的合作夥伴名稱
as2To	Yes	String	取自於 AS2 訊息標頭的 AS2 訊息接收者名稱
as2From	Yes	String	取自於 AS2 訊息標頭的 AS2 訊息傳送者名稱
agreementName	No	String	據以解析訊息的 AS2 合約名稱
direction	Yes	String	訊息流程的方向，即 receive 或 send
messageId	No	String	取自於 AS2 訊息標頭的 AS2 訊息識別碼
dispositionType	No	String	訊息處理通知 (MDN) 處理型別值
fileName	No	String	取自於 AS2 訊息標頭的檔案名稱
isMessageFailed	Yes	布林值	AS2 訊息是否失敗
isMessageSigned	Yes	布林值	AS2 訊息是否已簽署
isMessageEncrypted	Yes	布林值	AS2 訊息是否已加密
isMessageCompressed	Yes	布林值	AS2 訊息是否已壓縮
correlationMessageId	No	String	AS2 訊息識別碼，將訊息與 MDN 相互關聯
incomingHeaders	No	JToken 的字典	內送 AS2 訊息標頭的詳細資料
outgoingHeaders	No	JToken 的字典	外寄 AS2 訊息標頭的詳細資料
isNrrEnabled	Yes	布林值	如果值為未知，是否要使用預設值
isMdnExpected	Yes	布林值	如果值為未知，是否要使用預設值
mdnType	Yes	列舉	允許的值：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 訊息追蹤架構中的屬性：

屬性	必要	類型​	描述
senderPartnerName	No	String	AS2 訊息傳送者的合作夥伴名稱
receiverPartnerName	No	String	AS2 訊息接收者的合作夥伴名稱
as2To	Yes	String	接收該 AS2 訊息的夥伴名稱
as2From	Yes	String	傳送該 AS2 訊息的夥伴名稱
agreementName	No	String	據以解析訊息的 AS2 合約名稱
direction	Yes	String	訊息流程的方向，即 receive 或 send
messageId	No	String	AS2 訊息識別碼
originalMessageId	No	String	AS2 原始訊息識別碼
dispositionType	No	String	MDN 處置型別值
isMessageFailed	Yes	布林值	AS2 訊息是否失敗
isMessageSigned	Yes	布林值	AS2 訊息是否已簽署
isNrrEnabled	Yes	布林值	如果值為未知，是否要使用預設值
statusCode	Yes	列舉	允許的值：Accepted、Rejected、及 AcceptedWithErrors
micVerificationStatus	Yes	列舉	允許的值：NotApplicable、Succeeded、及 Failed
correlationMessageId	No	String	相互關聯識別碼，其為已設定 MDN 的原始訊息識別碼
incomingHeaders	No	JToken 的字典	內送訊息標頭的詳細資料
outgoingHeaders	No	JToken 的字典	外寄郵件標頭的詳細資料

X12

• X12 交易集追蹤架構
• X12 交易集通知追蹤架構
• X12 交換追蹤架構
• X12 交換通知追蹤架構
• X12 功能群組追蹤架構
• X12 功能群組通知追蹤架構

X12 交易集追蹤結構描述

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

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

下表描述 X12 交易集追蹤架構中的屬性：

屬性	必要	類型​	描述
senderPartnerName	No	String	X12 訊息傳送者的夥伴名稱
receiverPartnerName	No	String	X12 訊息接收者的夥伴名稱
senderQualifier	Yes	String	傳送合作夥伴辨識符號
senderIdentifier	Yes	String	傳送合作夥伴識別碼
receiverQualifier	Yes	String	接收合作夥伴辨識符號
receiverQualifier	Yes	String	接收合作夥伴識別碼
agreementName	No	String	據以解析訊息的 X12 合約名稱
direction	Yes	列舉	訊息流程的方向，即 receive 或 send
interchangeControlNumber	No	String	交換控制編號
functionalGroupControlNumber	No	String	功能的控制編號
transactionSetControlNumber	No	String	交易集控制編號
CorrelationMessageId	No	String	相互關聯訊息識別碼，其是 {AgreementName}{GroupControlNumber}{TransactionSetControlNumber} 的組合
messageType	No	String	交易集或文件類型
isMessageFailed	Yes	布林值	X12 訊息是否失敗
isTechnicalAcknowledgmentExpected	Yes	布林值	X12 合約中是否設定技術通知
isFunctionalAcknowledgmentExpected	Yes	布林值	X12 合約中是否設定功能通知
needAk2LoopForValidMessages	Yes	布林值	有效的訊息是否需要 AK2 迴圈
segmentsCount	No	整數	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 交易集通知追蹤架構中的屬性：

屬性	必要	類型​	描述
senderPartnerName	No	String	X12 訊息傳送者的夥伴名稱
receiverPartnerName	No	String	X12 訊息接收者的夥伴名稱
senderQualifier	Yes	String	傳送合作夥伴辨識符號
senderIdentifier	Yes	String	傳送合作夥伴識別碼
receiverQualifier	Yes	String	接收合作夥伴辨識符號
receiverQualifier	Yes	String	接收合作夥伴識別碼
agreementName	No	String	據以解析訊息的 X12 合約名稱
direction	Yes	列舉	訊息流程的方向，即 receive 或 send
interchangeControlNumber	No	String	功能通知的交換控制編號。 僅針對傳送至夥伴的訊息而接收功能通知的傳送端，才填入值。
functionalGroupControlNumber	No	String	功能群組的交換控制編號。 僅針對傳送至夥伴的訊息而接收功能通知的傳送端，才填入值
isaSegment	No	String	訊息的 ISA 區段。 僅針對傳送至夥伴的訊息而接收功能通知的傳送端，才填入值
isaSegment	No	String	訊息的 GS 區段。 僅針對傳送至夥伴的訊息而接收功能通知的傳送端，才填入值
respondingfunctionalGroupControlNumber	No	String	回應交換控制編號
respondingFunctionalGroupId	No	String	回應功能群組識別碼，在通知中對應至 AK101
respondingtransactionSetControlNumber	No	String	回應交易集控制編號
respondingTransactionSetId	No	String	回應交易集識別碼，在通知中對應至 AK201
statusCode	Yes	布林值	交易集通知狀態碼
segmentsCount	Yes	列舉	具有這些允許值的通知狀態碼：Accepted、Rejected 和 AcceptedWithErrors
processingStatus	Yes	列舉	具有這些允許值的通知處理狀態：Received、Generated 和 Sent
CorrelationMessageId	No	String	相互關聯訊息識別碼，其是 {AgreementName}{GroupControlNumber}{TransactionSetControlNumber} 的組合
isMessageFailed	Yes	布林值	X12 訊息是否失敗
ak2Segment	No	String	接收的功能群組內交易集的通知
ak3Segment	No	String	報告資料區段中的錯誤
ak5Segment	No	String	報告是否接受或拒絕 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 交換追蹤架構中的屬性：

屬性	必要	類型​	描述
senderPartnerName	No	String	X12 訊息傳送者的夥伴名稱
receiverPartnerName	No	String	X12 訊息接收者的夥伴名稱
senderQualifier	Yes	String	傳送合作夥伴辨識符號
senderIdentifier	Yes	String	傳送合作夥伴識別碼
receiverQualifier	Yes	String	接收合作夥伴辨識符號
receiverQualifier	Yes	String	接收合作夥伴識別碼
agreementName	No	String	據以解析訊息的 X12 合約名稱
direction	Yes	列舉	訊息流程的方向，即 receive 或 send
interchangeControlNumber	No	String	交換控制編號
isaSegment	No	String	訊息 ISA 區段
isTechnicalAcknowledgmentExpected	布林值	X12 合約中是否設定技術通知
isMessageFailed	Yes	布林值	X12 訊息是否失敗
isa09	No	String	X12 文件交換日期
isa10	No	String	X12 文件交換時間
isa11	No	String	X12 交換控制標準識別碼
isa12	No	String	X12 交換控制版本號碼
isa14	No	String	已要求 X12 通知
isa15	No	String	用於測試或生產的指標
isa16	No	String	元素分隔符號

X12 交換通知追蹤結構描述

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

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

下表描述 X12 交換通知追蹤架構中的屬性：

屬性	必要	類型​	描述
senderPartnerName	No	String	X12 訊息傳送者的夥伴名稱
receiverPartnerName	No	String	X12 訊息接收者的夥伴名稱
senderQualifier	Yes	String	傳送合作夥伴辨識符號
senderIdentifier	Yes	String	傳送合作夥伴識別碼
receiverQualifier	Yes	String	接收合作夥伴辨識符號
receiverQualifier	Yes	String	接收合作夥伴識別碼
agreementName	No	String	據以解析訊息的 X12 合約名稱
direction	Yes	列舉	訊息流程的方向，即 receive 或 send
interchangeControlNumber	No	String	從合作夥伴收到的技術通知交換控制編號
isaSegment	No	String	從合作夥伴收到的技術通知 ISA 區段
respondingInterchangeControlNumber	No	String	從合作夥伴收到的技術通知交換控制編號
isMessageFailed	Yes	布林值	X12 訊息是否失敗
statusCode	Yes	列舉	具有這些允許值的交換通知狀態碼：Accepted、Rejected 和 AcceptedWithErrors
processingStatus	Yes	列舉	具有這些允許值的通知狀態：Received、Generated 和 Sent
ta102	No	String	交換日期
ta103	No	String	交換時間
ta105	No	String	交換說明碼

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	No	String	X12 訊息傳送者的夥伴名稱
receiverPartnerName	No	String	X12 訊息接收者的夥伴名稱
senderQualifier	Yes	String	傳送合作夥伴辨識符號
senderIdentifier	Yes	String	傳送合作夥伴識別碼
receiverQualifier	Yes	String	接收合作夥伴辨識符號
receiverQualifier	Yes	String	接收合作夥伴識別碼
agreementName	No	String	據以解析訊息的 X12 合約名稱
direction	Yes	列舉	訊息流程的方向，接收或傳送
interchangeControlNumber	No	String	交換控制編號
functionalGroupControlNumber	No	String	功能的控制編號
isaSegment	No	String	訊息 GS 區段
isTechnicalAcknowledgmentExpected	Yes	布林值	X12 合約中是否設定技術通知
isFunctionalAcknowledgmentExpected	Yes	布林值	X12 合約中是否設定功能通知
isMessageFailed	Yes	布林值	X12 訊息是否失敗
gs01	No	String	功能識別碼
gs02	No	String	應用程式傳送者的代碼
gs03	No	String	應用程式接收者的代碼
gs04	No	String	功能群組的日期
gs05	No	String	功能群組的時間
gs07	No	String	負責單位的代碼
gs08	No	String	版本、發行版本或產業的識別碼

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 功能群組通知追蹤架構中的屬性：

屬性	必要	類型​	描述
senderPartnerName	No	String	X12 訊息傳送者的夥伴名稱
receiverPartnerName	No	String	X12 訊息接收者的夥伴名稱
senderQualifier	Yes	String	傳送合作夥伴辨識符號
senderIdentifier	Yes	String	傳送合作夥伴識別碼
receiverQualifier	Yes	String	接收合作夥伴辨識符號
receiverQualifier	Yes	String	接收合作夥伴識別碼
agreementName	No	String	據以解析訊息的 X12 合約名稱
direction	Yes	列舉	訊息流程的方向，即 receive 或 send
interchangeControlNumber	No	String	從合作夥伴收到技術通知時，傳送端會填入的交換控制編號
functionalGroupControlNumber	No	String	從合作夥伴收到技術通知時，傳送端會填入的技術通知功能群組控制編號
isaSegment	No	String	同交換控制編號，但只在特定情況下才會填入
isaSegment	No	String	同功能群組控制編號，但只在特定情況下才會填入
respondingfunctionalGroupControlNumber	No	String	原始功能群組的控制編號
respondingFunctionalGroupId	No	String	在通知功能群組識別碼中對應至 AK101
isMessageFailed	布林值	X12 訊息是否失敗
statusCode	Yes	列舉	具有這些允許值的通知狀態碼：Accepted、Rejected 和 AcceptedWithErrors
processingStatus	Yes	列舉	具有這些允許值的通知處理狀態：Received、Generated 和 Sent
ak903	No	String	已接收交易集數目
ak904	No	String	所識別的功能群組中接受的交易集數目
ak9Segment	No	String	是否接受或拒絕 AK1 區段中識別的功能群組，以及原因

自訂

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

{
   "sourceType": "",
   "source": {
      "workflow": {
         "systemId": ""
      },
      "runInstance": {
         "runId": ""
      },
      "operation": {
         "operationName": "",
         "repeatItemScopeName": "",
         "repeatItemIndex": ,
         "trackingId": "",
         "correlationId": "",
         "clientRequestId": ""
      }
   },
   "events": [
      {
         "eventLevel": "",
         "eventTime": "",
         "recordType": "",
         "record": {}
      }
   ]
}

下表描述自訂追蹤架構中的屬性：

屬性	必要	類型​	描述
sourceType	Yes	String	具有下列允許值的執行來源類型：Microsoft.Logic/workflows、custom
來源	Yes	JToken 字串	如果來源類型是 Microsoft.Logic/workflows，則來源資訊必須遵循此結構描述。 如果來源類型為 custom，則結構描述為 JToken。
systemId	Yes	String	邏輯應用程式系統識別碼
runId	Yes	String	邏輯應用程式執行識別碼
operationName	Yes	String	作業 (例如動作或觸發程序) 的名稱
repeatItemScopeName	Yes	String	如果動作在 foreach 或 until 迴圈內，重複項目名稱
repeatItemIndex	Yes	整數	表示動作在 foreach 或 until 迴圈內，而且是重複的專案索引編號。
trackingId	No	String	追蹤識別碼，使訊息相互關聯
correlationId	No	String	相互關連識別碼，使訊息相互關聯
clientRequestId	No	String	用戶端可以填入此屬性，以使訊息相互關聯
eventLevel	Yes	String	事件的層級
eventTime	Yes	Datetime	事件的時間，以 UTC 格式：YYYY-MM-DDTHH:MM:SS.00000Z
recordType	Yes	String	僅具有此允許值的追蹤記錄類型：custom
記錄	Yes	JToken	僅限 JToken 格式的自訂記錄類型

下一步

• 使用 Azure 監視器記錄監視 B2B 訊息