Acesso à URL (SSRS)

  • Artigo

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 de acesso à URL

O servidor de relatório processa parâmetros contidos nas solicitações de URL 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. O 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 do servidor de relatório configurada no Gerenciador de Configurações do Reporting Services (confira Configurar as URLs do servidor de relatório (Gerenciador de Configurações do Servidor de Relatório)). Por exemplo:

https://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:

https://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:

/AdventureWorks2022/Employee_Sales_Summary_2022

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

https://myspsite/subsite/AdventureWorks2022/Employee_Sales_Summary_2022.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 à URL disponíveis, confira a Referência de parâmetros de acesso à URL. Para ver exemplos de como transmitir parâmetros de relatório na URL, confira Passar um parâmetro de relatório em uma URL.

Descrições das tarefas Links
Acessar itens do servidor de relatório, como relatórios, fontes de dados compartilhadas e recursos. Acessar itens de servidor de relatório usando o acesso à URL
Transmitir parâmetros de relatório a um relatório. Passar um parâmetro de relatório em uma URL
Definir a localidade dos parâmetros de relatório na cadeia de caracteres de acesso à URL, o que define as interpretações de datas, moedas etc. específicas da localidade. Definir o idioma para parâmetros de relatório em uma URL
Enviar configurações específicas da extensão de renderização que personalizam como o relatório é renderizado. Especificar configurações de informações de dispositivo em uma URL
Exportar um relatório diretamente para um formato de arquivo sem exibi-lo no navegador. Exportar um relatório usando o acesso à URL
Abrir um relatório e navegar diretamente ao local de uma cadeia de caracteres. Pesquisar um relatório usando o acesso à URL
Renderizar um instantâneo de histórico de relatório específico. Renderizar um instantâneo de histórico de relatório usando o acesso à URL

Conteúdo relacionado