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

APLICA-SE A: Power BI Report Builder serviço Power BI Power BI Desktop

Pode transmitir parâmetros de relatório para um relatório ao incluí-los num URL de relatório para Relatórios Paginados. Estes parâmetros de URL não têm prefixos porque são transmitidos diretamente para o motor de processamento de relatórios.

Todos os parâmetros de consulta podem ter parâmetros de relatório correspondentes. Transmite um parâmetro de consulta para um relatório ao transmitir o parâmetro de relatório correspondente. Para obter mais informações, veja Criar uma Consulta no Estruturador de Consultas Relacionais (Power BI Report Builder).

Regras de parâmetros de relatórios paginados

Os parâmetros do relatório são sensíveis às maiúsculas e minúsculas e utilizam os seguintes carateres especiais:

  • Todos os carateres de espaço na cadeia de URL são substituídos pelos carateres "%20", de acordo com os padrões de codificação de URL.
  • Um caráter de espaço na parte do parâmetro do URL é substituído por um caráter de adição (+).
  • Um ponto e vírgula em qualquer parte da cadeia é substituído pelos carateres "%3A".
  • Os browsers deverão efetuar automaticamente a codificação do URL mais adequada. Não tem de codificar nenhum dos carateres manualmente.
  • Se não incluir a sintaxe de proxy, prefixe o parâmetro com rp:.

Exemplos de parâmetros de relatórios paginados

Para definir um parâmetro de relatório num URL, utilize a seguinte sintaxe:

  
rp:parameter=value  

Por exemplo, para especificar dois parâmetros, "Vendedor" e "Estado", definidos num relatório em A Minha Área de Trabalho, utilizaria o 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 num relatório numa aplicação, terá de utilizar o 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 a um parâmetro, utilize a seguinte sintaxe:

  
parameter:isnull=true  
  

Por exemplo,

rp:SalesOrderNumber:isnull=true 

Para transmitir um valor Booleano , utilize 0 para falso e 1 para verdadeiro. Para transmitir um valor Flutuante , inclua o separador decimal da região do servidor.

Nota

Se o relatório contiver um parâmetro de relatório com um valor predefinido e o valor da propriedade Prompt for falso (ou seja, a propriedade Prompt User não estiver selecionada no Gestor de Relatórios), não poderá transmitir um valor para esse parâmetro de relatório dentro de um URL. Isto fornece aos administradores uma opção para impedir que os utilizadores finais adicionem ou modifiquem os valores de determinados parâmetros de relatório.

Exemplos adicionais

O seguinte URL de exemplo inclui um parâmetro "Salesperson" de múltiplos valores. O formato para um parâmetro de múltiplos valores consiste em 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 seguinte transmite um único parâmetro de SellStartDate com um valor de "1/7/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 predefinido e o valor da propriedade Prompt for falso (ou seja, a propriedade Prompt User não estiver selecionada no Power BI Report Builder), não poderá transmitir um valor para esse parâmetro de relatório dentro de um URL. Isto permite que os administradores possam impedir os utilizadores finais de adicionarem ou modificarem os valores de determinados parâmetros de relatório.
  • O Power BI não suporta uma cadeia de consulta com mais de 2000 carateres. Poderá exceder inadvertidamente este valor se utilizar parâmetros de URL para ver o relatório paginado, especialmente se a cadeia de consulta contiver vários valores de parâmetros. Para carregar corretamente o relatório, reduza o número de carateres para menos de 2000.
  • O limite na cadeia de consulta é avaliado depois de iniciar sessão no Power BI. Se abrir o relatório antes de iniciar sessão, o limite será reduzido.

Passos seguintes