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

Aplica-se a:SQL Server no Windows Azure SQL Managed Instance

O serviço Web Master Data Manager permite que você faça uso programático dos recursos do Master Data Services a partir 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 principal classe de proxy que você usa para executar operações de serviço Web é a ServiceClient classe, que implementa a IService interface.

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

Antes de gerar classes de proxy, você deve habilitar a publicação de metadados de 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. Encontre a seção mdsWsHttpBehavior em <serviceBehaviors>. Para o <elemento serviceMetadata> , defina httpGetEnabled como true.

   Observação

   Se você quiser habilitar serviços da Web sobre Transport Layer Security (TLS), anteriormente conhecido como Secure Sockets Layer (SSL), defina httpsGetEnabled como true na seção mdsWsHttpBehavior do arquivo web.config. Você também precisa alterar mdsWsHTTPBinding para que ele também seja configurado para TLS e comentar a seção não-TLS.

3. Salve as alterações no arquivo.

4. Teste a publicação de metadados navegando até a URL do serviço, por exemplo: https://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 de 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, anexado com /service/service.svc. Por exemplo: https://yourserver/MDS/service/service.svc. Para obter mais informações, consulte Como adicionar, atualizar ou remover uma referência de serviço.

Criando classes de proxy usando Svcutil.exe

Você deve ter o Microsoft Visual Studio ou o SDK do Microsoft Windows instalado para ter Svcutil.exe no seu computador. Se você usar o Visual Studio, você deve 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 Gerando um cliente WCF a partir de metadados de serviço.

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

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  

Onde:

• 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 no IIS (Serviços de Informações da Internet).

• proxy_name é o nome do arquivo proxy gerado.

Ver também

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