Acesso à URL (SSRS)

O acesso à URL do servidor de relatório do SQL Server Reporting Services (SSRS) permite enviar comandos a um servidor de relatório por meio de uma solicitação de URL. Por exemplo, você pode personalizar a renderização de um relatório em um servidor de relatório em modo nativo ou em uma biblioteca do SharePoint. Você pode exibir o relatório usando um conjunto específico de valores de parâmetros de relatório ou exibir uma página específica de interesse do relatório. Você pode encapsular essas informações na URL usando parâmetros de acesso à URL predefinidos. Você pode personalizar ainda mais como o servidor de relatório processa o relatório inserindo parâmetros de renderização de formatos ou de aparência do visualizador de relatórios. Você pode colar essa URL diretamente em um email ou página da Web para permitir que outros acessem seu relatório da mesma maneira no navegador.

Outras ações que você pode executar por acesso à URL são:

• Enviar comandos ao visualizador de HTML, como ajuste de aparência

• Listar os itens filho de uma pasta de catálogo

• Recuperar a definição de XML de um item de catálogo

• Renderizar um instantâneo de histórico de relatório específico

• Gerenciar sessões de relatório

Para conferir a lista completa de comandos e configurações disponíveis por acesso à URL, consulte Referência de parâmetro de acesso de URL.

Conceitos do acesso à URL

As solicitações de URL ao servidor de relatório contêm parâmetros processados pelo servidor de relatório. A forma como o servidor de relatório manipula as solicitações de URL dependerá dos parâmetros, dos prefixos de parâmetro e dos tipos de item incluídos na URL. As URLs dos servidores de relatório aderem às diretrizes de formatação de URL propostas pelo padrão de rascunho do consórcio W3C/IETF. A funcionalidade de URL do Reporting Services é compatível com a maioria dos navegadores de Internet ou dos aplicativos que dão suporte ao endereçamento de URL padrão.

Sintaxe do acesso à URL

As solicitações de URL podem conter vários parâmetros listados em qualquer ordem. Os parâmetros são separados por um E comercial (&) e os pares de nome/valor são separados por um sinal de igualdade (=).

rswebserviceurl 
            ?reportpath
            [&prefix:param=value]...n]

Descrição da sintaxe

• rswebserviceurl
  A URL do serviço Web do servidor de relatório. No modo nativo, é a URL do serviço Web da instância de servidor de relatório configurada no Gerenciador de Configurações do Reporting Services (consulte Configurar URLs do Servidor de Relatório). Por exemplo:

  http://myrshost/reportserver
  https://machine.adventure-works.com/reportserver_MYNAMEDINSTANCE
  

  No modo integrado do SharePoint, é a URL do proxy do Reporting Services em um site do SharePoint integrado ao Reporting Services. Por exemplo:

  http://myspsite/subsite/_vti_bin/reportserver
  

  Dica
  É importante que a URL inclua a sintaxe do proxy _vti_bin para rotear a solicitação através do SharePoint e do proxy HTTP Reporting Services. O proxy adiciona qualquer contexto à solicitação HTTP, o contexto necessário para garantir a execução adequada do relatório para servidores de relatório no modo do SharePoint.

• pathinfo
  O nome do caminho relativo do item no banco de dados do servidor de relatório no modo nativo ou a URL totalmente qualificada do item em um catálogo do SharePoint.

  O caminho do item de catálogo. No modo nativo, é o caminho relativo do item no banco de dados do servidor de relatório, que começa com uma barra (/). Por exemplo:

  /AdventureWorks 2008R2/Employee_Sales_Summary_2008R2
  

  No modo integrado do SharePoint, é a URL totalmente qualificada do item na biblioteca do SharePoint, incluindo a extensão do item. Por exemplo:

  http://myspsite/subsite/AdventureWorks 2008R2/Employee_Sales_Summary_2008R2.rdl
  

• &
  Usado para separar os pares de nome e valor dos parâmetros de acesso à URL.

• prefixo
  Opcional. Um prefixo do parâmetro de acesso à URL (por exemplo, rs: ou rc:) que acessa um processo específico executado no servidor de relatório.

  Observação
  Se um prefixo de um parâmetro de acesso à URL não for incluído, o parâmetro será processado pelo servidor de relatório como um parâmetro de relatório. Os parâmetros de relatório não usam um prefixo de parâmetro e diferenciam maiúsculas de minúsculas.

• param
  O nome do parâmetro.

• value
  O texto da URL correspondente ao valor do parâmetro usado.

Observação: para obter uma lista dos parâmetros de acesso a URL disponíveis, consulte Referência de parâmetro de acesso de URL. Para obter exemplos de como transmitir parâmetros de relatório na URL, consulte Transmitir um parâmetro de relatório em uma URL.

Tarefas relacionadas

Consulte também

Referência

Referência de parâmetro de acesso de URL

Conceitos

Transmitir um parâmetro de relatório em uma URL

Localizando, exibindo e gerenciando relatórios (Construtor de Relatórios e SSRS)

Outros recursos

Integrando o Reporting Services por meio do acesso à URL