Compartilhar via


Passar um parâmetro de relatório em uma URL para um relatório paginado no 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órios paginados. Esses parâmetros de URL não são prefixados, pois eles são transmitidos 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, transmitindo o parâmetro de relatório correspondente. Para obter mais informações, confira Criar uma consulta no Designer de Consultas Relacionais (Power BI Report Builder).

Regras de parâmetro de relatório paginado

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.
  • Se você não incluir a sintaxe do proxy, adicione o prefixo rp: antes do parâmetro.

Exemplos de parâmetro de relatório paginado

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

  
rp:parameter=value  

Por exemplo, para especificar dois parâmetros, "Vendedor" e "Estado", definidos em um relatório na sua área Meu Workspace, 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, você usaria 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 transmitir um valor nulo para um parâmetro, use a sintaxe a seguir:

  
parameter:isnull=true  
  

Por exemplo,

rp:SalesOrderNumber:isnull=true 

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

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.

Mais exemplos

O exemplo de URL a seguir inclui um parâmetro com vários valores, "Vendedor". O formato usado para um parâmetro com 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 o 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 com um valor padrão e o valor da propriedade Prompt for false (ou seja, se a propriedade Solicitar Usuário não estiver selecionada no Power BI Report Builder), você não poderá passar um valor para esse parâmetro de relatório dentro de 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 dá suporte a cadeias de caracteres de consulta com mais de 2 mil caracteres. Talvez você exceda esse valor sem querer se usar parâmetros de URL para ver o relatório paginado, principalmente se a cadeia de caracteres de consulta contiver vários valores de parâmetro. Para carregar o relatório corretamente, reduza o número de caracteres para menos de 2 mil.
  • 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.