Esercitazione: Incorporare contenuto di Power BI usando un esempio di incorporamento per l'applicazione dei clienti

SI APPLICA A: L'app possiede dati di proprietà dell'utente

L'analisi incorporata e Power BI Embedded (offerta di Azure) consentono di incorporare contenuto di Power BI, ad esempio report, dashboard e riquadri, nell'applicazione.

In questa esercitazione apprenderai a:

• Configurare l'ambiente incorporato.
• Configurare un'applicazione di esempio di incorporamento per i clienti (nota anche come dati di proprietà dell'app).

Per usare l'applicazione, gli utenti non devono accedere a Power BI o avere una licenza di Power BI.

È consigliabile usare il metodo di incorporamento per i clienti per incorporare il contenuto di Power BI, se si è un fornitore di software indipendente (ISV) o uno sviluppatore, che vuole creare applicazioni per terze parti.

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 per i clienti in uno dei framework seguenti:

• .NET Framework
• .NET Core
• Java
• Node JS
• Python

Gli esempi di codice supportano i browser seguenti:

• Microsoft Edge
• Google Chrome
• Mozilla Firefox

Prerequisiti

Prima di iniziare questa esercitazione, verificare di avere le dipendenze di Power BI e del codice seguenti:

• Dipendenze di Power BI

  • Il proprio tenant di Microsoft Entra.

  • Per autenticare l'app in Power BI, è necessario uno dei seguenti:

    • Entità servizio: un oggetto entità servizio Microsoft Entra che consente a Microsoft Entra ID di autenticare l'app.

    • Licenza di Power BI Pro : si tratta dell'utente master e l'app la usa per eseguire l'autenticazione in Power BI.

    • Una licenza power BI Premium per utente (PPU): si tratta dell'utente master e l'app lo usa per l'autenticazione in Power BI.

    Nota

    Per passare alla produzione è necessaria una capacità.

• Dipendenze del codice

.NET Core

• .NET Core 3.1 SDK (o versione successiva)

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

  • Visual Studio

  • Visual Studio Code

.NET Framework

• .NET Framework 4.8

• Visual Studio

Java

• JDK (o JRE)

• IDE Eclipse : verificare di avere Eclipse per Java edizione Enterprise Developers (enterprise Edition)

• Distribuzioni binarie apache Tomcat

Node JS

• Node.JS

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

  • Visual Studio

  • Visual Studio Code

Python

• Python 3 (o versione successiva)

  Nota

  • Se si installa Python per la prima volta, selezionare l'opzione Aggiungi Python a PATH per aggiungere l'installazione alla PATH variabile.
  • Se Python è già installato, verificare che la variabile includa il PATH percorso di installazione. Per altre informazioni, vedere la documentazione di Excursus: Setting environment variables Python (questo collegamento fa riferimento a Python 3).

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

  • Visual Studio

  • Visual Studio Code

metodo

Per creare un'app di esempio per i clienti , seguire questa procedura:

1. Selezionare il metodo di autenticazione.

2. Registrare un'applicazione Microsoft Entra.

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

4. Creare e pubblicare un report di Power BI.

5. Ottenere i valori dei parametri di incorporamento.

6. Accesso all'API dell'entità servizio

7. Abilitare l'accesso all'area di lavoro.

8. Incorporare il contenuto.

Passaggio 1- Selezionare il metodo di autenticazione

La soluzione incorporata varia a seconda del metodo di autenticazione selezionato. È quindi importante comprendere le differenze tra i metodi di autenticazione e decidere quale soluzione si adatta meglio alla soluzione.

Nella tabella seguente vengono descritte alcune differenze principali tra l'entità servizio e i metodi di autenticazione utente master.

Considerazione	Entità servizio	Utente master
Meccanismo	L'oggetto entità servizio dell'app Microsoft Entra consente a Microsoft Entra ID di autenticare l'app della soluzione incorporata in Power BI.	L'app Microsoft Entra usa le credenziali (nome utente e password) di un utente di Power BI per eseguire l'autenticazione con Power BI.
Sicurezza	L'entità servizio è il metodo di autorizzazione consigliato per Microsoft Entra ID. Se si usa un'entità servizio, è possibile eseguire l'autenticazione usando un segreto dell'applicazione o un certificato. Questa esercitazione descrive solo l'uso dell'entità servizio con un segreto dell'applicazione. Per incorporare usando un'entità servizio e un certificato, vedere l'articolo relativo all'entità servizio con un certificato.	Questo metodo di autenticazione non è sicuro come un'entità servizio. Devi essere attento con le credenziali utente master (nome utente e password). Ad esempio, non esporli nell'applicazione di incorporamento e modificare frequentemente la password.
Autorizzazioni delegate per l'ID Di Microsoft Entra	Non obbligatorio.	L'utente master o un amministratore deve concedere il consenso all'app per accedere alle autorizzazioni dell'API REST di Power BI (note anche come ambiti). Ad esempio, Report.ReadWrite.All.
accesso servizio Power BI	Non è possibile accedere servizio Power BI con un'entità servizio.	È possibile accedere servizio Power BI con le credenziali utente master.
Licenza	Non richiede una licenza Pro. È possibile usare il contenuto di qualsiasi area di lavoro di cui si è membri o amministratori.	Richiede una licenza Power BI Pro o Premium per utente (PPU).

Passaggio 2 - Registrare un'applicazione Microsoft Entra

La registrazione dell'applicazione con Microsoft Entra ID consente di:

• Stabilire un'identità per l'app
• Consentire all'app di accedere alle API REST di Power BI
• Se si usa un utente master: specificare le autorizzazioni REST di Power BI dell'app

Per registrare l'applicazione con Microsoft Entra ID, seguire le istruzioni riportate in Registrare l'applicazione.

Nota

Prima di registrare l'applicazione, è necessario decidere quale metodo di autenticazione usare, entità servizio o utente master.

Passaggio 3: 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:

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

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 5: Ottenere i valori dei parametri di incorporamento

Per incorporare il contenuto, è necessario ottenere determinati valori di parametro. La tabella seguente mostra i valori necessari e indica se sono applicabili al metodo di autenticazione dell'entità servizio, al metodo di autenticazione utente master o a entrambi.

Prima di incorporare il contenuto, assicurarsi di avere tutti i valori elencati di seguito. Alcuni valori possono variare, a seconda del metodo di autenticazione in uso.

Parametro	Entità servizio	Utente master
ID client
ID area di lavoro
Report ID
Segreto client
ID tenant		obbligatorio solo per Node JS
Nome utente di Power BI
Password di Power BI

ID client

Suggerimento

Si applica a:Utente master dell'entità servizio

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

ID area di lavoro

Suggerimento

Si applica a:Utente master dell'entità servizio

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

   

In alternativa, è possibile trovare l'ID dell'area di lavoro nelle impostazioni del portale di Amministrazione selezionando Dettagli accanto al nome dell'area di lavoro.

ID report

Suggerimento

Si applica a:Utente master dell'entità servizio

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.

   

Segreto client

Suggerimento

Si applica a:Utente master dell'entità servizio

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.

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 tenant

Suggerimento

Si applica a:Utente master dell'entità servizio

Per ottenere il GUID ID tenant, 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 directory (tenant).

Nome utente e password di Power BI

Suggerimento

Si applica a:Utente master dell'entità servizio

Ottenere il nome utente e la password dell'utente di Power BI usato come utente master. Si tratta dello stesso utente usato per creare un'area di lavoro e caricare un report in servizio Power BI.

Passaggio 6 - Accesso all'API dell'entità servizio

Suggerimento

Si applica a:Utente master dell'entità servizio

Questo passaggio è rilevante solo se si usa il metodo di autenticazione dell'entità servizio. Se si usa un utente master, ignorare questo passaggio e continuare con il passaggio 7 - Abilitare l'accesso all'area di lavoro.

Per consentire a un'app Microsoft Entra di accedere al contenuto e alle API di Power BI, un amministratore di Power BI deve abilitare l'accesso all'entità servizio nel portale di amministrazione di Power BI. Se non si è l'amministratore del tenant, ottenere l'amministratore del tenant per abilitare le impostazioni del tenant.

1. In servizio Power BI selezionare Impostazioni> Impostazioni> Amministrazione portale.

   

2. Selezionare Impostazioni tenant e quindi scorrere verso il basso fino alla sezione Impostazioni sviluppatore.

3. Espandere Le entità servizio possono usare le API di Infrastruttura e abilitare questa opzione.

   

Nota

Quando si usa un'entità servizio, è consigliabile limitare l'accesso alle impostazioni del tenant usando un gruppo di sicurezza. Per altre informazioni su questa funzionalità, vedere queste sezioni nell'articolo relativo all'entità servizio:

• Creare un gruppo di sicurezza Microsoft Entra
• Abilitare le impostazioni di amministratore servizio Power BI

Passaggio 7- Abilitare l'accesso all'area di lavoro

Per abilitare l'accesso all'app Microsoft Entra, ad esempio report, dashboard e modelli semantici nella servizio Power BI, aggiungere l'entità servizio o l'utente master, come membro o amministratore all'area di lavoro.

1. Accedi al servizio Power BI.

2. Scorrere fino all'area di lavoro per cui si vuole abilitare l'accesso e scegliere Accesso all'area di lavoro dal menu Altro.

   

3. Nel riquadro Accesso, a seconda del metodo di autenticazione in uso, copiare l'entità servizio o l'utente master nella casella di testo Immetti indirizzo di posta elettronica.

   Nota

   Se si usa un'entità servizio, il nome è il nome assegnato all'app Microsoft Entra.

4. Selezionare Aggiungi.

Passaggio 8: Incorporare il contenuto

L'applicazione di esempio incorporata di Power BI consente di creare un incorporamento per l'app Power BI per i clienti .

Seguire questa procedura per modificare l'applicazione di esempio incorporamento per i clienti 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. A seconda della lingua che vuoi usare l'app, apri una di queste cartelle:

   • .NET Core
   • .NET Framework
   • Java
   • Node JS
   • Python

   Nota

   L'incorporamento per le applicazioni di esempio dei clienti supporta solo i framework elencati in precedenza. L'applicazione di esempio React supporta solo l'incorporamento per la soluzione dell'organizzazione .

5. Aprire la cartella Incorpora per i clienti .

.NET Core

6. Aprire l'app di esempio incorporamento per i clienti usando uno dei metodi seguenti:

   • Se si usa Visual Studio, aprire il file AppOwnsData.sln .

   • Se si usa Visual Studio Code, aprire la cartella AppOwnsData .

7. Aprire appsettings.json.

8. A seconda del metodo di autenticazione, immettere i valori dei parametri seguenti:

   Parametro	Entità servizio	Utente master
   AuthenticationMode	ServicePrincipal	MasterUser
   ClientId	ID client dell'app Microsoft Entra	ID client dell'app Microsoft Entra
   TenantId	ID tenant di Microsoft Entra	N/D
   PbiUsername	N/D	Nome utente master, vedere Nome utente e password di Power BI
   PbiPassword	N/D	Password utente master, vedere Nome utente e password di Power BI
   ClientSecret	Segreto client Microsoft Entra ID	N/D
   WorkspaceId	ID dell'area di lavoro con il report incorporato, vedere ID area di lavoro	ID dell'area di lavoro con il report incorporato, vedere ID area di lavoro
   ReportId	ID del report che si sta incorporando, vedere ID report	ID del report che si sta incorporando, vedere ID report

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

.NET Framework

6. Usando Visual Studio, aprire il file AppOwnsData.sln .

7. Aprire Web.config.

8. A seconda del metodo di autenticazione, immettere i valori dei parametri seguenti:

   Parametro	Entità servizio	Utente master
   authenticationType	ServicePrincipal	MasterUser
   applicationId	ID client dell'app Microsoft Entra	ID client dell'app Microsoft Entra
   workspaceId	ID dell'area di lavoro con il report incorporato, vedere ID area di lavoro	ID dell'area di lavoro con il report incorporato, vedere ID area di lavoro
   reportId	ID del report che si sta incorporando, vedere ID report	ID del report che si sta incorporando, vedere ID report
   pbiUsername	N/D	Nome utente master, vedere Nome utente e password di Power BI
   pbiPassword	N/D	Password utente master, vedere Nome utente e password di Power BI
   applicationSecret	Segreto client Microsoft Entra ID	N/D
   tenant	ID tenant di Microsoft Entra	N/D

9. Eseguire il progetto selezionando IIS Express (riproduzione).

Java

6. Aprire Eclipse e seguire le istruzioni descritte di seguito.

   Nota

   Le istruzioni per l'incorporamento Java per l'app di esempio per i clienti, vedere IDE Eclipse per Java edizione Enterprise Developers (enterprise edition). Se si usa un'applicazione diversa, è necessario configurarla manualmente.

7. Aggiungere il server Tomcat a Eclipse:

   a. Selezionare La finestra>Mostra server di visualizzazione.>

   b. Nella scheda Server selezionare Nessun server disponibile. Fare clic su questo collegamento per creare un nuovo server.

   c. Nella finestra Definisci un nuovo server espandere Apache e selezionare il server Tomcat in esecuzione nel computer. Ad esempio, Tomcat v9.0 Server.

   d. Selezionare Avanti.

   e. Nella finestra Del server Tomcat selezionare Sfoglia e passare alla cartella che contiene il server Tomcat.

   f. Nella finestra Del server Tomcat selezionare JREs installati.

   g. Nella finestra JREs installati selezionare il jre disponibile e selezionare Applica e chiudi.

   h. Nella finestra Del server Tomcat selezionare Fine. È possibile visualizzare il server Tomcat nella scheda Server .

8. Aprire il progetto in Eclipse:

   Importante

   Eclipse potrebbe riscontrare problemi se il nome del percorso è troppo lungo. Per evitare questo problema, verificare che la cartella dell'app di esempio non sia annidata troppo in profondità nella struttura di cartelle del computer.

   a. Selezionare File e quindi Apri progetti da File System.

   b. Nella finestra Importa progetti da file system o archivio selezionare Directory e aprire la cartella AppOwnsData .

   c. Selezionare Fine.

9. Aggiungere il server Tomcat al progetto:

   a. Nel riquadro Esplora pacchetti fare clic con il pulsante destro del mouse su AppOwnsData e scegliere Proprietà.

   b. Nella finestra Proprietà per AppOwnsData selezionare Runtime di destinazione e quindi Apache Tomcat. Questa selezione include la versione di Apache Tomcat in uso, ad esempio Apache Tomcat v9.0.

   c. Selezionare Applica e Chiudi.

10. Compilare i parametri obbligatori

    a. In Esplora pacchetti espandere il progetto AppOwnsData.

    b. Espandere Risorse Java.

    c. Espandere src.

    d. Espandere com.embedsample.appoensdata.config.

    e. Aprire Config.java.

    f. A seconda del metodo di autenticazione, immettere i valori dei parametri seguenti:

    Parametro	Entità servizio	Utente master
    authenticationType	ServicePrincipal	MasterUser
    workspaceId	ID dell'area di lavoro con il report incorporato, vedere ID area di lavoro	ID dell'area di lavoro con il report incorporato, vedere ID area di lavoro
    reportId	ID del report che si sta incorporando, vedere ID report	ID del report che si sta incorporando, vedere ID report
    clientId	ID client dell'app Microsoft Entra	ID client dell'app Microsoft Entra
    pbiUsername	N/D	Nome utente master, vedere Nome utente e password di Power BI
    pbiPassword	N/D	Password utente master, vedere Nome utente e password di Power BI
    tenantId	ID tenant di Microsoft Entra	N/D
    appSecret	Segreto client Microsoft Entra ID	N/D

11. Eseguire il progetto

    a. In Esplora pacchetti fare clic con il pulsante destro del mouse su AppOwnesData.

    b. Selezionare Esegui come>eseguito nel server.

    c. Nella finestra Esegui sul server selezionare Scegliere un server esistente e selezionare il server Tomcat .

    d. Selezionare Fine.

Node JS

6. Aprire la cartella App Owns Data usando l'IDE preferito. È consigliabile usare uno dei seguenti elementi:

   • Visual Studio

   • Visual Studio Code

7. Aprire un terminale e installare le dipendenze necessarie eseguendo : npm install.

8. Espandere la cartella Config e aprire config.json.

9. A seconda del metodo di autenticazione, immettere i valori dei parametri seguenti:

   Parametro	Entità servizio	Utente master
   authenticationMode	ServicePrincipal	MasterUser
   clientId	ID client dell'app Microsoft Entra	ID client dell'app Microsoft Entra
   workspaceId	ID dell'area di lavoro con il report incorporato, vedere ID area di lavoro	ID dell'area di lavoro con il report incorporato, vedere ID area di lavoro
   reportId	ID del report che si sta incorporando, vedere ID report	ID del report che si sta incorporando, vedere ID report
   pbiUsername	N/D	Nome utente master, vedere Nome utente e password di Power BI
   pbiPassword	N/D	Password utente master, vedere Nome utente e password di Power BI
   clientSecret	Segreto client Microsoft Entra ID	N/D
   tenantId	ID tenant di Microsoft Entra	ID tenant di Microsoft Entra

10. Eseguire il progetto eseguendo le operazioni seguenti:

    a. Nel terminale dell'IDE eseguire npm start.

    b. Aprire una nuova scheda nel browser e passare a http://localhost:5300.

Python

6. Aprire PowerShell o prompt dei comandi.

7. Verificare di essere nella cartella Python>Embed for your customers e che il file requirements.txt si trovi nella cartella ed eseguire .pip3 install -r requirements.txt

8. Aprire la cartella App Owns Data usando l'IDE preferito. È consigliabile usare uno degli ambienti seguenti:

   • Visual Studio

   • Visual Studio Code

9. Aprire config.py.

10. A seconda del metodo di autenticazione, immettere i valori dei parametri seguenti:

    Parametro	Entità servizio	Utente master
    AUTHENTICATION_MODE	ServicePrincipal	MasterUser
    WORKSPACE_ID	ID dell'area di lavoro con il report incorporato, vedere ID area di lavoro	ID dell'area di lavoro con il report incorporato, vedere ID area di lavoro
    REPORT_ID	ID del report che si sta incorporando, vedere ID report	ID del report che si sta incorporando, vedere ID report
    TENANT_ID	ID tenant di Microsoft Entra	N/D
    CLIENT_ID	ID client dell'app Microsoft Entra	ID client dell'app Microsoft Entra
    CLIENT_SECRET	Segreto client Microsoft Entra ID	N/D
    POWER_BI_USER	N/D	Nome utente master, vedere Nome utente e password di Power BI
    POWER_BI_PASS	N/D	Password utente master, vedere Nome utente e password di Power BI

11. Salvare il file.

12. Eseguire il progetto seguendo questa procedura:

    a. In PowerShell o nel prompt dei comandi passare alla cartella Incorpora Python>per i clienti>AppOwnesData ed eseguire .flask run

    b. Aprire una nuova scheda nel browser e passare a http://localhost:5000.

Sviluppo dell'applicazione

Dopo aver configurato ed eseguito l'applicazione di esempio incorporamento per i clienti , è possibile iniziare a sviluppare un'applicazione personalizzata.

Provare il playground di analisi incorporata di Power BI per iniziare a sviluppare e mantenere il passo con tutte le nuove funzionalità e gli aggiornamenti di Power BI Embedded.

Quando si è pronti, esaminare il passaggio ai requisiti di produzione . Sarà necessaria anche una capacità e si esaminerà l'articolo sulla pianificazione della capacità per stabilire lo SKU più adatto alle proprie esigenze.

Importante

Se sono stati usati token di valutazione gratuiti per lo sviluppo, è necessario acquistare una capacità per la produzione. Fino a quando non viene acquistata una capacità, il banner versione di valutazione gratuita continuerà a essere visualizzato nella parte superiore del report incorporato.

Contenuto correlato

• Passare in produzione
• Incorporamento per l'organizzazione
• Incorporare report impaginati

Altre domande? Chiedi al Community di Power BI.