다음을 통해 공유


사용된 웹 서비스의 URI를 동적으로 설정하는 방법

이용된 웹 서비스에 대해 웹 포트를 만들 때 동적 포트 바인딩을 선택할 수 있습니다. 동적 포트 바인딩을 선택할 경우 이용된 웹 서비스의 URI를 런타임에 설정해야 합니다. 선택한 URI는 웹 포트 유형을 만드는 데 사용한 웹 서비스와 동일한 웹 프록시를 갖는 웹 서비스를 호출해야 합니다.

참고

이 항목에서는 프로그래밍 방식으로 오케스트레이션에서 동적 SOAP 송신 포트 속성을 설정하는 방법을 설명합니다. 하지만 송신 포트가 정적이든 동적이든 관계없이 오케스트레이션이나 사용자 지정 파이프라인 구성 요소에서 이러한 속성을 설정할 수도 있습니다. 사용자 지정 파이프라인 구성 요소에 대한 자세한 내용은 사용자 지정 파이프라인 구성 요소 개발을 참조하세요.

웹 포트의 동적 포트 바인딩 동작은 비 웹 포트의 동적 포트 바인딩 동작과 다릅니다. 비 웹 포트에 대해 동적 바인딩을 선택할 경우에는 SOAP 어댑터를 사용할 수 없습니다.

동적 웹 포트를 사용하여 웹 서비스를 이용할 경우에는 송신 포트 속성이 기본값으로 설정됩니다. 이러한 값 중 일부는 내부적으로 설정되며 다른 값은 기본적으로 SOAP 어댑터 처리기 속성 페이지에 설정된 값으로 설정됩니다. 동적 송신 포트를 사용하는 경우에는 오케스트레이션에서 이러한 값을 덮어쓸 수 있습니다. 자세한 내용은 웹 서비스를 사용할 때 고려 사항을 참조하세요.

사용된 웹 서비스의 URI를 동적으로 변경

  1. 웹 포트를 추가하는 방법에 설명된 대로 웹 포트를 추가합니다. 그러나 다음 그림과 같이 지금 포트 바인딩 지정 을 선택하는 대신 동적 포트 바인딩을 선택합니다.

    포트 바인딩 화면을 보여 주는 이미지입니다.

  2. 사용된 웹 서비스를 호출하는 오케스트레이션에서 웹 포트에 연결한 보내기셰이프 앞에 식 셰이프를 추가합니다.

  3. 셰이프에서 다음과 유사한 식을 추가합니다.

    myWebPort(Microsoft.XLANGs.BaseTypes.Address) = "http://orders/myCompany.asmx";  
    

참고

들어오는 메시지, SQL 데이터베이스 또는 기간 업무(LOB) 응용 프로그램을 비롯한 다양한 위치에서 BizTalk 식 편집기에 사용되는 URI를 검색할 수 있습니다.

송신 포트 속성 동적 수정

  1. 메시지를 생성하는 데 사용하는 메시지 생성 셰이프에서 메시지 할당 셰이프가 아직 없는 경우 추가 합니다.

  2. 메시지 할당 셰이프에서 다음과 유사한 식을 추가합니다.

    myWebMessage(SOAP.UseSSO) = true;  
    

    SOAP 송신 포트의 모든 속성은 SOAP 네임스페이스를 사용합니다.

    다음 표에는 동적 웹 포트를 사용할 때 설정할 수 있는 SOAP 송신 포트 속성의 목록이 있습니다.

속성 이름 형식 Description
AuthenticationScheme String 웹 서비스 호출에 사용할 인증 방법입니다.

기본값: 익명

기타 허용 값: Basic, Digest, NTLM
사용자 이름 String 대상 웹 서비스에 액세스하기 위해 지정하는 사용자 이름

기본값: 공백
암호 String 서버 인증에 사용할 암호입니다.

기본값: 공백
ClientCertificate String 클라이언트 SSL(Secure Sockets Layer) 인증서의 손 도장(Thumbprint)

기본값: 공백
UseSSO 부울 이 웹 포트가 SSO(Single Sign-On)를 사용하는지 여부를 나타냅니다.

기본값: False
AffiliateApplicationName 문자열 클라이언트 자격 증명의 티켓을 교환할 때 이 웹 포트가 사용하는 SSO 응용 프로그램 이름

기본값: 공백
UseHandlerSetting 부울 이 웹 포트가 SOAP 송신 핸들러 HTTP 프록시 설정을 사용하는지 여부를 나타냅니다. 참고:UseProxy 컨텍스트 속성이 설정된 경우 UseHandlerSetting 컨텍스트 속성은 무시됩니다.

기본값: False
UseProxy 부울 이 웹 포트가 프록시 서버를 사용하여 대상 웹 서비스에 액세스하는지 여부를 나타냅니다. 참고:UseProxy 컨텍스트 속성이 설정된 경우 UseHandlerSetting 컨텍스트 속성은 무시됩니다.

기본값: False
ProxyAddress String 웹 서비스 호출에 사용할 HTTP 프록시의 주소

기본값: SOAP 송신 처리기 속성에서 검색됩니다.
ProxyPort 정수 웹 서비스 호출에 사용할 HTTP 프록시의 포트

기본값: SOAP 송신 처리기 속성에서 검색됩니다.
ProxyUsername 문자열 HTTP 프록시에 사용할 사용자 이름

기본값: SOAP 송신 처리기 속성에서 검색됩니다.
ProxyPassword String HTTP 프록시에 사용할 암호

기본값: SOAP 송신 처리기 속성에서 검색됩니다.
ClientConnectionTimeout Int32 HTTP 클라이언트 연결의 시간 제한 값

기본값: 기본 ASP.NET HTTP 연결 제한 시간과 동일합니다.
TypeName String 호출할 웹 메서드가 들어 있는 클래스의 이름을 지정합니다.

기본값: 공백
MethodName 문자열 호출할 클래스의 메서드를 지정합니다. 참고: 프로그래밍 방식으로 정적 SOAP 송신 포트에 대해 MethodName 속성을 구성하려면 BizTalk Server 관리 콘솔의 SOAP 전송 속성 대화 상자의 웹 서비스 탭에서 메서드 이름을[나중에 지정]으로 설정해야 합니다. SOAP 전송 속성 대화 상자에 대한 자세한 내용은 UI 지침 및 개발자 API 네임스페이스 참조SOAP 전송 속성 대화 상자, 웹 서비스 탭을 참조하세요.

기본값: 공백
Assemblyname 문자열 로드 및 실행할 .NET 유형과 어셈블리를 식별합니다.

기본값: 공백
UnknownHeaders 문자열 알 수 없는 SOAP 헤더의 serialize된 목록을 지정합니다.

기본값: 공백
Userdefined 문자열 사용자 정의 클래스를 정의합니다.

기본값: 공백
UseSoap12 부울 SOAP 1.2 프로토콜을 지원하는 프록시 코드를 생성하도록 지정합니다. 이 속성이 False이면 SOAP 1.1 규격 프록시 코드가 생성됩니다.

기본값: False

참고

ClientConnectionTimeout 설정을 제외하고 이러한 값은 동적 포트 바인딩을 사용할 때만 동적으로 설정할 수 있습니다. 지금 지정 포트 바인딩을 사용하는 경우 읽기 전용입니다. 지금 지정동적 포트 바인딩을 모두 사용하여 ClientConnectionTimeout 설정을 설정할 수 있습니다.

참고 항목

사용된 웹 서비스가 포함된 SOAP 헤더
웹 포트 만들기