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

O serviço Web do Master Data Manager permite que você faça 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 escrever código para acessar o serviço Web, você deve gerar classes proxy. A classe proxy principal usada para executar operações de serviço Web é a ServiceClient classe, que implementa a IService interface.

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

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

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

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

   Observação

   Se você quiser habilitar os serviços Web em SSL (Secure Sockets Layer), defina httpsGetEnabledtrue na mdsWsHttpBehavior seção do arquivo web.config. Você também precisa alterar mdsWsHTTPBinding para que ele esteja configurado para SSL e comente a seção não SSL.

3. Salve as alterações no arquivo.

4. Teste a publicação de metadados navegando até 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, a maneira mais simples de gerar classes proxy é adicionar uma Referência de Serviço ao seu projeto. O endereço da referência de serviço é a URL do aplicativo Web Master Data Manager, acrescentada 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 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 ServiceModel Metadata Utility Tool (Svcutil.exe) e Generating a WCF Client from Service Metadata.

Para criar um conjunto de classes proxy C# usando Svcutil.exe, use 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  

Em que:

• servername:port são o nome do computador e o 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

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