BizTalk 웹 서비스 게시 마법사를 사용하여 오케스트레이션을 웹 서비스로 게시하는 방법
BizTalk 웹 서비스 게시 마법사를 사용하여 오케스트레이션을 웹 서비스로 게시할 수 있습니다.
참고
BizTalk 웹 서비스 게시 마법사를 실행하려면 먼저 BizTalk 프로젝트를 빌드해야 합니다.
참고
명령줄 도구 BTSWebSvcPub.exe를 사용하여 오케스트레이션을 웹 서비스로 게시할 수 있습니다. 자세한 내용은 BTSWebSvcPub Command-Line 참조를 참조하세요.
오케스트레이션을 웹 서비스로 게시하려면
시작을 클릭하고 모든 프로그램을 가리킨 다음 Microsoft BizTalk Server 가리킨 다음 BizTalk Web Services 게시 마법사를 클릭합니다.
BizTalk Web Services 게시 마법사 시작 페이지에서 다음을 클릭합니다.
웹 서비스 만들기 페이지에서 BizTalk 오케스트레이션을 웹 서비스로 게시를 선택하고 다음을 클릭합니다.
BizTalk 어셈블리 페이지의 BizTalk 어셈블리 파일(*.dll) 텍스트 상자에 BizTalk 어셈블리 파일의 이름을 입력하거나 찾아보기를 클릭하여 게시할 오케스트레이션이 포함된 어셈블리를 찾은 다음 다음을 클릭합니다.
참고
BizTalk 어셈블리 파일을 선택하기 전에 모든 종속 어셈블리를 BizTalk 어셈블리와 동일한 폴더에 복사하거나 종속 어셈블리를 GAC(전역 어셈블리 캐시)에 설치합니다.
참고
BizTalk 어셈블리 파일을 GAC에 설치한 경우 GAC의 어셈블리가 BizTalk 어셈블리 대화 상자에서 선택할 어셈블리로 업데이트되었는지 확인합니다. GAC에 동일한 정규화된 이름이 있을 경우 BizTalk 웹 서비스 게시 마법사는 선택한 어셈블리 파일 대신 GAC에 있는 어셈블리을 사용합니다.
참고
오케스트레이션이 포함된 Visual Studio에서 BizTalk 웹 서비스 게시 마법사를 여는 경우 BizTalk 어셈블리 파일은 오케스트레이션이 포함된 어셈블리로 채워집니다.
참고
경로 길이가 260자보다 길면 경로가 너무 길다는 오류 메시지가 표시될 수 있습니다.
오케스트레이션 및 포트 페이지에서 더하기 기호를 클릭하여 각 어셈블리 및 오케스트레이션에 대한 트리 노드를 확장합니다. 해당 트리 노드 확인란을 선택하여 게시할 오케스트레이션 및 포트를 선택합니다. 각 수신 포트에 대해 하나의 웹 서비스가 아닌 선택한 모든 수신 포트에 대해 하나의 웹 서비스(.asmx)를 만들려면 선택한 모든 포트를 단일 웹 서비스로 병합 옵션을 선택하고 다음을 클릭합니다.
참고
선택된 모든 포트를 하나의 웹 서비스에 병합하면 선택된 모든 포트의 유형이 동일해지고 포트의 작업 이름이 고유해집니다.
웹 서비스 속성 페이지의 웹 서비스 상자의 대상 네임스페이스에 웹 서비스의 대상 네임스페이스를 입력하고 적절한 상자를 선택하여 마법사가 SOAP 헤더를 처리하는 방법을 지정하고 웹 서비스에 대한 2007 SSO(단일 Sign-On) 지원을 SharePoint Portal Server. 웹 서비스 구현을 추가로 사용자 지정하려면 고급 단추를 클릭합니다. 사용 가능한 추가 옵션이 표시됩니다.
옵션 값 Description SOAP 매개 변수 스타일 기본값 이 옵션은 SOAP 메시지에서 매개 변수 형식이 지정되는 방식을 지정합니다. 자세한 내용은 의 SoapParameterStyle 열거형을 https://go.microsoft.com/fwlink/?LinkId=62259참조하세요. SOAP 매개 변수 스타일 Bare 이 옵션은 SOAP 메시지에서 매개 변수 형식이 지정되는 방식을 지정합니다. 자세한 내용은 의 SoapParameterStyle 열거형을 https://go.microsoft.com/fwlink/?LinkId=62259참조하세요. SOAP 매개 변수 스타일 Wrapped 이 옵션은 SOAP 메시지에서 매개 변수 형식이 지정되는 방식을 지정합니다. 자세한 내용은 의 SoapParameterStyle 열거형을 https://go.microsoft.com/fwlink/?LinkId=62259참조하세요. 규칙 요구 없음 이 옵션은 바인딩 규칙이 요구하는 WSI(웹 서비스 상호 운용성) 사양을 지정합니다. 자세한 내용은 의 WebServiceBindingAttribute.ConformsTo 속성을 https://go.microsoft.com/fwlink/?LinkId=193064참조하세요. 규칙 요구 WS-I Basic Profile 1.1 이 옵션은 바인딩 규칙이 요구하는 WSI(웹 서비스 상호 운용성) 사양을 지정합니다. 자세한 내용은 의 WebServiceBindingAttribute.ConformsTo 속성을 https://go.microsoft.com/fwlink/?LinkId=193064참조하세요. 요청 응답 강제 적용 [기본값] 이 옵션은 단방향 BizTalk 작업을 요청-응답 웹 메서드로 노출할지 여부를 지정합니다. 기본값을 선택하면 단방향 플래그가 강제 적용되지 않습니다. 요청 응답 강제 적용 No 이 옵션은 단방향 BizTalk 작업을 요청-응답 웹 메서드로 노출할지 여부를 지정합니다. 기본값을 선택하면 단방향 플래그가 강제 적용되지 않습니다. 요청 응답 강제 적용 Yes 이 옵션은 단방향 BizTalk 작업을 요청-응답 웹 메서드로 노출할지 여부를 지정합니다. 기본값을 선택하면 단방향 플래그가 강제 적용되지 않습니다. 웹 서비스 속성 페이지에서 다음을 클릭합니다.
참고
선택한 SOAP 헤더 옵션은 이 마법사 인스턴스를 실행할 때 만들어지는 모든 웹 서비스 및 웹 메서드에 전역적으로 적용됩니다.
SOAP 헤더 추가 옵션을 선택한 경우 SOAP 헤더 요청 및 응답 SOAP 헤더 페이지가 나타납니다. 다음 대화 상자의 추가 및 제거 단추를 사용하여 요청 및 응답 SOAP 헤더를 추가 및 제거할 수 있습니다.
SOAP 헤더를 추가하려면 추가를 클릭합니다. BizTalk 어셈블리 파일(*.dll) 텍스트 상자에 SOAP 헤더 스키마가 포함된 어셈블리를 입력하거나 찾습니다. 사용 가능한 스키마 유형 목록 보기에는 스키마의 각 루트 요소가 표시됩니다. 요청 또는 응답 SOAP 헤더로 추가할 루트 노드를 선택합니다. 여러 항목을 선택하려면 Ctrl 키를 누른 채 확인을 클릭합니다.
목록에서 SOAP 헤더를 제거하려면 추가된 SOAP 헤더 목록에서 SOAP 헤더를 선택한 다음 제거를 클릭합니다.
마법사를 계속하려면 각 SOAP 헤더 페이지에서 다음을 클릭합니다.
참고
대상 네임스페이스와 루트 요소 이름이 SOAP 헤더를 정의합니다.
참고
대상 네임스페이스/루트 요소 이름의 동일한 조합을 요청 및 응답 SOAP 헤더로 추가하면 in/out 헤더로 처리되지 않습니다. 오케스트레이션 내에서 들어오는 헤더를 나가는 헤더에 수동으로 복사해야 합니다.
참고
대상 네임스페이스/루트 요소 이름의 동일한 조합은 요청 SOAP 헤더로 한 번만 추가하고 응답 SOAP 헤더로 한 번만 추가할 수 있습니다.
웹 서비스 프로젝트 페이지의 프로젝트 이름 텍스트 상자에 프로젝트의 이름을 입력합니다. 기본 위치()
http://localhost/<project_name>를 적용하거나 프로젝트 위치 텍스트 상자에 프로젝트의 위치를 입력하거나 찾아보기를 클릭하고 웹 디렉터리를 선택할 수 있습니다. 다음 옵션 중 하나를 선택합니다.기존 프로젝트를 덮어씁니다. 이 옵션은 프로젝트 위치가 이미 있는 경우에만 사용할 수 있습니다. 이 옵션을 선택하면 동일한 위치에만 게시할 수 있습니다. 그렇지 않으면 다른 프로젝트 위치를 입력해야 합니다.
웹 서비스에 익명 액세스를 허용합니다. 이 옵션은 생성된 가상 디렉터리에 대한 익명 액세스를 추가합니다. 기본적으로 가상 디렉터리는 부모 가상 디렉터리나 웹 사이트(최상위 가상 디렉터리인 경우)로부터 액세스 권한을 상속받습니다.
BizTalk 수신 위치를 만듭니다. 이 옵션은 생성된 각 .asmx 파일에 해당하는 SOAP 어댑터 수신 포트 및 위치를 자동으로 만듭니다. 수신 위치가 이미 있는 경우 대체되지 않습니다. SOAP 어댑터의 수신 위치는 /<virtual directory name>/<orchestration namespace_typename_portname.asmx >형식을 사용하여 확인됩니다. 이 옵션을 선택한 경우 수신 포트와 위치가 생성될 응용 프로그램을 선택합니다.
참고
프로젝트 위치가 다른 서버에 있을 수 있습니다. 웹 서비스를 다른 서버에 게시하려면 프로젝트 이름을 로
http://<servername>/<project_name>입력합니다.참고
프로젝트 위치가 기본 웹 사이트가 아닌 웹 사이트에 있을 수 있습니다. 기본 웹 사이트가 아닌 웹 사이트에 게시할 경우 URL에 웹 사이트의 포트 번호를 포함합니다. 예:
http://localhost:8080/<project_name>.참고
마법사를 사용하여 수신 위치를 만들 때는 기본값이 사용됩니다. 수신 파이프라인의 기본값은 Microsoft.BizTalk.DefaultPipelines.PassThruReceive 파이프라인입니다. 게시된 웹 서비스를 통해 받은 메시지에 특수 파이프라인 처리(예: 유효성 검사, 상관 관계/속성 승격 또는 인바운드/아웃바운드 맵)가 필요한 경우 수신 파이프라인을 Microsoft.BizTalk.DefaultPipelines.XMLReceive 또는 사용자 지정 파이프라인으로 설정해야 합니다.
참고
오케스트레이션에서 웹 서비스를 사용(호출)할 때 SOAP 어댑터는 통과 스타일 송신 파이프라인만 지원합니다. 사용자 지정 송신 파이프라인을 사용할 수는 있지만 이 파이프라인은 메시지의 본문을 수정하는 구성 요소를 포함할 수 없습니다. 이러한 구성 요소에는 XML 어셈블러와 모든 인코딩 구성 요소가 포함됩니다.
참고
이 페이지에 도달하고 웹 서비스로 스키마 게시 옵션을 선택하지 않도록 선택하면 웹 서비스 페이지에서 BizTalk 오케스트레이션을 웹 서비스로 게시 옵션에서 다시 시작하기 전에 이전에 선택한 BizTalk 어셈블리의 서비스 및 메서드 이름이 웹 서비스 설명에 표시되는 것을 볼 수 있습니다. 이는 게시 메서드를 변경할 때 메모리 내 웹 서비스 기술을 지우지 않았기 때문입니다.
다음을 클릭하여 ASP.NET 웹 서비스 프로젝트에 대한 설정을 검토합니다.
만들기를 클릭하여 ASP.NET 웹 서비스를 만듭니다.
마침을 클릭하여 BizTalk Web Services 게시 마법사를 완료합니다.
참고
Windows Vista에서 오케스트레이션을 웹 서비스로 게시하는 경우에는 서비스를 호스팅하는 가상 디렉터리를 업데이트해야 합니다. 이렇게 하려면 명령 프롬프트에서 다음 명령을 실행하여 vdir을 가상 디렉터리의 이름으로 바꿉<니다. %systemroot%\system32\inetsrv\APPCMD.EXE 구성 "기본 웹 사이트/<vdir 이름>"을 마이그레이션합니다.>