Partilhar via


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

Você pode passar parâmetros de relatório para um relatório incluindo-os em uma URL de relatório. Esses parâmetros de URL não são prefixados porque são passados diretamente para o mecanismo de processamento de relatório.

Importante

É 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:.

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, consulte Criar uma consulta no Designer de Consulta Relacional (Construtor de Relatórios e SSRS).

Importante

Os parâmetros de relatório diferenciam maiúsculas de minúsculas.

Observação

Os parâmetros de relatório diferenciam maiúsculas de minúsculas e utilizam os seguintes caracteres especiais:

  • Todos os caracteres de espaço na cadeia de caracteres de URL são substituídos pelos caracteres "%20", de acordo com os padrões de codificação de URL.
  • Um caractere de espaço na parte de parâmetro da URL é substituído por um caractere de adição (+).
  • Um ponto e vírgula em qualquer parte da cadeia de caracteres é substituído pelos caracteres "%3A".
  • Os navegadores devem executar automaticamente a codificação de URL adequada. Você não precisa codificar nenhum dos caracteres manualmente.

Para definir um parâmetro de relatório em uma URL, use a seguinte sintaxe:

  
parameter=value  

Por exemplo, para especificar dois parâmetros, "ReportMonth" e "ReportYear", definidos em um relatório, use a seguinte URL para um servidor de relatório de modo nativo:

http://myrshost/ReportServer?/AdventureWorks 2008R2/Employee_Sales_Summary_2008R2&ReportMonth=3&ReportYear=2008  

Por exemplo, para especificar os mesmos dois parâmetros definidos em um relatório, use a URL a seguir para um servidor de relatório de modo integrado do SharePoint. Observe o /_vti_bin.

http://myspsite/subsite/_vti_bin/reportserver?http://myspsite/subsite/AdventureWorks 2008R2/Employee_Sales_Summary_2008R2.rdl&ReportMonth=3&ReportYear=2008  

Para passar um valor nulo para um parâmetro, use a seguinte sintaxe:

  
parameter  
:isnull=true  
  

Por exemplo

SalesOrderNumber:isnull=true  

Para passar um Boolean valor, use 0 para false e 1 para true. Para passar um Float valor, inclua o separador decimal da localidade do servidor

Observação

Se o relatório contiver um parâmetro de relatório que tenha um valor padrão e o valor da Prompt propriedade for false (ou seja, a propriedade Usuário do Prompt não estiver selecionada no Gerenciador de Relatórios), você não poderá passar um valor para esse parâmetro de relatório dentro de uma URL. Isso fornece aos administradores uma opção para impedir que os usuários finais adicionem ou modifiquem os valores de determinados parâmetros de relatório.

Exemplos adicionais

O exemplo de URL a seguir inclui espaços e vários parâmetros

  • O nome da pasta "Equipe de Educação do Usuário do SQL Server" inclui espaços e, portanto, o "+" substitui cada espaço.

  • O nome do relatório de "relatório do projeto de equipe" inclui espaços e, portanto, o "+" substitui cada espaço.

  • Passa dois parâmetros de "teamgrouping2" com um valor de "xgroup" e "teamgrouping1" com um valor de "ygroup".

https://myserver/Reportserver?/SQL+Server+User+Education+Team/_ContentTeams/folder123/team+project+report&teamgrouping2=xgroup&teamgrouping1=ygroup  

O exemplo de URL a seguir inclui um parâmetro de vários valores "OrderID. O formato de um parâmetro Multi-Value é repetir o nome do parâmetro para cada valor.

https://myserver/Reportserver?/SQL+Server+User+Education+Team/_ContentTeams/folder123/team+project+report&teamgrouping2=xgroup&teamgrouping1=ygroup&OrderID=747&OrderID=787&OrderID=12  

O exemplo de URL a seguir passa um único parâmetro de SellStartDate com um valor de "1/7/2005", para um servidor de relatório de modo nativo.

http://myserver/ReportServer/Pages/ReportViewer.aspx?%2fProduct_and_Sales_Report_AdventureWorks&SellStartDate=7/1/2005  

Consulte Também

Acesso à URL (SSRS)
Referência de parâmetro de acesso à URL