Come usare l'utilizzo guidato servizio WCF BizTalk per usare un servizio WCF

BizTalk Adapter Framework consente di aggiungere ai progetti BizTalk schemi di adapter e tipi BizTalk, mentre l'Utilizzo guidato servizio WCF BizTalk consente di aggiungervi adapter di trasmissione WCF. Per gli adapter di trasmissione WCF è necessario selezionare un endpoint di scambio dei metadati (MEX) esistente per porte di trasmissione. È quindi necessario immettere le informazioni usate per generare gli schemi e i tipi. Al termine della procedura guidata, gli schemi e i tipi necessari per usare servizi WCF verranno aggiunti al progetto BizTalk.

Per aggiungere al progetto gli schemi e i tipi per gli adapter di trasmissione WCF

1. Nel progetto BizTalk di Microsoft Visual Studio, in Esplora soluzioni fare clic con il pulsante destro del mouse sul progetto, scegliere Aggiungi e quindi fare clic su Aggiungi elementi generati.

2. Nella finestra di dialogo Aggiungi elementi generati - <Nome> progetto, nella sezione Modelli selezionare Utilizza servizio WCF e quindi fare clic su Aggiungi.

3. Nella pagina Creazione guidata servizio WCF BizTalk fare clic su Avanti.

4. Nella pagina Origine metadati selezionare l'origine dei metadati da importare e quindi fare clic su Avanti.

   

   Per scaricare i documenti dei metadati dall'endpoint di scambio dei metadati di un servizio in esecuzione, selezionare l'opzione Endpoint MEX (Metadata Exchange). In questo modo, sarà possibile creare una porta di trasmissione che svolge la funzione di client per il servizio WCF. Per usare questa opzione, l'endpoint del servizio deve pubblicare i metadati del servizio da recuperare mediante una richiesta HTTP/GET o HTTPS/GET. L'endpoint deve inoltre consentire l'accesso ai metadati con credenziali utente anonime o con nome utente e password secondo lo schema di autenticazione di base.

   Nota

   Con lo schema di autenticazione di base, le credenziali vengono inviate come testo non crittografato e possono essere facilmente intercettate. Lo schema non offre inoltre alcuna sicurezza per le informazioni passate dal servizio. Per la crittografia dei dati è necessario usare il protocollo Secure Sockets Layer (SSL).

   Per importare altri documenti di metadati, selezionare l'opzione File di metadati (WSDL e XSD) per importare i metadati da un file system.

   Nota

   Non tutti i servizi devono pubblicare metadati. Se si lascia disabilitata la pubblicazione dei metadati, si riduce la superficie di attacco del servizio e il rischio di diffusione non intenzionale di informazioni.

5. Se è stata selezionata l'opzione Endpoint MEX (Metadata Exchange) nella pagina Origine metadati , viene visualizzata la pagina Endpoint metadati . Nella pagina Endpoint metadati specificare l'URL del servizio in esecuzione che fornisce metadati per il download tramite WS-Metadata Exchange o Http-Get. Per ottenere il documento dei metadati dall'URL, fare clic su Recupera. Se il servizio in esecuzione richiede una credenziale utente con lo schema di autenticazione di base, fare clic su Modifica per aprire la finestra di dialogo Utilizzo guidata servizio WCF BizTalk in cui è possibile specificare il nome utente e la password da usare quando si accede al servizio.

   

   Nota

   Per scaricare i metadati per i servizi WCF pubblicati tramite HTTP o HTTPS, non è possibile usare l'endpoint MEX, ad esempio http://localhost:8087/CalculatorService/mex per la casella di testo Indirizzo metadati . Per i servizi WCF, è necessario usare i metadati WSDL per scaricare i metadati come indicato di seguito: http://localhost:8087/CalculatorServicehttp://localhost:8087/CalculatorService?wsdl

6. Se è stata selezionata l'opzione File di metadati (WSDL e XSD) nella pagina Origine metadati , viene visualizzata la pagina Endpoint metadati . Nella pagina Endpoint metadati specificare i file di metadati da importare. Fare clic su Aggiungi per aggiungere i file di metadati da importare nella visualizzazione File di metadati . Verrà visualizzata la finestra di dialogo Aggiungi file di metadati in cui è possibile cercare i percorsi dei dischi per i file di metadati.

   Nella finestra di dialogo Aggiungi file di metadati selezionare un set completo di file WSDL e XSD da usare per i metadati. È possibile generare questi file digitando il seguente comando al prompt dei comandi:

   svcutil.exe /t:metadata http://localhost/service.svc/mex

   Fare clic su Rimuovi per rimuovere i file di metadati selezionati nella visualizzazione File di metadati .

   

   Nota

   SvcUtil.exe è incluso nel Software Development Kit (SDK) di Microsoft Windows Vista e dei componenti runtime di .NET Framework.

   Nota

   I metadati del servizio possono essere manomessi o sottoposti a spoofing quando vengono recuperati in modo non protetto. I metadati manomessi possono reindirizzare il client a un servizio dannoso, contenere impostazioni di sicurezza compromesse o includere strutture XML dannose. I documenti di metadati possono raggiungere dimensioni notevoli ed essere salvati frequentemente nel file system. È necessario assicurarsi che i file di metadati non siano stati manomessi.

7. Nella pagina Importa riepilogo metadati del servizio WCF esaminare le impostazioni. È possibile fare clic su Indietro per apportare modifiche. Fare quindi clic su Importa per creare gli artefatti e i tipi BizTalk da usare per l'utilizzo del servizio WCF.

8. Nella pagina Completamento guidata servizio WCF BizTalk fare clic su Fine. Per eseguire di nuovo questa procedura guidata, selezionare nuovamente l'opzione Esegui questa procedura guidata e quindi fare clic su Fine.

   Nel progetto BizTalk verranno creati gli schemi e i tipi BizTalk necessari per l'utilizzo di servizi WCF. I tipi BizTalk, ad esempio i tipi di porta e i tipi di messaggio multiparte, vengono creati in un'orchestrazione. Si consiglia di non modificare l'orchestrazione creata mediante la procedura guidata. Nel progetto BizTalk è invece possibile aggiungere nuove orchestrazioni per gli scopi desiderati. L'uso guidato del servizio WCF BizTalk crea anche due file di associazione, BizTalkServiceInstance.BindingInfo.xml e BizTalkServiceInstance_Custom.BindingInfo.xml. BizTalkServiceInstance.BindingInfo.xml è un file di associazione BizTalk che può essere importato dallo strumento della riga di comando di sviluppo o dalla procedura guidata per configurare le porte di invio con le schede WCF di associazione standard, ad esempio le schede WCF-NetMsmq e WCF-WSHttp. BizTalkServiceInstance.BindingInfo.xml è un file di associazione BizTalk che può essere importato dallo strumento della riga di comando di sviluppo o dalla procedura guidata per configurare le porte di invio con l'adattatore WCF-Custom.

   Quando si importa il file di associazione generato, viene popolato WCF . Proprietà Action nel formato di mapping delle azioni. Per vedere come è configurata questa proprietà, esaminare la casella di testo Azione nella scheda Generale nella finestra di dialogo Proprietà trasporto porta di trasmissione WCF nella console amministrazione BizTalk.

   È possibile specificare WCF. Proprietà Action in due modi diversi: il formato di azione singolo e il formato di mapping delle azioni. Se si imposta questa proprietà nel formato di azione singola, ad esempio, http://contoso.com/Svc/Op1 l'intestazione SOAPAction per i messaggi in uscita viene sempre impostata sul valore specificato in questa proprietà. Se si imposta questa proprietà nel formato di mapping delle azioni, l'intestazione SOAPAction in uscita viene determinata da BTS. Proprietà contesto operazione . Ad esempio, se questa proprietà è impostata sul formato XML seguente e su BTS. La proprietà Operation è impostata su Op1, l'adapter di invio WCF usa http://contoso.com/Svc/Op1 per l'intestazione SOAPAction in uscita.

   <BtsActionMapping>

   <Operation Name="Op1" Action="http://contoso.com/Svc/Op1" />

   <Operation Name="Op2" Action="http://contoso.com/Svc/Op2" />

   </BtsActionMapping>

   Se i messaggi in uscita provengono da una porta di orchestrazione, le istanze di orchestrazione impostano dinamicamente BTS. Proprietà Operation con il nome dell'operazione della porta. Se i messaggi in uscita vengono indirizzati con il routing basato sul contenuto, è possibile impostare BTS. Proprietà Operation nei componenti della pipeline. Le porte generate dalla Creazione guidata WCF BizTalk hanno operazioni con nomi che corrispondono agli attributi Name nell'elemento <BtsActionMapping> . Non è necessario impostare in modo esplicito il BTS. Proprietà operation nelle orchestrazioni quando si inviano messaggi tramite porte generate dalla procedura guidata.

Vedere anche

Come usare la Pubblicazione guidata servizio WCF BizTalk per pubblicare le orchestrazioni come servizi WCF
Come usare la Pubblicazione guidata servizio WCF BizTalk per pubblicare gli schemi come servizi WCF