Share via


방법: 메시지 변환 및 여정 라우팅 쪽지를 사용하여 단일 파일 위치로 결과 메시지 라우팅

목표

이 섹션에서는 ESB Designer DSL(도메인별 언어)을 사용하여 BizTalk 맵을 호출하여 메시지 변환을 구현하는 여정을 만든 다음 Microsoft BizTalk ESB Toolkit FILE 어댑터를 사용하여 메시지를 라우팅하는 방법을 보여 줍니다.

이 방법 항목에서는 다음 단계를 완료합니다.

  • BizTalk 맵을 구현하는 변환 여정 서비스를 사용하여 여정 라우팅 슬립을 만듭니다.

  • 변환된 메시지를 파일 위치로 라우팅하도록 여정을 구성합니다.

  • 여정 테스트 클라이언트 샘플 애플리케이션을 사용하여 여정을 테스트합니다.

필수 구성 요소

이 방법 항목의 절차에서는 개발 활동에 대한 필수 구성 요소를 완료해야 합니다.

단계

ESB 여정 DSL 모델을 만들려면

  1. Visual Studio에서 C:\HowTos\Patterns\Patterns.sln을 엽니다.

  2. 솔루션 탐색기 여정라이브러리 프로젝트를 마우스 오른쪽 단추로 클릭하고 추가를 가리킨 다음 새 여정을 클릭합니다.

  3. 새 항목 추가 대화 상자의 템플릿 창에서 여정Dsl을 클릭합니다.

  4. 이름 상자에 DataModelTransformation을 입력하고 추가를 클릭합니다.

여정의 속성을 구성하려면

  1. Visual Studio에서 DataModelTransformation.itinerary의 디자인 화면을 클릭합니다. DataModelTransformation 속성 창 다음 속성을 구성합니다.

    1. 모델 내보내기 드롭다운 목록에서 XML 여정 내보내기를 클릭합니다.

    2. Extender 설정 섹션의 여정 XML 파일 속성 옆에 있는 줄임표 단추(...)를 클릭합니다.

    3. XML 파일 선택 대화 상자의 파일 이름 상자에 C:\HowTos\Itineraries\DataModelTransformation을 입력하고 저장을 클릭합니다.

      참고

      이 단계를 통해 여정을 XML로 로컬 파일 위치로 내보낼 수 있습니다. 여정 데이터베이스 대신 로컬 파일 위치로 여정을 내보내면 ESB 테스트 클라이언트 애플리케이션을 사용하여 여정을 테스트할 수 있습니다. 이 프로세스는 이 방법 항목의 뒷부분에서 완료합니다.

여정의 구조를 정의하려면

  1. 도구 상자에서 On-Ramp 모델 요소를 디자인 화면으로 끌어옵니다. OnRamp1 속성 창 다음 속성을 구성합니다.

    1. Name 속성을 클릭한 다음 ReceiveNAOrder를 입력합니다.

    2. Extender 드롭다운 목록에서 On-Ramp ESB 서비스 확장을 클릭합니다.

    3. BizTalk 애플리케이션 드롭다운 목록에서 Microsoft.Practices.ESB를 클릭합니다.

    4. 수신 포트 드롭다운 목록에서 OnRamp.Itinerary를 클릭합니다.

  2. 도구 상자에서 여정 서비스 모델 요소를 디자인 화면으로 끌어온 다음 On-Ramp 모델 요소의 오른쪽에 놓습니다. ItineraryService1 속성 창 다음 속성을 구성합니다.

    1. Name 속성을 클릭한 다음 MapNAOrderToCNOrder를 입력합니다.

    2. 여정 서비스 확장기 드롭다운 목록에서 메시징 확장자를 클릭합니다.

      참고

      이 속성은 프로세스가 파이프라인(메시징)에서 수행되도록 정의합니다. 또는 프로세스가 오케스트레이션에서 수행되는 경우 여정 서비스 Extender 속성을 Orchestration Extender로 설정합니다.

    3. 컨테이너 드롭다운 목록에서 ReceiveNAOrder를 확장한 다음 수신 처리기를 클릭합니다.

    4. 서비스 이름 드롭다운 목록에서 Microsoft.Practices.ESB.Services.Transform을 클릭합니다.

  3. MapNAOrderToCNOrder 모델 요소의 Resolver 컬렉션을 마우스 오른쪽 단추로 클릭한 다음 새 해결 프로그램 추가를 클릭합니다. Resolver1 속성 창 다음 속성을 구성합니다.

    1. Name 속성을 클릭한 다음 StaticallySpecifyTheMap을 입력합니다.

    2. 해결 프로그램 구현 드롭다운 목록에서 정적 해결 프로그램 확장을 클릭합니다.

    3. 변환 형식 드롭다운 목록에서 GlobalBank.ESB.DynamicResolution.Transforms.SubmitOrderRequestNA_To_SubmitOrderRequestCN 클릭합니다.

    4. 전송 이름 드롭다운 목록에서 파일을 클릭합니다.

  4. 도구 상자에서 커넥터를 클릭합니다. ReceiveNAOrder 모델 요소에서 MapNAOrderToCNOrder 모델 요소로 연결을 끌어옵니다.

  5. 도구 상자에서 오프 램프 모델 요소를 디자인 화면으로 끌어온 다음 MapNAOrderToCNOrder 모델 요소의 오른쪽에 놓습니다. OffRamp1 속성 창 다음 속성을 구성합니다.

    1. Name 속성을 클릭한 다음 SendCNOrder를 입력합니다.

    2. Extender 드롭다운 목록에서 오프 램프 ESB Extender를 클릭합니다.

    3. BizTalk 애플리케이션 드롭다운 목록에서 GlobalBank.ESB를 클릭합니다.

    4. 송신 포트 드롭다운 목록에서 DynamicResolutionOneWay를 클릭합니다.

  6. 도구 상자에서 여정 서비스 모델 요소를 디자인 화면으로 끌어온 다음 MapNAOrderToCNOrder 모델 요소와 SendCNOrder 모델 요소 사이에 배치합니다. ItineraryService1 속성 창 다음 속성을 구성합니다.

    1. Name 속성을 클릭한 다음 SendPortFilter를 입력합니다.

    2. 여정 서비스 확장기 드롭다운 목록에서 램프 끄기 확장기를 클릭합니다.

    3. 램프 끄기 드롭다운 목록에서 SendCNOrder를 확장한 다음 송신 처리기를 클릭합니다.

  7. SendPortFilter 모델 요소의 Resolver 컬렉션을 마우스 오른쪽 단추로 클릭한 다음 새 해결 프로그램 추가를 클릭합니다. Resolver1 속성 창 다음 속성을 구성합니다.

    1. Name 속성을 클릭한 다음 ConfigureFolderSettings를 입력합니다.

    2. 전송 이름 드롭다운 목록에서 파일을 클릭합니다.

    3. 전송 위치 속성을 클릭한 다음 C:\HowTos\Out\%MessageID%.xml입력합니다.

      참고

      각 경사로에는 여정 서비스와 연결된 여정 서비스가 있습니다. 여정 서비스 속성과 오프 램프의 속성의 조합은 동적 송신 포트의 구독을 정의합니다.

  8. 도구 상자에서 커넥터를 클릭합니다. MapNAOrderToCNOrder 모델 요소에서 SendPortFilter 모델 요소로 연결을 끌어옵니다.

  9. 도구 상자에서 커넥터를 클릭합니다. SendPortFilter 모델 요소에서 SendCNOrder 모델 요소로 연결을 끌어옵니다.

여정 테스트 클라이언트에서 사용할 모델을 내보내려면

  1. Visual Studio에서 DataModelTransformation 여정의 디자인 화면을 마우스 오른쪽 단추로 클릭한 다음 모델 내보내기를 클릭합니다.

    참고

    여정의 XML 버전이 Visual Studio에서 열립니다.

  2. 모든 프로젝트 아티팩트 저장

  3. Windows Explorer C:\HowTos\Itineraries로 이동하여 여정 XML(DataModelTransformation.xml)이 생성되었는지 확인합니다.

여정을 테스트하려면

  1. 개발 활동(C:\HowTos\ESB.Itinerary.Test.exe - 바로 가기)에 대한 필수 구성 요소 중에 만든 바로 가기를 사용하여 여정 테스트 클라이언트 샘플 애플리케이션을 엽니다.

  2. 여정 테스트 클라이언트에서 WCF 서비스 검사 사용 상자의 선택 취소를 선택한 다음 여정 로드를 클릭합니다.

  3. 일정 파일 열기 대화 상자에서 C:\HowTos\Itineraries로 이동합니다. DataModelTransformation.xml를 선택한 다음 열기를 클릭하여 여정을 로드합니다.

  4. 확인을 클릭하여 적재된 여정 메시지의 지우기를 클릭합니다.

  5. 여정 테스트 클라이언트에서 메시지 로드 상자 옆에 있는 줄임표 단추(...)를 클릭합니다.

  6. 로드할 XML 문서 선택 대화 상자에서 C:\HowTos로 이동합니다. NAOrderDoc.xml를 선택한 다음 열기를 클릭하여 테스트 메시지를 로드합니다.

  7. 요청 제출 단추를 클릭합니다. 테스트가 완료되면 확인을 클릭하여 표시되는 확인을 해제합니다.

  8. Windows Explorer C:\HowTos\Out으로 이동합니다. %MessageID%.xml 메시지가 디렉터리에 기록되었는지 확인합니다.

추가 리소스

자세한 내용은 다음 관련 topics 참조하세요.

  1. 방법: 교환 분할 및 고유한 여정을 사용하여 여러 파일 위치로 결과 메시지 라우팅

  2. 개발 작업

  3. 메시지 변환 패턴