Pubblicare schemi come servizio Web in BizTalk
La Pubblicazione guidata Servizi Web BizTalk consente di pubblicare gli schemi come servizio Web.
Pubblicare schemi come servizio Web
In Programmi selezionare BizTalk Server e quindi selezionare Pubblicazione guidata servizi Web BizTalk.
Importante
È necessario generare progetti BizTalk prima di eseguire la Pubblicazione guidata Servizi Web BizTalk.
Nella pagina Benvenuti fare clic su Avanti.
Nella pagina Crea servizio Web selezionare Pubblica schemi come servizi Web e quindi fare clic su Avanti.
Nella pagina Servizio Web definire i servizi Web da pubblicare. Si usa l'albero nella finestra di dialogo Descrizione servizio Web per aggiungere, rimuovere, rinominare e modificare i nodi della descrizione del servizio Web. La finestra di dialogo Informazioni fornisce informazioni sul nodo selezionato e visualizza eventuali errori nel nodo corrente o in qualsiasi nodo secondario:
Il nodo radice dell'albero (descrizione del servizio Web) descrive il nome del progetto del servizio Web. Per il nome della directory virtuale viene usato il nodo principale come nome predefinito. È possibile modificare la descrizione del servizio Web selezionando Rinomina descrizione del servizio Web.
Per aggiungere un nuovo servizio Web, fare clic con il pulsante destro del mouse sul nodo descrizione del servizio Web e quindi scegliere Aggiungi servizio Web. Verrà creato un nuovo servizio Web senza metodi Web. Per modificare il nome del servizio Web, fare clic con il pulsante destro del mouse sul nodo servizio Web e selezionare Rinomina servizio Web e quindi premere INVIO per accettare il nuovo nome.
Per aggiungere un nuovo metodo Web, fare clic con il pulsante destro del mouse sul nodo servizio Web, scegliere Aggiungi metodo Web e quindi fare clic su One-way (per un metodo Web richiesta) o Request-response (per un metodo Web di risposta richiesta) dal menu di scelta rapida.
Per impostare i tipi di schema di richiesta e risposta , fare clic con il pulsante destro del mouse sul nodo Richiesta o Risposta e quindi scegliere Seleziona tipo di schema. Nella finestra di dialogo Tipo messaggio richiesta digitare il nome dell'assembly contenente lo schema del documento nella casella di testo file dell'assembly BizTalk oppure fare clic su Sfoglia per cercare l'assembly. La visualizzazione Elenco Tipi di schema disponibili visualizza ogni elemento radice dello schema. Selezionare un nodo principale da aggiungere come tipo di schema richiesta o risposta.
Nota
Se è stato installato il file di assembly BizTalk nella Global Assembly Cache (GAC), assicurarsi che l'assembly nel gaC sia stato aggiornato con l'assembly selezionato nella finestra di dialogo Tipo messaggio richiesta . Se l'assembly nella GAC utilizza lo stesso nome completo, durante la Pubblicazione guidata servizi Web BizTalk verrà selezionato il file di assembly nella GAC anziché quello desiderato.
È possibile rinominare i nodi Request and Response senza influire sul codice generato. Dopo avere definito gli schemi, è possibile rinominare gli elementi delle parti, modificando il nome del parametro del metodo Web. Per verificare le modifiche, visualizzare il codice del servizio Web generato.
Nota
Quando si rinomina uno dei nodi di descrizione del servizio Web, non è possibile usare spazi.
Fare clic su Avanti per continuare la procedura guidata.
Nella finestra di dialogo Proprietà servizio Web digitare uno spazio dei nomi di destinazione per il servizio Web e selezionare le caselle appropriate per specificare come gestire le intestazioni SOAP e il supporto di Single Sign-On per il servizio Web. Per personalizzare ulteriormente l'implementazione del servizio Web, fare clic sul pulsante Avanzate . Verranno visualizzate altre opzioni disponibili:
Opzione Valore Descrizione Stile dei parametri SOAP Predefinito Questa opzione specifica la formattazione dei parametri in un messaggio SOAP. Per altre informazioni, vedere Enumerazione SoapParameterStyle in https://go.microsoft.com/fwlink/?LinkId=62259. Stile dei parametri SOAP Bare Questa opzione specifica la formattazione dei parametri in un messaggio SOAP. Per altre informazioni, vedere Enumerazione SoapParameterStyle in https://go.microsoft.com/fwlink/?LinkId=62259. Stile dei parametri SOAP Wrapped Questa opzione specifica la formattazione dei parametri in un messaggio SOAP. Per altre informazioni, vedere Enumerazione SoapParameterStyle in https://go.microsoft.com/fwlink/?LinkId=62259. Attestazioni di conformità Nessuno Questa opzione indica la specifica WSI (Web Services Interoperability, Interoperabilità servizi Web) a cui dichiara di conformarsi il binding. Per altre informazioni, vedere WebServiceBindingAttribute.ConformsTo property at https://go.microsoft.com/fwlink/?LinkId=193064. Attestazioni di conformità Profilo base WS-I 1.1 Questa opzione indica la specifica WSI (Web Services Interoperability, Interoperabilità servizi Web) a cui dichiara di conformarsi il binding. Per altre informazioni, vedere WebServiceBindingAttribute.ConformsTo property at https://go.microsoft.com/fwlink/?LinkId=193064. Forza richiesta-risposta [Impostazione predefinita] Questa opzione specifica se le operazioni BizTalk unidirezionali devono essere esposte come metodi Web richiesta-risposta. Il valore predefinito non forza il flag unidirezionale. Nota
Eventuali opzioni di intestazione SOAP selezionate vengono applicate globalmente a tutti i servizi Web e a tutti i metodi Web creati durante l'esecuzione di questa istanza della procedura guidata.
Nella pagina Proprietà servizio Web fare clic su Avanti.
Se si seleziona Aggiungi intestazioni SOAP aggiuntive, vengono visualizzate le pagine Intestazioni SOAP richiesta e intestazioni SOAP di risposta . È possibile aggiungere e rimuovere intestazioni SOAP di richiesta e risposta usando i pulsanti Aggiungi e Rimuovi nelle finestre di dialogo seguenti:
Per aggiungere un'intestazione SOAP, fare clic su Aggiungi. Nella casella di testo Nome assembly BizTalk (*.dll) digitare il nome dell'assembly o cercare l'assembly contenente lo schema dell'intestazione SOAP nella casella di testo File di assembly BizTalk . La visualizzazione Elenco Tipi di schema disponibili visualizza ogni elemento radice dello schema. Selezionare un nodo radice da aggiungere come intestazione SOAP di richiesta o risposta. Per selezionare più elementi, tenere premuto IL tasto CTRL e fare clic su OK.
Per rimuovere un'intestazione SOAP dall'elenco, selezionarla dall'elenco delle intestazioni SOAP aggiunte e quindi fare clic su Rimuovi.
Fare clic su Avanti in ogni pagina di intestazione SOAP per continuare la procedura guidata.
Nota
L'intestazione SOAP viene definita dallo spazio dei nomi di destinazione e dal nome dell'elemento radice.
Nota
Se si aggiunge una stessa combinazione formata da spazio dei nomi di destinazione e nome di elemento radice come intestazione SOAP di richiesta e risposta, verrà considerata come un'intestazione in ingresso e in uscita. È necessario copiare manualmente l'intestazione in ingresso nell'intestazione in uscita all'interno di un'orchestrazione.
Nota
È possibile aggiungere una stessa combinazione formata da spazio dei nomi di destinazione e nome di elemento radice una sola volta come intestazione SOAP di richiesta e una sola volta come intestazione SOAP di risposta.
Nella pagina Progetto servizio Web digitare il percorso del progetto nella casella di testo Percorso progetto. È possibile accettare il percorso predefinito (
http://localhost/your_project_name), digitare un percorso per il progetto oppure fare clic su Sfoglia e selezionare una directory Web. Selezionare una o più delle seguenti opzioni:Sovrascrivi progetto esistente - Questa opzione è disponibile solo se il percorso del progetto esiste già. È possibile eseguire pubblicazioni nello stesso percorso solo se si seleziona questa opzione. In caso contrario, è necessario immettere un percorso diverso per il progetto.
Consenti accesso anonimo al servizio Web - Questa opzione consente di aggiungere l'accesso anonimo alla directory virtuale creata. Per impostazione predefinita, la directory virtuale eredita i privilegi di accesso dalla directory virtuale padre oppure dal sito Web se si tratta di una directory virtuale di livello superiore.
Crea indirizzi di ricezione BizTalk nella seguente applicazione - Questa opzione crea automaticamente le porte e gli indirizzi di ricezione dell'adapter SOAP corrispondenti a ciascun file con estensione asmx generato. Se esiste già un altro indirizzo di ricezione, l'indirizzo di ricezione non verrà sostituito. I percorsi di ricezione per l'adattatore SOAP vengono risolti usando il formato "/<nome >della directory virtuale/<orchestrazione namespace_typename_portname.asmx>". Dopo aver selezionato questa opzione, scegliere l'applicazione in cui verranno generati le porte e gli indirizzi di ricezione.
Nota
Il percorso del progetto può essere presente in un server diverso. Per pubblicare un servizio Web in un server diverso, digitare il nome del progetto come
http://<servername>/<project_name>.Nota
Il percorso del progetto può essere presente in un sito Web non predefinito. Quando si esegue la pubblicazione in un sito Web non predefinito, includere il numero di porta del sito Web nell'URL:
http://localhost:8080/<project_name>.Nota
Quando si utilizza la procedura guidata per creare indirizzi di ricezione, la procedura crea gli indirizzi di ricezione utilizzando molti valori predefiniti. I valori predefiniti per le pipeline di ricezione e invio sono Microsoft.BizTalk.DefaultPipelines.PassThruReceive e Microsoft.BizTalk.DefaultPipelines.PassThruTransmit. Se i messaggi ricevuti tramite il servizio Web pubblicato richiedono un'elaborazione speciale della pipeline (ad esempio, convalida, correlazione o mappe in ingresso/in uscita), è necessario impostare le pipeline di invio e ricezione su Microsoft.BizTalk.DefaultPipelines.XMLReceive, Microsoft.BizTalk.DefaultPipelines.XMLSend o su una pipeline personalizzata.
Fare clic su Avanti per esaminare le impostazioni per il progetto di servizio Web ASP.NET.
Fare clic su Crea per creare il servizio Web ASP.NET.
Fare clic su Fine per completare la Pubblicazione guidata servizi Web BizTalk.