CBRSample(BizTalk Server 샘플)
CBRSample 샘플에서는 필터 및 아웃바운드 맵을 적용하여 내용에 따라 인스턴스 메시지를 변환 및 라우팅하는 방법을 보여 줍니다.
이 샘플의 용도
이 샘플에서는 이름, 주소 및 연락처 정보가 포함된 메시지를 국가 코드에 따라 두 폴더 중 하나로 라우팅하는 방법을 보여 줍니다. 특히 이 샘플은 다음 작업을 수행합니다.
사용자 ID 및 전체 이름이 포함된 신원, 국가 코드가 포함된 주소, 전화 연락처 정보 등의 개인 관련 기본 정보를 포함하는 샘플 메시지 형식을 정의합니다.
포트 필터에서 변환 및 라우팅을 제어하는 데 사용할 수 있도록 입력 문서의 CountryCode 속성을 승격합니다.
CountryCode가 200이면 메시지를 캐나다 버전으로 변환하거나 CountryCode가 100인 경우 미국 버전으로 변환합니다. 두 변환 모두 중간 이니셜(초기)을 제외한 모든 데이터를 전달합니다. 또한 캐나다 버전은 State 를 Province 에 매핑하고 ZipCode 를 PinCode에 매핑합니다.
미국 메시지를 US 디렉터리로 라우팅하고 캐나다 메시지를 CAN 디렉터리로 라우팅합니다.
이 샘플이 디자인된 방식 및 이유
디자인은 메시지를 라우팅하기 위해 BizTalk Server 내의 기본 송신 및 수신 XML 파이프라인, 속성 승격, 구독 필터 및 아웃바운드 맵을 사용합니다. 다음 표에서는 디자인 요소와 맞춤을 보여 줍니다.
| 디자인 요소 | 선택 이유 |
|---|---|
| 기본 XML 수신 파이프라인 | - XMLReceive 파이프라인은 속성 승격을 지원합니다. PassThruReceive 파이프라인은 그렇지 않습니다. - 인바운드 메시지는 이미 XML 형식이며 기본 디스어셈블리 및 파티 확인 이외의 처리가 필요하지 않습니다. |
| 속성 승격 | - BizTalk Server는 라우팅을 수행할 속성 필드에 대한 설명입니다. 고유 필드는 오케스트레이션에서 사용되며 라우팅에 사용할 수 없습니다. |
| 구독 필터 | - 구독 필터는 속성 필드를 기반으로 하나 이상의 조건을 충족하는 메시지를 캡처하여 실제 라우팅을 수행합니다. |
| 아웃바운드 맵 | - 데이터 변환을 한 형식에서 다른 형식으로 매핑합니다. 샘플은 인바운드 메시지를 미국 또는 캐나다 형식으로 매핑합니다. |
| XMLTransmit | - 나가는 XML 메시지의 기본 어셈블리를 수행합니다. PassThruTransmit 파이프라인은 추가 지원을 제공하지 않습니다. |
이 기본 패턴을 확장하여 복잡한 여러 시나리오에 사용할 수 있습니다.
이 샘플이 있는 위치
이 샘플은 \Messaging\CBRSample\에 <Samples Path>있습니다.
다음 표는 이 샘플의 파일을 보여 주고 각각의 용도에 대해 설명합니다.
| 파일 | Description |
|---|---|
| CBRDataCAN.Xml, CBRDataUS.Xml | CBRInputSchema.xsd 파일에 정의된 스키마에 맞는 샘플 입력 파일입니다. |
| CBRInput2CANMap.btm, CBRInput2USMap.btm | 각각 캐나다 및 미국 형식 변환에 사용되는 맵 파일입니다. |
| CBRInputSchema.xsd, CBROutputSchemaCAN.xsd, CBROutputSchemaUS.xsd | 각각 입력 형식, 캐나다 출력 형식 및 미국 출력 형식용 스키마 파일입니다. |
| CBRPromotedPropertySchema.xsd | XML 입력 파일의 CountryCode 요소에 해당하는 승격된 속성에 대한 스키마 파일입니다. |
| CBRSample.btproj, CBRSample.sln | 이 샘플에 사용할 BizTalk 프로젝트 및 솔루션 파일입니다. |
| Cleanup.bat | 어셈블리 배포를 취소하고 전역 어셈블리 캐시에서 어셈블리를 제거하는 데 사용됩니다. 송신 및 수신 포트를 제거합니다. 필요에 따라 IIS(인터넷 정보 서비스) 가상 디렉터리를 제거합니다. |
| Setup.bat | 이 샘플을 빌드 및 초기화하는 데 사용됩니다. |
이 샘플의 사용 방법
내용을 기반으로 메시지를 라우팅하는 데 필요한 작업의 수행 예로 이 샘플을 사용합니다.
이 샘플 빌드 및 초기화
CBRSample 샘플을 빌드 및 초기화하려면 이 샘플용 BizTalk 프로젝트를 빌드 및 배포하고, 수신 포트 및 위치를 구성하고, 서로 다른 두 송신 포트를 구성해야 합니다.
이 샘플용 BizTalk 프로젝트를 빌드 및 배포하려면
명령 창에서 다음 폴더로 이동합니다.
<Samples Path>\Messaging\CBRSample다음 작업을 수행하는 Setup.bat를 실행합니다.
이 샘플에 대한 입력(In) 및 출력 폴더(미국 및 CAN)를 만듭니다.
이 샘플에 대한 Microsoft Visual Studio 프로젝트를 컴파일하고 배포합니다.
BizTalk Server 수신 위치와 송신 및 수신 포트를 만들고 바인딩합니다.
참고
포트를 만들고 바인딩할 경우 이 샘플에 다음 경고가 표시됩니다.
경고: 수신 위치 "CBRReceiveLocation"에 대해 수신 처리기가 지정되지 않았습니다. 전송 유형이 일치하는 첫 번째 수신 처리기로 업데이트합니다.
이 경고는 무시해도 됩니다. (사용자 설치에서 이름 지정에 차이가 있을 수 있는 경우 이를 수용하기 위해 호스트 이름과 수신 핸들러가 바인딩 파일에서 생략되었습니다.)
참고
이 샘플을 실행하기 전에 BizTalk Server가 빌드 및 초기화 프로세스 동안 오류를 보고하지 않았는지 확인해야 합니다.
참고
Setup.bat를 실행하지 않고 이 샘플에서 프로젝트를 열고 빌드하려는 경우 먼저 .NET Framework Strong Name Utility(sn.exe)를 사용하여 강력한 이름 키 쌍을 만들어야 합니다. 이 키 쌍을 사용하여 결과 어셈블리에 서명을 합니다.
참고
Setup.bat가 변경한 내용을 실행 취소하려면 Cleanup.bat를 실행합니다. Setup.bat를 두 번째로 실행하기 전에 Cleanup.bat를 실행해야 합니다.
수신 포트 및 위치와 송신 포트 구성을 준비하려면
Microsoft SQL Management Studio에서 올바른 BizTalk Management 데이터베이스를 선택합니다.
참고
BizTalk 관리 데이터베이스를 BizTalk 구성 데이터베이스라고도 합니다.
미국 송신 포트를 구성, 등록 및 시작하려면
BizTalk Server 관리 콘솔에서 송신 포트를 확장하고 CBRUSSendPort를 마우스 오른쪽 단추로 클릭한 다음 편집을 클릭합니다.
정적 One-Way 송신 포트 속성 대화 상자의 대화 상자 왼쪽에 있는 폴더 트리에서 필터 & 매핑 | 속성을CBRSample.CountryCode로 설정하고연산자 열을 로 설정하고 값 열을 100으로 ==설정하여 새 행을 필터링한 다음 추가합니다.
대화 상자 왼쪽의 폴더 트리에서 필터 & 매핑 | 를 선택합니다. 아웃바운드 맵을 설정하여 CBRSample.CBRInput2USMap에 속성을 적용한 다음 확인을 클릭합니다. 스크롤 단추를 클릭하여 맵을 보기에 표시해야 할 수도 있습니다.
캐나다 송신 포트를 구성, 등록 및 시작하려면
BizTalk Server 관리 콘솔에서 송신 포트를 확장하고 CBRCANSendPort를 마우스 오른쪽 단추로 클릭한 다음 편집을 클릭합니다.
정적 One-Way 송신 포트 속성 대화 상자의 대화 상자 왼쪽에 있는 폴더 트리에서 필터 & 매핑 | 속성을CBRSample.CountryCode로 설정하고연산자 열을 로 설정하고 값 열을 200으로 ==설정하여 새 행을 필터링한 다음 추가합니다.
대화 상자 왼쪽의 폴더 트리에서 필터 & 매핑 | 를 선택합니다. 아웃바운드 맵을 설정하여 CBRSample.CBRInput2CANMap에 속성을 적용한 다음 확인을 클릭합니다.
이러한 단계를 통해 송신 포트가 수신 포트에 연결됩니다. 샘플에서는 승격된 속성을 사용하여 문서를 라우팅합니다.
이제 BizTalk Server에서 이 샘플을 사용할 준비가 되었습니다.
이 샘플 실행
다음 절차에 따라 CBRSample 샘플을 실행합니다.
이 샘플을 실행하려면
입력 파일을 복사하고CBRDataCAN.xmlCBRDataUS.xml다음 입력 폴더에 복사합니다.
<Samples Path>\Messaging\CBRSample\In이러한 각 파일이 변환되고 해당 CountryCode 요소의 값(100 대 200)에 따라 다음 두 출력 폴더 중 하나로 라우팅되는 방식을 관찰합니다.
BizTalk Server 입력 파일을 변환하고 CBRDataCAN.xml 폴더로 라우팅합니다.
<Samples Path>\Messaging\CBRSample\CANBizTalk Server 입력 파일 CBRDataUS.xml 변환하고 폴더로 라우팅합니다.
<Samples Path>\Messaging\CBRSample\US
이 샘플에서 사용된 클래스 또는 메서드
없음
참고 항목
기본 파이프라인
송신 포트에 대한 아웃바운드 맵을 구성하는 방법
메시지(BizTalk Server 샘플 폴더)