次の方法で共有


Azure Logic Apps の標準ワークフローでの B2B トランザクションのスキーマの追跡 (プレビュー)

適用対象: Azure Logic Apps (Standard)

この機能はプレビュー段階にあり、「Microsoft Azure プレビューの追加使用条件」が適用されます。

Azure Logic Apps には、標準ワークフローの一部に対して有効にできる組み込みの追跡が含まれています。 このガイドでは、企業間 (B2B) メッセージの正常な配信または受信、エラー、プロパティを監視するために、トランザクションの B2B 追跡データを格納するテーブルをより深く理解するのに役立ちます。

この記事は、Standard ロジック アプリワークフローにのみ適用されます。 従量課金ロジック アプリ ワークフローの監視については、次のドキュメントを参照してください。

AS2 の AS2TrackRecords の追跡テーブル

AS2TrackRecords という名前の Azure Database Explorer テーブルには、すべての AS2 追跡データが格納されます。 次の例では、このテーブルを作成するクエリと、テーブル列を指定するために必要な順序について説明します。

.create table AS2TrackRecords (
   IntegrationAccountSubscriptionId: string, // Subscription ID for the integration account.
   IntegrationAccountResourceGroup: string, // Resource group for the integration account.
   IntegrationAccountName: string, // Name for the integration account.
   IntegrationAccountId: string, // ID for the integration account.
   WorkflowRunOperationInfo: dynamic, // Operation information for the workflow run. This dynamic type uses a specific JSON schema.
   ClientRequestId: string, // Client request ID.
   EventTime: datetime, // Time of the event.
   Error: dynamic, // Error, if any.
   RecordType: string, // Type of tracking record.
   Direction: string, // Message flow direction, which is either 'send' or 'receive'.
   IsMessageFailed: bool, // Whether the AS2 message failed.
   MessageProperties: dynamic, // Message properties. This dynamic type uses different schema based on the tracking record type.
   AdditionalProperties: dynamic, // Additional properties.
   TrackingId: string, // Custom tracking ID, if any.
   AgreementName: string, // Name for the AS2 agreement that resolves the messages.
   As2From: string, // Name for the AS2 message sender in the AS2 message headers.
   As2To: string, // Name for the AS2 message receiver in the AS2 headers.
   ReceiverPartnerName: string, // Partner name for the AS2 message receiver.
   SenderPartnerName: string, // Partner name for the AS2 message sender.
   MessageId: string, // AS2 message ID.
   OriginalMessageId: string,// Original AS2 message ID.
   CorrelationMessageId: string, // Message ID for correlating AS2 messages with Message Disposition Notifications (MDNs).
   IsMdnExpected: bool // Whether the Message Dispoition Notification (MDN) is expected.
)

WorkflowRunOperationInfo テーブル列には、特定の JSON スキーマを使用する動的な型構造があります。 MessageProperties テーブル列にも動的な型構造がありますが、追跡レコードの種類に基づいて異なる JSON スキーマが使用されます。 詳細については、以下のセクションを参照してください。

AS2 追跡レコード - MessageProperties スキーマ

MessageProperties テーブル列には、追跡レコードの種類に基づいて、異なる JSON スキーマを使用する動的な型構造があります。

AS2 メッセージ - MessageProperties スキーマ

次の構文では、追跡レコードの種類が AS2 メッセージの場合の MessageProperties スキーマについて説明します。

{
   "direction": "",
   "messageId": "",
   "dispositionType": "",
   "fileName": "",
   "isMessageFailed": "",
   "isMessageSigned": "",
   "isMessageEncrypted": "",
   "isMessageCompressed": "",
   "correlationMessageId": "",
   "incomingHeaders": {},
   "outgoingHeaders": {},
   "isNrrEnabled": "",
   "isMdnExpected": "",
   "mdnType": ""
}
財産 タイプ 説明
方向 メッセージ フローの方向 (send または receive)
messageId AS2 メッセージ ヘッダーに含まれる AS2 メッセージ ID
dispositionType メッセージ処分通知 (MDN) の処分タイプ
fileName AS2 メッセージ ヘッダーからのファイル名
isMessageFailed ブール値 AS2 メッセージが失敗したかどうか
isMessageSigned ブール値 AS2 メッセージが署名されたかどうか
isMessageEncrypted ブール値 AS2 メッセージが暗号化されたかどうか
isMessageCompressed ブール値 AS2 メッセージが圧縮されたかどうか
correlationMessageId AS2 メッセージをメッセージ処理通知 (MDN) と関連付けするためのメッセージ ID
incomingHeaders JToken 辞書 受信 AS2 メッセージのヘッダーの詳細
outgoingHeaders JToken 辞書 AS2 送信メッセージのヘッダー詳細
isNrrEnabled ブール値 レシートの否認不可 (NRR) が有効になっているかどうか
isMdnExpected ブール値 メッセージ処理通知 (MDN) が必要か
mdnType Enum 使用できる値: NotConfiguredSync、および Async

AS2 MDN - MessageProperties スキーマ

次の構文では、追跡レコードの種類が AS2 MDN の場合の MessageProperties スキーマについて説明します。

{
   "direction": "",
   "messageId": "",
   "originalMessageId": "",
   "dispositionType": "",
   "isMessageFailed": "",
   "isMessageSigned": "",
   "isNrrEnabled": "",
   "statusCode": "",
   "micVerificationStatus" "",
   "correlationMessageId": "",
   "incomingHeaders": {},
   "outgoingHeaders": {},
}
財産 タイプ 説明
方向 メッセージ フローの方向 (send または receive)
messageId AS2 メッセージ ヘッダーに含まれる AS2 メッセージ ID
originalMessageId 元の AS2 メッセージのメッセージ ID
dispositionType メッセージ処分通知 (MDN) の処分タイプ
isMessageFailed ブール値 AS2 メッセージが失敗したかどうか
isMessageSigned ブール値 AS2 メッセージが署名されたかどうか
isNrrEnabled ブール値 レシートの否認不可 (NRR) が有効になっているかどうか
statusCode Enum 使用できる値: AcceptedRejected、および AcceptedWithErrors
micVerificationStatus Enum 使用できる値: NotApplicableSucceeded、および Failed
correlationMessageId 関連付け ID。MDN が構成されている元のメッセージの ID です。
incomingHeaders JToken 辞書 受信 AS2 メッセージのヘッダーの詳細
outgoingHeaders JToken 辞書 AS2 送信メッセージのヘッダー詳細

X12の追跡テーブルEdiTrackRecords

EdiTrackRecords という名前の Azure Database Explorer テーブルには、すべての X12 追跡データが格納されます。 次の例では、このテーブルを作成するクエリと、テーブル列を指定するために必要な順序について説明します。

.create table EdiTrackRecords (
   IntegrationAccountSubscriptionId: string, // Subscription ID for the integration account.
   IntegrationAccountResourceGroup: string, // Resource group for the integration account.
   IntegrationAccountName: string, // Name for the integration account.
   IntegrationAccountId: string, // ID for the integration account.
   WorkflowRunOperationInfo: dynamic, // Operation information for the workflow run.
   ClientRequestId: string, // Client request ID.
   EventTime: datetime, // Time of the event.
   Error: dynamic, // Error, if any.
   RecordType: string, // Type of tracking record.
   Direction: string, // Message flow direction, which is either 'receive' or 'send'.
   IsMessageFailed: bool, // Whether the message failed.
   MessageProperties: dynamic, // Message properties.
   AdditionalProperties: dynamic, // Additional properties.
   TrackingId: string, // Custom tracking ID, if any.
   AgreementName: string, // Name for the agreement that resolves the messages.
   SenderPartnerName: string, // Partner name for the message sender.
   ReceiverPartnerName: string, // Partner name for the X12 message receiver.
   SenderQualifier: string, // Qualifier for the partner X12 message sender.
   SenderIdentifier: string, // Identifier for the partner X12 message sender.
   ReceiverQualifier: string, // Qualifier for the partner X12 message receiver.
   ReceiverIdentifier: string, // Identiifer for the partner X12 message receiver.
   TransactionSetControlNumber: string, // Control number for the transaction set.
   FunctionalGroupControlNumber: string, // Control number for the functional group.
   InterchangeControlNumber: string, // Control number for the interchange.
   MessageType: string, // Transaction set or document type.
   RespondingTransactionSetControlNumber: string, // Control number for the responding transaction set, in case of acknowledgment.
   RespondingFunctionalGroupControlNumber: string, // Control number for the responding functional group, in case of acknowledgment.
   RespondingInterchangeControlNumber: string, // Control number for the responding interchange, in case of acknowledgement.
   ProcessingStatus: string // Acknowledgment processing status with these permitted values: 'Received', 'Generated', and 'Sent'
)

X12 トラッキングレコード - メッセージプロパティーズ スキーマ

MessageProperties テーブル列には、追跡レコードの種類に基づいて、異なる JSON スキーマを使用する動的な型構造があります。

X12 トランザクション・セット - メッセージプロパティーズスキーマ

追跡レコードの種類が X12 トランザクション セットの場合の MessageProperties スキーマの構文を次に示します。

{
   "direction": "",
   "interchangeControlNumber": "",
   "functionalGroupControlNumber": "",
   "transactionSetControlNumber": "",
   "correlationMessageId": "",
   "messageType": "",
   "isMessageFailed": "",
   "isTechnicalAcknowledgmentExpected": "",
   "isFunctionalAcknowledgmentExpected": "",
   "needAk2LoopForValidMessages": "",
   "segmentsCount": ""
}
財産 タイプ 説明
方向 Enum メッセージ フローの方向 (send または receive)
インターチェンジ制御番号 インターチェンジの制御番号
機能グループ制御番号 機能グループの制御番号
トランザクションセットコントロールナンバー トランザクション セットの制御番号
correlationMessageId これらの値を組み合わせたメッセージ相関 ID: {AgreementName}{Interchange-or-FunctionalGroup-ControlNumber}{TransactionSetControlNumber}
messageType トランザクション セットまたはドキュメントの種類
isMessageFailed ブール値 X12 メッセージが失敗したかどうか
技術的な承認は期待されていますか ブール値 技術確認が X12 契約で構成されているかどうか
機能的な確認が期待されているか ブール値 機能確認が X12 契約で構成されているかどうか
有効なメッセージのためにAk2ループが必要 ブール値 有効なメッセージに AK2 ループが必要かどうか
セグメント数 整数 X12 トランザクション セット内のセグメント数

X12 トランザクション セット受信確認 - MessageProperties スキーマ

次の構文では、追跡レコードの種類が X12 トランザクション セット受信確認である場合の MessageProperties スキーマについて説明します。

{
   "direction": "",
   "interchangeControlNumber": "",
   "functionalGroupControlNumber": "",
   "respondingFunctionalGroupControlNumber": "",
   "respondingFunctionalGroupId": "",
   "respondingTransactionSetId": "",
   "statusCode": "",
   "processingStatus": "",
   "correlationMessageId": "",
   "isMessageFailed": ""
}
財産 タイプ 説明
方向 メッセージ フローの方向 (send または receive)
インターチェンジ制御番号 機能確認のインターチェンジ制御番号。 この値は、パートナーに送信されたメッセージに対して機能確認を受信した場合にのみ、送信者に対して設定されます。
機能グループ制御番号 機能確認の機能グループ制御番号。 この値は、パートナーに送信されたメッセージに対して機能確認を受信した場合にのみ、送信者に対して設定されます。
応答機能グループ制御番号 応答する機能グループの制御番号
respondingFunctionalGroupId 応答する機能グループの制御番号
respondingTransactionSetId 受信確認で AK101 にマップされる応答機能グループの ID
statusCode ブール値 トランザクション セットの受信確認状態コード
processingStatus Enum 認識処理ステータスには、これらの許可されている値があります: ReceivedGenerated、および Sent
correlationMessageId これらの値を組み合わせたメッセージ相関 ID: {AgreementName}{InterchangeORFunctionalGroupControlNumber}{TransactionSetControlNumber}
isMessageFailed X12 メッセージが失敗したかどうか

X12 インターチェンジ - MessageProperties スキーマ

次の構文では、追跡レコードの種類が X12 インターチェンジである場合の MessageProperties スキーマについて説明します。

{
   "direction": "",
   "interchangeControlNumber": "",
   "isTechnicalAcknowledgmentExpected": "",
   "isMessageFailed": "",
   "isa09": "",
   "isa10": "",
   "isa11": "",
   "isa12": "",
   "isa14": "",
   "isa15": "",
   "isa16": ""
}
財産 タイプ 説明
方向 Enum メッセージ フローの方向 (send または receive)
交換制御番号 インターチェンジの制御番号
技術的確認が期待されていますか ブール値 技術確認が X12 契約で構成されているかどうか
isMessageFailed ブール値 X12 メッセージが失敗したかどうか
isa09 X12 ドキュメント交換日
isa10 X12 ドキュメント交換時間
isa11 X12 インターチェンジ制御標準識別子
isa12 X12 インターチェンジ制御のバージョン番号
isa14 X12 受信確認が要求されている
isa15 テストまたは運用環境のインジケーター
isa16 要素の区切り記号

X12 インターチェンジ受信確認 - MessageProperties スキーマ

追跡レコードの種類が X12 インターチェンジ受信確認の場合の MessageProperties スキーマの構文を次に示します。

{
   "direction": "",
   "interchangeControlNumber": "",
   "respondingInterchangeControlNumber": "",
   "isMessageFailed": "",
   "statusCode": "",
   "processingStatus": "",
   "ta102": "",
   "ta103": "",
   "ta105": ""
}
財産 タイプ 説明
方向 Enum メッセージ フローの方向 (send または receive)
交換制御番号 パートナーから受信した技術確認のインターチェンジ制御番号
isMessageFailed ブール値 X12 メッセージが失敗したかどうか
statusCode ブール値 これらの許可された値を持つインターチェンジ確認ステータスコードは、AcceptedRejected、およびAcceptedWithErrorsです。
processingStatus Enum 認識処理ステータスには、これらの許可されている値があります: ReceivedGenerated、および Sent
ta102 インターチェンジの日付
ta103 乗り換え時間
ta103 インターチェンジ・ノートコード

X12 機能グループ - MessageProperties スキーマ

次の構文では、追跡レコードの種類が X12 機能グループである場合の MessageProperties スキーマについて説明します。

{
   "direction": "",
   "interchangeControlNumber": "",
   "functionalGroupControlNumber": "",
   "isTechnicalAcknowledgmentExpected": "",
   "isFunctionalAcknowledgmentExpected": "",
   "isMessageFailed": "",
   "gs01": "",
   "gs02": "",
   "gs03": "",
   "gs04": "",
   "gs05": "",
   "gs07": "",
   "gs08": ""
}
財産 タイプ 説明
方向 Enum メッセージ フローの方向 (send または receive)
交換制御番号 インターチェンジの制御番号
機能グループ制御番号 機能グループの制御番号
技術的確認が期待されていますか ブール値 技術確認が X12 契約で構成されているかどうか
機能的な確認が期待されているか ブール値 機能確認が X12 契約で構成されているかどうか
isMessageFailed ブール値 X12 メッセージが失敗したかどうか
gs01 機能グループ識別子コード
gs02 アプリケーションの送信者コード
gs03 アプリケーションレシーバーコード
gs04 機能グループの日付
gs05 機能グループ時間
gs07 責任ある機関コード
gs08 バージョン、リリース、または業界の識別子コード

X12 機能グループの受領確認 - MessageProperties スキーマ

次の構文では、追跡レコードの種類が X12 機能グループの受信確認である場合の MessageProperties スキーマについて説明します。

{
   "direction": "",
   "interchangeControlNumber": "",
   "functionalGroupControlNumber": "",
   "respondingFunctionalGroupControlNumber": "",
   "respondingFunctionalGroupId": "",
   "isMessageFailed": "",
   "statusCode": "",
   "processingStatus": "",
   "ak903": "",
   "ak904": "",
}
財産 タイプ 説明
方向 Enum メッセージ フローの方向 (send または receive)
交換制御番号 インターチェンジの制御番号。 この値は、パートナーから技術確認を受信したときに送信者に設定されます。
機能グループ制御番号 機能グループの制御番号
応答機能グループ制御番号 元の機能グループの制御番号
respondingFunctionalGroupId 受信確認機能グループ ID の AK101 にマップされます
statusCode Enum 次の値が許可されている受信確認状態コード: AcceptedRejected、および AcceptedWithErrors
processingStatus 認識処理ステータスには、これらの許可されている値があります: ReceivedGenerated、および Sent
ak903 受信したトランザクション セットの数
ak903 識別された機能グループ内の承認済みトランザクション セットの数

WorkflowRunOperationInfo スキーマ

AS2TrackRecords テーブルと EdiTrackRecords テーブルの WorkflowRunOperationInfo テーブル列は、標準ロジック アプリワークフローの実行に関する情報をキャプチャします。 この列には、次の JSON スキーマを使用する 動的 な型構造があります。

{
   "title": "WorkflowRunOperationInfo",
   "type": "object",
   "properties": {
      "Workflow": {
         "type": "object",
         "properties": {
            "SystemId": {
               "type": "string",
               "description": "The workflow system ID."
            },
            "SubscriptionId": {
               "type": "string",
               "description": "The subscription ID of the workflow."
            },
            "ResourceGroup": {
               "type": "string",
               "description": "The resource group name of the workflow."
            },
            "LogicAppName": {
               "type": "string",
               "description": "The logic app name of the workflow."
            },
            "Name": {
               "type": "string",
               "description": "The name of the workflow."
            },
            "Version": {
               "type": "string",
               "description": "The version of the workflow."
            }
         }
      },
      "RunInstance": {
         "type": "object",
         "properties": {
            "RunId": {
               "type": "string",
               "description": "The logic app run id."
            },
            "TrackingId": {
               "type": "string",
               "description": "The tracking id of the run."
            },
            "ClientTrackingId": {
               "type": "string",
               "description": "The client tracking id of the run."
            }
         }
      },
      "Operation": {
         "type": "object",
         "properties": {
            "OperationName": {
               "type": "string",
               "description": "The logic app operation name."
            },
            "RepeatItemScopeName": {
               "type": "string",
               "description": "The repeat item scope name."
            },
            "RepeatItemIndex": {
            "type": "integer",
            "description": "The repeat item index."
            },
            "RepeatItemBatchIndex": {
               "type": "integer",
               "description": "The index of the repeat item batch."
            },
            "TrackingId": {
               "type": "string",
               "description": "The tracking id of the logic app operation."
            },
            "CorrelationId": {
               "type": "string",
               "description": "The correlation id of the logic app operation."
            },
            "ClientRequestId": {
               "type": "string",
               "description": "The client request id of the logic app operation."
            },
            "OperationTrackingId": {
               "type": "string",
               "description": "The operation tracking id of the logic app operation."
            }
         }
      }
   }
}