Passare un parametro del report all'interno di un URL per un report impaginato di Power BI

  • Articolo

SI APPLICA A: Power BI Report Builder Power BI Desktop

È possibile passare parametri di report a un report, includendoli nell'URL di report, per i report impaginati. Questi parametri URL non hanno il prefisso in quanto vengono passati direttamente al motore di elaborazione dei report.

Tutti i parametri di query possono disporre di parametri di report corrispondenti. Passare un parametro di query a un report passando il parametro di report corrispondente. Per altre informazioni, vedere Compilare una query in Progettazione query relazionale (Power BI Report Builder).

Regole dei parametri per i report impaginati

Ai parametri del report viene applicata la distinzione tra maiuscole e minuscole e in essi vengono utilizzati i caratteri speciali seguenti:

  • Qualsiasi spazio nella stringa dell'URL viene sostituito con i caratteri "% 20", in base agli standard di codifica degli URL.
  • Lo spazio nella parte di parametro dell'URL viene sostituito con un carattere più (+).
  • Il punto e virgola in una parte qualsiasi della stringa viene sostituito con i caratteri "%3A".
  • La codifica appropriata dell'URL deve venire eseguita automaticamente dai browser. Non è necessario codificare manualmente i caratteri.
  • Se non si include la sintassi del proxy, è necessario anteporre al parametro il prefisso rp:.

Esempi di parametri per i report impaginati

Per impostare un parametro del report all'interno di un URL, utilizzare la sintassi seguente:

  
rp:parameter=value

Ad esempio, per specificare i due parametri "Salesperson" e "State" definiti in un report nell'area di lavoro personale, si userà l'URL seguente:

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

Per specificare gli stessi due parametri definiti in un report in un'app, è necessario usare l'URL seguente:

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

Per passare un valore Null per un parametro, utilizzare la sintassi seguente:

  
parameter:isnull=true

ad esempio:

rp:SalesOrderNumber:isnull=true

Per passare un valore Boolean , usare 0 per false e 1 per true. Per passare un valore Float, includere il separatore decimale delle impostazioni locali del server.

Nota

Se il report contiene un parametro del report con un valore predefinito e il valore della proprietà Prompt è false (ovvero la proprietà Richiesta all'utente non è selezionata in Gestione report), non è possibile passare un valore per tale parametro in un URL. In questo modo, gli amministratori possono impedire agli utenti finali di aggiungere o modificare i valori di determinati parametri dei report.

Esempi aggiuntivi

L'esempio di URL seguente include il parametro multivalore "Salesperson". Il formato di un parametro multivalore prevede la ripetizione del nome del parametro per ogni valore.

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

Nell'esempio di URL seguente viene passato un singolo parametro di SellStartDate con valore "7/1/2005".

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

Considerazioni e limitazioni

  • Se il report contiene un parametro di report con un valore predefinito, e il valore della proprietà Prompt è falso (ossia in Power BI Report Builder non è selezionata la proprietà Richiesta all’utente), non è possibile passare un valore per quel parametro di report all'interno di un URL. Ciò consente agli amministratori di impedire agli utenti finali di aggiungere o modificare i valori di determinati parametri del report.
  • Power BI non supporta stringhe di query con più di 2.000 caratteri. È possibile superare accidentalmente questo valore se si usano parametri URL per visualizzare il report impaginato, soprattutto se la stringa di query contiene più valori di parametro. Per caricare correttamente il report, ridurre il numero di caratteri a meno di 2.000.
  • Il limite nella stringa di query viene valutato dopo aver eseguito l'accesso a Power BI. Se si apre il report prima di aver eseguito l'accesso, il limite viene ridotto.

Contenuto correlato