Acessando a API SOAP

  • Artigo

O serviço Web Serviço de Relatório usa o SOAP sobre HTTP e age como uma interface de comunicações entre programas cliente e o servidor de relatório. O serviço Web oferece dois pontos de extremidade - um para a execução de relatórios e outro para o gerenciamento de relatórios - e consiste em métodos e em um conjunto de objetos de tipo complexo que podem ser usados para o acesso da funcionalidade completa do Reporting Services. Para chamar o serviço, referencie a WSDL (Reporting Services Web Services Description Language).

Fazer referência ao WSDL do Reporting Services

Para chamar um serviço Web com êxito, você precisa saber como acessá-lo, a que operações ele dá suporte, que parâmetros ele espera e o que ele retorna. A WSDL oferece essas informações em um documento XML que pode ser lido ou processado por um computador.

Os serviços Web do Servidor de Relatório são expostos em três pontos de extremidade diferentes. O nome do arquivo WSDL é diferente para cada ponto de extremidade. O ponto de extremidade ReportService2010 contém métodos para gerenciar objetos em um Servidor de Relatório em modo nativo ou integrado do SharePoint. A WSDL para esse ponto de extremidade é acessada por meio do ReportService2010.asmx?wsdl..

Observação

Os pontos de extremidade ReportService2005 e ReportService2006 foram preteridos no SQL Server 2008 R2 (10.50.x). O ponto de extremidade ReportService2010 inclui as funcionalidades dos dois pontos de extremidade e contém recursos de gerenciamento adicionais.

  • O ponto de extremidade ReportExecution2005 permite que os desenvolvedores processem e renderizem relatórios programaticamente em um Servidor de Relatório. A WSDL para esse ponto de extremidade é acessada por meio de ReportExecution2005.asmx?wsdl.

A WSDL pode ser consumida por kits de desenvolvimento que dão suporte a SOAP e a serviços Web, como o SDK do Microsoft .NET Framework.

O exemplo a seguir mostra o formato da URL para o arquivo WSDL de gerenciamento do Reporting Services:

https://server/reportserver/ReportService2010.asmx?wsdl

A tabela a seguir descreve cada elemento da URL.

Elemento da URL Descrição
server O nome do servidor no qual o servidor de relatório é implantado.
reportserver O nome da pasta que contém o serviço Web XML. Configurado durante a instalação.
<endpoint name>.asmx O nome do ponto de extremidade do serviço web.

Para saber mais sobre o formato WSDL, veja a especificação de WSDL feita pelo W3C (World Wide Web Consortium) em http://www.w3.org/TR/wsdl.

Conteúdo relacionado

Criando aplicativos usando o serviço Web e o .NET Framework
Serviço Web do Servidor de Relatório