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

Artigo
04/02/2014

Você pode transmitir parâmetros de relatório a um relatório incluindo-os em uma URL de relatório. Esses parâmetros de URL não são prefixados, pois eles são transmitidos 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:.

É 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 Compilar 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: Qualquer caractere de espaço na cadeia de caracteres da URL será substituído pelos caracteres "% 20", de acordo com os padrões de codificação de URL. Um caractere de espaço na parte do parâmetro da URL será substituído por um sinal de adição (+). Um ponto-e-vírgula em qualquer parte da cadeia de caracteres será substituído pelos caracteres "%3A." Os navegadores devem executar a codificação de URL apropriada automaticamente. Não é preciso codificar os caracteres manualmente.

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

Qualquer caractere de espaço na cadeia de caracteres da URL será substituído pelos caracteres "% 20", de acordo com os padrões de codificação de URL.
Um caractere de espaço na parte do parâmetro da URL será substituído por um sinal de adição (+).
Um ponto-e-vírgula em qualquer parte da cadeia de caracteres será substituído pelos caracteres "%3A."
Os navegadores devem executar a codificação de URL apropriada automaticamente. Não é preciso codificar os caracteres manualmente.

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

parameter=value

Por exemplo, para especificar dois parâmetros, "ReportMonth" e "ReportYear", definidos em um relatório, use a URL a seguir 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 de um servidor de relatório no modo integrado do SharePoint. Observe a sintaxe do proxy _vti_bin.

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

Para transmitir um valor nulo para um parâmetro, use a sintaxe a seguir:

parameter:isnull=true

Por exemplo,

SalesOrderNumber:isnull=true

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

Se o seu relatório contiver um parâmetro que tenha um valor padrão e o valor da propriedade Prompt for false (isto é, a propriedade Avisar Usuário não for selecionada no Gerenciador de Relatórios), você não poderá transmitir um valor para esse parâmetro em uma URL. Isso fornece aos administradores a opção de impedir que 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 de pasta “Equipe de instrução do usuário do SQL Server” inclui espaços e, portanto, o sinal “+” substitui cada espaço.
O nome de relatório “relatório do projeto da equipe” inclui espaços e, portanto, o sinal “+” substitui cada espaço.
Passa dois parâmetros “teamgrouping2” com um valor “xgroup” e “teamgrouping1” com um valor “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âmetros com vários valores, OrderID. O formato de um parâmetro com vários valores é 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 “7/1/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

Partilhar via

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

Exemplos adicionais

Consulte também

Referência

Conceitos

Recursos adicionais