Acessando a API SOAP
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).
Referenciando a 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.
O serviço Web Servidor de Relatório é exibido em dois pontos de extremidade diferentes. O nome do arquivo WSDL é diferente para cada ponto de extremidade. O ponto de extremidade ReportService2005 contém métodos para o gerenciamento de objetos em um Servidor de Relatório. A WSDL para esse ponto de extremidade é acessada por meio de ReportService2005.asmx?wsdl.
- 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/ReportService2005.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. |
<nome do ponto de extremidade>.asmx |
O nome do ponto de extremidade do serviço web. |
Para obter mais informações sobre o formato WSDL, consulte a especificação de WSDL feita pelo W3C (World Wide Web Consortium em http://www.w3.org/TR/wsdl.
Consulte também