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