Come eseguire il mapping delle orchestrazioni ai servizi Web

Un'orchestrazione può avere più porte di ricezione. Mediante la Pubblicazione guidata servizi Web BizTalk è possibile selezionare le porte di ricezione da pubblicare come servizi Web. La procedura guidata consente di creare un servizio Web (file asmx) per ciascuna porta di ricezione. È inoltre possibile creare un unico servizio Web se tutte le porte di ricezione sono dello stesso tipo (unidirezionale o richiesta-risposta). Le operazioni diventano chiamate di funzione. Ogni operazione nella porta di ricezione diventa un metodo Web. Le operazioni di richiesta diventano parametri di input e le operazioni di risposta tipi restituiti.

Se le operazioni di richiesta e risposta sono lo stesso tipo di messaggio Web, il parametro di input diventa un riferimento e il tipo restituito è void. I client Web ASP.NET possono modificare la firma del metodo Web combinando i parametri di input e output dello stesso tipo. Ad esempio, un client Web ASP.NET può modificare un metodo Web BizTalk da string myService(string part) a void myService(ref string part).

I tipi di messaggio delle operazioni definiscono le firme del metodo Web. Ogni parte del tipo di messaggio è un parametro del metodo Web.

Nomi delle parti del tipo di messaggio e spazi dei nomi di destinazione

Gli schemi dei documenti e le classi definite dall'utente con XmlRootAttribute specificati sono parti del tipo di messaggio che hanno definito spazi dei nomi di destinazione. Schemi EDI, classi definite dall'utente senza XmlRootAttribute specificati e tipi predefiniti, ad esempio System.String sono parti del tipo di messaggio senza spazi dei nomi di destinazione definiti.

Nome della parte del tipo di messaggio	Nome di parametro utilizzato
Con spazio dei nomi di destinazione definito	Nome dell'elemento principale
Senza spazio dei nomi di destinazione definito	Nome della parte del tipo di messaggio

Nota

Se per il messaggio di risposta viene utilizzato un tipo di messaggio multiparte, la Pubblicazione guidata servizi Web BizTalk utilizza la prima parte del messaggio per il valore restituito, mentre le altre parti vengono utilizzate come parametri di output.

Orchestrazioni con più operazioni

Per un'orchestrazione che prevede più operazioni è necessario progettare un'unica porta di ricezione anziché più porte di ricezione. Questo tipo di progettazione impedisce alla Pubblicazione guidata servizi Web BizTalk di creare più servizi Web (file asmx) e funziona solo quando tutte le operazioni presentano lo stesso modello di chiamata, ovvero sono tutte unidirezionali o tutte di tipo richiesta-risposta. Una singola porta di ricezione non può gestire sia operazioni unidirezionali sia operazioni di richiesta-risposta.

Nota

La Pubblicazione guidata servizi Web BizTalk consente di visualizzare porte di ricezione pubbliche, ovvero porte con un modificatore di tipo pubblico. Come servizio Web è possibile pubblicare solo porte pubbliche. Il tipo di porta predefinito è interno.

Nota

Se la porta di ricezione è definita come unidirezionale, il tipo di risposta del metodo Web è void e non vengono restituite informazioni al client Web. Le eccezioni generate dall'adapter SOAP o da un'orchestrazione non vengono restituite al client Web.

Convenzioni di denominazione dei servizi Web per le orchestrazioni pubblicate

La Pubblicazione guidata servizi Web BizTalk genera nomi di file del servizio Web (con estensione asmx) in base allo spazio dei nomi orchestrazioni, seguito da un carattere di sottolineatura (), seguito da un nome di sottolineatura (\) e seguito dal nome della porta di ricezione. Un carattere di sottolineatura (_) sostituisce le eventuali parti contenenti punti. Il nome del servizio Web è sempre seguito dal nome della porta.

Nella seguente tabella è illustrato come vengono generati i nomi dei servizi Web dalla Pubblicazione guidata servizi Web BizTalk.

Orchestrazioni con porte Web	Nome del servizio Web generato
Un'orchestrazione con una porta Web	orchestration1_port1.asmx
Un'orchestrazione con due porte Web	orchestration1_port1.asmx e orchestration1_port2.asmx
Due orchestrazioni con una porta Web ciascuna	orchestration1_port1.asmx e orchestration2_port2.asmx

Vedere anche

Pubblicazione di un'orchestrazione come servizio Web
Come usare la Pubblicazione guidata servizi Web BizTalk per pubblicare un'orchestrazione come servizio Web