Erstellen von Proxyklassen für den Master Data Manager-Webdienst

  • Artikel

Gilt für:SQL Server – nur Windows Azure SQL Managed Instance

Mit dem Master Data Manager-Webdienst können Sie die Features von Master Data Services von jedem Computer aus programmgesteuert nutzen, der auf Ihre Master Data Manager-Website zugreifen kann. Vor dem Schreiben des Codes für den Zugriff auf den Webdienst sind Proxyklassen zu erstellen. Die Hauptproxyklasse, mit der Sie Webdienstvorgänge ausführen, ist die ServiceClient-Klasse, welche die IService-Schnittstelle implementiert.

Aktivieren der Veröffentlichung von Webdienst-Metadaten

Bevor Sie Proxyklassen generieren können, ist die Veröffentlichung der Webdienst-Metadaten zu aktivieren. Gehen Sie dazu folgendermaßen vor:

  1. Öffnen Sie die datei Master Data Services Web.config in einem Text-Editor. Diese Datei befindet sich im Ordner WebApplication des Master Data Services Installationspfads.

  2. Suchen Sie den Abschnitt mdsWsHttpBehavior unter <serviceBehaviors>. Legen Sie für das <serviceMetadata-Element>httpGetEnabled auf true fest.

    Hinweis

    Wenn Sie Webdienste über Transport Layer Security (TLS), früher als Secure Sockets Layer (SSL) bezeichnet, aktivieren möchten, legen Sie httpsGetEnabled im Abschnitt mdsWsHttpBehavior der web.config-Datei auf true fest. Außerdem müssen Sie mdsWsHTTPBinding so ändern, dass es auch für TLS konfiguriert ist, und den Nicht-TLS-Abschnitt auskommentieren.

  3. Speichern Sie die an der Datei vorgenommenen Änderungen.

  4. Testen Sie die Metadaten-Veröffentlichung durch Navigieren zur Dienst-URL, beispielsweise: https://yourserver/MDS/service/service.svc. Ist die Metadaten-Veröffentlichung aktiviert, wird eine Seite angezeigt. Diese beginnt mit:
    „You have created a service.“ (Sie haben einen Dienst erstellt.)

Erstellen von Proxyklassen mit Visual Studio

Ist Visual Studio 2010 installiert, lassen sich Proxyklassen am einfachsten durch das Hinzufügen eines Dienstverweises zum Projekt erstellen. Die Adresse des Dienstverweis ist die URL der Master Data Manager-Webanwendung, die mit /service/service.svc angefügt wird. Beispiel: https://yourserver/MDS/service/service.svc. Weitere Informationen finden Sie unter Vorgehensweise: Hinzufügen, Aktualisieren oder Entfernen eines Dienstverweises.

Erstellen von Proxyklassen mit "Svcutil.exe"

Sie müssen Microsoft Visual Studio oder die Microsoft Windows SDK installiert haben, um Svcutil.exe auf Ihrem Computer zu haben. Wenn Sie Visual Studio verwenden, müssen Sie die Visual Studio-Eingabeaufforderung verwenden, um den Befehl auszuführen. Weitere Informationen finden Sie unter ServiceModel Metadata Utility-Tool (Svcutil.exe) und Generieren eines WCF-Clients aus Dienstmetadaten.

Verwenden Sie zum Erstellen mehrerer C#-Proxyklassen mit "Svcutil.exe" einen Befehl wie folgt:

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

Hierbei gilt:

  • servername:port sind der Computername und die Portnummer des Computers, auf dem Master Data Manager gehostet wird.

  • virtual_path ist der virtuelle Pfad von Master Data Manager in Internet Information Services (IIS).

  • proxy_name ist der Name für die generierte Proxydatei.

Weitere Informationen

Kategorisierte Webdienstvorgänge (Master Data Services)