Partilhar via

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. Essa funcionalidade permite personalizar a forma de renderizar relatórios em um servidor de relatório de modo nativo ou em uma biblioteca do SharePoint. Por exemplo, 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 definir esses parâmetros em uma URL usando parâmetros de acesso de URL predefinidos.

Você pode personalizar como o servidor de relatório processa o relatório incluindo parâmetros de renderização de formatos ou especificando a aparência do visualizador de relatórios. Em seguida, você pode enviar essa URL para outras pessoas para que elas possam acessar seu relatório da mesma maneira no navegador.

Outras ações que você pode executar por acesso à URL incluem:

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 World Wide Web Consortium 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. Você separa os parâmetros usando um E comercial (&) e os pares de nome/valor com um sinal de igual (=).

Compreender os diferentes componentes de uma cadeia de caracteres de acesso à URL é essencial para enviar comandos com eficiência para um servidor de relatório do SSRS. A cadeia de caracteres de acesso à URL inclui:

  • https://[rswebserviceurl]: a URL do serviço Web do servidor de relatório.
  • ?: indica o início da cadeia de caracteres de consulta que contém os parâmetros.
  • [pathinfo]: o caminho para o relatório ou item no servidor.
  • [&prefix:param=value]: um ou mais parâmetros com prefixos opcionais que personalizam a renderização ou o comportamento do relatório.
https://[rswebserviceurl]?[pathinfo][&prefix:param=value]...[&prefix:param=value]

Descrição da sintaxe

A seção a seguir fornece uma descrição detalhada de alguns parâmetros usados na cadeia de caracteres de acesso à URL. Para obter uma lista completa, consulte Referência de parâmetro de acesso à URL.

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 do serviço Web configurada no Gerenciador de Configurações do Reporting Services. Para obter mais informações, confira Configurar URLs do Sservidor 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

&prefix:param=value

Em uma cadeia de caracteres de acesso à URL, você adiciona parâmetros e seus valores correspondentes para personalizar a renderização ou o comportamento do relatório. Você constrói parâmetros em pares de nome/valor usando a sintaxe param=value, separados por um E comercial (&).

Use prefixos opcionais como rs: ou rc: para direcionar processos específicos 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.

O exemplo a seguir mostra a URL completa, conforme descrito neste artigo:

https://myrshost/reportserver?/AdventureWorks2022/Employee_Sales_Summary_2022&rs:Command=Render&rc:Toolbar=false&ReportMonth=3&ReportYear=2008

Conteúdo relacionado