Parametri URL nei report impaginati in Power BI

  • Articolo

SI APPLICA A: Power BI Report Builder Power BI Desktop

È possibile inviare comandi ai report impaginati in Power BI aggiungendo un parametro a un URL. È possibile, ad esempio, che il report sia stato visualizzato usando un set specifico di valori dei parametri del report. È possibile incapsulare queste informazioni nell'URL usando i parametri di accesso con URL predefiniti. Si può personalizzare ulteriormente il modo in cui Power BI elabora il report incorporando i parametri per il rendering dei formati o per l'aspetto della barra degli strumenti del report. Questo URL può quindi essere incollato direttamente in un messaggio di posta elettronica o in una pagina Web in modo che altri utenti possano visualizzare il report nello stesso modo nel browser.

Ecco le azioni che è possibile eseguire tramite i parametri di accesso con URL:

  • Inviare parametri di report a un report.
  • Avviare l'esportazione del contenuto del report in un formato di file supportato.
  • Nascondere o visualizzare il riquadro dei parametri.
  • Specificare l'impostazione DeviceInfo.

Per l'elenco completo dei comandi e delle impostazioni disponibili tramite l'accesso con URL, vedere riferimento ai parametri di accesso URL in questo articolo.

Concetti relativi all'accesso tramite URL

Le richieste URL per Power BI contengono parametri elaborati dal servizio. Il modo in cui il servizio gestisce le richieste URL dipende dai parametri, dai prefissi di parametro e dai tipi di elementi inclusi nell'URL. La funzionalità dell'URL per i report impaginati è compatibile con la maggior parte dei browser e delle applicazioni che supportano l'indirizzamento URL standard.

Sintassi per l'accesso con URL

Le richieste URL possono contenere più parametri, elencati in qualsiasi ordine. I parametri sono separati da una e commerciale (&). Le coppie nome/valore sono separate da un segno di uguale (=). Ad esempio:

powerbiservicereporturl?rp:parameter=value&rdl:parameter=value

Descrizione della sintassi

powerbiservicereporturl

URL del servizio Power BI del report impaginato. Ad esempio:

https://app.powerbi.com/groups/me/rdlreports/xxxxxxx-c4c4-4217-afd9-3920a0d1e2b0

?

Usato per separare il powerbiservicereporturl e i parametri di accesso all'URL.

&

Carattere utilizzato per separare le coppie di nome e valore dei parametri di accesso tramite URL.

prefix

Prefisso per il parametro URL che specifica un'azione nel servizio Power BI. Ad esempio, rp: o rdl:.

parameter

Nome del parametro.

value

Testo URL che corrisponde al valore del parametro usato.

Informazioni di riferimento sul parametro del report URL

È possibile passare parametri di report a un report, includendoli nell'URL di un report impaginato.

Parametri di report (rp:)

Per esempi relativi al passaggio di parametri di report in un URL, vedere Passare un parametro del report in un URL.

Nota

I parametri del report richiedono il prefisso del parametro rp: e fanno distinzione tra maiuscole e minuscole.

Riferimento ai parametri di accesso con URL

È possibile usare i parametri seguenti come parte di un URL per configurare l'aspetto dei report impaginati in Power BI. I parametri più comuni sono elencati in questa sezione: I parametri non fanno distinzione tra maiuscole e minuscole e iniziano con il prefissordl: se correlati al formato di output.

Comandi del report (rdl:)

Formato di esportazione

Specifica il formato in cui eseguire il rendering e l'esportazione di un report.

  • Ad esempio: rdl:format=PDF

Valori disponibili:

  • PPTX (PowerPoint)
  • MHTML
  • IMMAGINE
  • EXCELOPENXML (EXCEL)
  • WORDOPENXML (WORD)
  • CSV
  • PDF
  • ACCESSIBLEPDF (PDF)
  • XML

Visualizzazione report

Specifica il tipo di visualizzazione usato per mostrare il report

  • rdl:reportView

Valori disponibili:

  • interactive (impostazione predefinita): carica il report in modalità interattiva.
  • pageView: carica il report in modalità visualizzazione pagina.

Pannello parametri

Specifica se il pannello dei parametri è chiuso o aperto al caricamento del report o se è completamente nascosto.

  • rdl:parameterPanel

Valori disponibili:

  • collapsed: carica il report con il pannello parametri chiuso. Il pulsante del parametro è abilitato in modo che gli utenti possano selezionare il pulsante per espanderlo.
  • hidden: carica il report con il pannello dei parametri chiuso e il pulsante del parametro disabilitato.
  • expanded (impostazione predefinita): carica il report con il pannello dei parametri aperto e il pulsante del parametro abilitato.

Informazioni dispositivo

È possibile specificare parametri di output aggiuntivi per i formati di esportazione seguenti.

  • PDF/ACCESSIBLEPDF:

    • rdl:AccessiblePDF=true/false
    • rdl:Columns=integer
    • rdl:ColumnSpacing=decimal(in)
    • rdl:DpiX=integer
    • rdl:DpiY=integer
    • rdl:EndPage=integer
    • rdl:HumanReadablePDF=true/false
    • rdl:MarginBottom=decimal(in)
    • rdl:MarginLeft=decimal(in)
    • rdl:MarginRight=decimal(in)
    • rdl:MarginTop=decimal(in)
    • rdl:PageHeight=decimal(in)
    • rdl:PageWidth=decimal(in)
    • rdl:StartPage=integer

  • CSV:

    Nota

    Per questi valori stringa, fare riferimento alle impostazioni delle informazioni sul dispositivo CSV.

    • rdl:Encoding=string
    • rdl:ExcelMode=true/false
    • rdl:FieldDelimiter=string
    • rdl:NoHeader=true/false
    • rdl:Qualifier=string
    • rdl:RecordDelimiter=string
    • rdl:SuppressLineBreaks=true/false
    • rdl:UseFormattedValues=true/false

  • WORDOPENXML (WORD):

    • rdl:AutoFit=string -> True/False/Never/Default
    • rdl:ExpandToggles=true/false
    • rdl:FixedPageWidth=true/false
    • rdl:OmitDrillthroughs=true/false
    • rdl:OmitHyperlinks=true/false

  • EXCELOPENXML (EXCEL):

    • rdl:OmitDocumentMap=true/false
    • rdl:OmitFormulas=true/false
    • rdl:SimplePageHeaders=true/false

  • PPTX (PowerPoint):

    • rdl:Columns=integer
    • rdl:ColumnSpacing=decimal(in)
    • rdl:DpiX=integer
    • rdl:DpiY=integer
    • rdl:EndPage=integer
    • rdl:MarginBottom=decimal(in)
    • rdl:MarginLeft=decimal(in)
    • rdl:MarginRight=decimal(in)
    • rdl:MarginTop=decimal(in)
    • rdl:PageHeight=decimal(in)
    • rdl:PageWidth=decimal(in)
    • rdl:StartPage=integer
    • rdl:UseReportPageSize=true/false

  • XML:

    • rdl:Encoding=string
    • rdl:Indented=true/false
    • rdl:OmitNamespace=true/false
    • rdl:OmitSchema=true/false
    • rdl:Schema=true/false
    • rdl:UseFormattedValues=true/false

È possibile aggiungere rdl:targetSameWindow=true all'URL del collegamento ipertestuale nel report per aprire questo collegamento ipertestuale in Power BI nella stessa finestra del browser. Per informazioni sull'aggiunta di collegamenti ipertestuali a un report, vedere Aggiungere un collegamento ipertestuale a un URL.

Contenuto correlato