Condividi tramite

Creare le classi proxy del servizio Web Gestione dati master

  • Articolo

Il servizio Web Master Data Manager consente di utilizzare a livello di codice le caratteristiche di Master Data Services da qualsiasi computer che può accedere al sito Web di 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 Microsoft.MasterDataServices.ServiceClient, che implementa l'interfaccia Microsoft.MasterDataServices.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 di Master Data Services in un editor di testo. Il file Web.config si trova nella cartella WebApplication del percorso di installazione di Master Data Services.

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

    [!NOTA]

    Se si desidera abilitare servizi Web tramite Secure Sockets Layer (SSL), impostare invece httpsGetEnabled su true nella sezione mdsWsHttpBehavior del file web.config. È inoltre necessario modificare mdsWsHTTPBinding in modo tale che sia configurato per SSL e impostare come commento la sezione non SSL.

  3. Salvare le modifiche apportate al file.

  4. Testare la pubblicazione dei metadati passando all'URL del servizio, ad esempio http://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 si dispone di Visual Studio 2010 installato, 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 aggiunto a /service/service.svc, ad esempio http://yourserver/MDS/service/service.svc. Per ulteriori informazioni, vedere Procedura: aggiungere, aggiornare o rimuovere un riferimento al servizio.

Creazione di classi proxy tramite Svcutil.exe

Per utilizzare Svcutil.exe, è necessario che nel computer sia installato Microsoft Visual Studio o Microsoft Windows SDK. Se si utilizza Visual Studio, per eseguire il comando sarà necessario utilizzare il prompt dei comandi di Visual Studio. Per ulteriori informazioni, vedere Strumento ServiceModel Metadata Utility Tool (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 http://<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 corrispondono al nome del computer e al numero della porta del computer che ospita Master Data Manager.

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

  • proxy_name corrisponde al nome del file proxy generato.

Vedere anche

Concetti

Operazioni del servizio Web per categoria (Master Data Services)