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 Master Data ServicesMaster Data Services file Web. config 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 il mdsWsHttpBehavior sezione nel <serviceBehaviors >.Find the mdsWsHttpBehavior section under <serviceBehaviors>. Per il <serviceMetadata > elemento, impostare httpGetEnabled a true.For the <serviceMetadata> element, set httpGetEnabled to true.

    Nota

    Se si desidera abilitare i servizi Web tramite Secure Sockets Layer (SSL), impostare httpsGetEnabled a true nel mdsWsHttpBehavior sezione 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. È inoltre necessario modificare mdsWsHTTPBinding in modo che sia configurato per SSL, nonché 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 si dispone di Visual Studio 2010 installato, il modo più semplice per generare classi proxy consiste nell'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 ulteriori 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

È necessario disporre MicrosoftMicrosoft Visual StudioVisual Studio o MicrosoftMicrosoft per utilizzare Svcutil.exe nel computer è installato 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 ulteriori informazioni, vedere strumento ServiceModel Metadata Utility Tool (Svcutil.exe) e la 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:porta sono il nome del computer e il numero di computer che ospita porta 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 della 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)