Configurare Power BI Embedded

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

Per iniziare a usare Power BI Embedded per condividere i report con altri utenti, usare lo strumento di configurazione dell'analisi incorporata di Power BI per iniziare. Questo articolo illustra i passaggi da eseguire.

Per usare l'analisi incorporata di Power BI, è necessario registrare un'applicazione Microsoft Entra in Azure. L'app Microsoft Entra stabilisce le autorizzazioni per le risorse REST di Power BI e consente l'accesso alle API REST di Power BI.

Prerequisito

Per configurare un ambiente di analisi incorporata di Power BI, è necessario uno dei seguenti:

Operazioni preliminari

Prima di poter registrare l'app, decidere quali delle soluzioni seguenti meglio si adattano alle proprie esigenze:

Incorpora per i clienti

Usare la soluzione embed-for-your-customers , nota anche come dati di proprietà dell'app, se si crea un'app progettata per i clienti. Gli utenti non devono accedere a Power BI o avere una licenza di Power BI per usare l'app. L'app esegue l'autenticazione in Power BI usando un account utente master (una licenza di Power BI Pro usata per l'accesso a Power BI) o un'entità servizio.

La soluzione embed-for-your-customers viene in genere usata da fornitori di software indipendenti (ISV) e sviluppatori che creano applicazioni per terze parti.

Incorpora per l'organizzazione

Usare la soluzione embed-for-your-organization , nota anche come dati di proprietà dell'utente, se si crea un'applicazione che richiede agli utenti di usare le proprie credenziali per l'autenticazione in Power BI.

La soluzione embed-for-your-organization viene in genere usata dalle aziende e dalle organizzazioni di grandi dimensioni ed è destinata agli utenti interni.

Per altre informazioni sulle due soluzioni, vedere Informazioni sulle soluzioni di analisi incorporate di Power BI.

Configurare l'ambiente

Dopo aver compreso le due opzioni di incorporamento, è possibile usare lo strumento di installazione per creare l'ambiente Power BI Embedded.

Se si preferisce configurare manualmente l'ambiente, ignorare i passaggi descritti nelle sezioni seguenti. Seguire invece i passaggi descritti in Registrazione manuale, più avanti in questo articolo.

Importante

Se si esegue l'incorporamento per un GCC, seguire le istruzioni in Registrazione manuale.

Per usare lo strumento per configurare l'ambiente, passare allo strumento di configurazione dell'analisi incorporata di Power BI. Selezionare l'opzione di incorporamento desiderata.

Screenshot of the Power BI embedded analytics setup tool. The options for embedding for your customers or for your organization are highlighted.

Passaggio 1- Accedere a Power BI

  1. In Passaggio 1 dello strumento di installazione selezionare Accedi. Questo passaggio consente di accedere a Power BI. Se viene richiesto di selezionare un account, accedere con un utente appartenente al tenant di Power BI. L'app Microsoft Entra viene registrata con questo utente.

    Screenshot of the Power BI embedded analytics setup tool. Under Step 1, the Sign in button is highlighted.

    Nota

    Se è già stato eseguito l'accesso, verificare di aver eseguito l'accesso con l'utente che si vuole usare per creare l'app Microsoft Entra. Per modificare gli utenti, selezionare Disconnetti. Dopo il riavvio dello strumento, accedere con l'utente corretto.

  2. Selezionare Avanti per passare al passaggio successivo.

    Screenshot of the Power BI embedded analytics setup tool after a user has signed in to Power BI. The Next button in highlighted.

Passaggio 2: Registrare l'applicazione

In questo passaggio si registra un'applicazione Microsoft Entra in Azure. L'app Microsoft Entra stabilisce le autorizzazioni per le risorse REST di Power BI e consente l'accesso alle API REST di Power BI. È sempre possibile modificare queste impostazioni in un secondo momento.

  1. Per registrare l'applicazione per i clienti, compilare i campi seguenti:

    • Nome applicazione: assegnare un nome all'applicazione.

    • Accesso all'API: selezionare i API Power BI (noti anche come ambiti) necessari per l'applicazione. È possibile selezionare Seleziona tutto per selezionare tutte le API. Per altre informazioni sulle autorizzazioni di accesso di Power BI, vedere Autorizzazioni e consenso nell'endpoint di Microsoft Identity Platform.

    Screenshot of the Power BI embedded analytics setup tool. The step for registering an app is visible, with an app name box and API access options.

  2. Selezionare Registra.

  3. L'ID applicazione dell'app Microsoft Entra viene visualizzato nella casella Riepilogo. Copiare questo valore per usarlo in un secondo momento.

    Screenshot of the Power BI embedded analytics setup tool, with a Summary box on the right. Information in the box includes an application ID.

Passaggio 3: Creare un'area di lavoro (facoltativo)

Creare un'area di lavoro nel servizio Power BI:

  • Se si dispone già di un'area di lavoro di Power BI, selezionare Ignora.

  • Per creare un'area di lavoro, immettere un nome per l'area di lavoro e quindi selezionare Crea area di lavoro. Il nome e l'ID dell'area di lavoro vengono visualizzati nella casella Riepilogo . Copiare questi valori per usarli in un secondo momento.

    Suggerimento

    Affinché l'app di esempio di analisi incorporata funzioni come previsto, è necessario usare lo strumento per creare un'area di lavoro.

Passaggio 4 - Importare contenuto (facoltativo)

Selezionare una delle seguenti opzioni:

  • Se si ha un'app Power BI personalizzata, è possibile selezionare Ignora.

  • Se si vuole creare un'app Power BI di esempio usando un report di esempio, selezionare Report di Power BI di esempio e quindi selezionare Importa.

  • Se si vuole creare un'app Power BI di esempio usando il proprio report, selezionare Carica un file con estensione pbix, cercare il file e quindi selezionare Importa.

Passaggio 5- Concedere le autorizzazioni (incorporamento solo per i clienti )

Selezionare Concedi autorizzazioni e nella finestra di dialogo selezionare Accetta. Questo passaggio consente all'app Microsoft Entra di accedere alle API selezionate (note anche come ambiti) con l'utente connesso. Questo utente è noto anche come utente master.

Scaricare l'app di esempio (facoltativo)

Se è stata creata un'area di lavoro di Power BI e ne è stato caricato il contenuto usando questo strumento, è ora possibile selezionare Scarica applicazione di esempio.

Nota

Se le fasi facoltative sono state ignorate, è comunque possibile scaricare un'app Power BI di esempio. Tuttavia, il codice nell'app scaricata non contiene le proprietà che vengono compilate durante la registrazione. Ad esempio, se non si crea un'area di lavoro, l'app di esempio non include l'ID dell'area di lavoro.

Assicurarsi di copiare tutte le informazioni nella casella Riepilogo . L'ambiente di incorporamento di Power BI è pronto per l'uso.

Registrazione manuale

Se non è stato usato lo strumento di configurazione dell'analisi incorporata di Power BI, usare la procedura descritta in questa sezione per registrare manualmente un'app Microsoft Entra. Tuttavia, eseguire questi passaggi solo se si sta creando una delle soluzioni seguenti:

  • Applicazione embed-for-your-organization
  • Applicazione embed-for-your-customers con un'entità servizio

Per altre informazioni su come registrare le applicazioni in Microsoft Entra ID, vedere Registrare un'applicazione con Microsoft Identity Platform.

  1. Accedere al portale di Azure.

  2. Selezionare il tenant di Microsoft Entra selezionando l'account nell'angolo superiore destro della pagina.

  3. Selezionare Registrazioni app. Se questa opzione non viene visualizzata, cercarla.

  4. In Registrazioni app selezionare Nuova registrazione.

  5. Specificare i seguenti campi:

    • Nome : assegnare un nome all'applicazione.

    • Tipo di account supportato: selezionare chi può usare l'applicazione.

  6. (Facoltativo) Nella casella URI di reindirizzamento aggiungere un URL di reindirizzamento.

  7. Selezionare Registra. Dopo aver registrato l'app, si viene indirizzati alla pagina di panoramica dell'app, in cui è possibile ottenere l'ID applicazione.

Altre domande? Provare a chiedere il Community di Power BI.