Partilhar via

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

  • Artigo

O serviço Web 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 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:

  1. Abra o arquivo de Master Data Services Web.config 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 como httpGetEnabledtrue.

    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.

  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, 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 Master Data Manager, acrescentada a /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 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 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 no IIS (Serviços de Informações da Internet).

  • proxy_name é o nome do arquivo proxy gerado.

Consulte Também

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