Come usare la Pubblicazione guidata servizio WCF BizTalk per pubblicare gli schemi come servizi WCF
La Pubblicazione guidata servizio WCF BizTalk consente di pubblicare gli schemi come servizi WCF.
Nota
Prima di eseguire la Pubblicazione guidata servizio WCF BizTalk, è necessario generare i progetti BizTalk. I progetti BizTalk devono includere gli schemi per la pubblicazione come servizi WCF.
Per pubblicare schemi come servizi WCF
Fare clic su Start, scegliere Tutti i programmi, scegliere Microsoft BizTalk Server 20xx e quindi fare clic su Pubblicazione guidata servizio WCF BizTalk.
Nota
Per creare e pubblicare orchestrazioni e schemi BizTalk come servizi WCF con gli adapter WCF, è necessario usare la Pubblicazione guidata servizio WCF BizTalk. Per pubblicare le orchestrazioni e gli schemi come servizi Web con l'adapter SOAP, utilizzare la Pubblicazione guidata servizi Web BizTalk.
Nella pagina Pubblicazione guidata servizio WCF BizTalk fare clic su Avanti.
Nella pagina Tipo di servizio WCF selezionare l'opzione Endpoint servizio per pubblicare i servizi WCF nelle orchestrazioni BizTalk selezionate in un assembly BizTalk.
Nella pagina Tipo di servizio WCF selezionare o deselezionare la casella di controllo Abilita endpoint metadati per indicare se la posizione di ricezione WCF isolata ospitata da Internet Information Services (IIS) pubblica i metadati del servizio per il recupero tramite una richiesta HTTP/GET.
Quando questa casella di controllo è selezionata, la procedura guidata genera un file Web.config in cui l'attributo httpGetEnabled dell'elemento <serviceMetadata> è impostato su true. Per generare la coda client necessaria per chiamare questo servizio nell'ambiente di sviluppo, è possibile utilizzare uno strumento di importazione di metadati come SvcUtil.exe. L'indirizzo in cui vengono pubblicati i metadati è l'indirizzo dell'endpoint e una stringa di query ?wsdl .
Nota
Per evitare la diffusione accidentale di metadati del servizio potenzialmente riservati, è consigliabile disabilitare questo comportamento nell'ambiente di produzione. A tale scopo, è possibile impostare l'attributo httpgetenabled su false oppure eliminare la directory virtuale MEX.
Nell'elenco a discesa Tipo di servizio WCF selezionare l'adapter isolato con cui vengono pubblicati i servizi WCF. È possibile selezionare uno dei seguenti adapter:
WCF-BasicHttp. L'adapter WCF-BasicHttp può comunicare con i servizi Web conformi a Profilo base WS-I 1.1, ad esempio i servizi basati su ASMX.
WCF-WSHttp. L'adapter WCF-WSHttp può comunicare con un servizio tramite gli standard WS-* sul trasporto HTTP e HTTPS.
WCF-CustomIsolated. L'adapter WCF-CustomIsolated consente l'utilizzo delle funzionalità di estendibilità di Windows Communication Foundation (WCF) sul trasporto HTTP.
Nella pagina Tipo di servizio WCF selezionare la casella di controllo Crea percorsi di ricezione BizTalk nell'applicazione seguente per creare le porte di ricezione e i percorsi corrispondenti a ogni file con estensione svc generato per l'adapter WCF selezionato nell'elenco a discesa Nome adattatore . Se esiste già un indirizzo di ricezione, non verrà sostituito. Dopo aver selezionato questa opzione, scegliere l'applicazione in cui verranno generate le porte di ricezione e i percorsi nell'elenco a discesa Nome applicazione BizTalk e quindi fare clic su Avanti.
Nella pagina Crea servizio WCF selezionare Pubblica schemi come servizio WCF e quindi fare clic su Avanti.
Nella pagina servizio WCF definire i servizi WCF da pubblicare. Usare l'albero nella finestra di dialogo Descrizione servizio Web per aggiungere, rimuovere, rinominare e modificare i nodi della descrizione del servizio Web per i servizi WCF da pubblicare. La finestra di dialogo Informazioni fornisce informazioni sul nodo selezionato e visualizza eventuali errori nel nodo corrente o nei sottonodi:
Il nodo radice dell'albero (descrizione del servizio Web) descrive i servizi WCF da pubblicare. Per il nome della directory virtuale viene usato il nodo principale come nome predefinito. È possibile modificare il nome della descrizione del servizio Web per i servizi WCF da pubblicare selezionando Rinomina descrizione del servizio Web.
Il nodo del metodo Web, Operation1, del nodo del servizio predefinito, Service1, visualizzato per impostazione predefinita nella finestra di dialogo Descrizione servizio Web può essere usato per una posizione di ricezione della risposta richiesta. Se si prevede di pubblicare una posizione di ricezione WCF unidirezionale per questa descrizione del servizio, fare clic con il pulsante destro del mouse sul nodo metodo Web predefinito, scegliere Elimina metodo Web e quindi creare un metodo Web unidirezionale come indicato di seguito: Fare clic con il pulsante destro del mouse sul nodo del servizio predefinito, scegliere Aggiungi metodo Web e quindi fare clic su One-Way.
Per aggiungere un nuovo servizio WCF, fare clic con il pulsante destro del mouse sul nome della descrizione del servizio Web e quindi scegliere Aggiungi servizio Web. Verrà creato un nuovo servizio WCF senza operazioni WCF. Per modificare il nome del servizio WCF, fare clic con il pulsante destro del mouse sul nodo del servizio WCF, scegliere Rinomina servizio Web e quindi premere INVIO per accettare il nuovo nome.
Per aggiungere una nuova operazione WCF, fare clic con il pulsante destro del mouse sul nodo del servizio WCF, scegliere Aggiungi metodo Web e quindi fare clic su One-way (per un'operazione WCF richiesta) o Request-response (per un'operazione WCF di risposta richiesta).
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 BizTalkoppure 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 nella gaC sia stato aggiornato con l'assembly selezionato nella finestra di dialogo Tipo messaggio richiesta . Se la GAC ha lo stesso nome completo, la Pubblicazione guidata servizio WCF BizTalk userà il file di assembly disponibile nella GAC, invece del file selezionato.
È possibile rinominare i nodi Request and Response senza influire sul codice generato. Dopo aver definito gli schemi, è possibile rinominare gli elementi parziali, modificando in questo modo il nome del parametro dell'operazione WCF. Le modifiche sono visibili visualizzando i metadati per i servizi WCF da pubblicare.
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 pagina Proprietà servizio WCF , nella casella di testo Targetnamespace del servizio WCF digitare uno spazio dei nomi di destinazione per i servizi WCF e quindi fare clic su Avanti.
Nella casella di testo Posizionedel servizio WCF digitare il nome della directory Web in cui vengono generati i servizi WCF. È possibile accettare il percorso predefinito (
http://localhost/<Web service description name>), digitare un percorso per i servizi WCF nella casella di testo Percorso 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 la directory Web 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 WCF - 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.
Al termine di questa pagina, fare clic su Avanti.
Nota
Il percorso del progetto può essere presente in un server diverso. Per pubblicare i servizi WCF in un server diverso, digitare il nome del progetto come
http://<servername>/<WCF service location>.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, specificare il relativo numero di porta nell'URL, Ad esempio:
http://<servername>:8080/<WCF service location>.Nota
Quando si usa la procedura guidata per creare indirizzi di ricezione, vengono usati i valori predefiniti. Il valore predefinito per la pipeline di ricezione è la pipeline Microsoft.BizTalk.DefaultPipelines.PassThruReceive . Se i messaggi ricevuti tramite i servizi WCF pubblicati richiedono un'elaborazione speciale della pipeline ,ad esempio convalida, promozione di correlazione/proprietà o mappe in ingresso/in uscita, è necessario impostare la pipeline di ricezione su Microsoft.BizTalk.DefaultPipelines.XMLReceive o su una pipeline personalizzata usando la console di amministrazione BizTalk.
Nella pagina Riepilogo servizio WCF esaminare le impostazioni per i servizi WCF.
Fare clic su Crea per creare i servizi WCF.
Fare clic su Fine per completare la pubblicazione guidata del servizio WCF BizTalk.
Dopo la pubblicazione dei servizi WCF tramite la Pubblicazione guidata servizio WCF BizTalk, è necessario configurarli in modo appropriato. Per informazioni su come configurare la scheda di ricezione WCF isolata, vedere Come configurare i servizi WCF pubblicati con la pubblicazione guidata del servizio WCF BizTalk.
Vedere anche
Come configurare i servizi WCF pubblicati con la Pubblicazione guidata servizio WCF BizTalk
Procedura dettagliata: Pubblicazione di servizi WCF con l'adapter WCF-BasicHttp
Come usare la Pubblicazione guidata servizio WCF BizTalk per pubblicare le orchestrazioni come servizi WCF