Compartilhar via

Acesso à URL (SSRS)

O acesso à URL do servidor de relatório no SSRS (SQL Server Reporting Services) permite que você envie comandos para 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 de modo nativo ou em uma biblioteca do SharePoint. Você pode ter visualizado o relatório usando um conjunto específico de valores de parâmetro de relatório ou pode ter exibido uma página específica de interesse no relatório. Você pode encapsular essas informações na URL usando parâmetros de acesso de URL predefinidos. Você pode personalizar ainda mais como o servidor de relatório processa o relatório inserindo parâmetros para formatos de renderização ou para a aparência do visualizador de relatórios. Em seguida, você pode colar essa URL diretamente em um email ou página da Web para permitir que outras pessoas acessem seu relatório da mesma maneira no navegador.

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

  • Enviar comandos para o visualizador HTML, como ajustar sua aparência

  • Listar os filhos de uma pasta de catálogo

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

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

  • Gerenciar sessões de relatório

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

Conceitos de acesso à URL

As solicitações de URL para o servidor de relatório contêm parâmetros que são processados pelo servidor de relatório. A maneira como o servidor de relatório lida com solicitações de URL depende dos parâmetros, prefixos de parâmetro e tipos de itens incluídos na URL. As URLs do servidor de relatório aderem às diretrizes de formatação de URL conforme o padrão de rascunho conjunto proposto pelo World Wide Web Consortium (W3C) e pelo IETF. A funcionalidade de URL do Reporting Services é compatível com a maioria dos navegadores ou aplicativos da Internet que dão suporte ao endereçamento de URL padrão.

Sintaxe de acesso à URL

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

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

Descrição da sintaxe

rswebserviceurl
A URL do serviço Web do servidor de relatório. Para o 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 (consulte Configurar URLs do Servidor de Relatório (SSRS Configuration Manager)). Por exemplo:

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

Para o 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 em modo nativo, ou a URL totalmente qualificada do item em um catálogo do SharePoint.

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

/AdventureWorks 2008R2/Employee_Sales_Summary_2008R2

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

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

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

prefixo
Opcional. Um prefixo para o parâmetro de acesso à URL (por exemplo, rs: ou rc:) que acessa um processo específico em execução no servidor de relatório.

Observação

Se um prefixo para um parâmetro de acesso à URL não estiver 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 fazem distinção entre maiúsculas e minúsculas.

param
O nome do parâmetro.

valor
Texto de URL correspondente ao valor do parâmetro que está sendo usado.

Nota: Para obter uma lista dos parâmetros de acesso à URL disponíveis, consulte Referência de parâmetro de acesso à URL. Para obter exemplos que passam parâmetros de relatório na URL, consulte Passar um parâmetro de relatório dentro de uma URL.

Descrições da tarefa Links
Acesse itens do servidor de relatório, como relatórios, fontes de dados compartilhadas e recursos. Acessar itens do servidor de relatório usando o acesso à URL
Passe parâmetros de relatório para um relatório. Passar um parâmetro de relatório dentro de uma URL
Defina a localidade dos parâmetros de relatório na cadeia de caracteres de acesso à URL, que define as interpretações específicas da localidade de datas, moedas e assim por diante. 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 do dispositivo em uma URL
Exporte um relatório diretamente para um formato de arquivo sem exibi-lo no navegador. Exportar um relatório usando o acesso à URL
Abra um relatório e navegue diretamente até o local de uma cadeia de caracteres. Pesquisar um relatório usando o acesso à URL
Renderize um instantâneo específico do histórico de relatórios. Renderizar um instantâneo do histórico de relatórios usando o acesso à URL

Consulte Também

Passar um parâmetro de relatório dentro de uma URL
Referência de parâmetro de acesso à URL
Integrando os Serviços de Relatórios usando Acesso à URL
Localizando, exibindo e gerenciando relatórios (Construtor de Relatórios e SSRS)

  • Last updated on