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

 

Gilt für: SQL Server 2016 Preview

Der Master Data Manager -Webdienst ermöglicht die programmgesteuerte Verwendung der Funktionen von Master Data Services an jedem Computer, der auf die 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 auszuführen, ist die Microsoft.MasterDataServices.ServiceClient Klasse implementiert die Microsoft.MasterDataServices.IService Schnittstelle.

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

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

  2. Suchen der MdsWsHttpBehavior Handlerbereich unter dem ** <> </> > **. Für die ** <> > ** -Elementgruppe, HttpGetEnabled auf "true".

    System_CAPS_ICON_note.jpg Hinweis


    Wenn Sie Webdienste über Secure Sockets Layer (SSL) aktivieren möchten, legen Sie HttpsGetEnabled auf "true" in der MdsWsHttpBehavior Abschnitt der Datei "Web.config". Sie müssen auch ändern MdsWsHTTPBinding , damit sie für SSL, ebenfalls, und kommentieren Sie den Abschnitt "nicht-SSL" konfiguriert ist.

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

  4. Testen Sie die Metadaten-Veröffentlichung durch Navigieren zur Dienst-URL, beispielsweise "http://ihrserver/MDS/service/service.svc". Ist die Metadaten-Veröffentlichung aktiviert, wird eine Seite angezeigt. Diese beginnt mit:
    "Sie haben einen Dienst erstellt."

Wenn Sie Visual Studio 2010 installiert haben, ist die einfachste Methode zum Generieren von Proxyklassen Hinzufügen einer Dienstverweis zu Ihrem Projekt. Die Adresse des Dienstverweises ist die URL der Master Data Manager-Webanwendung, wobei "/service/service.svc" angefügt wird. Beispiel: http://ihrserver/MDS/service/service.svc. Weitere Informationen finden Sie unter wie: hinzufügen, aktualisieren oder Entfernen eines Dienstverweises.

Benötigen Sie entweder Microsoft Visual Studio oder Microsoft Windows SDK installiert, um Svcutil.exe auf Ihrem Computer verfügen. Wenn Sie Visual Studio verwenden, müssen Sie den Befehl über die Visual Studio-Eingabeaufforderung ausfü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 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:

  • Servername:Port dem Computernamen und die Portnummer des Computers, auf dem gehostet Master Data Manager.

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

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

Kategorisierte Webdienstvorgänge (Master Data Services)

Community-Beiträge

Anzeigen: