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:

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.

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

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:

      • Power BI Pro

      • Premium per utente (PPU)

    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
  • .NET Framework
  • React TypeScript

  • .NET Core 3.1 SDK (o versione successiva)

  • Un ambiente di sviluppo integrato (IDE, Integrated Development Environment). È consigliabile usare uno degli IDE seguenti:

    • Visual Studio

    • Visual Studio Code

metodo

Per creare un'app di esempio di incorporamento per l'organizzazione , seguire questa procedura:

1. Registrare un'applicazione Microsoft Entra.

2. Creare un'area di lavoro di Power BI.

3. Creare e pubblicare un report di Power BI.

4. Ottenere i valori dei parametri di incorporamento.

5. Incorporare il contenuto.

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.

Per creare un'area di lavoro, eseguire le operazioni seguenti:

1. Accedere a Power BI.

2. Selezionare Aree di lavoro.

3. Seleziona Crea un'area di lavoro.

4. 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.

Per scaricare un report di esempio e pubblicarlo nell'area di lavoro, seguire questa procedura:

1. Aprire la cartella degli esempi di GitHub Power BI Desktop.

2. Selezionare Codice e quindi Scarica zip.

   

3. Estrarre il file ZIP scaricato e passare alla cartella Samples Reports .Extract the downloaded ZIP and navigate to the Samples Reports folder.

4. 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

Per ottenere il GUID ID client (noto anche come ID applicazione), seguire questa procedura:

1. Accedere a Microsoft Azure.

2. Cercare Registrazioni app e selezionare il collegamento Registrazioni app.

3. Selezionare l'app Microsoft Entra usata per incorporare il contenuto di Power BI.

4. Nella sezione Panoramica copiare il GUID ID applicazione (client).

Segreto client

Per ottenere il segreto client, seguire questa procedura:

1. Accedere a Microsoft Azure.

2. Cercare Registrazioni app e selezionare il collegamento Registrazioni app.

3. Selezionare l'app Microsoft Entra usata per incorporare il contenuto di Power BI.

4. In Gestisci, selezionare Certificati e segreti.

5. In Segreti client, selezionare Nuovo segreto client.

6. 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.

7. Nella sezione Segreti client copiare la stringa nella colonna Valore del segreto dell'applicazione appena creato. Il valore del segreto client è l'ID client.

ID area di lavoro

Per ottenere il GUID dell'ID dell'area di lavoro, seguire questa procedura:

1. Accedi al servizio Power BI.

2. Aprire il report da incorporare.

3. Copiare il GUID dall'URL. Il GUID è il numero tra /groups/ e /reports/.

   

ID report

Per ottenere il GUID dell'ID report, seguire questa procedura:

1. Accedi al servizio Power BI.

2. Aprire il report da incorporare.

3. 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.

1. Aprire la cartella degli esempi per sviluppatori di Power BI.

2. Selezionare Codice e quindi Scarica zip.

   

3. Estrarre il file ZIP scaricato e passare alla cartella PowerBI-Developer-Samples-master .

4. 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 .

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