Crear clases de proxy del servicio web Master Data Manager

  • Artículo

Se aplica a:SQL Server: solo Windows Azure SQL Managed Instance

El servicio web Master Data Manager le permite usar mediante programación las características de Master Data Services desde cualquier equipo que pueda acceder al sitio web de Master Data Manager. Antes de empezar a escribir código para acceder al servicio web, debe generar clases de proxy. La clase de proxy principal que utiliza para realizar operaciones del servicio web es la clase ServiceClient, que implementa la interfaz IService.

Habilitar la publicación de metadatos del servicio web

Para poder generar clases de proxy, debe habilitar la publicación de metadatos del servicio web. Para ello, siga estos pasos:

  1. Abra el archivo Master Data Services Web.config en un editor de texto. Este archivo se encuentra en la carpeta WebApplication de la ruta de acceso de instalación de Master Data Services.

  2. Busque la sección mdsWsHttpBehavior en <serviceBehaviors>. Para el <elemento serviceMetadata> , establezca httpGetEnabled entrue.

    Nota

    Si desea habilitar servicios web a través de Seguridad de la capa de transporte (TLS), anteriormente conocido como Capa de sockets seguros (SSL), establezca httpsGetEnabled en true en la sección mdsWsHttpBehavior del archivo web.config. También debe cambiar mdsWsHTTPBinding para que esté configurado para TLS, así como comentar la sección que no es TLS.

  3. Guarde los cambios realizados en el archivo.

  4. Pruebe la publicación de metadatos yendo a la dirección URL del servicio (por ejemplo, https://yourserver/MDS/service/service.svc). Si la publicación de metadatos está habilitada, se muestra una página que empieza con
    "Ha creado un servicio".

Crear clases de proxy usando Visual Studio

Si tiene instalado Visual Studio 2010, la manera más sencilla de generar clases de proxy consiste en agregar una referencia de servicio al proyecto. La dirección de la referencia de servicio es la dirección URL de la aplicación web master Data Manager, anexada a /service/service.svc. Por ejemplo: https://yourserver/MDS/service/service.svc. Para más información, vea Cómo: Agregar, actualizar o quitar una referencia de servicio.

Crear clases de proxy usando Svcutil.exe

Debe tener Microsoft Visual Studio o el Microsoft Windows SDK instalado para tener Svcutil.exe en el equipo. Si usa Visual Studio, debe usar el símbolo del sistema de Visual Studio para ejecutar el comando. Para más información, vea Herramienta de utilidad de metadatos de ServiceModel (Svcutil.exe) y Generación de un cliente WCF a partir de los metadatos de servicio.

Para crear un conjunto de clases de proxy en C# usando Svcutil.exe, utilice un comando como el siguiente:

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

Donde:

  • servername:port son el nombre de equipo y el número de puerto del equipo que hospeda Master Data Manager.

  • virtual_path es la ruta de acceso virtual de Master Data Manager en Internet Information Services (IIS).

  • proxy_name es el nombre del archivo de proxy generado.

Consulte también

Operaciones de servicio web clasificadas (Master Data Services)