Erstellen von Proxyklassen für den Master Data Manager-WebdienstCreate Master Data Manager Web Service Proxy Classes

Der Master Data ManagerMaster Data Manager-Webdienst ermöglicht die programmgesteuerte Verwendung der Funktionen von Master Data ServicesMaster Data Services an jedem Computer, der auf die Master Data ManagerMaster Data Manager-Website zugreifen kann.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. Vor dem Schreiben des Codes für den Zugriff auf den Webdienst sind Proxyklassen zu erstellen.Before you can start writing code to access the web service, you must generate proxy classes. Die Hauptproxyklasse, mit der Sie Webdienstvorgänge ausführen, ist die ServiceClient-Klasse, welche die IService-Schnittstelle implementiert.The main proxy class you use to perform web service operations is the ServiceClient class, which implements the IService interface.

Aktivieren der Veröffentlichung von Webdienst-MetadatenEnable Web Service Metadata Publishing

Bevor Sie Proxyklassen generieren können, ist die Veröffentlichung der Webdienst-Metadaten zu aktivieren.Before you can generate proxy classes, you must enable web service metadata publishing. Gehen Sie dazu folgendermaßen vor:Follow these steps to do this:

  1. Öffnen Sie die Datei „Web.config“ von Master Data ServicesMaster Data Services in einem Text-Editor.Open the Master Data ServicesMaster Data Services Web.config file in a text editor. Diese Datei befindet sich im Ordner "WebApplication" des Master Data ServicesMaster Data Services-Installationspfads.This file is in the WebApplication folder of the Master Data ServicesMaster Data Services installation path.

  2. Suchen Sie den Bereich mdsWsHttpBehavior unter <serviceBehaviors>.Find the mdsWsHttpBehavior section under <serviceBehaviors>. Legen Sie für das Element <serviceMetadata> httpGetEnabled auf TRUE fest.For the <serviceMetadata> element, set httpGetEnabled to true.

    Hinweis

    Wenn Sie Webdienste über Secure Sockets Layer (SSL) aktivieren möchten, legen Sie httpsGetEnabled auf TRUE im Abschnitt mdsWsHttpBehavior der Datei „web.config“ fest.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. Sie müssen außerdem mdsWsHTTPBinding ändern, damit auch hier eine Konfiguration für SSL vorliegt, und den Nicht-SSL-Abschnitt auskommentieren.You also need to change mdsWsHTTPBinding so that it is configured for SSL, as well, and comment out the non-SSL section.

  3. Speichern Sie die an der Datei vorgenommenen Änderungen.Save changes to the file.

  4. Testen Sie die Metadaten-Veröffentlichung durch Navigieren zur Dienst-URL, beispielsweise: http://yourserver/MDS/service/service.svc.Test metadata publishing by browsing to the service URL, for example: http://yourserver/MDS/service/service.svc. Ist die Metadaten-Veröffentlichung aktiviert, wird eine Seite angezeigt. Diese beginnt mit:If metadata publishing is enabled, a page is displayed that begins with
    "Sie haben einen Dienst erstellt."“You have created a service.”

Erstellen von Proxyklassen mit Visual StudioCreating Proxy Classes by Using Visual Studio

Ist Visual Studio 2010 installiert, lassen sich Proxyklassen am einfachsten durch das Hinzufügen eines Dienstverweises zum Projekt erstellen.If you have Visual Studio 2010 installed, the simplest way to generate proxy classes is to add a Service Reference to your project. Die Adresse des Dienstverweises ist die URL der Master Data ManagerMaster Data Manager-Webanwendung, wobei "/service/service.svc" angefügt wird.The address of the service reference is the URL of the Master Data ManagerMaster Data Manager web application, appended with /service/service.svc. Beispiel: http://yourserver/MDS/service/service.svcFor example: http://yourserver/MDS/service/service.svc. Weitere Informationen finden Sie unter Vorgehensweise: Hinzufügen, Aktualisieren oder Entfernen eines Dienstverweises.For more information, see How to: Add, Update, or Remove a Service Reference.

Erstellen von Proxyklassen mit "Svcutil.exe"Creating Proxy Classes by Using Svcutil.exe

Damit „Svcutil.exe“ auf dem Computer verfügbar ist, muss MicrosoftMicrosoft Visual StudioVisual Studio oder das MicrosoftMicrosoft Windows SDK installiert sein.You must have either MicrosoftMicrosoft Visual StudioVisual Studio or the MicrosoftMicrosoft Windows SDK installed in order to have Svcutil.exe on your computer. Wenn Sie Visual StudioVisual Studio verwenden, müssen Sie den Befehl über die Visual StudioVisual Studio-Eingabeaufforderung ausführen.If you use Visual StudioVisual Studio, you must use the Visual StudioVisual Studio command prompt to run the command. Weitere Informationen finden Sie unter ServiceModel Metadata Utility-Tool (Svcutil.exe) und Generieren eines WCF-Clients aus Dienstmetadaten.For more information, see ServiceModel Metadata Utility Tool (Svcutil.exe) and Generating a WCF Client from Service Metadata.

Verwenden Sie zum Erstellen mehrerer C#-Proxyklassen mit "Svcutil.exe" einen Befehl wie folgt: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  

Erläuterungen:Where:

  • servername:port entspricht dem Computernamen und der Portnummer des Computers, auf dem Master Data ManagerMaster Data Manager gehostet wird.servername:port are the computer name and port number of the computer that hosts Master Data ManagerMaster Data Manager.

  • virtual_path ist der virtuelle Pfad von Master Data ManagerMaster Data Manager in den Internetinformationsdiensten (IIS).virtual_path is the virtual path of Master Data ManagerMaster Data Manager in Internet Information Services (IIS).

  • proxy_name ist der Name für die generierte Proxydatei.proxy_name is the name for the generated proxy file.

Siehe auchSee Also

Kategorisierte Webdienstvorgänge (Master Data Services)Categorized Web Service Operations (Master Data Services)