Passar um parâmetro de relatório dentro de uma URL para um relatório paginado do Power BI

APLICA-SE A: Power BI Report Builder Power BI Desktop

Você pode passar parâmetros de relatório para um relatório incluindo-os em uma URL de relatório para Relatórios Paginados. Esses parâmetros de URL não são prefixados porque são passados diretamente para o mecanismo de processamento 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 passando 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 do Power BI).

Regras de parâmetros de relatório paginado

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 do 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. Não é necessário codificar nenhum dos caracteres manualmente.
  • Se você não incluir a sintaxe do proxy, prefixe o parâmetro com rp:.

Exemplos de parâmetros de relatório paginado

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

  
rp:parameter=value  

Por exemplo, para especificar dois parâmetros, "Vendedor" e "Estado", definidos em um relatório em Meu espaço de trabalho, você usaria a seguinte URL:

https://app.powerbi.com/groups/me/rdlreports/xxxxxxx-abc7-40f0-b456-febzf9cdda4d?rp:Salesperson=Tie+Bear&rp:State=Utah 

Para especificar os mesmos dois parâmetros definidos em um relatório em um aplicativo, use a seguinte URL:

https://app.powerbi.com/groups/me/apps/xxxxxxx-c4c4-4217-afd9-3920a0d1e2b0/rdlreports/xxxxxxx-639e-41d0-b733-05d2bca9853c?rp:Salesperson=Tiggee&rp:State=Utah 

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

  
parameter:isnull=true  
  

Por exemplo,

rp:SalesOrderNumber:isnull=true 

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

Nota

Se o relatório contiver um parâmetro de relatório que tenha um valor padrão e o valor da propriedade Prompt for false (ou seja, a propriedade Prompt User não estiver selecionada no Gerenciador de Relatórios), você não poderá passar um valor para esse parâmetro de relatório em 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 um parâmetro de vários valores "Salesperson". O formato de um parâmetro de vários valores é repetir o nome do parâmetro para cada valor.

https://app.powerbi.com/groups/me/rdlreports/xxxxxxx-abc7-40f0-b456-febzf9cdda4d?rp:Salesperson=Tie+Bear&rp:Salesperson=Mickey

O exemplo de URL a seguir passa um único parâmetro de SellStartDate com um valor de "7/1/2005".

https://app.powerbi.com/groups/me/rdlreports/xxxxxxx-abc7-40f0-b456-febzf9cdda4d?rp:SellStartDate=7/1/2005

Considerações e limitações

  • Se o relatório contiver um parâmetro de relatório que tenha um valor padrão e o valor da propriedade Prompt for false (ou seja, a propriedade Prompt User não estiver selecionada no Construtor de Relatórios do Power BI), você não poderá passar um valor para esse parâmetro de relatório em uma URL. Isso fornece aos administradores a opção de impedir que os usuários finais adicionem ou modifiquem os valores de determinados parâmetros de relatório.
  • O Power BI não suporta uma cadeia de caracteres de consulta de mais de 2.000 caracteres. Você pode inadvertidamente exceder esse valor se usar parâmetros de URL para exibir seu relatório paginado, especialmente se a cadeia de caracteres de consulta contiver vários valores de parâmetro. Para carregar corretamente o relatório, reduza o número de caracteres para menos de 2.000.
  • O limite na cadeia de caracteres de consulta é avaliado depois que você entra no Power BI. Se você abrir o relatório antes de entrar, o limite será reduzido.