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

  • Articolo

SI APPLICA A: Power BI Generatore report Power BI Desktop

È possibile passare i parametri del report a un report includendoli in un URL del 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 Creare una query in Progettazione query relazionali (Power BI Generatore report).For more information, see Build a Query in the Relational Query Designer (Power BI Generatore report).

Regole dei parametri del 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, anteporre il parametro con rp:.

Esempi di parametri del report impaginati

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

  
rp:parameter=value

Ad esempio, per specificare due parametri, "Salesperson" e "State", definiti in un report in 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, 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 un parametro multivalore "Salesperson". Il formato per un parametro multivalore consiste nel ripetere il 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 il 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 del report con un valore predefinito e il valore della proprietà Prompt è false, ovvero la proprietà Prompt User non è selezionata in Power BI Generatore report), non è possibile passare un valore per il parametro del report all'interno di un URL. In questo modo gli amministratori possono impedire agli utenti finali di aggiungere o modificare i valori di determinati parametri del report.
  • Power BI non supporta una stringa di query di 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 l'accesso a Power BI. Se si apre il report prima dell'accesso, il limite viene ridotto.

Contenuto correlato