Creare le classi proxy del servizio Web Gestione dati masterCreate Master Data Manager Web Service Proxy Classes

Il servizio Web Master Data ManagerMaster Data Manager consente di utilizzare a livello di codice le caratteristiche di Master Data ServicesMaster Data Services da qualsiasi computer che può accedere al sito Web di Master Data ManagerMaster Data Manager.The Master Data ManagerMaster Data Manager web service lets you make programmatic use of the features of Master Data ServicesMaster Data Services from any computer that can access your Master Data ManagerMaster Data Manager web site. Prima di iniziare a scrivere il codice per accedere al servizio Web, è necessario generare le classi proxy.Before you can start writing code to access the web service, you must generate proxy classes. La classe proxy principale utilizzata per eseguire le operazioni del servizio Web è la classe ServiceClient, che implementa l'interfaccia IService.The main proxy class you use to perform web service operations is the ServiceClient class, which implements the IService interface.

Abilitare la pubblicazione dei metadati del servizio WebEnable Web Service Metadata Publishing

Prima di generare le classi proxy, è necessario abilitare la pubblicazione dei metadati del servizio Web.Before you can generate proxy classes, you must enable web service metadata publishing. A tale scopo, effettuare le operazioni seguenti:Follow these steps to do this:

  1. Aprire il file Web.config di Master Data ServicesMaster Data Services in un editor di testo.Open the Master Data ServicesMaster Data Services Web.config file in a text editor. Il file Web.config si trova nella cartella WebApplication del percorso di installazione di Master Data ServicesMaster Data Services.This file is in the WebApplication folder of the Master Data ServicesMaster Data Services installation path.

  2. Trovare la sezione mdsWsHttpBehavior in <serviceBehaviors>.Find the mdsWsHttpBehavior section under <serviceBehaviors>. Per l'elemento <serviceMetadata>, impostare httpGetEnabled su true.For the <serviceMetadata> element, set httpGetEnabled to true.

    Nota

    Per abilitare servizi Web tramite Secure Sockets Layer (SSL), impostare httpsGetEnabled su true nella sezione mdsWsHttpBehavior del file web.config.If you want to enable Web services over Secure Sockets Layer (SSL), set httpsGetEnabled to true in the mdsWsHttpBehavior section of the web.config file. È anche necessario modificare mdsWsHTTPBinding in modo che sia configurato per SSL e impostare come commento la sezione non SSL.You also need to change mdsWsHTTPBinding so that it is configured for SSL, as well, and comment out the non-SSL section.

  3. Salvare le modifiche apportate al file.Save changes to the file.

  4. Testare la pubblicazione dei metadati passando all'URL del servizio, ad esempio: http://yourserver/MDS/service/service.svc.Test metadata publishing by browsing to the service URL, for example: http://yourserver/MDS/service/service.svc. Se la pubblicazione dei metadati è abilitata, viene visualizzata una pagina che inizia conIf metadata publishing is enabled, a page is displayed that begins with
    "È stato creato un servizio".“You have created a service.”

Creazione di classi proxy tramite Visual StudioCreating Proxy Classes by Using Visual Studio

Se è installato Visual Studio 2010, il modo più semplice per generare le classi proxy è aggiungere un Riferimento al servizio al progetto.If you have Visual Studio 2010 installed, the simplest way to generate proxy classes is to add a Service Reference to your project. L'indirizzo del riferimento al servizio è l'URL dell'applicazione Web Master Data ManagerMaster Data Manager aggiunto a /service/service.svc,The address of the service reference is the URL of the Master Data ManagerMaster Data Manager web application, appended with /service/service.svc. Esempio: http://yourserver/MDS/service/service.svc.For example: http://yourserver/MDS/service/service.svc. Per altre informazioni, vedere Procedura: Aggiungere, aggiornare o rimuovere un riferimento al servizio.For more information, see How to: Add, Update, or Remove a Service Reference.

Creazione di classi proxy tramite Svcutil.exeCreating Proxy Classes by Using Svcutil.exe

Per usare Svcutil.exe è necessario che nel computer sia installato MicrosoftMicrosoft Visual StudioVisual Studio o MicrosoftMicrosoft Windows SDK.You must have either MicrosoftMicrosoft Visual StudioVisual Studio or the MicrosoftMicrosoft Windows SDK installed in order to have Svcutil.exe on your computer. Se si utilizza Visual StudioVisual Studio, per eseguire il comando sarà necessario utilizzare il prompt dei comandi di Visual StudioVisual Studio.If you use Visual StudioVisual Studio, you must use the Visual StudioVisual Studio command prompt to run the command. Per altre informazioni, vedere Strumento ServiceModel Metadata Utility (Svcutil.exe) e Generazione di un client WCF dai metadati del servizio.For more information, see ServiceModel Metadata Utility Tool (Svcutil.exe) and Generating a WCF Client from Service Metadata.

Per creare un set di classi proxy in C# tramite Svcutil.exe, utilizzare un comando analogo al seguente:To create a set of C# proxy classes by using Svcutil.exe, use a command such as the following:

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:Where:

  • servername:port corrispondono al nome del computer e al numero della porta del computer host di Master Data ManagerMaster Data Manager.servername:port are the computer name and port number of the computer that hosts Master Data ManagerMaster Data Manager.

  • virtual_path è il percorso virtuale di Master Data ManagerMaster Data Manager in Internet Information Services (IIS).virtual_path is the virtual path of Master Data ManagerMaster Data Manager in Internet Information Services (IIS).

  • proxy_name è il nome del file proxy generato.proxy_name is the name for the generated proxy file.

Vedere ancheSee Also

Operazioni del servizio Web per categoria (Master Data Services)Categorized Web Service Operations (Master Data Services)