Condividi tramite


Esercitazione: incorporare contenuti di Power BI usando un esempio di incorporamento di per l'applicazione dei clienti

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

L'analisi incorporata e Power BI Embedded (l'offerta Azure) consentono di incorporare contenuti di Power BI come report, dashboard e riquadri nell'applicazione.

In questa esercitazione apprenderai a:

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

Per usare l'applicazione, gli utenti non dovranno accedere a Power BI né 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 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 i clienti in uno dei contesti 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 che siano disponibili le dipendenze, sia di Power BI, sia del codice elencate di seguito:

metodo

Per creare un'app di esempio con incorporamento per i clienti, seguire questi passaggi:

  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 sia la soluzione più adatta.

Nella tabella seguente vengono descritte alcune differenze principali tra i metodi di autenticazione con entità servizio e con 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 in 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 soltanto l'uso dell'entità servizio con un segreto dell'applicazione. Per eseguire l'incorporamento con un'entità servizio e un certificato, vedere l'articolo Entità servizio con un certificato.
Questo metodo di autenticazione non è sicuro come un'entità servizio. Il motivo è che occorre vigilare sulle credenziali (nome utente e password) dell'utente master. 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 consentire all'app di accedere alle autorizzazioni (note anche come ambiti) dell'API REST di Power BI. Ad esempio, Report.ReadWrite.All.
Accesso al servizio Power BI Non è possibile accedere al servizio Power BI con un'entità servizio. È possibile accedere al servizio Power BI con le credenziali dell'utente master.
Licenza Non è richiesta una licenza Pro. È possibile usare il contenuto di qualsiasi area di lavoro di cui si è membri o amministratori. È necessaria 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:

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

Nota

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

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

  1. Accedere a Fabric.

  2. Selezionare Aree di lavoro.

  3. Selezionare + Nuova 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 è 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:

  1. Aprire la cartella GitHub Power BI Desktop samples.

  2. Selezionare Code (Codice) e quindi selezionare Download zip (Scarica ZIP).

    Screenshot che mostra l'opzione per scaricare lo ZIP nella cartella di GitHub degli esempi desktop di Power BI

  3. Estrarre il file ZIP scaricato e passare alla cartella Samples Reports.

  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 parametri. La tabella seguente mostra i valori richiesti e indica se sono applicabili al metodo di autenticazione con entità servizio, al metodo di autenticazione con utente master o a entrambi.

Prima di incorporare il contenuto, assicurarsi di avere tutti i valori elencati di seguito. Alcuni valori potrebbero essere differenti, a seconda del metodo di autenticazione utilizzato.

Parametro Entità servizio Utente master
ID client Si applica a. Si applica a.
ID area di lavoro Si applica a. Si applica a.
ID report Si applica a. Si applica a.
Segreto client Si applica a. Non si applica a.
ID tenant Si applica a. necessario solo per Node JS
Nome utente di Power BI Non si applica a. Si applica a.
Password di Power BI Non si applica a. Si applica a.

ID client

Suggerimento

Si applica a:Si applica a.Utente master dell'entità Si applica a.servizio

Per ottenere il GUID dell'ID del client (noto anche come ID dell'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 utilizzata per incorporare il contenuto di Power BI.

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

ID area di lavoro

Suggerimento

Si applica a:Si applica a.Utente master dell'entità Si applica a.servizio

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

  1. Accedi al servizio Power BI.

  2. Aprire il report che si vuole incorporare.

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

    Screenshot che mostra il GUID dell'ID dell'area di lavoro nell'URL del servizio Power BI

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.

Screenshot che mostra come trovare l'ID dell'area di lavoro dalle impostazioni di amministrazione.

ID report

Suggerimento

Si applica a:Si applica a.Utente master dell'entità Si applica a.servizio

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

  1. Accedi al servizio Power BI.

  2. Aprire il report che si vuole incorporare.

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

    Screenshot che mostra il GUID dell'ID del report nell'URL del servizio Power BI

Segreto client

Suggerimento

Si applica a:Si applica a.Utente master dell'entità Non si applica a.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 utilizzata 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 la scadenza del segreto dell'applicazione e quindi selezionare Aggiungi.

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

Suggerimento

Si applica a:Si applica a.Utente master dell'entità Non si applica a.servizio

Per ottenere il GUID dell'ID del 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 utilizzata per incorporare il contenuto di Power BI.

  4. Dalla sezione Panoramica copiare il GUID ID della directory (tenant).

Nome utente e password di Power BI

Suggerimento

Si applica a:Non si applica a.Utente master dell'entità Si applica a.servizio

Ottenere il nome utente e la password dell'utente di Power BI che si sta usando come utente master. Si tratta dello stesso utente usato per creare un'area di lavoro e caricarvi un report nel servizio Power BI.

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

Suggerimento

Si applica a:Si applica a.Utente master dell'entità Non si applica a.servizio

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

Per consentire a un'app Microsoft Entra di accedere ai contenuti 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, richiedere all'amministratore del tenant di abilitare Impostazioni tenant.

  1. In Servizio Power BI selezionare Impostazioni>Impostazioni>Portale di amministrazione.

    Screenshot che mostra l'opzione di menu per le impostazioni di amministrazione nel menu delle impostazioni del servizio Power BI.

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

  3. Per espandere le entità servizio possono occorrere le API di Fabric e l'abilitazione di questa opzione.

    Screenshot che illustra come abilitare l'opzione Impostazioni modalità sviluppatore nell'opzione del menu Impostazioni tenant, nel servizio Power BI.

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 consentire all'app Microsoft Entra di accedere ad oggetti come report, dashboard e modelli semantici nel servizio Power BI, aggiungere l'entità servizio o l'utente master come membro o amministratore nell'area di lavoro.

  1. Accedere a Fabric.

  2. Scorrere fino all'area di lavoro per cui si vuole abilitare l'accesso e selezionare Gestisci accesso.

    Screenshot del pulsante di accesso all'area di lavoro nel menu Altro di un'area di lavoro Power BI.

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

    Nota

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

  4. Selezionare Aggiungi.

Passaggio 8 - Incorporare il contenuto

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

Per incorporare il report di Power BI, seguire questa procedura per modificare l'applicazione di esempio con incorporamento per i clienti.

  1. Aprire la cartella Power BI developer samples.

  2. Selezionare Code (Codice) e quindi selezionare Download zip (Scarica ZIP).

    Screenshot che mostra l'opzione per scaricare lo ZIP nella cartella di GitHub degli esempi di Power BI per sviluppatori

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

  1. A seconda del linguaggio che si vuole usare per l'applicazione, aprire una delle cartelle seguenti:

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

    Nota

    Le applicazioni di esempio con incorporamento per i clienti supportano solo i contesti elencati in precedenza. L'applicazione di esempio React supporta soltanto la soluzione di incorporamento per l'organizzazione.

  2. Aprire la cartella Embed for your customers.

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

  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 di Microsoft Entra ID client dell'app di Microsoft Entra
    TenantId ID tenant di Microsoft Entra N/D
    PbiUsername N/D Nome utente dell'utente master, vedere Nome utente e password di Power BI
    PbiPassword N/D Password dell'utente master, vedere Nome utente e password di Power BI
    ClientSecret Segreto client di 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 (Esegui).

    • Se si usa Visual Studio Code, selezionare Esegui > Avvia debug.

Sviluppo dell'applicazione

Dopo aver configurato ed eseguito l'applicazione di esempio con 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, rivedere i requisiti per il passaggio in produzione. Sarà necessaria anche una capacità ed è consigliabile leggere l'articolo 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 della versione di valutazione gratuita continuerà a essere visualizzato nella parte superiore del report incorporato.

Altre domande? Inviare una domanda alla community di Power BI.