Condividi tramite

Incorporare un report in un portale o un sito Web sicuro

  • Articolo

L'opzione Incorpora per i report di Power BI consente di incorporare facilmente e in modo sicuro i report nei portali Web interni. Questi portali possono essere basati sul cloud o ospitati in locale, come SharePoint 2019. I report incorporati rispettano tutte le autorizzazioni per gli elementi e la sicurezza dei dati tramite la sicurezza a livello di riga e la sicurezza a livello di oggetto del modello tabulare di Analysis Services. Questi report consentono l'incorporamento senza codice in qualsiasi portale che accetti un URL o un iFrame.

L'opzione Incorpora supporta filtri URL e impostazioni per gli URL. Consente di eseguire l'integrazione con i portali usando un approccio con poco codice che richiede solo conoscenze HTML e JavaScript di base.

Importante

A causa degli aggiornamenti della sicurezza di Chromium in corso, l'opzione Incorpora non funziona più esattamente come prima e agli utenti potrebbe essere richiesto di autenticarsi più di una volta. Per risolvere questo problema, prendere in considerazione la creazione di una soluzione Power BI Embedded.

Come incorporare report di Power BI nei portali

  1. Aprire un report nel servizio Power BI.

  2. Nel menu File, selezionare Incorpora report>Sito Web o portale.

  3. Nella finestra di dialogo visualizzata Codice di incorporamento sicuro, selezionare il valore riportato in Ecco un collegamento che può essere usato per incorporare il contenuto. In alternativa, se si preferisce usare un iframe in un blog o un sito Web, selezionare il valore presente in Codice HTML da incollare in un sito Web.

    Screenshot della finestra di dialogo dell'opzione Incorpora

  4. Se un utente apre un URL di un report direttamente oppure uno che è incorporato in un portale Web, l'accesso al report richiede l'autenticazione. Se l'utente non ha eseguito l'accesso a Power BI nella sessione del browser, viene visualizzata la schermata seguente. Quando si seleziona Accedi, dovrebbe aprirsi una nuova finestra o scheda del browser. Chiedere agli utenti di controllare i blocchi popup, se non viene visualizzata la richiesta di accesso.

    Screenshot della pagina di accesso di Power BI che mostra l'accesso per la visualizzazione di questa finestra di dialogo del report.

  5. Dopo che l'utente ha eseguito l'accesso, il report viene visualizzato con i dati ed è possibile spostarsi tra le pagine e impostare filtri. Solo gli utenti con autorizzazione di visualizzazione possono vedere il report in Power BI. Vengono applicate anche tutte le regole di sicurezza a livello di riga. Gli utenti devono essere in possesso di una licenza corretta. È necessaria una licenza Power BI Pro o Premium per utente oppure il contenuto deve essere in un'area di lavoro inclusa in una capacità Power BI Premium. L'utente deve effettuare l'accesso ogni volta che apre una nuova finestra del browser. Tuttavia, una volta effettuato l'accesso, gli altri report vengono caricati automaticamente.

    Screenshot del report di esempio vendite e marketing.

  6. Quando si utilizza un iframe, potrebbe essere necessario modificare i valori di altezza e larghezza per adattarlo alla pagina Web del portale.

<iframe width="1080" height="760" src="https://app.powerbi.com/reportEmbed?reportId=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx&autoAuth=true" frameborder="0" allowFullScreen="true"></iframe>

Concedere l'accesso al report

L'opzione Incorpora non consente automaticamente agli utenti di visualizzare il report. Le autorizzazioni di visualizzazione sono impostate nel servizio Power BI.

Nel servizio Power BI, è possibile condividere report incorporati con gli utenti che richiedono l'accesso. Se si usa un gruppo di Microsoft 365, è possibile elencare l'utente come membro dell'area di lavoro.

Licenze

Per visualizzare il report incorporato, è necessaria una licenza Power BI Pro o Premium per utente. In alternativa, il contenuto deve essere in un'area di lavoro inclusa in una capacità Power BI Premium (SKU EM o P).

Personalizzare l'esperienza di incorporamento mediante le impostazioni per l'URL

È possibile personalizzare l'esperienza utente mediante le impostazioni di input dell'URL di incorporamento. Nell'iframe fornito è possibile aggiornare le impostazioni src dell'URL.

Proprietà Descrizione
pageName È possibile usare il parametro della stringa di query pageName per impostare la pagina del report da aprire. È possibile trovare questo valore alla fine dell'URL del report quando si visualizza un report nel servizio Power BI, come illustrato più avanti nell'articolo.
Filtri URL Per filtrare il contenuto incorporato, è possibile usare filtri URL nell'URL di incorporamento che si è ricevuto dall'interfaccia utente di Power BI. In questo modo è possibile realizzare integrazioni con poco codice e conoscenze di base di HTML e JavaScript.

Impostare la pagina che viene aperta per un report incorporato

Quando si visualizza un report nel servizio Power BI, è possibile trovare il valore pageName alla fine dell'URL del report.

  1. Aprire il report dal servizio Power BI nel Web browser e quindi copiare l'URL dalla barra degli indirizzi.

    https://app.powerbi.com/groups/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/reports/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/ReportSection2

  2. Aggiungere la proprietà pageName e il relativo valore alla fine dell'URL.

    https://app.powerbi.com/reportEmbed?reportId=/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx&autoAuth=true&pageName=ReportSection2

Filtrare il contenuto del report utilizzando i filtri URL

È possibile usare filtri URL per fornire diverse visualizzazioni dei report. Ad esempio, l'URL seguente filtra il report in modo da visualizzare i dati per il settore energetico.

L'uso combinato di pageName e filtri URL offre grandi potenzialità. È possibile creare esperienze con codice HTML e JavaScript molto semplice.

Ecco ad esempio un pulsante che è possibile aggiungere in una pagina HTML:

<button class="textLarge" onclick='show("ReportSection", "Energy");' style="display: inline-block;">Show Energy</button>

Una volta premuto, il pulsante chiama una funzione per aggiornare l'iframe con un URL aggiornato, che include il filtro per il settore energetico.

function show(pageName, filterValue)

{

var newUrl = baseUrl + "&pageName=" + pageName;

if(null != filterValue && "" != filterValue)

{

newUrl += "&$filter=Industries/Industry eq '" + filterValue + "'";

}

//Assumes there's an iFrame on the page with id="iFrame"

var report = document.getElementById("iFrame")

report.src = newUrl;

}

https://app.powerbi.com/reportEmbed?reportId=/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx&autoAuth=true&pageName=ReportSection&filter=Industries/Industry eq 'Energy'

È possibile aggiungere tutti i pulsanti desiderati per creare un'esperienza personalizzata con poco codice.

Considerazioni e limitazioni

  • I report impaginati sono supportati con gli scenari di incorporamento sicuri, come anche i report impaginati con parametri URL. Per altre informazioni, vedere Passare un parametro di report in un URL per un report impaginato in Power BI.

  • L'opzione di incorporamento sicuro è disponibile per i report pubblicati nel servizio Power BI.

  • Per ospitare contenuti incorporati in modo sicuro, gli utenti devono utilizzare HTTPS per la pagina di livello superiore. Non è supportato l'utilizzo di una pagina host non protetta per l'accesso sicuro al contenuto incorporato.

  • L'utente deve effettuare l'accesso per visualizzare il report ogni volta che apre una nuova finestra o scheda del browser.

  • Per poter eseguire l'autenticazione, gli utenti devono aver abilitato le finestre popup.

  • Se gli utenti hanno eseguito correttamente l'accesso ai report in precedenza, ma ora riscontrano problemi, devono cancellare la cache del browser.

  • Alcuni browser richiedono di aggiornare la pagina dopo aver effettuato l'accesso, soprattutto quando si usa la modalità InPrivate o in incognito.

  • È possibile che si verifichino problemi, se si usano versioni del browser non supportate. Per un elenco dei browser supportati da Power BI, vedere Browser supportati per Power BI.

  • Se il sito Web imposta l'intestazione COOP (CROSS-Origin-Opener-Policy) su "same-origin", non è possibile accedere per visualizzare il contenuto incorporato perché MSAL non supporta questa intestazione. Scegliere invece "restrict-properties" (per i browser basati su Chromium) o "same-origin-allow-popups". In alternativa, se non è possibile modificare COOP, collegarsi direttamente all'URL incorporato, anziché incorporarlo in un iframe.

  • Il server SharePoint classico non è supportato perché richiede le versioni di Internet Explorer precedenti a 11 o l'abilitazione della modalità di visualizzazione di compatibilità.

  • Per ottenere un'esperienza Single Sign-On, usare l'opzione Incorpora in SharePoint Online oppure creare un'integrazione personalizzata tramite il metodo di incorporamento di dati di proprietà dell'utente.

  • Le funzionalità di autenticazione automatica fornite con l'opzione Incorpora non sono compatibili con l'API JavaScript di Power BI. Sono bloccati negli SDK del client integrato PBI, a partire dalla versione 2.10.4. Per l'API JavaScript di Power BI, usare il metodo di incorporamento di dati di proprietà dell'utente.

  • Le funzionalità di autenticazione automatica non sono disponibili quando sono incorporate nelle applicazioni, incluse le applicazioni per dispositivi mobili e desktop.

  • La durata del token di autenticazione viene controllata in base alle impostazioni di Microsoft Entra. Quando il token di autenticazione scade, l'utente dovrà accedere di nuovo per ottenere un token di autenticazione aggiornato. La durata predefinita è di un'ora, ma l'organizzazione potrebbe scegliere una durata più breve o più lunga. In questo scenario non è possibile aggiornare automaticamente il token.

Contenuto correlato