Crear clases de proxy del servicio web Master Data Manager

  • Artículo

El servicio web Administrador de datos maestros le permite usar las características de Master Data Services mediante programación desde cualquier equipo que pueda acceder a su sitio web de Administrador de datos maestros. 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 Microsoft.MasterDataServices.ServiceClient, que implementa la interfaz Microsoft.MasterDataServices.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 Web.config de Master Data Services en un editor de texto. Este archivo se encuentra en la carpeta WebApplication de la ruta de instalación de Master Data Services.

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

    [!NOTA]

    Si desea habilitar los servicios web sobre la capa de (SSL) sockets seguros, establezca httpsGetEnabled a true en la sección de mdsWsHttpBehavior de archivo web.config. También debe cambiar mdsWsHTTPBinding para configurarlo para SSL y comentar la sección que no es de SSL.

  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, http://suservidor/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 simple de generar clases de proxy es agregar una referencia de servicio a su proyecto. La dirección de la referencia de servicio es la URL de la aplicación de Administrador de datos maestros, seguida de /service/service.svc. Por ejemplo: http://suservidor/MDS/service/service.svc. Para obtener más información, vea Cómo: Agregar, actualizar o quitar una referencia de servicio.

Crear clases de proxy usando Svcutil.exe

Debe haber instalado Microsoft Visual Studio o el SDK de Windows Microsoft para tener Svcutil.exe en su equipo. Si utiliza Visual Studio, debe utilizar el símbolo del sistema de Visual Studio para ejecutar el comando. Para obtener 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 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

Donde:

  • servername:port son el nombre de equipo y número de puerto del equipo que hospeda a Administrador de datos maestros.

  • virtual_path es la ruta de acceso virtual de Administrador de datos maestros en Internet Information Services (IIS).

  • proxy_name es el nombre del archivo de proxy generado.

Vea también

Conceptos

Operaciones de servicio web clasificadas (Master Data Services)