Pontos de extremidade do serviço Web Servidor de Relatórios

Artigo
05/07/2013

O serviço Web Servidor de Relatórios fornece vários pontos de extremidade para gerenciar um servidor de relatório como também executar relatórios e navegar neles.

Pontos de extremidade de gerenciamento

Existem três pontos de extremidade disponíveis para o gerenciamento de objetos em um servidor de relatório: ReportService2005, ReportService2006 e ReportService2010. O ponto de extremidade ReportService2005 é usado para gerenciar objetos em um servidor de relatório que está configurado para o modo nativo. O ponto de extremidade ReportService2006 é usado para gerenciar objetos em um servidor de relatório que está configurado para o modo integrado do SharePoint. O ponto de extremidade ReportService2010 mescla as funcionalidades do ReportService2005 e do ReportService2006 e pode gerenciar objetos em um servidor de relatório configurado para modo nativo ou integrado do SharePoint.

Importante
Quando um servidor de relatório estiver configurado para o modo integrado do SharePoint, as APIs ReportService2005 retornarão um erro rsOperationNotSupportedSharePointMode. Se o servidor de relatório estiver configurado para o modo nativo, as APIs do ReportService2006 retornarão um erro rsOperationNotSupportedNativeMode. Da mesma forma, quando APIs específicas ao modo no ReportService2010 forem usadas em modos sem finalidade, as APIs retornarão os respectivos erros.

Quando um servidor de relatório estiver configurado para o modo integrado do SharePoint, as APIs ReportService2005 retornarão um erro rsOperationNotSupportedSharePointMode. Se o servidor de relatório estiver configurado para o modo nativo, as APIs do ReportService2006 retornarão um erro rsOperationNotSupportedNativeMode. Da mesma forma, quando APIs específicas ao modo no ReportService2010 forem usadas em modos sem finalidade, as APIs retornarão os respectivos erros.

Observação
Os pontos de extremidade ReportService2005 e ReportService2006 foram preteridos no SQL Server 2008 R2. O ponto de extremidade ReportService2010 inclui as funcionalidades dos dois pontos de extremidade e contém recursos de gerenciamento adicionais.

Se o servidor de relatório estiver configurado para o modo nativo ou o modo integrado do SharePoint, o WSDL do ponto de extremidade de gerenciamento poderá ser acessado por meio de uma das seguintes URLs:

http://<Server Name>/ReportServer/ReportService2010.asmx?wsdl

Para obter mais informações, consulte Acessando a API SOAP.

Ponto de extremidade de execução

O ponto de extremidade do ReportExecution2005 permite que os desenvolvedores personalizem o processamento e a renderização do relatório de forma mais fácil em um servidor de relatório tanto no modo nativo como no integrado do SharePoint. O ponto de extremidade inclui classes e métodos que existiram em versões anteriores do serviço Web Servidor de Relatórios. Além disso, muitas classes e métodos novos foram adicionados ao serviço Web Servidor de Relatórios que foram expostos por meio do ponto de extremidade de execução.

O WSDL para o ponto de extremidade de gerenciamento pode ser acessado através desta URL:

http://<Server Name>/ReportServer/ReportExecution2005.asmx?wsdl

Se o servidor de relatório for configurado para o modo de integração do SharePoint, o WSDL poderá ser acessado por meio da URL a seguir:

http://<Server Name>/<Site Name>/_vti_bin/ReportServer/ReportExecution2005.asmx?wsdl

Para obter mais informações, consulte Acessando a API SOAP.

Pontos de extremidade de proxy do SharePoint

Quando um servidor de relatório for configurado para o modo integrado do SharePoint e o Suplemento Reporting Services tiver sido instalado, um conjunto de pontos de extremidade de proxy será instalado no servidor do SharePoint. Os pontos de extremidade de proxy são a API primária para desenvolver soluções de relatório quando um servidor de relatório é configurado para o modo integrado do SharePoint. Quando você estiver desenvolvendo soluções nos pontos de extremidade de proxy, o Suplemento Reporting Services gerenciará a troca de credenciais entre o SharePoint Server e o servidor de relatório no modo de autenticação de conta confiável. Quando você estiver desenvolvendo soluções nos pontos de extremidade do servidor de relatório, o aplicativo de chamada terá que gerenciar a troca de credencial no modo de autenticação de conta confiável. A tabela a seguir lista os pontos de extremidade que são instalados com o Suplemento Reporting Services.

ReportService2006

Fornece as APIs para gerenciar um servidor de relatório que é configurado para o modo de integração do SharePoint.

Observação
Esse ponto de extremidade foi preterido no SQL Server 2008 R2.

ReportService2010

Fornece as APIs para gerenciamento de um servidor de relatório configurado para o modo nativo ou o modo integrado do SharePoint.

ReportExecution2005

Fornece as APIs para executar relatórios e navegar neles.

ReportServiceAuthentication

Fornece as APIs para autenticar os usuários de um servidor de relatório quando o aplicativo Web do SharePoint é configurado para Autenticação de Formulários.

A seguir são apresentadas URLs de exemplo para referenciar os pontos de extremidade de proxy em um site do SharePoint.

http://<Server Name>/<Site Name>/_vti_bin/ReportServer/ReportService2010.asmx

http://<Server Name>/<Site Name>/_vti_bin/ReportServer/ReportExecution2005.asmx

http://<Server Name>/<Site Name>/_vti_bin/ReportServer/ReportServiceAuthentication.asmx

Consulte também

Outros recursos

Criando aplicativos que usam o serviço Web e o .NET Framework

Partilhar via