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

Artigo
07/04/2024

Aplica-se a: SQL Server – somente Windows Instância Gerenciada de SQL do Azure

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 o 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 ServiceClient, que implementa a interface 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 do 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

Se você quiser habilitar os serviços Web por meio do TLS (Transport Layer Security), anteriormente conhecido como SSL (Secure Sockets Layer), 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.
Salve as alterações no arquivo.
Teste a publicação de metadados navegando para 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 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 de serviço é a URL do aplicativo Web do 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 proxy usando Svcutil.exe

Você deve ter o Microsoft Visual Studio ou o SDK do Microsoft Windows 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 Ferramenta de utilitário de metadados ServiceModel (Svcutil.exe)Gerando um cliente WCF de metadados do serviço.

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

Confira também

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

Partilhar via