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

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. Bevor Sie mit dem Schreiben von Code für den Zugriff auf den Webdienst beginnen können, müssen Sie Proxyklassen generieren. Die Hauptproxyklasse, die Sie zum Ausführen von Webdienstvorgängen verwenden, ist die ServiceClient Klasse, die die IService Schnittstelle implementiert.

Aktivieren der Webdienstmetadatenveröffentlichung

Bevor Sie Proxyklassen generieren können, müssen Sie die Webdienstmetadatenveröffentlichung aktivieren. Führen Sie die folgenden Schritte aus, um dies zu tun:

1. Ö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".

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

   Hinweis

   Wenn Sie Webdienste über SSL (Secure Sockets Layer) aktivieren möchten, legen Sie sie im mdsWsHttpBehavior Abschnitt der web.config Datei fest httpsGetEnabledtrue. Sie müssen auch ändern mdsWsHTTPBinding , damit sie auch für SSL konfiguriert ist, und kommentieren Sie den Abschnitt ohne SSL aus.

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

4. Testen Sie die Veröffentlichung von Metadaten, indem Sie zur Dienst-URL navigieren, z. B.: http://yourserver/MDS/service/service.svc. Wenn die Metadatenveröffentlichung aktiviert ist, wird eine Seite angezeigt, die mit
   "Sie haben einen Dienst erstellt."

Erstellen von Proxyklassen mithilfe von Visual Studio

Wenn Sie Visual Studio 2010 installiert haben, besteht die einfachste Möglichkeit zum Generieren von Proxyklassen darin, Ihrem Projekt einen Dienstverweis hinzuzufügen. Die Adresse des Dienstverweises ist die URL der Master Data Manager-Webanwendung, angefügt mit "/service/service.svc". Beispiel: http://yourserver/MDS/service/service.svc. Weitere Informationen finden Sie unter How to: Add, Update, or Remove a Service Reference.

Erstellen von Proxyklassen mithilfe von 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.

Um einen Satz von C#-Proxyklassen mithilfe von Svcutil.exezu erstellen, verwenden Sie einen Befehl wie den folgenden:

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  

Ort:

• 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 Managers in Internetinformationsdienste (IIS).

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

Siehe auch

Kategorisierte Webdienstvorgänge (Master Data Services)