BizTalk에서 스키마를 웹 서비스로 게시
BizTalk 웹 서비스 게시 마법사를 사용하여 스키마를 웹 서비스로 게시합니다.
웹 서비스로 스키마 게시
프로그램에서BizTalk Server 선택한 다음 BizTalk Web Services 게시 마법사를 선택합니다.
중요
BizTalk 웹 서비스 게시 마법사를 실행하기 전에 BizTalk 프로젝트를 빌드해야 합니다.
Welcome 페이지에서 다음을 클릭합니다.
웹 서비스 만들기 페이지에서 웹 서비스로 스키마 게시를 선택하고 다음을 클릭합니다.
웹 서비스 페이지에서 게시할 웹 서비스를 정의합니다. 웹 서비스 설명 대화 상자의 트리를 사용하여 웹 서비스 설명 노드를 추가, 제거, 이름 바꾸기 및 편집할 수 있습니다. 정보 대화 상자는 선택한 노드에 대한 정보를 제공하고 현재 노드 또는 하위 노드에 오류를 표시합니다.
트리의 루트 노드(웹 서비스 기술)에서는 웹 서비스 프로젝트 이름을 기술합니다. 가상 디렉터리 이름은 루트 노드를 기본 이름으로 사용합니다. 웹 서비스 설명 이름 바꾸기를 선택하여 웹 서비스 설명을 수정할 수 있습니다.
새 웹 서비스를 추가하려면 웹 서비스 설명 노드를 마우스 오른쪽 단추로 클릭한 다음 웹 서비스 추가를 클릭합니다. 이렇게 하면 웹 메서드 없이 새 웹 서비스가 만들어집니다. 웹 서비스의 이름을 수정하려면 웹 서비스 노드를 마우스 오른쪽 단추로 클릭하고 웹 서비스 이름을 선택한 다음 Enter 키를 눌러 새 이름을 적용합니다.
새 웹 메서드를 추가하려면 웹 서비스 노드를 마우스 오른쪽 단추로 클릭하고 웹 메서드 추가를 가리킨 다음 바로 가기 메뉴에서 단방향 (요청 웹 메서드의 경우) 또는 요청-응답 (요청-응답 웹 메서드의 경우)을 클릭합니다.
요청 및 응답 스키마 유형을 설정하려면 요청 또는 응답 노드를 마우스 오른쪽 단추 로 클릭한 다음 스키마 유형 선택을 클릭합니다. 메시지 형식 요청 대화 상자에서 BizTalk 어셈블리 파일 텍스트 상자에 문서 스키마가 포함된 어셈블리의 이름을 입력하거나 찾아보기를 클릭하여 어셈블리를 검색합니다. 사용 가능한 스키마 유형 목록 보기에는 스키마의 각 루트 요소가 표시됩니다. 요청 또는 응답 스키마 유형으로 추가할 루트 노드를 선택합니다.
참고
BizTalk 어셈블리 파일을 GAC(전역 어셈블리 캐시)에 설치한 경우 GAC의 어셈블리가 메시지 유형 요청 대화 상자에서 선택할 어셈블리로 업데이트되었는지 확인합니다. GAC에 동일한 정규화된 이름이 있을 경우 BizTalk 웹 서비스 게시 마법사는 선택한 어셈블리 파일 대신 GAC에 있는 어셈블리을 사용합니다.
생성된 코드에 영향을 주지 않고 요청 및 응답 노드의 이름을 바꿀 수 있습니다. 스키마를 정의한 후 웹 메서드 매개 변수 이름을 수정하는 파트 요소의 이름을 바꿀 수 있습니다. 생성된 웹 서비스 코드를 보면 변경 내용을 확인할 수 있습니다.
참고
웹 서비스 기술 노드의 이름을 바꿀 때는 공백을 사용할 수 없습니다.
다음을 클릭하여 마법사를 계속합니다.
웹 서비스 속성 페이지의 웹 서비스의 대상 네임스페이스 대화 상자에서 웹 서비스에 대한 대상 네임스페이스를 입력하고 적절한 상자를 선택하여 마법사가 SOAP 헤더 및 웹 서비스에 대한 단일 Sign-On 지원을 처리하는 방법을 지정합니다. 웹 서비스 구현을 추가로 사용자 지정하려면 고급 단추를 클릭합니다. 사용 가능한 추가 옵션이 표시됩니다.
옵션 값 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 작업을 요청-응답 웹 메서드로 노출할지 여부를 지정합니다. 기본값은 단방향 플래그를 강제 적용하지 않습니다. 참고
SOAP 헤더 옵션 선택은 이 마법사 인스턴스를 실행할 때 만들어진 모든 웹 서비스와 웹 메서드에 전체적으로 적용됩니다.
웹 서비스 속성 페이지에서 다음을 클릭합니다.
SOAP 헤더 추가를 선택한 경우 SOAP 헤더 요청 및 응답 SOAP 헤더 페이지가 나타납니다. 다음 대화 상자의 추가 및 제거 단추를 사용하여 요청 및 응답 SOAP 헤더를 추가 및 제거할 수 있습니다.
SOAP 헤더를 추가하려면 추가를 클릭합니다. BizTalk 어셈블리 이름(*.dll) 텍스트 상자에 어셈블리 이름을 입력하거나 BizTalk 어셈블리 파일 텍스트 상자에 SOAP 헤더 스키마가 포함된 어셈블리를 찾습니다. 사용 가능한 스키마 유형 목록 보기에는 스키마의 각 루트 요소가 표시됩니다. 요청 또는 응답 SOAP 헤더로 추가할 루트 노드를 선택합니다. 여러 항목을 선택하려면 Ctrl 키를 누른 채 확인을 클릭합니다.
목록에서 SOAP 헤더를 제거하려면 추가된 SOAP 헤더 목록에서 SOAP 헤더를 선택한 다음 제거를 클릭합니다.
마법사를 계속하려면 각 SOAP 헤더 페이지에서 다음 을 클릭합니다.
참고
대상 네임스페이스와 루트 요소 이름이 SOAP 헤더를 정의합니다.
참고
대상 네임스페이스/루트 요소 이름의 동일한 조합을 요청 및 응답 SOAP 헤더로 추가하면 in/out 헤더로 처리되지 않습니다. 오케스트레이션 내에서 들어오는 헤더를 나가는 헤더에 수동으로 복사해야 합니다.
참고
대상 네임스페이스/루트 요소 이름의 동일한 조합은 요청 SOAP 헤더로 한 번만 추가하고 응답 SOAP 헤더로 한 번만 추가할 수 있습니다.
웹 서비스 프로젝트 페이지의 프로젝트 위치 텍스트 상자에 프로젝트 위치를 입력합니다. 기본 위치()
http://localhost/your_project_name를 수락하거나, 프로젝트의 위치를 입력하거나, 찾아보기를 클릭하고 웹 디렉터리를 선택할 수 있습니다. 다음 옵션 중 하나를 선택합니다.기존 프로젝트를 덮어씁니다. 이 옵션은 프로젝트 위치가 이미 있는 경우에만 사용할 수 있습니다. 이 옵션을 선택하면 동일한 위치에만 게시할 수 있습니다. 그렇지 않으면 다른 프로젝트 위치를 입력해야 합니다.
웹 서비스에 익명 액세스를 허용합니다. 이 옵션은 생성된 가상 디렉터리에 대한 익명 액세스를 추가합니다. 기본적으로 가상 디렉터리는 부모 가상 디렉터리나 웹 사이트(최상위 가상 디렉터리인 경우)로부터 액세스 권한을 상속받습니다.
BizTalk 수신 위치를 만듭니다. 이 옵션은 생성된 각 .asmx 파일에 해당하는 SOAP 어댑터 수신 포트 및 위치를 자동으로 만듭니다. 다른 수신 위치가 이미 있는 경우 수신 위치가 바뀌지 않습니다. SOAP 어댑터의 수신 위치는 "/가상 디렉터리 이름>/<<오케스트레이션 namespace_typename_portname.asmx>" 형식을 사용하여 확인됩니다. 이 옵션을 선택한 경우 수신 포트와 위치가 생성될 응용 프로그램을 선택합니다.
참고
프로젝트 위치가 다른 서버에 있을 수 있습니다. 웹 서비스를 다른 서버에 게시하려면 프로젝트 이름을 로
http://<servername>/<project_name>입력합니다.참고
프로젝트 위치가 기본 웹 사이트가 아닌 웹 사이트에 있을 수 있습니다. 기본이 아닌 웹 사이트에 게시할 때 URL
http://localhost:8080/<project_name>에 웹 사이트의 포트 번호를 포함합니다.참고
마법사를 사용하여 수신 위치를 만드는 경우 마법사는 많은 기본값을 사용하여 수신 위치를 만듭니다. 수신 및 송신 파이프라인의 기본값은 Microsoft.BizTalk.DefaultPipelines.PassThruReceive 및 Microsoft.BizTalk.DefaultPipelines.PassThruTransmit입니다. 게시된 웹 서비스를 통해 받은 메시지에 특수 파이프라인 처리(예: 유효성 검사, 상관 관계 또는 인바운드/아웃바운드 맵)가 필요한 경우 송신 및 수신 파이프라인을 Microsoft.BizTalk.DefaultPipelines.XMLReceive, Microsoft.BizTalk.DefaultPipelines.XMLSend 또는 사용자 지정 파이프라인으로 설정해야 합니다.
다음을 클릭하여 ASP.NET 웹 서비스 프로젝트에 대한 설정을 검토합니다.
만들기를 클릭하여 ASP.NET 웹 서비스를 만듭니다.
마침을 클릭하여 BizTalk Web Services 게시 마법사를 완료합니다.