Incorporamento con Power BIEmbedding with Power BI

Power BI offre API per l'incorporamento di dashboard e report nelle applicazioni.Power BI offers APIs for embedding your dashboards and reports into applications. Le API di Power BI offrono un set coerente di funzionalità e l'accesso alle funzionalità più recenti di Power BI, ad esempio dashboard, gateway e aree di lavoro per le app, quando si incorpora il contenuto.The Power BI APIs offer a consistent set of capabilities and access to the latest Power BI features – such as dashboards, gateways and app workspaces – when embedding content.

Una singola APIA single API

Esistono due scenari principali quando si incorpora il contenuto di Power BI.There are two main scenarios when embedding Power BI content. Incorporamento per gli utenti dell'organizzazione (che dispongono di licenze per Power BI) e incorporamento per utenti e clienti senza che venga loro richiesta una licenza di Power BI.Embedding for users in your organization (who have licenses for Power BI) and embedding for your users and customers without requiring them to have Power BI licenses. Le API REST di Power BI consentono entrambi gli scenari.The Power BI REST API allows for both scenarios.

Per i clienti e gli utenti senza licenza di Power BI, sarà possibile incorporare dashboard e report nell'applicazione personalizzata usando la stessa API per l'organizzazione o per i clienti.For customers and users without Power BI licenses, you can embed dashboards and reports into your custom application, using the same API to either service your organization or your customers. I clienti visualizzeranno i dati gestiti dall'applicazione.Your customers see the data that is managed by the application. Gli utenti di Power BI dell'organizzazione potranno invece usufruire di opzioni aggiuntive per visualizzare i propri dati direttamente in Power BI o nel contesto dell'applicazione incorporata.And for Power BI users in your organization, they'll have the additional options to view their own data directly in Power BI or in the context of the embedded application. È possibile usufruire delle API REST e JavaScript per soddisfare le proprie esigenze di incorporamento.You can take full advantage of the JavaScript and REST APIs for your embedding needs.

Per visualizzare un esempio di come funziona l'incorporamento, vedere l'esempio di incorporamento di JavaScript.To view a sample of how embedding works, see the JavaScript embed sample.

Incorporamento per l'organizzazioneEmbedding for your organization

L'incorporamento per l'organizzazione consente di estendere il servizio Power BI.Embedding for your organization allows you to extend the Power BI service. A questo scopo, gli utenti dell'applicazione dovranno eseguire l'accesso al servizio Power BI quando vogliono visualizzare il contenuto.This requires that users of your application sign into the Power BI service when they want to view their content. Quando un utente dell'organizzazione esegue l'accesso, potrà accedere solo ai dashboard e ai report di cui è proprietario o che sono stati condivisi con tale utente nel servizio Power BI.Once someone in your organization signs in, they will only have access to dashboards and reports that they own or that have been shared with them in the Power BI service.

Gli esempi di incorporamento per l'organizzazione includono l'applicazione Web interna, la web part di SharePoint Online e l'integrazione di Microsoft Teams.Examples of embedding for your organization include internal web application, the SharePoint Online web part and Microsoft Teams integration.

Per l'incorporamento per l'organizzazione, vedere quanto segue:For embedding for your organization, see the following:

Le funzionalità self-service, quali la modifica, il salvataggio e altro ancora, sono disponibili tramite le API JavaScript durante l'incorporamento per gli utenti di Power BI.Self-service capabilities, such as edit, save and more, are available through the JavaScript API when embedding for Power BI users.

Incorporamento per i clientiEmbedding for your customers

L'incorporamento per i clienti offre la possibilità di incorporare dashboard e report per gli utenti che non hanno un account per Power BI.Embedding for your customers provides the ability to embed dashboards and reports to users who don't have an account for Power BI. Non è necessario che i clienti abbiano informazioni su Power BI.Your customers don't need to know anything about Power BI. Per creare un'applicazione incorporata, è necessario almeno un account Power BI Pro.At least one Power BI Pro account is needed to create an embedded application. Tale account verrà usato come account master per l'applicazione.The Power BI Pro account acts as a master account for your application. Basta immaginarlo come un account del proxy.Think of this as a proxy account. L'account Power BI Pro consente anche di generare i token di incorporamento che forniscono l'accesso a dashboard e report di proprietà o gestiti dall'applicazione nel servizio Power BI.The Power BI Pro account also allows you to generate embed tokens that provide access to dashboards and reports within the Power BI service that are owned/managed by your application.

Un esempio di incorporamento per i clienti è costituito da un'applicazione ISV venduta ad altre aziende.An example of embedding for your customers is an ISV application being sold to other companies.

Flusso di incorporamento per l'incorporamento per i clienti

Per incorporare dashboard, report e riquadri, usare le stesse API usate per l'incorporamento per l'organizzazione.To embed dashboards, reports and tiles, you would use the same APIs that you would use for embedding for your organization.

Importante

Mentre l'incorporamento ha una dipendenza dal servizio Power BI, non esiste alcuna dipendenza da Power BI per i clienti.While embedding has a dependency on the Power BI service, there is not a dependency on Power BI for your customers. Gli utenti non dovranno eseguire l'iscrizione a Power BI per visualizzare il contenuto incorporato nell'applicazione.They do not need to sign up for Power BI to view the embedded content in your application.

Quando si è pronti per passare alla produzione, all'area di lavoro per le app viene assegnata una capacità.When you are ready to move to production, your app workspace must be assigned to a capacity. Power BI Embedded in Microsoft Azure offre capacità da usare con le applicazioni.Power BI Embedded, within Microsoft Azure, offers capacity to use with your applications.

Per informazioni dettagliate su come incorporare, vedere Come incorporare i dashboard, i report e i riquadri di Power BI.For details on how to embed, see How to embed your Power BI dashboards, reports and tiles.

Se si usa il servizio Raccolta di aree di lavoro di Power BI in Azure, vedere Eseguire la migrazione di contenuto dal servizio Raccolta di aree di lavoro di Power BI per ottenere informazioni sulla procedura di migrazione del contenuto.If you were using the Power BI Workspace Collections service within Azure, see Migrate content from the Power BI Workspace Collections Azure service for information on how to migrate your content over.

Passaggi successiviNext steps

Come incorporare i dashboard, i report e i riquadri di Power BIHow to embed your Power BI dashboards, reports and tiles
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: di cosa si tratta?Power BI Premium - what is it?
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