Skip to content

Latest commit

 

History

History
57 lines (39 loc) · 4.29 KB

create-master-data-manager-web-service-proxy-classes.md

File metadata and controls

57 lines (39 loc) · 4.29 KB
Raw
title description author ms.author ms.date ms.service ms.subservice ms.topic
Create Master Data Manager Web Service Proxy Classes
Create Master Data Manager Web Service Proxy Classes
CordeliaGrey
jiwang6
03/17/2017
sql
master-data-services
reference

Create Master Data Manager Web Service Proxy Classes

[!INCLUDE SQL Server Windows Only - ASDBMI]

The [!INCLUDEssMDSmdm] web service lets you make programmatic use of the features of [!INCLUDEssMDSshort] from any computer that can access your [!INCLUDEssMDSmdm] web site. Before you can start writing code to access the web service, you must generate proxy classes. The main proxy class you use to perform web service operations is the xref:Microsoft.MasterDataServices.ServiceClient class, which implements the xref:Microsoft.MasterDataServices.IService interface.

Enable Web Service Metadata Publishing

Before you can generate proxy classes, you must enable web service metadata publishing. Follow these steps to do this:

  1. Open the [!INCLUDEssMDSshort] Web.config file in a text editor. This file is in the WebApplication folder of the [!INCLUDEssMDSshort] installation path.

  2. Find the mdsWsHttpBehavior section under <serviceBehaviors>. For the <serviceMetadata> element, set httpGetEnabled to true.

    [!NOTE]
    If you want to enable Web services over Transport Layer Security (TLS), previously known as Secure Sockets Layer (SSL), set httpsGetEnabled to true in the mdsWsHttpBehavior section of the web.config file. You also need to change mdsWsHTTPBinding so that it is configured for TLS, as well, and comment out the non-TLS section.

  3. Save changes to the file.

  4. Test metadata publishing by browsing to the service URL, for example: https://yourserver/MDS/service/service.svc. If metadata publishing is enabled, a page is displayed that begins with
    "You have created a service."

Creating Proxy Classes by Using Visual Studio

If you have Visual Studio 2010 installed, the simplest way to generate proxy classes is to add a Service Reference to your project. The address of the service reference is the URL of the [!INCLUDEssMDSmdm] web application, appended with /service/service.svc. For example: https://yourserver/MDS/service/service.svc. For more information, see How to: Add, Update, or Remove a Service Reference.

Creating Proxy Classes by Using Svcutil.exe

You must have either [!INCLUDEmsCoName] [!INCLUDEvsprvs] or the [!INCLUDEmsCoName] Windows SDK installed in order to have Svcutil.exe on your computer. If you use [!INCLUDEvsprvs], you must use the [!INCLUDEvsprvs] command prompt to run the command. For more information, see ServiceModel Metadata Utility Tool (Svcutil.exe) and Generating a WCF Client from Service Metadata.

To create a set of C# proxy classes by using Svcutil.exe, use a command such as the following:

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

Where:

  • servername:port are the computer name and port number of the computer that hosts [!INCLUDEssMDSmdm].

  • virtual_path is the virtual path of [!INCLUDEssMDSmdm] in Internet Information Services (IIS).

  • proxy_name is the name for the generated proxy file.

See Also

Categorized Web Service Operations (Master Data Services)