HelloWorld(BizTalk Server 샘플)
HelloWorld 샘플은 BizTalk 오케스트레이션을 사용하여 XML 메시지(구매 주문)를 관련은 있지만 별도의 메시지 유형(송장)으로 변환하는 방법을 보여 줍니다.
이 샘플의 용도
이 샘플에서는 In 폴더를 수신 위치로 구성합니다. 샘플 파일SamplePOInput.xml같은 파일을 이 폴더에 배치하면 BizTalk Server 다음 단계를 사용하여 메시지를 처리합니다.
BizTalk Server 수신 위치 폴더에서 XML 구매 주문 메시지를 검색합니다.
오케스트레이션이 맵 파일을 사용하여 XML 구매 주문에서 XML 송장을 만듭니다.
BizTalk Server 결과 XML 송장 메시지를 송신 어댑터 Out 폴더에 배치합니다.
이 샘플이 디자인된 방식 및 이유
회사 간 메시지 교환 시나리오에서는 거래 업체에서 받은 인바운드 메시지를 내부 응용 프로그램이 인식할 수 있는 형식으로 변환해야 하는 경우가 많습니다. 이 샘플에서는 Receive 셰이프, 변환 셰이프 및 보내기 도형을 사용하여 이 결과를 달성합니다. 변환 셰이프는 메시지 형식 변환이 발생하는 위치이기 때문에 이 샘플에서 중요한 역할을 합니다. 변환 셰이프를 오케스트레이션으로 끌어와 원본 메시지, 맵 이름 및 대상 메시지를 구성합니다. 런타임 중에 소스 메시지는 지정한 맵을 사용하여 대상 메시지에 매핑됩니다.
변환 셰이프에 대한 자세한 내용은 변환셰이프를 구성하는 방법을 참조하세요. 지도 빌드에 대한 자세한 내용은 BizTalk Mapper를 사용하여 지도 만들기를 참조하세요.
이 샘플이 있는 위치
< 샘플 경로>\Orchestrations\HelloWorld\
다음 표는 이 샘플의 파일을 보여 주고 각각의 용도에 대해 설명합니다.
| 파일 | Description |
|---|---|
| Cleanup.bat | 어셈블리 배포를 취소하고 전역 어셈블리 캐시에서 어셈블리를 제거하는 데 사용됩니다. 송신 및 수신 포트를 제거합니다. 필요한 경우 Microsoft IIS(인터넷 정보 서비스) 가상 디렉터리를 제거합니다. |
| HelloOrchestration.odx | 구매 주문을 송장으로 변환하는 과정을 조정하는 오케스트레이션입니다. |
| HelloWorld.btproj, HelloWorld.sln | 이 샘플에 대한 프로젝트 및 솔루션 파일입니다. |
| HelloWorldBinding.xml | 포트 바인딩과 같은 자동화된 설치에 사용됩니다. |
| InvoiceSchema.xsd, POSchema.xsd | 각각 송장 및 구매 주문 메시지에 대한 스키마입니다. |
| POToInvoice.btm | 구매 주문을 송장으로 변환하는 데 사용되는 맵입니다. |
| SamplePOInput.xml | 샘플 입력 파일입니다. |
| Setup.bat | 이 샘플을 빌드 및 초기화하는 데 사용됩니다. |
이 샘플 빌드 및 초기화
HelloWorld 샘플을 빌드 및 초기화하려면 다음을 수행하십시오.
명령 창에서 다음 폴더로 이동합니다.
< 샘플 경로>\Orchestrations\HelloWorld
다음 작업을 수행하는 Setup.bat 파일을 실행합니다.
다음 폴더에 이 샘플의 입력(In) 및 출력(Out) 폴더를 만듭니다.
< 샘플 경로>\Orchestrations\HelloWorld
이 샘플에 대한 Visual Studio 프로젝트를 컴파일합니다.
BizTalk Server 수신 위치와 송신 및 수신 포트를 오케스트레이션에 만들고 바인딩합니다.
수신 위치를 사용하도록 설정하고 송신 포트를 시작합니다. 오케스트레이션을 등록하고 시작합니다.
참고
이 샘플을 실행하기 전에 BizTalk Server가 빌드 및 초기화 프로세스 동안 오류를 보고하지 않았는지 확인해야 합니다. 이벤트 로그를 보고 확인할 수 있습니다.
이 샘플 실행
HelloWorld 샘플을 실행하려면 다음을 수행하십시오.
파일 SamplePOInput.xml 복사본을 In 폴더에 붙여넣 습니다 .
Out 폴더에서 만든 .xml 파일을 확인합니다. 이 파일에는 입력 파일 SamplePOInput.xml 생성된 XML 청구서가 포함되어 있습니다. 이 파일의 이름 형식은 <MessageID>.xml. 여기서 <MessageID> 는 메시지를 고유하게 식별하기 위해 생성된 GUID입니다.
이 샘플 제거
HelloWorld 샘플을 제거하려면 다음을 수행하십시오.
명령 창에서 다음 폴더로 이동합니다.
< 샘플 경로>\Orchestrations\HelloWorld\
Cleanup.bat를 실행합니다.