Acessando a API SOAP

O serviço Web do Servidor de Relatórios utiliza o Protocolo de Acesso a Objetos Simples (SOAP) via HTTP e atua como interface de comunicação entre os programas clientes e o servidor de relatórios. O serviço Web fornece dois endpoints – um para execução de relatórios e outro para gestão de relatórios – e consiste em métodos e um conjunto de objetos de tipo complexos que pode usar para aceder à funcionalidade completa dos Reporting Services. Para ligar para o serviço, deve consultar a Reporting Services Web Services Description Language (WSDL).

Referência ao Reporting Services WSDL

Para chamar um serviço Web com sucesso, é necessário saber como aceder ao serviço, que operações o serviço suporta, que parâmetros o serviço espera e o que o serviço devolve. O WSDL fornece esta informação num documento XML que pode ser lido ou processado por um computador.

Os serviços Web do Servidor de Relatórios são expostos em três endpoints diferentes. O nome do ficheiro WSDL é diferente para cada endpoint. O ReportService2010 endpoint contém métodos para gerir objetos num Servidor de Relatórios em modo nativo ou integrado no SharePoint. O WSDL deste endpoint é acedido através de ReportService2010.asmx?wsdl.

Note

Os ReportService2005 endpoints e ReportService2006 estão obsoletos no SQL Server 2008 R2 (10.50.x). O ReportService2010 endpoint inclui as funcionalidades de ambos os endpoints e contém funcionalidades adicionais de gestão.

  • O ReportExecution2005 endpoint permite aos programadores processar e renderizar relatórios programáticamente num Servidor de Relatórios. O WSDL deste endpoint é acedido através ReportExecution2005.asmx?wsdlde .

O WSDL pode ser consumido por kits de desenvolvimento que suportam SOAP e serviços Web, como o SDK Microsoft .NET Framework.

O exemplo seguinte mostra o formato do URL do ficheiro WSDL de gestão do Reporting Services:

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

A tabela seguinte descreve cada elemento na URL.

Elemento URL Description
servidor O nome do servidor onde o servidor de relatórios está implantado.
Reportserver O nome da pasta que contém o serviço Web XML. Isto é configurado durante a configuração.
<endpoint name.asmx> O nome do endpoint do serviço web.

Para mais informações sobre o formato WSDL, consulte a especificação WSDL do World Wide Web Consortium (W3C) em http://www.w3.org/TR/wsdl.

Conteúdo relacionado

  • Última atualização a