• Artigo

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.