연습: XML 봉투(Envelope)(기본) 사용

아티클
07/21/2023

이 예제에서는 가상의 오류 추적 시스템의 일부를 구현하여 기본 XML 봉투(Envelope) 디스어셈블리를 보여 줍니다. 이 예제는 다음 요구 사항을 충족합니다.

오류 메시지는 회사 내의 물리적 사이트에 기록되고 다양한 백 엔드 시스템으로 처리를 분산하기 위해 중앙 위치로 전송됩니다.
오류 메시지는 XML 형식으로 기록됩니다.
오류 메시지는 봉투 없이 단독으로 보내거나 봉투 내에 포함하여 일괄 처리로 보낼 수 있습니다.

필수 구성 요소

이 예제를 사용하려면 BizTalk 프로젝트 만들기, 어셈블리 서명 및 BizTalk Server 관리 콘솔을 통한 응용 프로그램/포트 보기 작업에 익숙해야 합니다. 연습 : 기본 BizTalk 애플리케이션 배포에 제시된 아이디어도 익숙해져야 합니다.

이 예의 용도

이 예제에서는 봉투 스키마를 정의하고 XmlDisassembler 파이프라인을 사용하여 단일 오류 메시지나 오류 메시지 일괄 처리를 포함하는 인바운드 메시지를 처리합니다.

예제

예를 만들려면 다음 섹션에 개괄적으로 설명되어 있는 단계를 따르십시오.

새 BizTalk 프로젝트 만들기

BizTalk 프로젝트를 만드는 데 필요한 솔루션을 빌드하려면 먼저 해당 솔루션에 강력한 이름이 지정되어 있는지 확인하고 응용 프로그램 이름을 할당해야 합니다. 응용 프로그램 이름을 할당하면 BizTalk Server가 해당 솔루션을 기본 BizTalk 응용 프로그램으로 배포하지 않습니다.

새 BizTalk 프로젝트를 만들고 구성하려면 다음을 수행하십시오.

Visual Studio를 사용하여 새 BizTalk 프로젝트를 만듭니다. 프로젝트 BasicXMLEnvelope을 호출합니다.
키 파일을 생성하여 프로젝트에 할당합니다. 이 작업에 대한 자세한 내용은 강력한 이름 어셈블리 키 파일을 구성하는 방법을 참조하세요.
프로젝트의 배포 구성 속성에서 애플리케이션 이름을 할당하고 호스트 인스턴스True다시 시작을 로 설정합니다. 이 플래그를 설정하면 호스트가 어셈블리의 캐시된 인스턴스를 삭제합니다.

Error 스키마 만들기

이 단계에서는 Error 스키마를 만듭니다. 이는 시스템에 대한 주요 메시지를 정의합니다.

Error 스키마를 만들려면 다음을 수행하십시오.

"Error"라는 새 스키마를 프로젝트에 추가합니다.
스키마의 대상 네임스페이스를 로 변경합니다 http://BasicXMLEnvelope.
고급 범주 아래의 스키마 속성 요소 FormDefault를 정규화로 변경합니다. 이는 인스턴스 문서에서 로컬로 선언된 요소를 대상 네임스페이스로 한정해야 함을 나타냅니다.
루트 노드의 이름을 "Error"로 바꾸고 다음과 같은 유형으로 자식 요소를 5개 만듭니다.
- ID, xs:int
- Type, xs:int
- Priority, xs:string
- Description, xs:string
- ErrorDateTime, xs:string
  
  결과 스키마는 다음과 같습니다.
이 스키마의 샘플 메시지를 만듭니다. 이는 봉투 밖의 단일 메시지가 제대로 처리되는지 확인하는 데 사용됩니다. 예제 샘플 메시지는 다음과 같습니다.
```
<Error xmlns="http://BasicXMLEnvelope">  
  <ID>1</ID>  
  <Type>5</Type>  
  <Priority>Low</Priority>  
  <Description>Sprocket widget prints reports slowly.</Description>  
  <ErrorDateTime>1999-05-31T13:20:00.000-05:00</ErrorDateTime>  
</Error>  
```
프로젝트 디렉터리의 파일에 이 메시지를 저장합니다.

봉투 스키마 만들기

봉투에는 하나 이상의 오류 메시지가 포함되어 있습니다. 이 기본 예제의 봉투에는 고유 속성 및 요소가 없습니다.

봉투 스키마를 만들려면 다음을 수행하십시오.

"Envelope"이라는 새 스키마를 BasicXMLEnvelope 프로젝트에 추가합니다.
대상 네임스페이스를 로 변경합니다 http://BasicXMLEnvelope.
루트 노드의 이름을 "Root"에서 "Envelope"로 변경합니다.
이제 스키마를 봉투 스키마로 표시합니다. 스키마> 노드를< 클릭합니다. 속성 창에서 스키마 참조 속성 Envelope 을 로 OK설정합니다.
Body XPath 속성을 설정합니다. 이렇게 하려면 Envelope 노드를 클릭합니다. 속성 창 본문 XPath 속성에서 줄임표(...) 단추를 클릭하고 봉투를 선택한 다음 확인을 클릭합니다.
Envelope 노드에 Any Element 자식을 추가합니다. 이 요소에 오류 메시지가 포함됩니다. 결과 스키마는 다음과 같습니다.

봉투 및 하나 이상의 샘플 메시지를 포함하는 샘플 메시지를 만듭니다. 예제 메시지는 다음과 같습니다.

<Envelope xmlns="http://BasicXMLEnvelope">  
  <Error>  
    <ID>102</ID>  
    <Type>0</Type>  
    <Priority>High</Priority>  
    <Description>Sprocket query fails.</Description>  
    <ErrorDateTime>1999-05-31T13:20:00.000-05:00</ErrorDateTime>  
  </Error>  
  <Error>  
    <ID>16502</ID>  
    <Type>2</Type>  
    <Priority>Low</Priority>  
    <Description>Time threshold exceeded.</Description>  
    <ErrorDateTime>1999-05-31T13:20:00.000-05:00</ErrorDateTime>  
  </Error>  
</Envelope>

프로젝트 디렉터리의 파일에 이 메시지를 저장합니다.

송신/수신 포트 배포 및 구성

스키마를 만들었으면 프로젝트를 컴파일하고 배포해야 합니다. 프로젝트를 배포한 다음에는 BizTalk Server 관리 콘솔을 사용하여 송신 및 수신 포트를 구성할 수 있습니다.

BasicXMLEnvelope를 배포하려면 다음을 수행하십시오.

Visual Studio의 빌드 메뉴에서 BasicXMLEnvelope 배포 를 선택합니다. 이렇게 하면 해당 프로젝트가 빌드되고 BizTalk Server에 응용 프로그램 "BasicXMLEnvelope"로 배포됩니다.
BizTalk Server 관리 콘솔에서 애플리케이션 그룹을 확장하여 BasicXMLEnvelope이 사용자 지정 애플리케이션으로 있는지 확인합니다.

수신 포트를 구성하려면 다음을 수행하십시오.

Windows Explorer 사용하여 BasicXMLEnvelope 프로젝트 디렉터리 아래에 "Receive"라는 디렉터리를 만듭니다.
BizTalk Server 관리 콘솔에서 BasicXMLEnvelope 애플리케이션을 확장하고 수신 포트를 마우스 오른쪽 단추로 클릭하고 새로 만들기를 가리킨 다음 단방향 수신 포트를 클릭합니다.
수신 포트 속성 대화 상자에서 포트의 이름을 "수신"으로 설정합니다.
수신 위치를 마우스 오른쪽 단추로 클릭한 다음 새로 만들기를 클릭하여 수신 포트를 추가합니다. 새 포트의 이름을 "ReceiveError"로 지정합니다. 수신 파이프라인을 XMLReceive로 설정합니다. 전송 유형에서 파일을 선택한 다음 구성을 클릭합니다.
위에서 만든 수신 디렉터리를 선택하고 확인을 클릭합니다. 이제 수신 포트가 구성되었습니다. 확인을 클릭하여 닫습니다.

송신 포트를 구성하려면 다음을 수행하십시오.

Windows Explorer 사용하여 BasicXMLEnvelope 프로젝트 디렉터리 아래에 "Send"라는 디렉터리를 만듭니다.
BizTalk Server 관리 콘솔에서 BasicXMLEnvelope 애플리케이션을 확장하고 포트 보내기를 마우스 오른쪽 단추로 클릭하고 새로 만들기를 가리킨 다음 정적 단방향을 클릭합니다.
송신 포트 속성 대화 상자에서 포트의 이름을 "보내기"로 설정합니다.
전송 유형에서 파일을 선택한 다음 구성을 클릭합니다. 대상 폴더를 이전에 만든 송신 디렉터리로 설정하고 확인을 클릭합니다.
필터를 클릭하고 단일 필터를 추가합니다.
- Bts. MessageType == http://BasicXMLEnvelope#Error
확인을 클릭하여 송신 포트 구성을 완료합니다. 송신 포트가 구성되었습니다.

예제 실행

이제 예제를 실행해 보겠습니다. BizTalk Server 관리 콘솔을 사용하여 BasicXMLEnvelope 응용 프로그램을 시작한 다음 테스트 파일을 수신 위치에 복사하여 송신 위치에서 생성되는 내용을 확인합니다.

BasicXMLEnvelope 예제를 실행하려면 다음을 수행하십시오.

BizTalk Server 관리 콘솔에서 BasicXMLEnvelope 애플리케이션을 마우스 오른쪽 단추로 클릭한 다음 시작을 클릭합니다. 송신 및 수신 포트가 등록되고 시작됩니다.
각 샘플 파일을 수신 디렉터리에 놓습니다. 앞에서 제공된 샘플을 사용하면 처리가 완료될 때 송신 위치에 세 개의 개별 오류 메시지가 표시됩니다.

예제 확장

예제를 확장하여 다른 요구 사항을 수용할 수 있습니다. 이 섹션에서는 다음과 같은 두 가지 일반적인 시나리오에 대해 설명합니다.

한 봉투 내에서 오류 일괄 처리가 전송되는 경우 디스어셈블리의 개별 메시지 실패로 인해 다른 정상 메시지의 추가 처리 작업이 방해를 받지 않아야 합니다.
오류가 우선 순위에 따라 서로 다른 위치로 배달되어야 합니다. 우선 순위가 높은 메시지는 신속히 처리되고 기타 우선 순위의 메시지는 정상 채널을 통해 처리됩니다.

다음 섹션에서는 예제를 확장하여 이러한 요구 사항을 처리합니다.

복구 가능한 교환 처리

BizTalk Server 복구 가능한 교환 처리를 지원합니다. 이 기능을 사용하면 메시지 일괄 처리가 일괄적으로 실패하지 않고 디스어셈블리에서 개별적으로 실패하게 만들 수 있습니다.

복구 가능한 교환 처리를 사용할 수 있도록 예제를 구성하려면 다음을 수행하십시오.

BizTalk Server 관리 콘솔에서 BasicXMLEnvelope 애플리케이션을 확장하고 수신 포트를 클릭한 다음 수신 포트를 두 번 클릭합니다. 이는 앞에서 만든 포트입니다.
수신 포트 속성 대화 상자에서 수신 위치를 클릭합니다. 속성을 클릭하여 ReceiveError 수신 위치 속성 대화 상자를 표시합니다. 수신 파이프라인의 줄임표(...) 단추를 클릭합니다.
파이프라인 구성 - XMLReceive 대화 상자에서 복구 가능한 교환 처리 속성을 로 True설정한 다음 확인을 클릭합니다.
확인을 클릭하여 수신 위치 속성 대화 상자를 닫은 다음 확인을 클릭하여 수신 포트 속성 대화 상자를 닫습니다.

샘플 파일을 만들어 예제를 실행하려면 다음을 수행하십시오.

샘플 파일을 만들려면 예제에서 만든 봉투 샘플 파일의 복사본을 만들어 Error 인스턴스 중 하나에 존재하지 않는 네임스페이스를 추가한 다음 해당 파일을 저장합니다.

<Envelope xmlns="http://BasicXMLEnvelope">  
  <Error>  
    <ID>102</ID>  
    <Type>0</Type>  
    <Priority>High</Priority>  
    <Description>Sprocket query fails to return any sprockets even though some exist</Description>  
    <ErrorDateTime>1999-05-31T13:20:00.000-05:00</ErrorDateTime>  
  </Error>  
  <Error xmlns="http://ThisIsAnError">  
    <ID>16502</ID>  
    <Type>2</Type>  
    <Priority>Low</Priority>  
    <Description>Time threshold exceeded.</Description>  
    <ErrorDateTime>1999-05-31T13:20:00.000-05:00</ErrorDateTime>  
  </Error>  
</Envelope>

BizTalk Server 관리 콘솔에서 애플리케이션을 클릭하고 BasicXMLEnvelope 애플리케이션이 실행 중인지 확인합니다.
메시지를 수신 위치에 놓습니다. 처리를 마치면 첫 번째 메시지가 송신 위치에 표시되고 두 번째 낮은 우선 순위의 메시지가 일시 중단된 큐에 표시됩니다.

CBR(콘텐츠 기반 라우팅)

콘텐츠 기반 라우팅을 사용하면 해당 콘텐츠를 기반으로 메시지를 라우팅할 수 있습니다. 이 시나리오에서는 우선 순위에 따라 라우팅이 발생합니다. 즉, 우선 순위가 높음인 메시지는 하나의 송신 위치로 전송되고 우선 순위가 낮음이나 보통인 메시지는 다양한 송신 위치로 전송됩니다.

샘플을 확장하려면 다음 작업을 완료해야 합니다.

BasicXMLEnvelope 프로젝트의 오류 스키마에서 우선 순위 필드를 승격합니다. 콘텐츠 기반 라우팅은 승격된 속성을 사용하여 메시지를 라우팅합니다. 자세한 내용은 속성 승격을 참조하세요.
두 개의 추가 송신 포트를 만들고 구성합니다. 이러한 포트는 단일 필터를 사용하여 해당 포트에서 적절한 메시지를 받을 수 있도록 합니다.

Error 스키마의 Priority 필드를 승격하려면 다음을 수행하십시오.

Visual Studio에서 BasicXMLEnvelope 프로젝트가 열리면 오류 스키마를 열고 오류 노드를 확장합니다.
Priority 요소를 마우스 오른쪽 단추로 클릭하고 승격을 가리킨 다음 빠른 승격을 클릭합니다.
확인을 클릭하여 승격된 속성에 대한 새 속성 스키마 추가를 확인합니다.
Visual Studio의 솔루션 탐색기 새 속성 스키마 PropertySchema.xsd를 엽니다. 스키마에서 "Field1"을 제거합니다.
이제 솔루션을 다시 컴파일하고 재배포합니다. 빌드 메뉴에서 BasicXMLEnvelope 배포를 선택합니다.
솔루션을 재배포할 때 호스트 인스턴스를 다시 설정하도록 프로젝트가 구성되었습니다. 이를 변경한 경우 호스트를 중지하고 시작해야 합니다.

우선 순위가 낮음이거나 보통인 송신 포트를 구성하려면 다음을 수행하십시오.

Windows Explorer 사용하여 BasicXMLEnvelope 프로젝트 디렉터리 아래에 "SendLowMediumPriority"라는 디렉터리를 만듭니다.
BizTalk Server 관리 콘솔에서 BasicXMLEnvelope 애플리케이션을 확장하고 포트 보내기를 마우스 오른쪽 단추로 클릭하고 새로 만들기를 가리킨 다음 정적 단방향을 클릭합니다.
송신 포트 속성 대화 상자에서 포트의 이름을 "SendLowMediumPriority"로 설정합니다.
전송 유형에서 파일을 선택한 다음 구성을 클릭합니다. 대상 폴더를 앞에서 만든 디렉터리로 설정합니다. 확인을 클릭하여 닫습니다.
필터를 클릭하고 세 개의 필터 식을 추가합니다.
- Bts. MessageType == http://BasicXMLEnvelope#Error And
- BasicXMLEnvelope.PropertySchema.Priority == Low Or
- BasicXMLEnvelope.PropertySchema.Priority == Medium
확인을 클릭하여 우선 순위가 낮은 송신 포트 구성을 완료합니다.

우선 순위가 높음인 송신 포트를 구성하려면 다음을 수행하십시오.

Windows Explorer 사용하여 BasicXMLEnvelope 프로젝트 디렉터리 아래에 "SendHighPriority"라는 디렉터리를 만듭니다.
BizTalk Server 관리 콘솔에서 BasicXMLEnvelope 애플리케이션을 확장하고 포트 보내기를 마우스 오른쪽 단추로 클릭하고 새로 만들기를 가리킨 다음 정적 단방향을 클릭합니다.
송신 포트 속성 대화 상자에서 포트의 이름을 "SendHighPriority"로 설정합니다.
전송 유형에서 파일을 선택한 다음 구성을 클릭합니다. 대상 폴더를 앞에서 만든 디렉터리로 설정합니다. 확인을 클릭하여 닫습니다.
필터를 클릭하고 두 개의 필터 식을 추가합니다.
- Bts. MessageType == http://BasicXMLEnvelope#Error And
- BasicXMLEnvelope.PropertySchema.Priority == High
확인을 클릭하여 우선 순위가 높은 송신 포트 구성을 완료합니다.

라우팅 솔루션을 테스트하려면 다음을 수행하십시오.

BizTalk Server 관리 콘솔에서 애플리케이션 그룹을 확장하고 BasicXMLEnvelope 애플리케이션을 마우스 오른쪽 단추로 클릭한 다음 시작을 클릭합니다. 확인하라는 메시지가 표시되면 시작을 클릭합니다. 이렇게 하면 새 송신 포트가 등록됩니다.
테스트 메시지를 수신 위치에 놓습니다. 오류 메시지가 다양한 송신 위치로 라우팅되는 방식을 확인합니다.
- 우선 순위가 낮음, 보통 또는 높음인 오류 메시지 및 실패하지 않은 메시지 처리는 원래 송신 위치(핵심 예제에서 구성함)와 우선 순위별 송신 위치에 모두 라우팅됩니다. 우선 순위가 낮음이거나 보통인 메시지의 경우 원래 송신 위치와 낮음/보통 송신 위치에 모두 복사본이 나타납니다.
- 복구 가능한 교환 처리를 사용하는 경우 실패한 오류 메시지는 라우팅되지 않으며 실패하지 않은 메시지는 예상대로 올바르게 라우팅됩니다. 실패한 메시지의 경우 메시지 유형이 구성된 필터에 사용된 유형과 일치하지 않기 때문에 라우팅되지 않습니다.

참고 항목

복구 가능한 교환 처리
속성 승격
CBRSample(BizTalk Server 샘플)

다음을 통해 공유