Erstellen von Proxyklassen für den Master Data Manager-Webdienst
Gilt für: SQL Server –
Nur Windows Azure SQL verwaltete Instanz
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:
Öffnen Sie die Master Data Services Web.config-Datei in einem Text-Editor. Diese Datei befindet sich im Ordner "WebApplication" des Installationspfads "Master Data Services".
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) aktivieren möchten, zuvor als Secure Sockets Layer (SSL) bezeichnet, legen Sie "httpsGetEnabled" im Abschnitt "mdsWsHttpBehavior" der Datei "web.config" auf "true" fest. Außerdem müssen Sie mdsWsHTTPBinding so ändern, dass es auch für TLS konfiguriert ist, und den Abschnitt ohne TLS kommentieren.
Speichern Sie die an der Datei vorgenommenen Änderungen.
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 Dienstverweises ist die URL der Master Data Manager-Webanwendung, angefügt mit "/service/service.svc". 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 entweder Microsoft Visual Studio oder das Microsoft Windows SDK installiert haben, um auf Ihrem Computer Svcutil.exe 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 are the computer name and port number of the computer that hosts Master Data Manager.
virtual_path ist der virtuelle Pfad des Master Data Manager in Internetinformationsdienste (IIS).
proxy_name ist der Name für die generierte Proxydatei.