Azure Logic Apps에서 B2B 메시지를 모니터링하기 위한 스키마 추적

적용 대상: Azure Logic Apps(사용량 + 표준)

Azure Logic Apps에는 워크플로의 일부에 대해 사용하도록 설정할 수 있는 기본 제공 추적이 포함되어 있습니다. B2B(Business-to-Business) 메시지의 성공적인 배달 또는 영수증, 오류 및 속성을 모니터링하기 위해 통합 계정에서 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	예	String	AS2 메시지를 보낸 사람의 파트너 이름
receiverPartnerName	예	String	AS2 메시지를 받는 사람의 파트너 이름
as2To	예	String	AS2 메시지의 헤더에서 AS2 메시지를 받는 사람의 이름
as2From	예	String	AS2 메시지의 헤더에서 AS2 메시지를 보낸 사람의 이름
agreementName	예	String	메시지가 확인되는 AS2 규약의 이름
direction	예	String	receive 또는 send인 메시지 흐름 방향
messageId	예	String	AS2 메시지 헤더의 AS2 메시지 ID
dispositionType	예	String	MDN(메시지 처리 알림) 처리 유형 값
fileName	예	String	AS2 메시지 헤더의 파일 이름
isMessageFailed	예	부울	AS2 메시지의 실패 여부
isMessageSigned	예	부울	AS2 메시지의 서명 여부
isMessageEncrypted	예	부울	AS2 메시지의 암호화 여부
isMessageCompressed	예	부울	AS2 메시지의 압축 여부
correlationMessageId	예	String	메시지와 MDN의 상관 관계를 지정하기 위한 AS2 메시지 ID
incomingHeaders	예	JToken의 사전	들어오는 AS2 메시지 헤더 세부 정보
outgoingHeaders	예	JToken의 사전	보내는 AS2 메시지 헤더 세부 정보
isNrrEnabled	예	부울	값을 알 수 없는 경우 기본값 사용 여부
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 메시지에 대한 추적 스키마의 특성을 설명합니다.

속성	필수	형식	설명
senderPartnerName	예	String	AS2 메시지를 보낸 사람의 파트너 이름
receiverPartnerName	예	String	AS2 메시지를 받는 사람의 파트너 이름
as2To	예	String	AS2 메시지를 받는 파트너 이름
as2From	예	String	AS2 메시지를 보내는 파트너 이름
agreementName	예	String	메시지가 확인되는 AS2 규약의 이름
direction	예	String	receive 또는 send인 메시지 흐름 방향
messageId	예	String	AS2 메시지 ID
OriginalMessageId	예	String	AS2 원본 메시지 ID
dispositionType	예	String	MDN 처리 유형 값
isMessageFailed	예	부울	AS2 메시지의 실패 여부
isMessageSigned	예	부울	AS2 메시지의 서명 여부
isNrrEnabled	예	부울	값을 알 수 없는 경우 기본값 사용 여부
statusCode	예	열거형	허용되는 값: Accepted, Rejected, AcceptedWithErrors
micVerificationStatus	예	열거형	허용되는 값: NotApplicable, Succeeded, Failed
correlationMessageId	예	String	MDN이 구성된 원본 메시지의 ID인 상관 관계 ID
incomingHeaders	예	JToken의 사전	들어오는 AS2 메시지 헤더 세부 정보
outgoingHeaders	예	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	예	String	X12 메시지 보낸 사람의 파트너 이름
receiverPartnerName	예	String	X12 메시지 받는 사람의 파트너 이름
senderQualifier	예	String	파트너 보내기 한정자
senderIdentifier	예	String	파트너 보내기 식별자
receiverQualifier	예	String	파트너 받기 한정자
receiverQualifier	예	String	파트너 받기 식별자
agreementName	예	String	메시지가 확인되는 X12 규약의 이름
direction	예	열거형	receive 또는 send인 메시지 흐름 방향
interchangeControlNumber	예	String	교환 컨트롤 번호
functionalGroupControlNumber	예	String	기능 컨트롤 번호
transactionSetControlNumber	예	String	트랜잭션 집합 컨트롤 번호입니다.
CorrelationMessageId	예	String	상관 관계 메시지 ID는 {AgreementName}{GroupControlNumber}{TransactionSetControlNumber}의 조합입니다.
messageType	예	String	트랜잭션 집합 또는 문서 형식
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 트랜잭션 집합 승인에 대한 추적 스키마의 특성에 대해 설명합니다.

속성	필수	형식	설명
senderPartnerName	예	String	X12 메시지 보낸 사람의 파트너 이름
receiverPartnerName	예	String	X12 메시지 받는 사람의 파트너 이름
senderQualifier	예	String	파트너 보내기 한정자
senderIdentifier	예	String	파트너 보내기 식별자
receiverQualifier	예	String	파트너 받기 한정자
receiverQualifier	예	String	파트너 받기 식별자
agreementName	예	String	메시지가 확인되는 X12 규약의 이름
direction	예	열거형	receive 또는 send인 메시지 흐름 방향
interchangeControlNumber	예	String	기능 승인의 교환 컨트롤 번호. 해당 값은 파트너에게 전송된 메시지에 대해 기능 승인을 받은 보내는 쪽에 대해서만 채워집니다.
functionalGroupControlNumber	예	String	기능 승인의 기능 그룹 컨트롤 번호. 해당 값은 파트너에게 전송된 메시지에 대해 기능 승인을 받은 보내는 쪽에 대해서만 채워집니다.
isaSegment	예	String	메시지의 ISA 세그먼트. 해당 값은 파트너에게 전송된 메시지에 대해 기능 승인을 받은 보내는 쪽에 대해서만 채워집니다.
gsSegment	예	String	메시지의 GS 세그먼트. 해당 값은 파트너에게 전송된 메시지에 대해 기능 승인을 받은 보내는 쪽에 대해서만 채워집니다.
respondingfunctionalGroupControlNumber	예	String	응답 교환 컨트롤 번호
respondingFunctionalGroupId	예	String	승인에서 AK101에 매핑되는 응답 기능 그룹 ID
respondingtransactionSetControlNumber	예	String	응답 트랜잭션 집합 컨트롤 번호
respondingTransactionSetId	예	String	승인에서 AK201에 매핑되는 응답 트랜잭션 집합 ID
statusCode	예	부울	트랜잭션 집합 승인 상태 코드
segmentsCount	예	열거형	허용되는 값이 있는 승인 상태 코드: Accepted, Rejected, AcceptedWithErrors
processingStatus	예	열거형	허용되는 값이 있는 승인 처리 상태: ReceivedGeneratedSent
CorrelationMessageId	예	String	상관 관계 메시지 ID는 {AgreementName}{GroupControlNumber}{TransactionSetControlNumber}의 조합입니다.
isMessageFailed	예	부울	X12 메시지 실패 여부
ak2Segment	예	String	받은 기능 그룹 내의 트랜잭션 집합에 대한 승인
ak3Segment	예	String	데이터 세그먼트의 오류 보고
ak5Segment	예	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	예	String	X12 메시지 보낸 사람의 파트너 이름
receiverPartnerName	예	String	X12 메시지 받는 사람의 파트너 이름
senderQualifier	예	String	파트너 보내기 한정자
senderIdentifier	예	String	파트너 보내기 식별자
receiverQualifier	예	String	파트너 받기 한정자
receiverQualifier	예	String	파트너 받기 식별자
agreementName	예	String	메시지가 확인되는 X12 규약의 이름
direction	예	열거형	receive 또는 send인 메시지 흐름 방향
interchangeControlNumber	예	String	교환 컨트롤 번호
isaSegment	예	String	메시지 ISA 세그먼트
isTechnicalAcknowledgmentExpected	부울	X12 규약에서 기술 승인이 구성되었는지 여부
isMessageFailed	예	부울	X12 메시지 실패 여부
isa09	예	String	X12 문서 교환 날짜
isa10	예	String	X12 문서 교환 시간
isa11	예	String	X12 교환 컨트롤 표준 식별자
isa12	예	String	X12 교환 컨트롤 버전 번호
isa14	예	String	X12 승인이 요청됨
isa15	예	String	테스트 또는 프로덕션에 대한 표시기
isa16	예	String	요소 구분 기호

X12 교환 승인 추적 스키마

다음 구문에서는 X12 교환 승인에 대한 추적 스키마를 설명합니다.

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

다음 표에서는 X12 교환 승인에 대한 추적 스키마의 특성을 설명합니다.

속성	필수	형식	설명
senderPartnerName	예	String	X12 메시지 보낸 사람의 파트너 이름
receiverPartnerName	예	String	X12 메시지 받는 사람의 파트너 이름
senderQualifier	예	String	파트너 보내기 한정자
senderIdentifier	예	String	파트너 보내기 식별자
receiverQualifier	예	String	파트너 받기 한정자
receiverQualifier	예	String	파트너 받기 식별자
agreementName	예	String	메시지가 확인되는 X12 규약의 이름
direction	예	열거형	receive 또는 send인 메시지 흐름 방향
interchangeControlNumber	예	String	파트너로부터 받은 기술 승인의 교환 컨트롤 번호
isaSegment	예	String	파트너로부터 받은 기술 승인의 ISA 세그먼트
respondingInterchangeControlNumber	예	String	파트너로부터 받은 기술 승인의 교환 컨트롤 번호
isMessageFailed	예	부울	X12 메시지 실패 여부
statusCode	예	열거형	허용되는 값이 있는 교환 승인 상태 코드: Accepted, Rejected, AcceptedWithErrors
processingStatus	예	열거형	허용되는 값이 있는 승인 상태: Received, Generated, Sent
ta102	예	String	교환 날짜
ta103	예	String	교환 시간
ta105	예	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	예	String	X12 메시지 보낸 사람의 파트너 이름
receiverPartnerName	예	String	X12 메시지 받는 사람의 파트너 이름
senderQualifier	예	String	파트너 보내기 한정자
senderIdentifier	예	String	파트너 보내기 식별자
receiverQualifier	예	String	파트너 받기 한정자
receiverQualifier	예	String	파트너 받기 식별자
agreementName	예	String	메시지가 확인되는 X12 규약의 이름
direction	예	열거형	받기 또는 보내기인 메시지 흐름 방향
interchangeControlNumber	예	String	교환 컨트롤 번호
functionalGroupControlNumber	예	String	기능 컨트롤 번호
gsSegment	예	String	메시지 GS 세그먼트
isTechnicalAcknowledgmentExpected	예	부울	X12 규약에서 기술 승인이 구성되었는지 여부
isFunctionalAcknowledgmentExpected	예	부울	X12 규약에서 기능 승인이 구성되었는지 여부
isMessageFailed	예	부울	X12 메시지 실패 여부
gs01	예	String	기능 식별자 코드
gs02	예	String	애플리케이션 보낸 사람 코드
gs03	예	String	애플리케이션 받는 사람 코드
gs04	예	String	기능 그룹 날짜
gs05	예	String	기능 그룹 시간
gs07	예	String	담당 에이전시 코드
gs08	예	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	예	String	X12 메시지 보낸 사람의 파트너 이름
receiverPartnerName	예	String	X12 메시지 받는 사람의 파트너 이름
senderQualifier	예	String	파트너 보내기 한정자
senderIdentifier	예	String	파트너 보내기 식별자
receiverQualifier	예	String	파트너 받기 한정자
receiverQualifier	예	String	파트너 받기 식별자
agreementName	예	String	메시지가 확인되는 X12 규약의 이름
direction	예	열거형	receive 또는 send인 메시지 흐름 방향
interchangeControlNumber	예	String	파트너에게서 기술 승인을 받을 때 보내는 쪽에 대해 채워지는 교환 컨트롤 번호
functionalGroupControlNumber	예	String	파트너에게서 기술 승인을 받을 때 보내는 쪽에 대해 채워지는 기술 승인의 기능 그룹 컨트롤 번호
isaSegment	예	String	교환 컨트롤 번호와 동일하지만 특정 경우에만 채워짐
gsSegment	예	String	기능 그룹 컨트롤 번호와 동일하지만 특정 경우에만 채워짐
respondingfunctionalGroupControlNumber	예	String	원래 기능 그룹의 컨트롤 번호
respondingFunctionalGroupId	예	String	승인 기능 그룹 ID에서 AK101에 매핑
isMessageFailed	부울	X12 메시지 실패 여부
statusCode	예	열거형	허용되는 값이 있는 승인 상태 코드: Accepted, Rejected, AcceptedWithErrors
processingStatus	예	열거형	허용되는 값이 있는 승인 처리 상태: ReceivedGeneratedSent
ak903	예	String	받은 트랜잭션 집합 수
ak904	예	String	식별된 기능 그룹에서 승인된 트랜잭션 집합 수
ak9Segment	예	String	AK1 세그먼트에 식별된 기능 그룹이 허용되는지 또는 거부되는지와 그 이유

사용자 지정

논리 앱 워크플로의 시작부터 끝까지 이벤트를 기록하는 사용자 지정 추적을 설정할 수 있습니다. 예를 들어 워크플로, SQL Server, BizTalk Server 또는 기타 계층을 포함하는 계층에서 이벤트를 기록할 수 있습니다. 다음 섹션에서는 워크플로 외부의 계층에서 사용할 수 있는 사용자 지정 추적 스키마 코드를 제공합니다.

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

다음 표에서는 사용자 지정 추적 스키마의 특성에 대해 설명합니다.

속성	필수	형식	Description
sourceType	예	String	허용되는 값을 포함하는 실행 원본의 형식: Microsoft.Logic/workflowscustom
source	예	문자열 또는 JToken	원본 형식이 Microsoft.Logic/workflows인 경우 소스 정보는 해당 스키마를 따라야 합니다. 원본 형식이 custom이면 스키마는 JToken입니다.
systemId	예	String	논리 앱 시스템 ID
runId	예	String	논리 앱 실행 ID
operationName	예	String	작업의 이름(예: action 또는 trigger)
repeatItemScopeName	예	String	작업이 foreach 또는 until 루프 내에 있으면 항목 이름을 반복
repeatItemIndex	예	정수	동작이 foreach 또는 until 루프 내에 있음을 나타내며 반복되는 항목 인덱스 번호입니다.
trackingId	예	String	메시지에 상관 관계를 지정할 추적 ID
correlationId	예	String	메시지에 상관 관계를 지정할 상관 관계 ID
clientRequestId	예	String	클라이언트는 메시지에 상관 관계를 지정하기 위해 해당 항목을 채울 수 있음
eventLevel	예	String	이벤트의 수준
eventTime	예	DateTime	UTC 형식의 이벤트 시간: YYYY-MM-DDTHH:MM:SS.00000Z
recordType	예	String	해당 허용되는 값만 포함된 추적 레코드 유형: custom
레코드(record)	예	JToken	JToken 형식만 포함된 사용자 지정 레코드 형식

다음 단계

• Azure Monitor 로그를 사용하여 B2B 메시지 모니터링