OrderedSample 샘플은 오케스트레이션을 사용하여 왕복 방식으로 정렬된 일련의 메시지를 수신하고 보내는 방법을 보여 줍니다.
이 샘플이 수행하는 작업
샘플에서는 메시지를 수신하는 MQSeries 큐에 메시지가 있다고 가정합니다. 어댑터는 MQSeries 큐에서 메시지를 읽는 경우 순서대로 읽고 BizTalk Server에 제출합니다.
오케스트레이션의 수신 포트인 mqreceive에는 Ordered Delivery 속성이 True로 설정되어 있습니다.
송신 쪽의 경우 오케스트레이션은 메시지를 보낸 다음, 다음 메시지를 보내기 전에 배달 알림을 기다립니다. 송신 포트, mqsend 에는 전송 알림 속성이 전송됨으로 설정되어 있습니다. 예제를 단순하게 유지하기 위해 오케스트레이션은 무한 루프를 사용합니다.
오케스트레이션은 메시지 및 단일 메시지의 일괄 처리를 받을 수 있습니다.
이 샘플을 찾을 수 있는 위치
<샘플 경로>\AdaptersUsage\MQSeriesAdapter\OrderedSample
다음 표에서는 이 샘플의 파일을 보여 줍니다. 해당 용도를 설명합니다.
| 파일 | 설명 |
|---|---|
| OrderedReceiveSend.btproj, OrderedReceiveSend.sln |
애플리케이션에 대한 프로젝트 및 솔루션 파일입니다. |
| 오더드리시브센드오케스트레이션.odx | 애플리케이션 오케스트레이션 |
| OrderedSample.snk | 강력한 이름 지정 키 파일입니다. |
| Setup.bat | 이 샘플을 빌드하고 초기화합니다. |
샘플 빌드 및 실행
샘플을 빌드하고 배포하려면
명령 창에서 다음 폴더로 이동합니다.
<Samples Path>\AdaptersUsage\MQSeriesAdapter\OrderedSample다음 작업을 수행하는 파일 Setup.bat실행합니다.
프로젝트에 대한 강력한 이름 키를 만듭니다.
오케스트레이션 프로젝트를 컴파일하고 배포합니다.
Windows용 MQSeries Server 설치에 필요한 권한이 있는 경우 어댑터 대화 상자를 통해 MQSeries 큐를 만들고 다음 절차를 건너뛸 수 있습니다. 이러한 액세스 권한이 없는 경우 IBM WebSphere MQ Explorer를 사용하여 큐를 만들 수 있습니다. WebSphere MQ 탐색기를 통해 큐를 만들려면 다음 단계를 완료합니다.
WebSphere MQ Explorer를 통해 MQSeries 큐 만들기
WebSphere MQ Explorer를 통해 MQSeries 큐를 만들려면
시작을 클릭하고 모든 프로그램을 가리키고 IBM WebSphere MQ를 가리킨 다음 WebSphere MQ 탐색기를 클릭합니다.
큐 관리자를 두 번 클릭한 다음 기본 큐 관리자를 두 번 클릭합니다. 기본 큐 관리자의 이름은 일반적으로 QM_<machine_name> 여기서 machine_name 컴퓨터의 이름입니다.
큐를 마우스 오른쪽 단추로 클릭하고 새로 만들기를 가리킨 다음 로컬 큐를 클릭합니다.
로컬 큐 만들기 대화 상자의 큐 이름에서 "queue1"을 입력한 다음 확인을 클릭합니다.
큐를 마우스 오른쪽 단추로 클릭하고 새로 만들기를 클릭한 다음 로컬 큐를 클릭합니다.
로컬 큐 만들기 대화 상자의 큐 이름에서 "queue2"를 입력한 다음 확인을 클릭합니다.
수신 위치 및 MQSeries 큐 만들기
이 절차에서는 메시지를 보내고 MQSeries에서 상관 관계 메시지를 받을 송신 포트 및 수신 위치를 만듭니다. 아직 만들지 않은 경우 수신 위치를 만들 때 MQSeries 큐도 만들어집니다.
수신 위치 및 MQSeries 큐를 만들려면
BizTalk Server 관리 콘솔을 엽니다.
BizTalk Server 관리를 확장하고 BizTalk 그룹을 확장한 다음 애플리케이션을 확장한 다음 필요한 애플리케이션을 확장합니다.
수신 포트를 마우스 오른쪽 단추로 클릭하고 새로 만들기를 가리킨 다음 단방향 수신 포트를 클릭합니다.
단방향 수신 포트 속성 대화 상자의 이름 상자에 OrderedSampleReceive를 입력하고 확인을 클릭합니다.
왼쪽 창에서 수신 위치 탭 을 클릭한 다음 새로 만들기를 클릭합니다.
수신 위치 속성 대화 상자의 이름 상자에 "OrderedSampleReceiveLocation"을 입력합니다.
전송 유형 상자에서 MQSeries를 선택합니다.
수신 처리기 상자에서 BizTalkServerApplication을 선택합니다.
수신 파이프라인 상자에서 Microsoft.BizTalk.DefaultPipelines.PassThruReceive를 선택합니다.
구성을 클릭합니다.
MQSeries 전송 속성 대화 상자의 폴링 간격 상자에 "10"을 입력합니다.
큐 정의 상자에서 줄임표(...) 단추를 클릭합니다.
큐 정의 대화 상자의 서버 이름 상자에 컴퓨터 이름을 입력합니다.
큐 관리자 상자에서 기본 큐 관리자를 선택합니다.
큐 상자에 "queue1"을 입력하고 내보내기를 클릭합니다.
내보내기 대화 상자에서 큐 만들기를 클릭한 다음 모든 대화 상자를 종료할 때까지 확인 또는 완료를 클릭합니다.
송신 포트 및 MQSeries 큐 만들기
송신 포트 및 MQSeries 큐를 만들려면
송신 포트를 마우스 오른쪽 단추로 클릭하고 새로 만들기를 가리킨 다음 정적 단방향 송신 포트를 클릭합니다.
정적 포트 속성 대화 상자의 이름 상자에 "OrderedSampleSend"를 입력합니다.
전송 유형 상자에서 MQSeries를 선택합니다.
송신 파이프라인 상자에서 Microsoft.BizTalk.DefaultPipelines.PassThruTransmit를 선택합니다.
구성을 클릭합니다.
MQSeries 전송 속성 대화 상자의 큐 정의 상자에서 줄임표(...) 단추를 클릭합니다.
큐 정의 대화 상자의 서버 이름 상자에 컴퓨터 이름을 입력합니다.
큐 관리자 상자에서 기본 큐 관리자를 선택합니다.
큐 상자에 "queue2"를 입력하고 내보내기를 클릭합니다.
내보내기 대화 상자에서 큐 만들기를 클릭한 다음 모든 대화 상자를 종료할 때까지 확인 또는 완료를 클릭합니다.
수신 위치를 사용하도록 설정하고 송신 포트를 시작하려면
BizTalk Server 관리 콘솔에서 수신 포트를 클릭합니다.
세부 정보 창에서 MQIn 수신 위치를 마우스 오른쪽 단추로 클릭하고 [사용]을 클릭합니다.
세부 정보 창에서 MQOut 송신 포트를 마우스 오른쪽 단추로 클릭하고 시작을 클릭합니다.
오케스트레이션을 연결하고 시작하려면
BizTalk Server 관리 콘솔에서 오케스트레이션 폴더를 확장합니다.
OrderedSampleOrchestration 오케스트레이션을 두 번 클릭한 다음 바인딩을 클릭합니다.
오케스트레이션 포트를 다음 송신 포트 및 수신 위치에 바인딩합니다.
오케스트레이션 포트 메시징 포트/수신 위치 mqreceive 주문된샘플수신 mqsend 정렬된 샘플 전송 호스트를 클릭합니다.
호스트 상자에서 BizTalkServerApplication을 선택하고 확인을 클릭합니다.
오케스트레이션을 마우스 오른쪽 단추로 클릭하고 시작을 클릭합니다.
이 샘플을 실행하려면
오케스트레이션을 시작합니다.
구성한 수신 위치에서 읽을 수 있도록 메시지를 MQSeries 큐로 보냅니다.
메시지를 보내도록 송신 포트를 구성한 송신 큐의 WebSphere MQ Explorer에서 메시지를 봅니다.