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

  • Artigo

Você pode passar parâmetros de relatório para um servidor de relatório do SQL Server Reporting Services (SSRS) incluindo-os em uma URL de relatório. Todos os parâmetros de consulta podem ter parâmetros de relatório correspondentes. Você passa um parâmetro de consulta para um relatório, transmitindo o parâmetro de relatório correspondente. Para obter mais informações, confira Criar uma consulta no Designer de Consultas Relacionais (Construtor de Relatórios e SSRS).

Sintaxe básica dos parâmetros

  • Os parâmetros de relatório diferenciam maiúsculas de minúsculas.
  • Para caracteres especiais:
    • Substitua todos os caracteres de espaço na cadeia da URL pelos caracteres %20.
    • Substitua quaisquer caracteres de espaço na parte do parâmetro da URL por um caractere de adição +.
    • Substitua um ponto e vírgula em qualquer parte da cadeia de caracteres pelos caracteres %3A.
  • Os navegadores normalmente lidam com a codificação de URL automaticamente, portanto, você não precisa codificar caracteres manualmente.
  • É 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. Se você não incluir a sintaxe do proxy, precisará prefixar o parâmetro com rp:.

Exemplos

Observação

A integração do SSRS ao SharePoint não está mais disponível após o SQL Server 2016.

  • Definir um parâmetro de relatório em uma URL.
    • Sintaxe: parameter=value
  • Especifique dois parâmetros definidos em um relatório.
    • Exemplo para um servidor de modo do SharePoint do SSRS: https://myspsite/subsite/_vti_bin/reportserver?https://myspsite/subsite/AdventureWorks2022/Employee_Sales_Summary_2022.rdl&ReportMonth=3&ReportYear=2008
    • Exemplo para de um servidor de modo nativo do SSRS: https://myrshost/ReportServer?/AdventureWorks2022/Employee_Sales_Summary_2022&ReportMonth=3&ReportYear=2008
  • Passe um valor nulo para um parâmetro.
    • Sintaxe: parameter:isnull=true
    • Exemplo: SalesOrderNumber:isnull=true
  • Passe é um valor booliano. Os valores possíveis são 0 para false e 1 para true.
    • Exemplo: https://myrshost/ReportServer?/AdventureWorks2022/Employee_Sales_Summary_2022&ShowDetails=1
  • Passe um valor flutuante. Inclua o separador decimal da localidade do servidor.

Conteúdo relacionado