Esercitazione: incorporare contenuti di Power BI usando un'applicazione di esempio con incorporamento per l’organizzazione
L'analisi incorporata di Power BI Embedded consente di incorporare contenuto di Power BI come report, dashboard e riquadri nell'applicazione.
Questa esercitazione illustra come:
- Configurare l'ambiente di incorporamento.
- Configurare un'applicazione di esempio di incorporamento per l’organizzazione (condizione nota anche come I dati sono di proprietà dell'app).
Per usare l'applicazione, gli utenti dovranno accedere a Power BI.
La soluzione di incorporamento per l'organizzazione viene in genere usata da aziende e organizzazioni di grandi dimensioni ed è destinata agli utenti interni.
Importante
Se si incorporano contenuti per un cloud nazionale/regionale, i primi passaggi di questa esercitazione sono differenti. Per informazioni dettagliate, vedere Incorporare contenuti per cloud nazionali/regionali.
Specifiche dell'esempio di codice
Questa esercitazione include istruzioni per la configurazione di un'applicazione di esempio con incorporamento per l’organizzazione in uno dei contesti seguenti:
- .NET Framework
- .NET Core
- React TypeScript
Nota
Gli esempi di .NET Core e .NET Framework consentono all'utente finale di visualizzare qualsiasi dashboard, report o riquadro di Power BI a cui ha accesso nel servizio Power BI. L'esempio React TypeScript consente di incorporare un solo report a cui l'utente finale ha già accesso nel servizio Power BI.
Gli esempi di codice supportano i browser seguenti:
- Microsoft Edge
- Google Chrome
- Mozilla Firefox
Prerequisiti
Prima di iniziare questa esercitazione, verificare che siano disponibili le dipendenze, sia di Power BI, sia del codice elencate di seguito:
Dipendenze di Power BI
Il proprio tenant di Microsoft Entra.
Una delle licenze seguenti:
Nota
Per passare all'ambiente di produzione, è necessaria una delle configurazioni seguenti:
- Tutti gli utenti con licenze Pro.
- Tutti gli utenti con licenze PPU.
- SKU equivalente o superiore a SKU F64. Questa configurazione consente a tutti gli utenti di avere licenze gratuite.
Dipendenze del codice
.NET Core 3.1 SDK (o versione successiva)
Un ambiente di sviluppo integrato (IDE, Integrated Development Environment). È consigliabile usare una delle seguenti IDE:
metodo
Per creare un'app di esempio con incorporamento per l’organizzazione, seguire questi passaggi:
Passaggio 1 - Registrare un'applicazione Microsoft Entra
La registrazione dell'applicazione con Microsoft Entra ID consente di stabilire un’identità per l’app.
Per registrare l'applicazione in Microsoft Entra ID, seguire le istruzioni riportate in Registrare l'applicazione.
Passaggio 2 - Creare un'area di lavoro di Power BI
Microsoft Fabric mantiene report, dashboard e riquadri in un'area di lavoro. Per incorporare questi elementi, è necessario crearli e caricarli in un'area di lavoro.
Suggerimento
Se è già disponibile un'area di lavoro, è possibile ignorare questo passaggio.
Per creare un'area di lavoro, eseguire le operazioni seguenti:
Accedere a Fabric.
Selezionare Aree di lavoro.
Selezionare + Nuova area di lavoro.
Assegnare un nome all'area di lavoro e selezionare Salva.
Passaggio 3 - Creare e pubblicare un report di Power BI
Il passaggio successivo consiste nel creare un report e caricarlo nell'area di lavoro. È possibile creare un report personalizzato usando Power BI Desktop e quindi pubblicarlo nell'area di lavoro. In alternativa, è possibile caricare un report di esempio nell'area di lavoro.
Suggerimento
Se è già disponibile un'area di lavoro con un report, è possibile ignorare questo passaggio.
Per scaricare un report di esempio e pubblicarlo nell'area di lavoro, seguire questa procedura:
Aprire la cartella GitHub Power BI Desktop samples.
Selezionare Code (Codice) e quindi selezionare Download zip (Scarica ZIP).
Estrarre il file ZIP scaricato e passare alla cartella Samples Reports.
Selezionare un report da incorporare e pubblicarlo nell'area di lavoro.
Passaggio 4 - Ottenere i valori dei parametri di incorporamento
Per incorporare il contenuto, sarà necessario ottenere alcuni valori di parametri. I valori dei parametri dipendono dalla lingua dell'applicazione di esempio che si vuole usare. La tabella seguente elenca i valori dei parametri necessari per ogni esempio.
| Parametro | .NET Core | .NET Framework | React TypeScript |
|---|---|---|---|
| ID client | 
|
|
|
| Segreto client |
|
|
|
| ID area di lavoro |
|
|
|
| ID report |
|
|
|
ID client
Suggerimento
Si applica a: .NET Core .NET Framework React TypeScript
Per ottenere il GUID dell'ID del client (noto anche come ID dell'applicazione), seguire questa procedura:
Accedere a Microsoft Azure.
Cercare Registrazioni app e selezionare il collegamento Registrazioni app.
Selezionare l'app Microsoft Entra utilizzata per incorporare il contenuto di Power BI.
Dalla sezione Panoramica copiare il GUID ID applicazione (client).
Segreto client
Suggerimento
Si applica a: .NET Core .NET Framework React TypeScript
Per ottenere il segreto client, seguire questa procedura:
Accedere a Microsoft Azure.
Cercare Registrazioni app e selezionare il collegamento Registrazioni app.
Selezionare l'app Microsoft Entra utilizzata per incorporare il contenuto di Power BI.
In Gestisci, selezionare Certificati e segreti.
In Segreti client, selezionare Nuovo segreto client.
Nella finestra popup Aggiungi un segreto client specificare una descrizione per il segreto dell'applicazione, selezionare la scadenza del segreto dell'applicazione e quindi selezionare Aggiungi.
Dalla sezione Segreti client copiare la stringa nella colonna Valore del segreto dell'applicazione appena creato. Il valore del segreto client è l'ID del client.
Nota
Accertarsi di copiare il valore del segreto client quando compare per la prima volta. Dopo la chiusura di questa pagina, il segreto client verrà nascosto e non sarà possibile recuperarne il valore.
ID area di lavoro
Suggerimento
Si applica a: .NET Core .NET Framework React TypeScript
Per ottenere il GUID dell'ID dell'area di lavoro, seguire questa procedura:
Accedi al servizio Power BI.
Aprire il report che si vuole incorporare.
Copiare il GUID dall'URL. Il GUID è il numero tra /groups/ e /reports/.
ID report
Suggerimento
Si applica a: .NET Core .NET Framework React TypeScript
Per ottenere il GUID dell'ID del report, seguire questa procedura:
Accedi al servizio Power BI.
Aprire il report che si vuole incorporare.
Copiare il GUID dall'URL. Il GUID è il numero tra /reports/ e /ReportSection.
Passaggio 5: Incorporare il contenuto
L'applicazione di esempio incorporata di Power BI consente di creare un'app di Power BI con incorporamento per l’organizzazione.
Per incorporare il report di Power BI, seguire questa procedura per modificare l'applicazione di esempio con incorporamento per l’organizzazione.
Aprire la cartella Power BI developer samples.
Selezionare Code (Codice) e quindi selezionare Download zip (Scarica ZIP).
Estrarre il file ZIP scaricato e passare alla cartella PowerBI-Developer-Samples-master.
Aprire una delle cartelle seguenti a seconda del linguaggio che si vuole usare per l'applicazione:
- .NET Core
- .NET Framework
- React-TS
Nota
Le applicazioni di esempio con incorporamento per l’organizzazione supportano solo i contesti elencati in precedenza. Le applicazioni di esempio Java, Node JS e Python supportano solo la soluzione di incorporamento per i clienti.
Configurare l'app Microsoft Entra
Accedere al portale di Azure.
Selezionare Registrazioni app. Se questa opzione non è visibile, cercarla.
Aprire l'applicazione Microsoft Entra creata nel passaggio 1 - Registrare un'applicazione Microsoft Entra.
Dal menu Gestisci, scegliere Autenticazione.
In Configurazioni della piattaforma aprire la piattaforma Web e nella sezione URI di reindirizzamento aggiungere
https://localhost:5000/signin-oidc.Nota
Se non si ha una piattaforma Web, selezionare Aggiungi una piattaforma e nella finestra Configura piattaforme scegliere Web.
Salva le modifiche.
Configurare l'app di incorporamento di esempio
Aprire la cartella Incorporare per l'organizzazione.
Aprire l'app di esempio con incorporamento per l’organizzazione usando uno di questi metodi:
Se si usa Visual Studio, aprire il file UserOwnsData.sln.
Se si usa Visual Studio Code, aprire la cartella UserOwnsData.
Aprire appsettings.json e immettere i valori dei parametri seguenti:
ClientId- Usare il GUID ID clientClientSecret- Usare il segreto client
Eseguire l'app di esempio
Eseguire il progetto selezionando l'opzione appropriata:
Se si usa Visual Studio, selezionare IIS Express (Esegui).
Se si usa Visual Studio Code, selezionare Esegui > Avvia debug.
Accedere all'applicazione di esempio di incorporamento.
Nota
Durante il primo accesso, verrà richiesto di consentire le autorizzazioni di Microsoft Entra per l'app.
Quando l'applicazione di esempio di incorporamento viene caricata, selezionare il contenuto di Power BI da incorporare, quindi selezionare Incorpora.
Sviluppare un’applicazione
Dopo aver configurato ed eseguito l'applicazione di esempio con incorporamento per i clienti è possibile iniziare a sviluppare un'applicazione personalizzata.
Aggiornare le autorizzazioni utente
Gli utenti devono disporre dell'autorizzazione per accedere alla cartella di Power BI in cui si trova il report. Quando si concede a un utente l'autorizzazione per accedere a una cartella, la modifica in genere diventa effettiva solo dopo l'accesso dell'utente al portale di Power BI. Affinché le nuove autorizzazioni vengano applicate immediatamente, nello scenario incorporato effettuare una chiamata esplicita all'API REST RefreshUser Permissions all'avvio. Questa chiamata API aggiornerà le autorizzazioni ed eviterà errori di autorizzazione per gli utenti con le autorizzazioni appena concesse.