Criar classes proxy do serviço Web do Master Data Manager

Artigo
05/07/2013

O serviço Web Master Data Manager permite a você fazer uso programático dos recursos do Master Data Services de qualquer computador que possa acessar seu site do Master Data Manager. Antes de começar a gravar código para acessar o serviço Web, você deve gerar classes proxy. A classe proxy principal que você usa para executar operações de serviço Web é a classe Microsoft.MasterDataServices.ServiceClient, que implementa a interface Microsoft.MasterDataServices.IService.

Habilitar a publicação de metadados de serviço Web

Antes de gerar classes proxy, você deve habilitar a publicação de metadados de serviço Web. Siga estas etapas para fazer isso:

Abra o arquivo Web.config do Master Data Services em um editor de texto. Esse arquivo está na pasta WebApplication, no caminho de instalação do Master Data Services.

Localize a seção mdsWsHttpBehavior em <serviceBehaviors>. Para o elemento <serviceMetadata>, defina httpGetEnabled como true.

Observação
Entretanto, se quiser habilitar serviços Web sobre protocolo SSL (Secure Sockets Layer), defina httpsGetEnabled como true na seção mdsWsHttpBehavior do arquivo web.config. Você também precisa alterar o mdsWsHTTPBinding para que ele seja configurado para SSL, também, e faça um comentário da seção não SSL.

Salve as alterações no arquivo.
Teste a publicação de metadados navegando para a URL do serviço, por exemplo: http://yourserver/MDS/service/service.svc. Se a publicação de metadados estiver habilitada, será exibida uma página que começa com “Você criou um serviço”.

Criando classes proxy usando o Visual Studio

Se você tiver o Visual Studio 2010 instalado, o modo mais simples de gerar classes proxy será adicionar uma Referência de Serviço ao seu projeto. O endereço da referência do serviço é a URL do aplicativo Web Master Data Manager, com /service/service.svc. Por exemplo: http://yourserver/MDS/service/service.svc. Para obter mais informações, consulte Como adicionar, atualizar ou remover uma referência de serviço.

Criando classes proxy usando Svcutil.exe

Você deve ter o Microsoft Visual Studio ou o Microsoft Windows SDK instalado para ter o Svcutil.exe em seu computador. Se você usar o Visual Studio, deverá usar o prompt de comando do Visual Studio para executar o comando. Para obter mais informações, consulte Ferramenta de utilitário de metadados ServiceModel (Svcutil.exe) e Gerando um cliente WCF a partir de metadados do serviço.

Para criar um conjunto de classes proxy C# usando Svcutil.exe, utilize um comando como o seguinte:

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

Onde:

servername:port são o nome do computador e número da porta do computador que hospeda o Master Data Manager.
virtual_path é o caminho virtual do Master Data Manager nos Serviços de Informações da Internet (IIS).
proxy_name é o nome do arquivo proxy gerado.

Consulte também

Conceitos

Operações de serviço Web categorizadas (Master Data Services)

Compartilhar via