웹 서비스에 오케스트레이션을 매핑하는 방법
하나의 오케스트레이션이 여러 수신 포트를 포함할 수 있습니다. BizTalk 웹 서비스 게시 마법사를 사용하면 수신 포트를 선택하여 웹 서비스로 게시할 수 있습니다. 마법사는 수신 포트당 하나의 웹 서비스(.asmx 파일)를 만듭니다. 또한 마법사에서는 수신 포트 유형(단방향 또는 요청/응답)이 같은 경우 모든 수신 포트에 대해 하나의 웹 서비스를 만들 수도 있습니다. 이 경우 작업은 함수 호출이 되고 수신 포트의 각 작업은 웹 메서드가 됩니다. 그리고 요청 작업은 입력 매개 변수가 되고 응답 작업은 반환 유형이 됩니다.
요청 및 응답 작업이 동일한 웹 메시지 형식인 경우 입력 매개 변수는 ref 가 되고 반환 형식은 void입니다. ASP.NET 웹 클라이언트는 같은 유형의 입력 및 출력 매개 변수를 조합하여 웹 메서드 서명을 변경할 수 있습니다. 예를 들어 ASP.NET 웹 클라이언트는 BizTalk Web 메서드를 문자열 myService(문자열 파트) 에서 void myService(ref string part)로 변경할 수 있습니다.
작업 메시지 유형은 웹 메서드 서명을 정의합니다. 각 메시지 유형 파트는 웹 메서드의 매개 변수입니다.
메시지 유형 파트 이름 및 대상 네임스페이스
XmlRootAttribute가 지정된 문서 스키마 및 사용자 정의 클래스는 대상 네임스페이스를 정의한 메시지 유형 부분입니다. EDI 스키마, XmlRootAttribute 가 지정되지 않은 사용자 정의 클래스 및 System.String 과 같은 기본 제공 형식은 정의된 대상 네임스페이스가 없는 메시지 형식 부분입니다.
메시지 유형 파트 이름의 종류 | 사용되는 매개 변수 이름 |
---|---|
정의된 대상 네임스페이스 있음 | 루트 요소 이름 |
정의된 대상 네임스페이스 없음 | 메시지 유형 파트 이름 |
참고
응답 메시지에 다중 파트 메시지 유형이 사용되는 경우 BizTalk 웹 서비스 게시 마법사는 반환 값에 대해 첫 번째 메시지 파트를 사용하며 나머지 메시지 파트는 출력 매개 변수로 사용됩니다.
여러 작업이 포함된 오케스트레이션
오케스트레이션에 여러 작업이 포함된 경우에는 여러 수신 포트가 아닌 단일 수신 포트를 포함하도록 오케스트레이션을 디자인해야 합니다. 이 디자인은 BizTalk 웹 서비스 게시 마법사가 여러 웹 서비스(.asmx) 파일을 만들지 않도록 하며, 모든 작업의 호출 패턴이 동일할 때(모두 단방향 작업이거나 모두 요청-응답 작업일 때)만 작동합니다. 단일 수신 포트가 단방향 작업과 요청/응답 작업을 모두 포함할 수는 없습니다.
참고
BizTalk 웹 서비스 게시 마법사에는 공용 수신 포트가 표시됩니다. 공용 수신 포트는 공용 유형 한정자가 포함된 포트 유형입니다. 공용 포트만 웹 서비스로 게시할 수 있습니다. 기본 포트 유형은 내부입니다.
참고
수신 포트가 단방향으로 정의된 경우 웹 메서드 응답 형식은 void 이며 웹 클라이언트에 정보가 반환되지 않습니다. SOAP 어댑터 또는 오케스트레이션에서 throw한 예외는 웹 클라이언트로 반환되지 않습니다.
게시된 오케스트레이션에 대한 웹 서비스 명명 규칙
BizTalk Web Services 게시 마법사는 오케스트레이션 네임스페이스를 기반으로 웹 서비스(.asmx) 파일 이름을 생성한 다음, 밑줄() 뒤에 형식 이름, 밑줄(\) 뒤에 수신 포트의 이름을 잇습니다. 밑줄(_)은 마침표가 포함된 모든 파트 대신 표시됩니다. 웹 서비스 이름에는 항상 포트 이름이 추가됩니다.
다음 표는 BizTalk 웹 서비스 게시 마법사에서 웹 서비스 이름을 생성하는 방법을 보여 줍니다.
웹 포트가 포함된 오케스트레이션 | 생성되는 웹 서비스 이름 |
---|---|
단일 웹 포트가 포함된 단일 오케스트레이션 | orchestration1_port1.asmx |
두 개의 웹 포트가 포함된 단일 오케스트레이션 | orchestration1_port1.asmx 및 orchestration1_port2.asmx |
각각 단일 웹 포트가 포함된 두 오케스트레이션 | orchestration1_port1.asmx 및 orchestration2_port2.asmx |
참고 항목
웹 서비스로 오케스트레이션 게시
BizTalk 웹 서비스 게시 마법사를 사용하여 오케스트레이션을 웹 서비스로 게시하는 방법