XML 단방향 브리지 만들기

업데이트 날짜: 2015년 8월

이 섹션에서는 BizTalk Services 프로젝트에 XML 단방향 연결을 만드는 단계를 보여줍니다. XML 연결에는 다른 단계가 있습니다. 항목 내용

  1. BizTalk 서비스 프로젝트에 브리지 추가

  2. XML 연결에서 처리한 XML 메시지에 대한 요청 스키마 입력.

  3. 디코딩 단계 구성

  4. 유효성 검사 단계 구성

  5. 보강 단계 및 해당 속성 구성

  6. 변환 단계 구성

  7. 보강 단계(변환 후) 구성

  8. 인코딩 단계 구성

  1. BizTalk Services 프로젝트를 만듭니다. 해당 단계는 Visual Studio 프로젝트 시작에 나와 있습니다.

  2. BizTalk Services 프로젝트 디자인 영역에서 아무 곳이나 마우스 오른쪽 단추로 클릭하고 속성을 선택합니다. BizTalk 서비스 URL에 BizTalk 서비스 URL을 입력합니다.

  3. 도구 상자에서 XML 단방향 연결을 BizTalk Services 프로젝트 디자인 영역으로 끌어 놓습니다. .BridgeConfig 파일이 솔루션에 추가됩니다.

  4. 연결를 마우스 오른쪽 단추로 클릭하고 속성을 선택한 후 다음 속성을 입력합니다.

     

    속성 이름 설명

    연결된 프로젝트 항목

    읽기 전용: 연결된 .BridgeConfig 파일의 이름입니다. 파일 이름을 변경하려면 엔터티 이름 속성을 변경합니다.

    엔터티 이름

    BizTalk Services 프로젝트 디자인 영역의 XML 연결 이름입니다. 이 이름은 BizTalk Services 프로젝트에 대해 고유해야 합니다. .BridgeConfig 파일의 이름은 여기에 입력하는 값과 같습니다.

    상대 주소

    XML 연결가 역할로에서 호스팅되는 상대 주소입니다. 이 주소가 2단계에서 입력한 BizTalk 서비스 URL과 결합되어 연결의 전체 URL을 만듭니다.

    예를 들어 BizTalk 서비스 URL이 MyBizTalkService이고 연결의 상대 주소가 UpdateCustomers이면 서비스 버스의 끝점 URL은 https://MyBizTalkService.biztalk.windows.net/default/UpdateCustomers입니다.

    경로 순서 지정 테이블

    연결에서 메시지 흐름의 다른 구성 요소로 메시지를 라우팅하는 순서를 입력합니다. See The Routing Order.

    런타임 주소

    브리지를 배포할 공용 런타임 끝점 URL입니다.

    추적 속성

    연결에서 추적할 메시지 속성을 정의하려면 이 속성을 설정합니다. See 브리지가 처리한 메시지 추적.

  5. 저장을 클릭합니다.

단일 BizTalk Services 프로젝트에 브리지와 스키마를 여러 개 포함할 수 있습니다. 쉽게 사용하고 처리 시간을 줄이려면 브리지에 스키마를 연결할 수 있습니다. 즉, 특정 브리지가 특정 스키마 또는 스키마 집합을 따르는 메시지만 처리하도록 지정할 수 있습니다. 이 섹션에서는 이러한 연결을 만드는 단계를 설명합니다.

  1. BizTalk Services 프로젝트에 스키마를 추가합니다. 해당 단계는 Visual Studio 프로젝트 시작에 나와 있습니다. 이 단계를 반복하여 스키마를 BizTalk Services 프로젝트에 필요한 수만큼 추가합니다.

  2. XML 단방향 연결를 두 번 클릭하여 일정 디자이너를 엽니다.

    note참고
    일정 디자이너는 읽기 전용 영역이므로 일정 디자이너에서 단계 또는 활동을 추가하거나 제거할 수 없습니다.

  3. 연결 디자인 영역의 메시지 유형 상자에서 추가 아이콘 [ 추가 아이콘 ]을 선택하여 메시지 유형 선택을 엽니다. 메시지 유형 선택에서 다음을 수행합니다.

    1. 사용 가능한 메시지 유형 상자에서 요청 메시지에 대한 스키마를 선택합니다.

    2. 오른쪽 화살표 아이콘 [ 화살표 아이콘 ]을 선택하여 연결에 요청 스키마를 연결합니다.

    3. 확인을 선택합니다. 그러면 선택한 스키마가 메시지 유형 상자 아래에 나열됩니다.

      추가 정보:

      • 여러 스키마를 동시에 추가할 수는 없습니다. 연결에 더 많은 스키마를 연결하려면 이 단계를 반복합니다.

      • 연결과의 스키마 연결을 제거하려면 메시지 유형 상자에서 스키마를 선택하고 삭제 아이콘 [ 삭제 아이콘 ]을 누릅니다.

      • 스키마 연결을 다른 연결로 바꾸려면 편집 단추 [ 편집 아이콘 ]를 클릭하여 메시지 유형 선택을 다시 엽니다.

  4. 저장을 클릭합니다.

디코딩 단계에서는 들어오는 텍스트 메시지를 XML 메시지로 디코딩한 다음 XML 단방향 연결 브리지의 유효성 검사 단계로 전달합니다. 브리지의 다른 단계와는 달리 디코딩 단계에는 IsEnabled 속성이 없습니다. 단계의 IsEnabled 속성은 해당 단계에서 브리지를 통과하는 메시지를 처리하는지 여부를 정의합니다. 메시지 디코딩 여부는 들어오는 메시지의 콘텐츠 형식에 따라 달라지므로 디코딩 단계에는 이 속성이 포함되지 않습니다. 브리지가 'text/plain' 콘텐츠 형식의 메시지를 받을 경우 디코딩 단계에서 메시지를 디코딩하고 XML 메시지로 변환합니다. 브리지 내 각 단계의 나머지 처리는 플랫 파일 메시지가 아니라 XML 메시지에서 수행됩니다. 그러나 다른 콘텐츠 형식의 메시지가 브리지에서 수신되면 디코딩 단계가 활성화되지 않으며 메시지는 다음 단계로 전달만 됩니다.

디코딩 단계에서는 On Enter InspectorOn Exit Inspector)의 두 개 속성을 제공합니다. 이러한 속성은 사용자 지정 코드를 브리지 처리의 일부로 포함하는 데 사용됩니다. See 연결에 사용자 지정 코드를 포함하는 방법.

유효성 검사 단계에서 해당 단계에서 들어오는 요청 메시지에 대해 스키마 유효성 검사를 수행하는지 여부와 유효성 검사 경고를 예외로 클라이언트에 다시 전파할 수 있는지 여부를 입력할 수 있습니다.

  1. 연결을 두 번 클릭하여 연결 구성 디자인 영역을 엽니다.

  2. 유효성 검사 단계를 선택합니다. 속성에서 IsEnabledTrue 또는 False로 설정합니다. True로 설정하면 이 단계에서 이전에 추가한 스키마를 기준으로 들어오는 요청 메시지의 유효성을 검사합니다. False로 설정하면 스키마 유효성을 검사하지 않으며 메시지가 단순히 다음 단계로 전달됩니다.

    추가 정보:

  3. Xml Validate 작업을 선택합니다. 속성에서 Report Warnings As Errors 속성을 True 또는 False로 설정합니다. True로 설정하면 연결에서 스키마를 기준으로 한 XML 유효성 검사 중에 발생한 경고를 오류로 보고하고 요청 메시지를 보낸 클라이언트에 경고를 반환합니다. 그리고 유효성 검사 경고가 예외로 throw되며 유효성 검사가 실패합니다. XML 스키마 유효성 검사의 경고와 오류에 대해 알아보려면 유효성 검사 및 스키마 개체 모델을 참조하세요.

  4. 저장을 클릭합니다.

보강 단계에서는 속성, 즉 해당 값이 메시지 헤더(표준 또는 사용자 지정)에서, BizTalk 서비스가 승격한 기본 속성을 통해, 외부 데이터 원본(Microsoft Azure SQL 데이터베이스 테이블만 지원됨) 또는 메시지 본문 내의 요소에서 파생될 수 있는 값을 정의하여 메시지를 보강할 수 있습니다. 이러한 속성은 메시지를 대상 끝점으로 라우팅하거나 메시지 수신 엔터티가 메지를 추가로 처리하는 데 사용할 수 있습니다. 이 섹션에서는 다음 각 작업을 수행하는 단계를 나열합니다.

  • 속성에 메시지 헤더 값을 할당합니다.

  • BizTalk 서비스가 승격한 시스템 속성 또는 기본 속성을 사용합니다.

  • 외부 데이터 원본 조회

  • Xpath를 사용하여 메시지 본문 요소에서 값 추출

중요:

  • 이 단계에서 입력한 속성 이름은 대/소문자를 구분하지 않습니다.

  • 연결 구성을 저장하지 않은 경우 이 단계에서 입력한 속성은 경로 동작이나 회신 동작에 대한 것이 아닙니다. 경로 및 회신에 대한 자세한 내용은 경로 및 회신 동작: 브리징 프로토콜 불일치를 참조하세요.

보강 단계를 설정하거나 해제하여 이러한 동작을 수행할 것인지 여부를 선택할 수 있습니다.

단계:

  1. XML 단방향 연결를 두 번 클릭하여 일정 디자이너를 엽니다.

  2. 보강 단계를 선택합니다. 속성에서 IsEnabled 속성을 True 또는 False로 설정합니다.

    note참고
    True로 설정하고 속성을 정의하지 않은 경우 연결(디자인 타임)를 구성할 때와 메시지를 처리할 때(런타임) 연결에 오류가 발생하지 않습니다.

    추가 정보:

  3. 보강 단계 내에서 보강 작업을 선택합니다. 속성에서 속성 정의 속성의 줄임표 단추 (...)를 선택하여 속성 정의를 엽니다.

  4. 속성 정의에서 추가를 선택합니다. 속성 추가에서 여러 원본의 값을 사용하고 메시지에 속성으로 포함할 수 있습니다. 그런 다음 이러한 속성 및 해당 값은 나중에 속성 값을 기반으로 하여 다른 대상으로 메시지 라우팅과 같은 다른 처리 작업에 사용할 수 있습니다(The Routing Action 참조). 다음 표에는 메시지에 속성을 추가하는 다른 원본 및 방법이 나와 있습니다.

     

    원본 방법

    속성에 메시지 헤더 값 할당

     

    시스템 승격 속성 사용

     

    외부 데이터 원본 조회

    XPath를 사용하여 메시지 내에서 값 추출

    To extract values from a message body using xpath

  1. 속성 추가에서 다음을 수행합니다.

    note참고
    아래 표에는 속성에 헤더를 할당하는 작업에 필요한 필드만 나와 있습니다. 이 작업은 SOAP, HTTP, FTP, SFTP와 같은 메시지 전송 프로토콜만 사용하여 전송된 메시지와 관련이 있습니다. 따라서 다음 단계는 유형 드롭다운 목록에서 HTTP, SOAP, FTP 또는 SFTP를 선택한 경우에만 적용됩니다. 또한 유형 드롭다운 목록에서 선택한 항목에 따라 필수 필드가 빨간색으로 윤곽선 처리되고 다른 필드는 회색으로 표시됩니다.

     

    섹션 필드 이름 설명

    원본(읽기 대상)

    Type

    헤더 값이 추출되는 메시지 유형을 지정합니다. 속성에 헤더 값을 할당하려는 경우 가능한 값은 SOAP, HTTP, FTP, SFTP조정됨입니다.

    SOAP 헤더 네임스페이스(유형SOAP로 설정된 경우에만 해당됨)

    사용자 지정 SOAP 헤더의 네임스페이스를 지정합니다. 예를 들면 다음 인용문에서 MessageType 용자 지정 헤더의 네임스페이스가 강조 표시되어 있습니다.

    <s:Header>
       ...
      <MessageType xmlns="http://schemas.microsoft.com/integration/2011/system-properties">http://POAttr.org#PurchaseOrderAttr</MessageType> 
       ...
    </s:Header>
    
    Important중요
    식별자 드롭다운 목록에서 표준 헤더를 선택하면 이 필드를 사용할 수 없습니다. 사용자 지정 SOAP 헤더의 네임스페이스만 입력해야 합니다. 하지만, 필수 속성은 아닙니다.

    유형이 HTTP, FTP, SFTP 또는 조정됨으로 설정된 경우에도 이 필드는 회색으로 표시됩니다.

    식별자

    메시지 헤더 속성의 이름을 지정합니다. 이 속성의 값을 추출하여 이 대화 상자에 정의할 속성에 할당합니다. 위와 동일한 인용문을 가져오는 경우 식별자는 MessageType이 됩니다.

    여기서 사용자 지정 헤더를 지정할 수도 있습니다. FTP 및 SFTP의 경우 드롭다운에 표준 식별자가 나열됩니다. HTTP 메시지 유형의 경우 표준 헤더 목록이 크므로 드롭다운에 헤더가 나열되지 않습니다. 그런 경우에는 헤더 이름을 입력할 수 있습니다. SOAP, HTTP 및 조정됨 메시지 유형의 경우 값을 다른 속성에 할당할 사용자 지정 헤더를 나열할 수도 있습니다.

    이 방법을 명확하게 이해하려면 다음 예제를 살펴 보세요. SOAP 메시지 헤더가 다음과 같다고 가정합니다.

    <s:Header>
      ...  
      <PONumber xmlns="http://schemas.microsoft.com/integration/promotedpropertiesinfo">PO1234</PONumber> 
      ...  
    </s:Header>
    

    이 인용문에서 PONumber는 값이 PO1234인 사용자 지정 SOAP 헤더입니다. 따라서 식별자를 PONumber로 설정하는 경우 여기서 정의한 속성에 값 PO1234가 할당됩니다.

    속성(쓰기 대상)

    속성 이름

    정의하려는 속성의 이름을 지정합니다. 이 속성의 값은 이전에 지정한 메시지 헤더 속성에 추출된 값으로 설정됩니다.

    위와 동일한 예제를 계속 사용하기 위해 속성 이름을 P1로 설정하고, 식별자PONumber로 설정하는 경우 P1 값은 PO1234로 설정됩니다.

    데이터 형식

    속성에 대한 데이터 형식을 지정합니다. 드롭다운 목록에서 값을 선택할 수 있습니다.

  2. 속성 추가 대화 상자에서 확인을 클릭합니다. 그러면 대화 상자가 다음과 같이 표시됩니다.

    속성 정의

    이 화면 캡처에 표시된 설정에 따르면, 들어오는 메시지가 SOAP 헤더 이름이 PONumber이고 헤더 네임스페이스가 http://schemas.microsoft.com/integration/promotedpropertiesinfo인 SOAP 메시지이면 데이터 형식이 문자열P1이 만들어지고, 헤더 값이 이 속성에 할당됩니다.

  3. 속성 정의를 업데이트하거나 제거하려면 대화 상자에서 속성 정의를 선택한 다음 편집 또는 제거를 각각 클릭하면 됩니다. 속성 정의 대화 상자에서 확인을 클릭한 후 저장을 클릭하여 연결 구성에 변경 내용을 저장합니다.

  1. 속성 추가에서 다음을 수행합니다.

    note참고
    아래 표에는 메시지에 시스템 승격 속성 할당에 필요한 필드만 나와 있습니다. 또한 유형 드롭다운 목록에서 선택한 항목에 따라 필수 필드가 빨간색으로 윤곽선 처리되고 다른 필드는 회색으로 표시됩니다.

     

    섹션 필드 이름 설명

    원본(읽기 대상)

    Type

    시스템 승격 속성을 사용하려면 드롭다운 목록에서 시스템을 선택합니다.

    식별자

    시스템 승격 속성의 이름을 지정합니다. 이 속성의 값을 추출하여 이 대화 상자에 정의할 속성에 할당합니다.

    속성(쓰기 대상)

    속성 이름

    정의하려는 속성의 이름을 지정합니다. 이 속성의 값은 이전에 지정한 시스템 승격 속성에 추출된 값으로 설정됩니다.

    데이터 형식

    속성에 대한 데이터 형식을 지정합니다. 드롭다운 목록에서 값을 선택할 수 있습니다.

  1. 속성 추가에서 다음을 수행합니다.

    note참고
    아래 표에는 조회 작업에 필요한 필드만 나와 있습니다. 따라서 다음 단계는 유형 드롭다운 목록에서 조회를 선택한 경우에만 적용됩니다. 또한 유형 드롭다운 목록에서 선택한 항목에 따라 필수 필드가 빨간색으로 윤곽선 처리되고 다른 필드는 회색으로 표시됩니다.

    Important중요
    이 릴리스의 경우 Microsoft Azure SQL 데이터베이스 테이블에서만 조회할 수 있습니다.

     

    섹션 필드 이름 설명

    원본(읽기 대상)

    Type

    조회 작업을 위해서는 드롭다운 목록에서 조회를 선택합니다.

    식별자

    드롭다운 목록에서 이미 구성된 공급자를 선택합니다.

    공급자를 아직 구성하지 않은 경우에는 공급자를 구성합니다.

    1. 식별자 드롭다운 목록에서 새로 구성을 선택합니다.

    2. 그런 다음 공자 구성 대화 상자에서 다음 값을 지정합니다.

       

      필드 이름 설명

      공급자 이름

      공급자의 이름을 지정합니다.

      연결 문자열

      Microsoft Azure SQL 데이터베이스 표에 연결할 유효한 연결 문자열을 지정합니다.

      테이블 이름

      데이터 조회를 수행하려는 Microsoft Azure SQL 데이터베이스 테이블 이름을 지정합니다.

      쿼리 입력 열

      Microsoft Azure SQL 데이터베이스 테이블에서 데이터 조회를 수행하기 위해 입력 쿼리로 사용되는 값인 열 이름을 지정합니다.

      쿼리 출력 열

      Microsoft Azure SQL 데이터베이스 테이블에서 조회된 속성에 결과적으로 할당되는 출력의 값인 열 이름을 지정합니다.

    3. 확인을 클릭하여 공급자 구성을 추가합니다.

    조회 속성

    드롭다운 목록에서 이미 정의되어 있어야 하는 속성을 선택합니다. 이 속성의 값은 위의 공급자 구성에 지정된 쿼리 입력 열에 전달됩니다.

    속성(쓰기 대상)

    속성 이름

    조회된 값이 포함된 속성의 이름을 지정합니다. 이 속성의 값은 위의 공급자 구성에서 쿼리 출력 열의 값으로부터 파생됩니다.

    데이터 형식

    속성에 대한 데이터 형식을 지정합니다. 드롭다운 목록에서 값을 선택할 수 있습니다.

  2. 속성 추가 대화 상자에서 확인을 클릭합니다. 대화 상자는 다음과 같이 표시됩니다.

    정의 조회

    이 대화 상자에 표시된 설정에 따르면, 논리 흐름 방식은 다음과 같습니다(위와 동일한 구매 주문 예제를 사용하여 설명).

    • 연결는 MyProvider 공급자 구성에 정의된 표(TempTable)의 입력 쿼리 열(P_Order)에 있는 P1(PO1234) 값을 조회합니다.

    • 그런 다음 연결가 TempTable의 출력 쿼리 열(Cust_Name)에서 PO1234에 해당하는 값을 선택합니다.

    • 출력 쿼리 열에서 선택된 값이 속성 P2에 할당됩니다. 예를 들어 구매 주문 PO1234에 해당하는 고객 이름이 John이면 P2의 값은 John으로 설정됩니다.

    • 속성 P2의 데이터 형식이 문자열로 설정됩니다.

  3. 속성 정의를 업데이트하거나 제거하려면 대화 상자에서 속성 정의를 선택한 다음 편집 또는 제거를 각각 클릭하면 됩니다. 속성 정의 대화 상자에서 확인을 클릭한 후 저장을 클릭하여 연결 구성에 변경 내용을 저장합니다.

  1. 속성 추가에서 다음을 수행합니다.

    note참고
    아래 표에는 추출(xpath) 작업에 필요한 필드만 나와 있습니다. 또한 유형 드롭다운 목록에서 선택한 항목에 따라 필수 필드가 빨간색으로 윤곽선 처리되고 다른 필드는 회색으로 표시됩니다.

     

    섹션 필드 이름 설명

    원본(읽기 대상)

    Type

    드롭다운 목록에서 Xpath를 선택합니다.

    식별자

    메시지에서 요소 또는 특성을 추출할 xpath 쿼리를 지정합니다. 일반적인 xpath 쿼리는 다음과 같습니다.

    /*[local-name()='<root_node>' and namespace-uri()='<namespace>']/*[local-name()='<node_name>' and namespace-uri()=<namespace>']/*@[local-name()='<attribute_name>' and namespace-uri()='<namespace>']
    

    메시지 유형

    xpath 쿼리를 사용하여 요소 또는 특성 값을 추출해야 하는 메시지에 대한 메시지 유형을 지정합니다.

    드롭다운 목록에 BizTalk Services 프로젝트에 추가된 스키마가 모두 나열됩니다. 추출할 요소가 있는 스키마를 선택합니다.

    속성(쓰기 대상)

    속성 이름

    정의하려는 속성의 이름을 지정합니다. 이 속성의 값은 xpath 쿼리를 사용하여 메시지 본문에서 추출된 값으로 설정됩니다.

    데이터 형식

    속성에 대한 데이터 형식을 지정합니다. 드롭다운 목록에서 값을 선택할 수 있습니다.

  2. 속성 추가 대화 상자에서 확인을 클릭합니다. 대화 상자는 다음과 같이 표시됩니다.

    Xpath를 사용하는 추출

    이 대화 상자에 표시된 설정에 따르면, 메시지 유형(이 예제의 경우 PurchaseOrder)에서 연결는 제공된 xpath 쿼리에 따라 요소에서 값을 추출하여 P3 속성에 할당하고 P3 속성의 데이터 형식을 double로 설정합니다.

  3. 속성 정의를 업데이트하거나 제거하려면 대화 상자에서 속성 정의를 선택한 다음 편집 또는 제거를 각각 클릭하면 됩니다. 속성 정의 대화 상자에서 확인을 클릭한 후 저장을 클릭하여 연결 구성에 변경 내용을 저장합니다.

연결 구성 디자인 화면을 사용하는 디자인 타임 시 승격되는 속성과 속성에 할당되는 값을 정의할 수 있습니다. 하지만 속성 승격 및 값 할당은 메시지가 서비스 버스에 배포된 연결를 통해 흐르는 런타임 시 실제로 수행됩니다. 하지만 런타임 시 여러 가지 이유로 속성 승격이 실패하는 경우가 있을 수 있습니다. 아래 표에서 이러한 상황이 어떻게, 언제 발생할 수 있는지 확인하세요.

 

발생하는 상황 승격되는 속성

디자인 타임 시 지정한 SOAP 또는 HTTP 헤더가 런타임 시 연결로 보낸 실제 메시지에 없는 경우

디자인 타임 시 정의한 속성이 런타임 시 승격되지 않으며, 예외가 발생하지 않습니다.

디자인 타임 시 지정한 XPATH 쿼리가 런타임 시 연결로 보낸 메시지의 요소에 해당하지 않는 경우

디자인 타임 시 정의한 속성이 런타임 시 승격되지 않으며, 예외가 발생하지 않습니다.

조회의 경우, 디자인 타임 시 지정한 조회 속성이 런타임 시 없는 경우(전혀 승격되지 않았기 때문)

조회 결과로 값이 할당되었을 수 있는 속성이 승격되지 않으며, 예외가 발생하지 않습니다.

조회의 경우, 디자인 타임 시 지정한 공급자 구성(연결 문자열, 테이블 이름 등이 포함됨)이 잘못된 경우

런타임 시 예외가 발생하고, 속성이 승격되지 않습니다. 연결 구성 디자인 화면이 공급자 구성의 유효성 검사를 수행하지 않으므로 디자인 타임 시 예외가 발생하지 않습니다.

Important중요
디자인 타임 시에 사용자 자격 증명의 유효성만 검사하며, 유효성 검사가 성공하지 않으면 배포에 실패합니다.

조회의 경우, 디자인 타임 시 지정한 조회 속성 값이 런타임 시 공급자 데이터 원본(이 경우 Microsoft Azure SQL 데이터베이스 테이블)에서 일치하지 않는 경우

예외가 발생하지 않으면, 값이 승격되지 않습니다.

조회의 경우, 디자인 타임 시 지정한 조회 속성 값이 런타임 시 공급자 데이터 원본(이 경우 Microsoft Azure SQL 데이터베이스 테이블)에서 한 개 이상 일치하는 경우

속성이 승격되고, 데이터 원본에서 일치하는 값 중 하나만 승격된 속성에 값으로 할당됩니다.

SOAP, HTTP, XPATH 및 조회의 경우 디자인 타임 시 속성에 대해 지정한 데이터 형식이 런타임 시 속성이 갖는 값의 데이터 형식과 다른 경우

형식 변환이 가능하면 어디서든지 형식이 변환되고 속성이 승격됩니다. 예를 들어 런타임 시 속성을 문자열로 정의했지만 런타임 시 이 속성에 할당된 값이 30이면 이 속성 값은 “30”(문자열)이 됩니다.

형식 변환을 사용할 수 없는 경우 예외가 발생하며, 속성이 승격되지 않습니다. 예를 들어 디자인 타임 시 속성을 “double”로 정의했지만 런타임 시 이 속성에 할당된 값은 “John”입니다. “John”은 속성에 “double”로 저장할 수 없으므로 예외가 발생하고 속성이 승격되지 않습니다.

이 단계에서, 브리지에서 사용할 변환을 입력할 수 있습니다. 이 단계를 사용하거나 사용하지 않을 수도 있습니다.

  1. BizTalk Services 프로젝트에 변환을 추가합니다. 해당 단계는 Visual Studio 프로젝트 시작에 나와 있습니다. 이 단계를 반복하여 변환을 프로젝트에 필요한 수만큼 추가합니다.

  2. XML 단방향 연결를 두 번 클릭하여 일정 디자이너를 엽니다.

  3. 변환 단계를 선택합니다. 속성에서 IsEnabledTrue 또는 False로 설정합니다. True로 설정하는 경우 단계에서는 사용자가 입력하는 변환을 사용하여 들어오는 요청 메시지를 변환합니다. False로 설정하면 메시지가 변환되지 않게 되며 다음 단계로 전달만 됩니다.

    추가 정보:

  4. 변환 단계 내에서 XML 변환 작업을 선택합니다. 속성에서 속성의 줄임표 단추(...)를 선택하여 맵 선택을 엽니다.

  5. 표시되는 맵 목록에서 변환 단계와 연결할 맵을 선택하고 확인을 선택합니다. 이제 추가한 맵이 일정 디자이너의 선택한 맵 상자에 나열됩니다.

    Important중요
    이 대화 상자에는 원본 스키마가 이 항목의 요청 스키마 입력에 입력한 요청 메시지 스키마와 일치하는 맵만 표시됩니다.

    note참고
    변환 단계에서 IsEnabled 속성을 True로 설정했으나 맵을 XML 변환 작업의 일부로 지정하지 않으면 브리지를 구성하는 동안(디자인 타임) 그리고 메시지를 처리하는 동안(런타임) 연결에서 오류가 throw되지 않습니다.

    속성의 줄임표 단추(…)를 클릭하여 맵을 추가하거나 제거할 수 있습니다.

  6. 저장을 클릭합니다.

변환 단계 후의 보강 단계 구성은 변환 단계 전의 보강 단계 구성과 동일합니다. 이 항목의 보강 단계 및 해당 속성 구성을 참조하세요. 변환 후 보강 단계를 구성할 때 고려해야 하는 유일한 사항은 변환 전 보강 단계에서 정의한 속성이 변환 후 보강 단계에서도 사용 가능한지 여부입니다. 따라서 그러한 속성을 유지하려는 경우 같은 이름의 속성을 만들지 마세요. 같은 이름의 속성을 만들 경우 새 속성 정의가 기존 속성 정의를 덮어씁니다.

변환 후 보강 단계에서도 다음 두 속성을 제공합니다. On Enter InspectorOn Exit Inspector의 두 속성이 있습니다. 이러한 속성은 사용자 지정 코드를 브리지 처리의 일부로 포함하는 데 사용됩니다. See 연결에 사용자 지정 코드를 포함하는 방법.

이 단계에서 XML 메시지를 플랫 파일 메시지로 변환하는 데 사용할 플랫 파일 스키마를 입력할 수 있습니다. 메시지가 인코딩 단계에 도달하면 메시지는 이미 XML 형식이 되어 있습니다. 인코딩 단계가 구성된 방식에 따라 메시지는 플랫 파일 형식으로 인코딩되거나 XML 메시지로 전송됩니다.

  1. XML 단방향 연결를 두 번 클릭하여 일정 디자이너를 엽니다.

  2. 인코딩 단계를 선택합니다. 속성에서 IsEnabled 속성을 True 또는 False로 설정합니다. True인 경우 단계에는 XML 메시지를 플랫 파일 메시지로 인코딩하기 위해 입력한 플랫 파일 스키마가 사용됩니다. False인 경우 인코딩이 없으며 XML 메시지가 브리지에서 전송됩니다.

    추가 정보:

  3. 인코딩 단계 내에서 플랫 파일 인코딩 작업을 선택합니다. 속성에서 플랫 파일 스키마 속성에 대한 줄임표 단추(…)를 클릭하여 플랫 파일 스키마 선택 대화 상자를 엽니다.

  4. 대화 상자에 표시된 플랫 파일 스키마 목록에서 XML 메시지를 플랫 파일 메시지로 인코딩하는 데 사용할 스키마를 선택한 후 확인을 클릭합니다. 런타임에 XML 메시지가 플랫 파일 인코딩 작업에 도달하면 메시지 유형(Namespace#Root)이 작업 구성의 일부로 제공된 플랫 파일 스키마에 대해 매핑됩니다. 일치하는 항목이 있으면 해당 스키마가 XML 메시지를 플랫 파일 메시지로 변환하는 데 사용됩니다. 변환된 메시지의 HTTP 헤더는 “text/plain”으로 설정됩니다. 일치하는 항목이 없으면 처리된 XML이 인코딩 단계에서 그대로 전송됩니다.

    note참고
    IsEnabled 속성이 인코딩 단계에 대해 True로 설정된 경우 플랫 파일 스키마를 플랫 파일 인코딩 작업의 일부로 지정하지 않으면 브리지를 구성하는 동안(디자인 타임) 및 메시지를 처리하는 동안(런타임) 연결에서 오류가 throw되지 않습니다.

    플랫 파일 스키마 속성에 대한 줄임표 단추(…)를 클릭하여 스키마를 추가하거나 제거할 수 있습니다.

  5. 저장을 클릭합니다.

XML 단방향 연결가 구성되었습니다. 이제 연결를 LOB(기간 업무) 시스템에 연결하고 메시지를 라우팅하며 연결를 배포할 수 있습니다.

BizTalk Services 프로젝트에서 LOB 시스템에 연결

BizTalk Services 프로젝트의 연결에서 대상으로 메시지 라우팅

BizTalk 서비스 프로젝트 배포 및 새로 고침

참고 항목

표시: