다음을 통해 공유

MQSSendPipelineComponent(BizTalk Server 샘플)

  • 아티클

이 샘플은 XML 파일에서 일련의 MQSeries 속성 값을 읽고 메시지에 적용하는 파이프라인 구성 요소를 작성하는 방법을 보여 줍니다.

이 샘플의 용도

이 샘플은 두 개의 Visual Studio 프로젝트, 파이프라인 구성 요소 프로젝트 및 파이프라인 구성 요소를 사용하는 파이프라인 프로젝트로 구성됩니다.

이 샘플이 있는 위치

  • <SamplesPath>\AdaptersUsage\MQSeriesAdapter\MQSSendPipelineComponent\SetMQSeriesHeaderPropertyComponent

  • <SamplesPath>\AdaptersUsage\MQSeriesAdapter\MQSSendPipelineComponent\SetMQSeriesHeaderPropertyPipeline

    다음 표는 이 샘플의 파일을 보여 주고 각각의 용도에 대해 설명합니다.

최근에 사용한 파일 설명
SetMQSeriesHeaderPropertyComponent\SetMQSeriesHeaderPropertyComponent.sln,

SetMQSeriesHeaderPropertyComponent\SetMQSeriesHeaderPropertyComponent.csproj		 파이프라인 구성 요소에 대한 프로젝트 및 솔루션 파일입니다.
SetMQSeriesHeaderPropertyComponent\CSetMQSeriesHeaderPropertyComponent.cs 파이프라인 구성 요소에 대한 Visual C#® 소스 파일입니다.
SetMQSeriesHeaderPropertyComponent\SetMQSMQMDHdrProps.xml 파이프라인 구성 요소가 읽고 사용하는 MQSeries 속성입니다.
SetMQSeriesHeaderPropertyPipeline\SetMQSeriesHeaderPropertyPipeline.btproj,

SetMQSeriesHeaderPropertyPipeline\SetMQSeriesHeaderPropertyPipeline.sln		 BizTalk 파이프라인에 대한 프로젝트 및 솔루션 파일입니다.
SetMQSeriesHeaderPropertyPipeline\SetMQSeriesHeaderPropertyPipeline.snk BizTalk 파이프라인 프로젝트에 대한 강력한 이름 키 파일입니다.
SetMQSeriesHeaderPropertyPipeline\SetMQSeriesHeaderPropertyPipeline.btp BizTalk Server 파이프라인입니다.

이 샘플의 사용 방법

응용 프로그램을 만들려면 다음 단계를 완료해야 합니다.

  1. 응용 프로그램에 대한 폴더를 만듭니다.

  2. 파이프라인 구성 요소에 대한 Visual Studio 프로젝트를 수정하고 컴파일합니다.

  3. 컴파일된 어셈블리 및 헤더 파일을 해당 폴더에 복사합니다.

  4. BizTalk Server 파이프라인에 대한 Visual Studio 프로젝트를 수정합니다.

  5. BizTalk Server 파이프라인 프로젝트를 컴파일하고 배포합니다.

  6. BizTalk Server 수신 위치를 설정합니다.

  7. MQSeries 큐를 만듭니다.

  8. 송신 포트를 설정합니다.

  9. 수신 위치를 사용하도록 설정하고 송신 포트를 시작합니다.

응용 프로그램에 대한 폴더 만들기

이 절차에서는 응용 프로그램에 대한 적절한 폴더를 만듭니다.

응용 프로그램에 대한 폴더를 만들려면 다음을 수행하십시오.

  1. C:\ 드라이브에 temp 라는 폴더가 아직 없는 경우 만듭니다.

  2. Pickup3이라는 C:\temp 디렉터리 아래에 폴더를 만듭니다.

파이프라인 구성 요소에 대한 프로젝트 수정 및 컴파일

이 절차는 파이프라인 구성 요소에 대한 Visual Studio 프로젝트를 수정하고 컴파일합니다.

파이프라인 구성 요소에 대한 프로젝트를 수정 및 컴파일하려면 다음을 수행하십시오.

  1. 솔루션 파일 SetMQSeriesHeaderPropertyComponent\SetMQSeriesHeaderPropertyComponent.sln 을 두 번 클릭하여 Visual Studio에서 솔루션을 엽니다.

  2. 클래스 파일 CSetMQSeriesHeaderPropertyComponent.cs를 두 번 클릭하여 Visual Studio에서 클래스 파일을 엽니다.

  3. samplesDir 변수를 찾아 이 변수가 C:\temp 위치로 설정되어 있는지 확인합니다.

  4. 솔루션 탐색기 솔루션을 마우스 오른쪽 단추로 클릭하고 빌드를 클릭합니다. 그러면 프로젝트를 SetMQSeriesHeaderPropertyComponent\SetMQSeriesHeaderPropertyComponent\bin\Debug\ 디렉터리에 있는 dll로 컴파일합니다.

어셈블리 및 헤더 파일을 해당 폴더에 복사

이 절차에서는 컴파일된 어셈블리 및 헤더 파일을 해당 폴더에 복사합니다.

컴파일된 어셈블리 및 헤더 파일을 해당 폴더에 복사하려면 다음을 수행하십시오.

  1. 컴파일된 어셈블리 SetMQSeriesHeaderPropertyComponent.dll BizTalk 파이프라인 구성 요소 폴더에 복사합니다. BizTalk 파이프라인 구성 요소 폴더의 기본 위치는 \Program Files (x86)\Microsoft BizTalk Server <VERSION>Pipeline Components입니다.

  2. MQHeader 속성 파일 SetMQSMQMDHdrProps.xmlC:\temp 디렉터리에 복사합니다.

BizTalk Server 파이프라인에 대한 프로젝트 수정

이 절차에서는 BizTalk Server 파이프라인에 대한 Visual Studio 프로젝트를 수정합니다.

BizTalk Server 파이프라인에 대한 프로젝트를 수정하려면 다음을 수행하십시오.

  1. Visual Studio에서 솔루션 파일 SetMQSeriesHeaderPropertyPipeline\SetMQSeriesHeaderPropertyPipeline.sln을 두 번 클릭하여 솔루션을 엽니다.

  2. 프로젝트에 대한 강력한 이름 키 파일을 만듭니다. 이렇게 하려면 다음을 수행할 수 있습니다.

    1. Visual Studio 명령 프롬프트를 엽니다.

    2. 디렉터리를 <SamplesPath>\AdaptersUsage\MQSeriesAdapter\MQSSendPipelineComponent로 변경합니다.

    3. 다음과 같이 입력합니다.

      sn -k MQSSendPipelineComponent.snk

    4. Enter 키를 누릅니다. 이렇게 하면 키 파일이 만들어집니다.

  3. 솔루션 탐색기 프로젝트를 마우스 오른쪽 단추로 클릭하고 속성을 클릭하여 프로젝트의 프로젝트 Designer 시작합니다(가운데 창).

    1. 프로젝트 Designer 서명 탭을 클릭합니다.

    2. 오른쪽 창에서 어셈블리 서명 옵션을 선택합니다.

    3. 강력한 이름 키 파일 선택 옵션에 대한 드롭다운 목록을 클릭하고 찾아보기를 클릭합니다.

    4. <SamplesPath>\AdaptersUsage\MQSeriesAdapter\MQSSendPipelineComponent\MQSSendPipelineComponent.snk로 이동하여 열기를 클릭합니다.

  4. 이전에 만든 파이프라인 구성 요소가 이미 이 파이프라인 프로젝트의 사전 어셈블 단계에 추가되었습니다. 이 구성 요소가 추가되지 않은 경우 다음 단계를 수행하여 구성 요소를 추가해야 합니다.

    1. Visual Studio IDE에서 왼쪽의 도구 상자 탭을 클릭합니다.

    2. 도구 상자를 마우스 오른쪽 단추로 클릭하고 항목 선택을 클릭합니다.

    3. 도구 상자 항목 선택 대화 상자에서 BizTalk 파이프라인 구성 요소 탭을 클릭하고 사용자 지정 구성 요소를 선택하여 MQseries 헤더 속성구성 요소를 설정한 다음 확인을 클릭합니다.

    4. 사용자 지정 구성 요소를 끌어 MQseries 헤더 속성구성 요소를 이 파이프라인의 사전 어셈블 단계로 끕니다.

파이프라인 프로젝트 컴파일 및 배포

이 절차는 BizTalk Server 파이프라인 프로젝트를 컴파일하고 배포합니다.

파이프라인 프로젝트를 컴파일 및 배포하려면 다음을 수행하십시오.

  1. 솔루션 탐색기 창에서 솔루션을 마우스 오른쪽 단추로 클릭한 다음 솔루션 배포를 클릭합니다. 이렇게 하면 솔루션이 빌드되고 어셈블리가 BizTalk 관리 데이터베이스에 배포됩니다.

  2. 어셈블리가 BizTalk 관리 데이터베이스에 배포되었는지 확인합니다.

    1. BizTalk 관리 콘솔을 엽니다.

    2. BizTalk 그룹 [<servername>:<management 데이터베이스>]을 클릭하여 확장한 다음 어셈블리 폴더를 확장하려면 클릭합니다.

      배포된 파이프라인 어셈블리는 어셈블리 폴더 아래에 표시되어야 합니다.

수신 위치 만들기

이 절차에서는 BizTalk Server 수신 위치를 만듭니다.

수신 위치를 만들려면 다음을 수행하십시오.

  1. BizTalk Server 관리 콘솔에서 수신 포트를 마우스 오른쪽 단추로 클릭하고 새로 만들기를 가리킨 다음 단방향 수신 포트를 클릭합니다.

  2. 단방향 수신 포트 속성 대화 상자의 이름 상자에 "MQReply"를 입력하고 확인을 클릭합니다.

  3. 왼쪽 창에서 수신 위치 탭을 클릭한 다음 새로 만들기를 클릭합니다.

  4. 수신 위치 속성 대화 상자의 이름 필드에 "ReceiveFile"을 입력합니다.

  5. 전송 유형 상자에서 파일을 선택합니다.

  6. 수신 처리기 필드에서 BizTalkServerApplication을 선택합니다.

  7. 수신 파이프라인 필드에서 Microsoft.BizTalk.DefaultPipelines.PassThruReceive를 선택합니다.

  8. 수신 폴더 필드에 "C:\temp\Pickup3"을 입력합니다.

  9. 파일 마스크 필드에 "*.*"를 입력합니다.

  10. 확인을 클릭한 다음 확인을 다시 클릭하여 수신 위치 속성 대화 상자를 종료합니다.

MQSeries Explorer를 통해 MQSeries 큐 만들기

Windows용 MQSeries 서버 설치에 대한 필수 사용 권한이 있는 경우 어댑터 대화 상자를 통해 MQSeries 큐를 만들고 다음 절차를 건너뛰어도 됩니다.

이러한 액세스 권한이 없는 경우 다음 절차에 따라 IBM WebSphere MQ Explorer를 사용하여 큐를 만들 수 있습니다.

MQSeries Explorer를 통해 MQSeries 큐를 만들려면 다음을 수행하십시오.

  1. 시작을 클릭하고 프로그램을 가리킨 다음 IBM WebSphere MQ를 가리킨 다음 WebSphere MQ Explorer 클릭합니다.

  2. 큐 관리자를 두 번 클릭한 다음 기본 큐 관리자를 두 번 클릭합니다. 기본 큐 관리자의 이름은 일반적으로 QM_<machine_name> 여기서 machine_name 컴퓨터의 이름입니다.

  3. 큐를 마우스 오른쪽 단추로 클릭하고 새로 만들기를 가리킨 다음 로컬 큐를 클릭합니다.

  4. 로컬 큐 만들기 대화 상자의 큐 이름에 SETHEADER를 입력한 다음 확인을 클릭합니다.

송신 포트 및 MQSeries 큐 만들기

이 절차에서는 출력 메시지에 대한 송신 포트를 만듭니다. 아직 만들지 않은 경우 송신 포트를 만들 때 MQSeries 큐도 생성됩니다.

송신 포트 및 MQSeries 큐를 만들려면

  1. 포트 보내기를 마우스 오른쪽 단추로 클릭하고 새로 만들기를 가리킨 다음 정적 단방향 송신 포트를 클릭합니다.

  2. 송신 포트 속성 대화 상자의 이름 상자에 "MQSolicitResponse"를 입력합니다.

  3. 전송 유형 상자에서 MQSeries를 선택합니다.

  4. 파이프라인 보내기 상자에서 SetMQSeriesHeaderPropertyPipeline.SetMQSeriesHeadersSendPipeline을 선택합니다.

  5. 필터에서 다음 이름/값 쌍을 사용하여 새 항목을 추가합니다.

    • 속성을 "BTS"로 설정합니다. ReceivePortName".

    • 연산자 를 "=="로 설정합니다.

    • 값을 "ReceiveFile"으로 설정합니다.

      참고

      이렇게 하면 송신 포트가 ReceiveFile 수신 포트에 도착하는 메시지에 등록하도록 설정됩니다.

  6. 전송을 클릭합니다.

  7. 주소(URI) 필드에서 줄임표(...) 단추를 클릭합니다.

  8. MQSeries 전송 속성 대화 상자의 큐 정의 필드에서 줄임표(...) 단추를 클릭합니다.

  9. 큐 정의 대화 상자의 서버 이름 필드에 컴퓨터 이름을 입력합니다.

  10. 큐 관리자 필드에서 기본 큐 관리자를 선택합니다.

  11. 큐 필드에 "SETHEADER"를 입력한 다음 내보내기를 클릭합니다.

  12. 내보내기 대화 상자에서 큐 만들기를 클릭한 다음 모든 대화 상자를 종료할 때까지 확인 또는 완료를 클릭합니다.

수신 위치를 사용하도록 설정하고 송신 포트 시작

이 절차에서는 수신 위치를 사용하도록 설정하고 송신 포트를 시작합니다.

수신 위치를 사용하도록 설정하고 송신 포트를 시작하려면

  1. BizTalk Server 관리 콘솔에서 수신 포트를 클릭합니다.

  2. 세부 정보 창에서 MQIn 수신 위치를 마우스 오른쪽 단추로 클릭하고 사용을 클릭합니다.

  3. 세부 정보 창에서 SetMQHeader 송신 포트를 마우스 오른쪽 단추로 클릭하고 시작을 클릭합니다.

애플리케이션 테스트

이 절차에서는 응용 프로그램을 테스트합니다.

애플리케이션을 테스트하려면

  1. C:\Temp\Pickup3 폴더에 파일을 넣습니다.

  2. WebSphere MQ Explorer를 시작하고 SETHEADER 큐를 두 번 클릭하여 SETHEADER 큐에 있는 메시지를 검사합니다.

    SETHEADER 큐에 있는 메시지의 모든 컨텍스트 속성을 보려면 다음 단계를 수행합니다.

    1. SETHEADER 큐를 두 번 클릭하여 메시지 브라우저 대화 상자를 표시합니다.

    2. 메시지 브라우저 대화 상자에서 열을 클릭하여 메시지에 대한 열 표시/숨기기 대화 상자를 표시합니다.

    3. 사용 가능한 열에서 각 항목을 두 번 클릭하여 메시지 브라우저 대화 상자에 표시한 다음 확인을 클릭합니다.

  3. 각 메시지에 대한 메시지 컨텍스트 속성은 메시지 브라우저 대화 상자에 표시되어야 합니다.

참고 항목

MQSeries 어댑터 샘플