Incorporare i dashboard, i report e i riquadri di Power BIEmbed your Power BI dashboards, reports and tiles

Informazioni sulla procedura da seguire per incorporare il contenuto di Power BI all'interno dell'applicazione.Learn about the steps you need to take to embed Power BI content within your application.

Microsoft ha annunciato Power BI Premium, un nuovo modello di gestione delle licenze basato sulla capacità che aumenta la flessibilità di accesso, condivisione e distribuzione del contenuto per gli utenti.Microsoft announced Power BI Premium, a new capacity-based licensing model that increases flexibility for how users access, share and distribute content. L'offerta aggiunge anche ulteriore scalabilità e rendimento al servizio Power BI.The offering also delivers additional scalability and performance to the Power BI service. È stato annunciato anche Power BI Embedded, che consente la creazione di capacità in Microsoft Azure.Power BI Embedded was also announced that allows for creating capacity within Microsoft Azure. Power BI Embedded è incentrato sull'applicazione e sui clienti dell'utente.Power BI Embedded is focused on your application and your customers.

Questo articolo esamina la procedura per incorporare il contenuto di Power BI per l'organizzazione e i clienti.This article will look at embedding your Power BI content for both your organization and your customers. I passaggi sono simili per entrambi gli scenari.The steps are similar between the two scenarios. Verranno eseguiti dei callout quando un passaggio è specifico per la procedura di incorporamento per il cliente.Callouts will be made when a step is specific to embedding for your customer.

A tale scopo, sono previsti alcuni passaggi che è necessario eseguire con l'applicazione.There are a few steps you have to do with your application to make this possible. Verranno esaminati i passaggi necessari a consentire di creare e usare un contenuto incorporato all'interno dell'applicazione.We will go through the steps needed to allow you to create and use embedded content within your application.

Nota

Le API di Power BI fanno ancora riferimento alle aree di lavoro per le app come gruppi.The Power BI APIs still refer to app workspaces as groups. I riferimenti ai gruppi indicano che si stanno usando le aree di lavoro per le app.Any references to groups mean that you are working with app workspaces.

Passaggio 1: Configurare l'ambiente di sviluppo di analisi incorporatoStep 1: Setup your embedded analytics development environment

Prima di iniziare la procedura di incorporamento di dashboard e report in un'applicazione, è necessario assicurarsi che l'ambiente sia configurato per consentire per l'incorporamento.Before you start embedding dashboards and reports into your application, you need to make sure your environment is setup to allow for embedding. Come parte dell'installazione, sarà necessario eseguire le operazioni seguenti.As part of the setup, you will need to do the following.

Nota

La capacità di Power BI non è necessaria per lo sviluppo dell'applicazione.Power BI capacity is not required for development of your application. Gli sviluppatori dell'applicazione dovranno avere la licenza di Power BI Pro.The developers of the application will need to have a Power BI Pro license.

Tenant di Azure Active DirectoryAzure Active Directory tenant

Per incorporare gli elementi da Power BI è necessario un tenant di Azure Active Directory (Azure AD).You will need an Azure Active Directory (Azure AD) tenant in order to embed items from Power BI. Questo tenant deve avere almeno un utente di Power BI Pro.This tenant must have at least one Power BI Pro user. È inoltre necessario definire un'app di Azure AD nel tenant.You will also need to define an Azure AD app within the tenant. È possibile usare un tenant di Azure AD esistente o crearne uno nuovo specifico per eseguire l'incorporamento.You can make use of an existing Azure AD tenant or create a new one specifically for embedding purposes.

Sarà necessario determinare quale configurazione del tenant usare in caso di incorporamento per i clienti.You will need to determine what tenant setup to use if you are embedding for your customers.

  • Usare il tenant di Power BI aziendale esistente?Use your existing corporate Power BI tenant?
  • Usare un tenant diverso per l'applicazione?Use a separate tenant for your application?
  • Usare un tenant diverso per ogni cliente?Use a separate tenant for each customer?

Se non si vuole usare un tenant esistente, è possibile decidere di creare un nuovo tenant per l'applicazione o di crearne uno per ogni cliente. Vedere Creare un tenant di Azure Active Directory o Come ottenere un tenant di Azure Active Directory.If you do not want to use an existing tenant, you can decide to create a new tenant for your application, or one for each customer, see Create an Azure Active Directory tenant or How to get an Azure Active Directory tenant.

Creare un account utente di Power BI ProCreate a Power BI Pro user account

Per incorporare il contenuto è necessario disporre di un solo account di Power BI Pro.You only need a single Power BI Pro account to embed content. Tuttavia, è consigliabile disporre di diversi utenti che hanno un accesso specifico agli elementi.However, you may want to have a few different users that have specific access to items. Ecco gli utenti che è possibile prendere in considerazione all'interno del tenant.Here is a look at possible users to consider within your tenant.

I seguenti account dovranno esistere all'interno del tenant e avere una licenza per Power BI Pro.The following accounts will need to exist within your tenant and have a Power BI Pro license assigned to them. Per usare le aree di lavoro dell'app in Power BI, è necessaria una licenza per Power BI Pro.A Power BI Pro license is required to work with app workspaces within Power BI.

Un utente amministratore del tenant/dell'organizzazioneAn organization/tenant admin user

È consigliabile che l'utente amministratore globale del tenant o dell'organizzazione non sia usato come account dell'applicazione in caso di incorporamento per i clienti,It is recommended that your organization/tenant Global Admin user should not be used as account your application uses if embedding for your customers. allo scopo di ridurre l'accesso dell'account dell'applicazione all'interno del tenant.This is to minimize access that the application account has within your tenant. È consigliabile che l'utente amministratore sia amministratore di tutte le aree di lavoro per le app create allo scopo dell'incorporamento.It is recommended that the admin user be an admin of all app workspaces created for the purpose of embedding.

Account per gli analisti che creeranno il contenutoAccounts for analysts that will create content

Possono esserci più utenti che creano contenuto per Power BI.You may have multiple users that create content for Power BI. È necessario un account di Power BI Pro per ogni analista che crea e distribuisce il contenuto in Power BI.You will need a Power BI Pro account for each analyst that is creating and deploying content to Power BI.

Account utente master dell'applicazione per l'incorporamento per i clientiAn application master user account for embedding for your customers

L'account master è l'account che verrà usato dall'applicazione durante l'incorporamento del contenuto per i clienti.The master account is the account your application will use when embedding content for your customers. Questo scenario è in genere relativo ad applicazioni ISV.The scenario is typically for ISV applications. L'account master è l'unico account obbligatorio che è necessario all'interno dell'organizzazione.The master account is really the only required account you need within your organization. Può anche essere usato come account di amministratore e analista, ma non è consigliato.It can also be used as the admin and analyst account, but it is not recommended. Il back-end delle applicazioni memorizza le credenziali per l'account e le userà per acquisire un token di autenticazione di Azure AD da usare con le API di Power BI.Your application's backend will store the credentials for this account and use it for acquiring an Azure AD auth token for use with the Power BI APIs. Questo account verrà usato per generare il token di incorporamento per l'applicazione da usare per i clienti.This account will be used to generate an embed token for the application to use for your customers.

L'account master è semplicemente un utente normale con una licenza di Power BI Pro che viene usato con l'applicazione.The master account is just a regular user with a Power BI Pro license that you use with your application. Deve essere un account amministratore delle aree di lavoro per le app create per l'incorporamento.The account must be an admin of the app workspace that is being used for embedding.

Registrazione e autorizzazioni dell'appApp registration and permissions

Sarà necessario registrare l'applicazione in Azure AD per effettuare chiamate all'API REST.You will need to register your application with Azure AD in order to make REST API calls. Per altre informazioni, vedere Registrare un'app di Azure AD per incorporare il contenuto di Power BI.For more information, see Register an Azure AD app to embed Power BI content.

Creare aree di lavoro per le appCreate app workspaces

Se si intende incorporare i dashboard e i report per i clienti, questi devono essere inseriti all'interno di un'area di lavoro per le app.If you are embedding dashboards and reports for your customers, those dashboards and reports have to be placed within an app workspace. L'account master indicato in precedenza deve essere un amministratore dell'area di lavoro per le app.The master account, that was mentioned above, must be an admin of the app workspace.

  1. Iniziare creando l'area di lavoro.Start by creating the workspace. Selezionare Aree di lavoro > Creare un'area di lavoro per le app.Select Workspaces > Create app workspace.

    Creare un'area di lavoro per le app

    Questa sarà la posizione in cui inserire il contenuto su cui collaborare assieme ai colleghi.This will be the place to put content that you and your colleagues collaborate on.

  2. Assegnare un nome all'area di lavoro.Give the workspace a name. Se il corrispondente ID area di lavoro non è disponibile, modificarlo in modo da ottenere un ID univoco.If the corresponding Workspace ID isn't available, edit it to come up with a unique ID.

    Questo sarà anche il nome dell'app.This will be the name of the app, too.

    Denominare l'area di lavoro

  3. Ci sono alcune opzioni da impostare.You have a few options to set. Se si sceglie Pubblica, chiunque nell'organizzazione potrà visualizzare il contenuto dell'area di lavoro.If you choose Public, anyone in your organization can see what’s in the workspace. Privata, d'altra parte, significa che solo i membri dell'area di lavoro potranno visualizzarne il contenuto.Private, on the other hand, means only members of the workspace can see its contents.

    Scegliere l'impostazione Privata o Pubblica

    Dopo aver creato il gruppo, non è possibile modificare l'impostazione di gruppo pubblico o privato.You can't change the Public/Private setting after you've created the group.

  4. È anche possibile scegliere se i membri possono modificare o avere l'accesso di sola visualizzazione.You can also choose if members can edit or have view-only access.

    Impostare su Modifica o Solo visualizzazione

    Aggiungere all'area di lavoro per le app solo utenti che possono modificare il contenuto.Only add people to the app workspace so they can edit the content. Se l'utente potrà soltanto visualizzare il contenuto, non aggiungerlo all'area di lavoro.If they're only going to view the content, don't add them to the workspace. È possibile includerlo quando si pubblica l'app.You can include them when you publish the app.

  5. Aggiungere gli indirizzi di posta elettronica delle persone che avranno accesso all'area di lavoro e selezionare Aggiungi.Add email addresses of people you want to have access to the workspace, and select Add. Non è possibile aggiungere alias di gruppo, soli singoli utenti.You can’t add group aliases, just individuals.

  6. Decidere se ogni persona è un membro o un amministratore.Decide whether each person is a member or an admin.

    Impostare come Membro o Amministratore

    Gli amministratori possono modificare l'area di lavoro stessa, inclusa l'aggiunta di altri membri.Admins can edit the workspace itself, including adding other members. I membri possono modificare il contenuto nell'area di lavoro, a meno che non abbiano accesso in sola visualizzazione.Members can edit the content in the workspace, unless they have view-only access. Sia gli amministratori che i membri possono pubblicare l'app.Both admins and members can publish the app.

  7. Selezionare Salva.Select Save.

Power BI crea l'area di lavoro, che verrà apertaPower BI creates the workspace and opens it. e visualizzata nell'elenco delle aree di lavoro di cui si è membri.It appears in the list of workspaces you’re a member of. Gli amministratori potranno a questo punto selezionare i puntini di sospensione (…) per tornare indietro e apportare modifiche, aggiungere nuovi membri o modificarne le autorizzazioni.Because you’re an admin, you can select the ellipsis (…) to go back and make changes to it, adding new members or changing their permissions.

Modifica area di lavoro

Creare e caricare i reportCreate and upload your reports

È possibile creare report e set di dati usando Power BI Desktop e quindi pubblicando tali report in un'area di lavoro per le app.You can create your reports and datasets using Power BI Desktop and then publish those reports to an app workspace. Per pubblicare in un'area di lavoro per le app l'utente finale che pubblica i report deve avere una licenza di Power BI Pro.The end user publishing the reports need to have a Power BI Pro license in order to publish to an app workspace.

Passaggio 2: Incorporare il contenutoStep 2: Embed your content

All'interno dell'applicazione è necessario eseguire l'autenticazione con Power BI.Within your application, you will need to authenticate with Power BI. Se si intende incorporare il contenuto per i clienti, le credenziali per l'account master verranno archiviate all'interno dell'applicazione.If you are embedding content for your customers, you will store the credentials for the master account within your application. Per altre informazioni, vedere Autenticare gli utenti e ottenere un token di accesso di Azure AD per l'app Power BI.For more information, see Authenticate users and get an Azure AD access token for your Power BI app.

Dopo l'autenticazione, nell'applicazione usare le API REST di Power BI e le API JavaScript per incorporare dashboard e report nell'applicazione.Once authenticated, within your application, use the Power BI REST APIs and JavaScript APIs to embed dashboards and reports into your application.

Per l'incorporamento per l'organizzazione, vedere le procedure dettagliate seguenti:For embedding for your organization, see the following walkthroughs:

Per l'incorporamento con i clienti, scenario tipico per ISV, vedere quanto segue:For embeding with your customers, which is typical for ISVs, see the following:

Quando si esegue l'incorporamento per i clienti, è necessario un token di incorporamento.When embedding for your customers, an embed token is required. Per altre informazioni, vedere GenerateToken.To learn more see, GenerateToken.

Passaggio 3: Alzare di livello della soluzione alla produzioneStep 3: Promote your solution to production

Lo spostamento in produzione richiede alcuni passaggi aggiuntivi.Moving to production requires a few extra steps.

Incorporamento per l'organizzazioneEmbedding for your organization

Se si intende incorporare per l'organizzazione, è sufficiente informare gli utenti su come ottenere l'applicazione.If you are embedding for your organization, you only need to let people know how to get to your application.

Gli utenti del piano Gratuito possono utilizzare contenuti incorporati da un'area di lavoro dell'app (gruppo) se tale area di lavoro dispone della capacità sufficiente.Free users can consume content that is embedded from an app workspace (group), if that workspace is backed by capacity. Elencare l'utente del piano Gratuito come membro dell'area di lavoro dell'app (gruppo). In caso contrario, viene visualizzato un errore di tipo 401 - Non autorizzato.List the Free user as a member of app workspace (group), otherwise you receive a 401 unauthorized error. La tabella seguente elenca gli SKU di Power BI Premium disponibili in Office 365.The following table lists the available Power BI Premium SKUs available within Office 365.

Nodo della capacitàCapacity Node Totale coreTotal cores
(Back-end + front-end)(Backend + frontend)
Core di back-endBackend Cores Core di front-endFrontend Cores Limiti di connessione dinamica/DirectQueryDirectQuery/live connection limits Rendering massimo della pagina all'ora di puntaMax page renders at peak hour
EM3EM3 4 v-core4 v-cores 2 core, 10 GB di RAM2 cores, 10GB RAM 2 core2 cores 601-1.200601-1,200
P1P1 8 v-core8 v-cores 4 core, 25 GB di RAM4 cores, 25GB RAM 4 core4 cores 30 al secondo30 per second 1.201-2.4001,201-2,400
P2P2 16 v-core16 v-cores 8 core, 50 GB di RAM8 cores, 50GB RAM 8 core8 cores 60 al secondo60 per second 2.401-4.8002,401-4,800
P3P3 32 v-core32 v-cores 16 core, 100 GB di RAM16 cores, 100GB RAM 16 ore16 cores 120 al secondo120 per second 4.801-96004,801-9600

Nota

È necessario essere amministratore globale o di fatturazione, all'interno del tenant, per acquistare Power BI Premium.You must be a Global or Billing Admin, within your tenant, in order to purchase Power BI Premium. Per informazioni su come acquistare Power BI Premium, vedere How to purchase Power BI Premium (Come acquistare Power BI Premium).For information on how to purchase Power BI Premium, see How to purchase Power BI Premium.

Incorporamento per i clientiEmbedding for your customers

Per eseguire l'incorporamento per i clienti, procedere nel modo seguente.If you are embedding for your customers, do the following.

  • Se si usa un tenant diverso per lo sviluppo, è necessario assicurarsi che l'area di lavoro per le app, insieme ai dashboard e ai report, sia disponibile nell'ambiente di produzione.If you are using a separate tenant for development, then you must make sure your app workspaces, along with dashboards and reports, are available in your production environment. Assicurarsi di creare l'applicazione in Azure AD per il tenant di produzione e di assegnare le autorizzazioni di dell'app adeguate, come indicato nel Passaggio 1.Make sure that you create the application in Azure AD for your production tenant and assign the proper app permissions as indicated in Step 1.
  • Acquistare una capacità adatta alle proprie esigenze.Purchase a capacity that fits your needs. È possibile usare la tabella seguente per individuare gli SKU per la capacità di Power BI Embedded necessari.You can use the table below to understand which Power BI Embedded capacity SKU you may need. Per altre informazioni, vedere Embedded analytics capacity planning whitepaper (White paper sulla pianificazione della capacità di analisi incorporata)For more details, see Embedded analytics capacity planning whitepaper. Quando si è pronti, è possibile completare l'acquisto nel portale di Microsoft Azure.When you are ready to purchase, you can do so within the Microsoft Azure portal. Per informazioni dettagliate su come creare capacità per Power BI Embedded, vedere Create Power BI Embedded capacity in the Azure portal (Creare capacità per Power BI Embedded nel portale di Azure).For details on how to create Power BI Embedded capacity, see Create Power BI Embedded capacity in the Azure portal.

Importante

Dato che i token di incorporamento sono destinati solo alle attività di sviluppo e test, un account master Power BI può generare un numero di token di incorporamento limitato.Because embed tokens are intended for development testing only, the number of embed tokens a Power BI master account can generate is limited. È necessario acquistare una capacità per gli scenari di incorporamento della produzione.A capacity must be purchased for production embedding scenarios. Dopo l'acquisto della capacità è possibile generare un numero illimitato di token di incorporamento.There is no limit to embed token generation when a capacity is purchased.

Nodo della capacitàCapacity Node Totale coreTotal cores
(Back-end + front-end)(Backend + frontend)
Core di back-endBackend Cores Core di front-endFrontend Cores Limiti di connessione dinamica/DirectQueryDirectQuery/live connection limits Rendering massimo della pagina all'ora di puntaMax page renders at peak hour
A1A1 1 v-core1 v-cores 0,5 core, 3 GB di RAM.5 cores, 3GB RAM 0,5 core.5 cores 5 al secondo5 per second 1-3001-300
A2A2 2 v-core2 v-cores 1 core, 5 GB di RAM1 core, 5GB RAM 1 core1 core 10 al secondo10 per second 301-600301-600
A3A3 4 v-core4 v-cores 2 core, 10 GB di RAM2 cores, 10GB RAM 2 core2 cores 15 al secondo15 per second 601-1.200601-1,200
A4A4 8 v-core8 v-cores 4 core, 25 GB di RAM4 cores, 25GB RAM 4 core4 cores 30 al secondo30 per second 1.201-2.4001,201-2,400
A5A5 16 v-core16 v-cores 8 core, 50 GB di RAM8 cores, 50GB RAM 8 core8 cores 60 al secondo60 per second 2.401-4.8002,401-4,800
A6A6 32 v-core32 v-cores 16 core, 100 GB di RAM16 cores, 100GB RAM 16 ore16 cores 120 al secondo120 per second 4.801-96004,801-9600
  • Modificare l'area di lavoro per le app e assegnarla a una capacità in Opzioni avanzate.Edit the app workspace and assign it to a capacity under advanced.

    Assegnare un'area di lavoro a una capacità

  • Distribuire l'applicazione aggiornata nell'ambiente di produzione e iniziare a incorporare i dashboard e i report di Power BI.Deploy your updated application to production and begin embedding Power BI dashboards and reports.

Impostazioni di amministrazioneAdmin settings

Gli amministratori globali o gli amministratori del servizio Power BI possono attivare o disattivare la possibilità di usare le API REST per un tenant.Global Admins, or Power BI service administrators, can turn the ability to use the REST APIs, on or off for a tenant. Gli amministratori di Power BI possono configurare questa impostazione per l'intera organizzazione o per singoli gruppi di sicurezza.Power BI admins can set this setting for the entire organization, or for individual security groups. L'opzione è abilitata per l'intera organizzazione per impostazione predefinita.It is enabled for the entire organization by default. Questa operazione viene eseguita tramite il portale di amministrazione di Power BI.This is done through the Power BI admin portal.

Passaggi successiviNext steps

Incorporamento con Power BIEmbedding with Power BI
Come eseguire la migrazione del contenuto della raccolta di aree di lavoro di Power BI Embedded in Power BIHow to migrate Power BI Embedded workspace collection content to Power BI
Power BI Premium - what is it? (Power BI Premium: descrizione)Power BI Premium - what is it?
How to purchase Power BI Premium (Come acquistare Power BI Premium)How to purchase Power BI Premium
Archivio GIT API JavaScriptJavaScript API Git repo
Archivio GIT C# di Power BIPower BI C# Git repo
Esempio di incorporamento JavaScriptJavaScript embed sample
Embedded analytics capacity planning whitepaper (White paper sulla pianificazione della capacità di analisi incorporata)Embedded analytics capacity planning whitepaper
White paper su Power BI PremiumPower BI Premium whitepaper

Altre domande?More questions? Provare a rivolgersi alla community di Power BITry asking the Power BI Community