Esercitazione: Incorporare contenuto di Power BI usando un esempio di incorporamento per l'applicazione dell'organizzazione
L'analisi incorporata di Power BI consente di incorporare contenuto di Power BI, ad esempio report, dashboard e riquadri, nell'applicazione.
Questa esercitazione illustra come:
- Configurare l'ambiente incorporato.
- Configurare un'applicazione di esempio di incorporamento per l'organizzazione (nota anche come dati di proprietà dell'utente).
Per usare l'applicazione, gli utenti dovranno accedere a Power BI.
L'incorporamento per la soluzione dell'organizzazione viene in genere usato dalle aziende e dalle organizzazioni di grandi dimensioni ed è destinato agli utenti interni.
Importante
Se si incorpora contenuto per un cloud nazionale/regionale, i primi passaggi di questa esercitazione sono diversi. Per informazioni dettagliate, vedere Incorporare il contenuto per i cloud nazionali/regionali.
Specifiche di esempio di codice
Questa esercitazione include istruzioni per la configurazione di un'applicazione di esempio di incorporamento per l'organizzazione in uno dei framework 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 nella servizio Power BI. L'esempio React TypeScript consente di incorporare un solo report a cui l'utente finale ha già accesso nella servizio Power BI.
Gli esempi di codice supportano i browser seguenti:
- Microsoft Edge
- Google Chrome
- Mozilla Firefox
Prerequisiti
Prima di iniziare questa esercitazione, verificare di avere entrambe le dipendenze di Power BI e del codice seguenti:
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 uno 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 uno degli IDE seguenti:
metodo
Per creare un'app di esempio di incorporamento per l'organizzazione , seguire questa procedura:
Registrare un'applicazione Microsoft Entra.
Creare un'area di lavoro di Power BI.
Creare e pubblicare un report di Power BI.
Ottenere i valori dei parametri di incorporamento.
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 con Microsoft Entra ID, seguire le istruzioni riportate in Registrare l'applicazione.
Passaggio 2: Creare un'area di lavoro di Power BI
Power BI mantiene i report, i dashboard e i riquadri in un'area di lavoro. Per incorporare questi elementi, è necessario crearli e caricarli in un'area di lavoro.
Suggerimento
Se si dispone già di un'area di lavoro, è possibile ignorare questo passaggio.
Per creare un'area di lavoro, eseguire le operazioni seguenti:
Accedere a Power BI.
Selezionare Aree di lavoro.
Seleziona Crea un'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 si dispone già di 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 degli esempi di GitHub Power BI Desktop.
Selezionare Codice e quindi Scarica zip.
Estrarre il file ZIP scaricato e passare alla cartella Samples Reports .Extract the downloaded ZIP and navigate to the Samples Reports folder.
Selezionare un report da incorporare e pubblicarlo nell'area di lavoro.
Passaggio 4: Ottenere i valori dei parametri di incorporamento
Per incorporare il contenuto, è necessario ottenere alcuni valori di parametro. 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 | |||
Report ID |
Client ID
Suggerimento
Si applica a: .NET Core .NET Framework React TypeScript
Per ottenere il GUID ID client (noto anche come ID applicazione), seguire questa procedura:
Accedere a Microsoft Azure.
Cercare Registrazioni app e selezionare il collegamento Registrazioni app.
Selezionare l'app Microsoft Entra usata per incorporare il contenuto di Power BI.
Nella 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 usata 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 quando scade il segreto dell'applicazione e selezionare Aggiungi.
Nella sezione Segreti client copiare la stringa nella colonna Valore del segreto dell'applicazione appena creato. Il valore del segreto client è l'ID client.
Nota
Assicurarsi di copiare il valore del segreto client quando viene visualizzato per la prima volta. Dopo lo spostamento da 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 da incorporare.
Copiare il GUID dall'URL. Il GUID è il numero tra /groups/ e /reports/.
ID report
Suggerimento
Si applica a: .NET Core .NET Framework ReactTypeScript
Per ottenere il GUID dell'ID report, seguire questa procedura:
Accedi al servizio Power BI.
Aprire il report da 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 incorporamento per l'app Power BI dell'organizzazione .
Seguire questa procedura per modificare l'incorporamento per l'applicazione di esempio dell'organizzazione per incorporare il report di Power BI.
Aprire la cartella degli esempi per sviluppatori di Power BI.
Selezionare Codice e quindi Scarica zip.
Estrarre il file ZIP scaricato e passare alla cartella PowerBI-Developer-Samples-master .
Aprire una delle cartelle seguenti a seconda della lingua che si vuole usare nell'applicazione:
- .NET Core
- .NET Framework
- React-TS
Nota
L'incorporamento per le applicazioni di esempio dell'organizzazione supporta solo i framework elencati in precedenza. Le applicazioni di esempio Java, Node JS e Python supportano solo l'incorporamento per la soluzione clienti .
Configurare l'app Microsoft Entra
Accedere al portale di Azure.
Selezionare Registrazioni app. Se non è possibile visualizzare questa opzione, cercarla.
Aprire l'applicazione Microsoft Entra creata nel passaggio 1 - Registrare un'applicazione Microsoft Entra.
Scegliere Autenticazione dal menu Gestisci.
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 Incorpora per l'organizzazione .
Aprire l'app di esempio incorporamento per l'organizzazione usando uno dei metodi seguenti:
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 (riproduzione).
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 e quindi selezionare Incorpora.
Sviluppare l'applicazione
Dopo aver configurato ed eseguito l'applicazione di esempio 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.
Contenuto correlato
Commenti e suggerimenti
https://aka.ms/ContentUserFeedback.
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedereInvia e visualizza il feedback per