Controllo Riquadro Power BI in Power Apps

Un controllo che consente di visualizzare un riquadro di Power BI in un'app.

Non hai Power BI? Iscriviti.

Descrizione

Sfrutta i vantaggi delle analisi di dati e degli strumenti di creazione di report esistenti visualizzando i riquadri di Power BI nelle app. Specifica il riquadro da visualizzare impostandone le proprietà Workspace, Dashboard e Tile nella scheda Dati del pannello delle opzioni.

Condivisione e sicurezza

Quando condividi un'app con contenuto di Power BI al suo interno, è necessario condividere non solo l'app stessa, ma anche il dashboard da cui proviene il riquadro. In caso contrario, il contenuto di Power BI non verrà visualizzato neanche se si apre l'app. Le app con contenuto di Power BI al loro interno rispettano le autorizzazioni per tale contenuto.

Prestazioni

Non è consigliabile mantenere caricati in un'app più di tre riquadri di Power BI contemporaneamente. Puoi controllare il caricamento e lo scaricamento dei riquadri impostando la proprietà LoadPowerBIContent.

Opzioni di incorporamento

L'incorporamento varia da una versione all'altra dell'API Power BI. A causa del nuovo schema di autenticazione dell'API Power BI, il riquadro potrebbe non essere accessibile nei dispositivi mobili o in altri scenari incorporati (Teams o SharePoint).

Puoi controllare l'uso della versione API usando la proprietà AllowNewAPI. Per altre informazioni, vedi Proprietà chiave.

Filtri

I filtri variano da una versione all'altra dell'API Power BI. Vedi le sezioni appropriate di seguito a seconda di come si configura il controllo.

Quando si utilizza la nuova API per chiamare il servizio Power BI

Quando la proprietà AllowNewAPI è impostata su "True", stai usando la nuova API per chiamare il servizio Power BI. Per altre informazioni, consulta Filtrare un report usando i parametri della stringa di query nell'URL.

Quando si utilizza l'API originale per chiamare il servizio Power BI

Quando la proprietà AllowNewAPI è impostata su "False", stai usando l'API originale per chiamare il servizio Power BI. In questo caso, passando un solo parametro dall'app, puoi filtrare i risultati che compaiono in un riquadro di Power BI. Tuttavia, sono supportati solo i valori di stringa e l'operatore di uguaglianza e il filtro potrebbe non funzionare se il nome della tabella o il nome della colonna contiene spazi.

Per passare un singolo valore di filtro, modifica il valore della proprietà TileURL che segue questa sintassi:

"https://app.powerbi.com/embed?dashboardId=<DashboardID>&tileId=<TileID>&config=<SomeHash>"

A quel valore, aggiungi questa sintassi:

&$filter=<TableName>/<ColumnName> eq '<Value>'

Ad esempio, utilizzando un valore di una casella di riepilogo:

"&$filter=Store/Territory eq '" & ListBox1.Selected.Abbr & "'"

Il parametro filtra un valore in set di dati del report in cui ha origine il riquadro. Tuttavia, la funzionalità di filtro presenta le seguenti limitazioni:

• È possibile applicare un solo filtro.
• Solo l'operatore eq è supportato.
• Il tipo di campo deve essere stringa.
• Il filtro è disponibile solo per i riquadri di visualizzazione aggiunti. Non è supportata per i report aggiunti.
• Gli oggetti visivi di script R e Python non possono essere filtrati.

Puoi utilizzare i campi calcolati nel report di Power BI per convertire altri tipi di valore in stringa o combinare più campi in uno.

Proprietà chiave

AllowNewAPI - Indica se utilizzare la nuova API quando si chiama il servizio Power BI. L'impostazione del valore su True consentirà l'utilizzo della nuova API Power BI (che non è supportata nei dispositivi mobili e in alcuni scenari incorporati, ma consente un filtro più avanzato). Il valore false comporta l'utilizzo dell'API originale. Il valore predefinito è false.

Dashboard: dashboard di Power BI di origine del riquadro.

LoadPowerBIContent: se true, il contenuto di Power BI viene caricato e visualizzato. Se false, il contenuto di Power BI viene scaricato. Questa operazione rilascia la memoria e ottimizza le prestazioni.

PowerBIInteractions: quando impostata su True, è possibile interagire con il contenuto Power BI, ma l'evento OnSelect di Power Apps non si attiverà. Quando impostata su False, non è possibile interagire con il riquadro, ma l'evento OnSelect di Power Apps si attiverà quando si seleziona il riquadro.

Tile: nome del riquadro di Power BI da visualizzare.

Workspace: area di lavoro di Power BI di origine del riquadro.

Proprietà aggiuntive

BorderColor: colore del bordo di un controllo.

BorderStyle: indica se il bordo di un controllo è Solid (Tinta unita), Dashed (Tratteggiato), Dotted (Punteggiato) o None (Nessuno).

BorderThickness: spessore del bordo di un controllo.

DisplayMode: indica se il controllo consente l'input dell'utente (Edit), visualizza solo i dati (View) o è disabilitato (Disabled).

Height: distanza tra i bordi superiore e inferiore del controllo.

OnSelect: azioni da eseguire quando l'utente seleziona un controllo. Per impostazione predefinita, viene aperto il report di Power BI associato al riquadro.

TileUrl: l'URL dal quale viene richiesto il riquadro al servizio Power BI. Per aggiungere il filtro delle stringhe di query all'URL, vedi la sezione Filtri sopra.

Visible: indica se un controllo viene visualizzato o è nascosto.

Width: distanza tra i bordi sinistro e destro di un controllo.

X: distanza tra il bordo sinistro di un controllo e il bordo sinistro del relativo contenitore padre (o della schermata se non c'è un contenitore padre).

Y: distanza tra il bordo superiore di un controllo e il bordo superiore del contenitore padre (o della schermata se non c'è un contenitore padre).

Esempio

1. Nella scheda Inserisci apri il menu Grafici e quindi aggiungi un controllo Riquadro Power BI.

   Non sai come aggiungere e configurare un controllo?

2. Nella scheda Dati del pannello delle opzioni seleziona Area di lavoro personale per l'impostazione Area di lavoro.

3. Seleziona un dashboard nell'elenco dei dashboard e quindi seleziona un riquadro nell'elenco dei riquadri.

   Il controllo visualizza il riquadro di Power BI.

Linee guida per l'accessibilità

Il Power BI tile è semplicemente un contenitore per i contenuti Power BI. Informazioni su come creare contenuto accessibile con questi suggerimenti sull'accessibilità di Power BI.

Se il contenuto di Power BI non ha un titolo, per consentire il supporto delle utilità per la lettura dello schermo è consigliabile aggiungere un'intestazione usando un controllo Etichetta. Puoi posizionare l'etichetta immediatamente prima del controllo Power BI tile.