Condividi tramite

Creare le classi proxy del servizio Web Gestione dati master

  • Articolo

Si applica a: SQL Server - Solo Windows Istanza gestita di SQL di Azure

Il servizio Web Master Data Manager consente di usare a livello di codice le funzionalità di Master Data Services da qualsiasi computer in grado di accedere al sito Web Master Data Manager. Prima di iniziare a scrivere il codice per accedere al servizio Web, è necessario generare le classi proxy. La classe proxy principale utilizzata per eseguire le operazioni del servizio Web è la classe ServiceClient, che implementa l'interfaccia IService.

Abilitare la pubblicazione dei metadati del servizio Web

Prima di generare le classi proxy, è necessario abilitare la pubblicazione dei metadati del servizio Web. A tale scopo, effettuare le operazioni seguenti:

  1. Aprire il file Web.config master data services in un editor di testo. Questo file si trova nella cartella WebApplication del percorso di installazione di Master Data Services.

  2. Trovare la sezione mdsWsHttpBehavior in <serviceBehaviors>. Per l'elemento serviceMetadata> impostare httpGetEnabled su true.<

    Nota

    Se si desidera abilitare i servizi Web su Transport Layer Security (TLS), noto in precedenza come Secure Sockets Layer (SSL), impostare httpsGetEnabled su true nella sezione mdsWsHttpBehavior del file web.config. È anche necessario modificare mdsWsHTTPBinding in modo che sia configurato anche per TLS e impostare come commento la sezione non TLS.

  3. Salvare le modifiche apportate al file .

  4. Testare la pubblicazione dei metadati passando all'URL del servizio, ad esempio: https://yourserver/MDS/service/service.svc. Se la pubblicazione dei metadati è abilitata, viene visualizzata una pagina che inizia con
    "È stato creato un servizio".

Creazione di classi proxy tramite Visual Studio

Se è installato Visual Studio 2010, il modo più semplice per generare le classi proxy è aggiungere un Riferimento al servizio al progetto. L'indirizzo del riferimento al servizio è l'URL dell'applicazione Web Master Data Manager, aggiunta con /service/service.svc. Ad esempio: https://yourserver/MDS/service/service.svc. Per altre informazioni, vedere Procedura: Aggiungere, aggiornare o rimuovere un riferimento al servizio.

Creazione di classi proxy tramite Svcutil.exe

È necessario avere Installato Microsoft Visual Studio o Microsoft Windows SDK per avere Svcutil.exe nel computer. Se si usa Visual Studio, è necessario usare il prompt dei comandi di Visual Studio per eseguire il comando . Per altre informazioni, vedere Strumento ServiceModel Metadata Utility (Svcutil.exe) e Generazione di un client WCF dai metadati del servizio.

Per creare un set di classi proxy in C# tramite Svcutil.exe, utilizzare un comando analogo al seguente:

svcutil.exe https://<server_name:port>/<virtual_path>/Service/Service.svc   
/out:<proxy_name>.cs /messageContract /tcv:Version35   
/noconfig /ct:System.Collections.ObjectModel.Collection`1   
/namespace:*,Microsoft.MasterDataServices

Dove:

  • servername:port sono il nome del computer e il numero di porta del computer che ospita Master Data Manager.

  • virtual_path è il percorso virtuale di Master Data Manager in Internet Information Services (IIS).

  • proxy_name è il nome del file proxy generato.

Vedi anche

Operazioni del servizio Web per categoria (Master Data Services)