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

  • Articolo

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.

Questa esercitazione illustra come:

  • 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 dovranno 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 entrambe le dipendenze di Power BI e del codice elencate di seguito:

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.

La tabella seguente descrive 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.

    A screenshot showing the ZIP download option in the Power B I desktop samples GitHub

  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 variano a seconda del metodo di autenticazione in uso.

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

Client ID

Suggerimento

Si applica a:Applies to.Utente master dell'entità Applies to.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:Applies to.Utente master dell'entità Applies to.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/.

    A screenshot showing workspace ID GUID in the Power B I service U R L

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.

A screenshot showing how to find the workspace I D from the admin settings.

ID report

Suggerimento

Si applica a:Applies to.Utente master dell'entità Applies to.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.

    A screenshot showing report ID GUID in the Power B I service U R L

Segreto client

Suggerimento

Si applica a:Applies to.Utente master dell'entità Does not apply to.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:Applies to.Utente master dell'entità Does not apply to.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:Does not apply to.Utente master dell'entità Applies to.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:Applies to.Utente master dell'entità Does not apply to.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.

    A screenshot showing the admin settings menu option in the Power B I service settings menu.

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

  3. Espandere Consenti alle entità servizio di usare API Power BI e abilitare questa opzione.

    A screenshot showing how to enable the developer settings option, in the tenant settings menu option, in Power B I service.

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:

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.

    Screenshot showing the workspace access button in the more menu of a Power B I workspace.

  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.

    A screenshot showing the ZIP download option in the Power B I developer samples GitHub

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

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

  2. Aprire la cartella Incorpora per i clienti .

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

  2. Aprire appsettings.json.

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

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

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

Altre domande? Chiedi al Community di Power BI.