Esercitazione: Incorporare contenuto di Power BI in un'applicazione per i clientiTutorial: Embed Power BI content into an application for your customers

Questa pagina è stata utile?

Con Power BI Embedded in Azure, è possibile incorporare report, dashboard o riquadri in un'applicazione usando dati di proprietà dell'app.With Power BI Embedded in Azure, you can embed reports, dashboards, or tiles into an application using app owns data. I dati di proprietà dell'app consistono nel disporre di un'applicazione che usa Power BI come piattaforma di analisi incorporata.App owns data is about having an application that uses Power BI as its embedded analytics platform. Gli sviluppatori ISV possono creare contenuti Power BI che visualizzano report, dashboard o riquadri in un'applicazione completamente integrata e interattiva, senza richiedere agli utenti di disporre di una licenza Power BI.As an ISV developer, you can create Power BI content that displays reports, dashboards, or tiles in an application that is fully integrated and interactive, without requiring users to have a Power BI license. Questa esercitazione illustra come integrare un report in un'applicazione tramite .NET SDK di Power BI e l'API JavaScript di Power BI usando Power BI Embedded in Azure per i clienti.This tutorial demonstrates how to integrate a report into an application using the Power BI .NET SDK with the Power BI JavaScript API using Power BI Embedded in Azure for your customers.

Incorporare report di Power BI

In questa esercitazione viene illustrato come:In this tutorial, you learn how to:

  • Registrare un'applicazione in Azure.Register an application in Azure.
  • Incorporare un report di Power BI in un'applicazione.Embed a Power BI report into an application.

PrerequisitiPrerequisites

Per iniziare, è necessario avere:To get started, you're required to have:

Se non si è ancora iscritti a Power BI Pro, iscriversi per ottenere una versione di prova gratuita prima di iniziare.If you're not signed up for Power BI Pro, sign up for a free trial before you begin.

Se non si ha una sottoscrizione di Azure, creare un account gratuito prima di iniziare.If you don’t have an Azure subscription, create a free account before you begin.

Configurare l'ambiente di sviluppo di analisi incorporataSet up your embedded analytics development environment

Prima di iniziare a incorporare report, dashboard o riquadri in un'applicazione, è necessario assicurarsi che l'ambiente consenta l'incorporamento con Power BI.Before you start embedding reports, dashboard, or tiles into your application, you need to make sure your environment allows for embedding with Power BI.

È possibile usare lo strumento di installazione dell'incorporamento per iniziare rapidamente e scaricare un'applicazione di esempio che facilita la creazione di un ambiente e l'incorporamento di un report.You can go through the Embedding setup tool, so you can quickly get started and download a sample application that helps you walk through creating an environment and embedding a report.

Se tuttavia si sceglie di configurare l'ambiente manualmente, è possibile continuare con le istruzioni che seguono.However, if you choose to set up the environment manually, you can continue below.

Registrare un'applicazione in Azure Active Directory (Azure AD)Register an application in Azure Active Directory (Azure AD)

Registrare l'applicazione in Azure Active Directory per consentire all'applicazione di accedere alle API REST di Power BI.Register your application with Azure Active Directory to allow your application access to the Power BI REST APIs. La registrazione consente di definire un'identità per l'applicazione e di specificare le autorizzazioni per accedere alle risorse REST di Power BI.Registering your application allows you to establish an identity for your application and specify permissions to Power BI REST resources. A seconda che si voglia usare un account master oppure un'entità servizio, la registrazione di un'applicazione varia.Depending if you want to use a master account or service principal, determines how to get started registering an application.

Il metodo scelto influisce sul tipo di applicazione da registrare in Azure.Depending on which method you take, affects which type of application you register in Azure.

Se si usa account master, procedere con la registrazione di un'app nativa.If you proceed using a master account, then proceed with registering a Native app. Si sceglie un'app nativa in quanto l'accesso in uso non è interattivo.You use a Native app because you're working with a non-interactive login.

Se invece si usa l'entità servizio, è necessario procedere con la registrazione di un'applicazione Web sul lato server.However, if you proceed using the service principal, you need to proceed with registering a server-side web application app. Si registra un'applicazione Web sul lato server per creare un segreto dell'applicazione.You register a server-side web application to create an application secret.

Configurare l'ambiente di Power BISet up your Power BI environment

Crea area di lavoro per le appCreate an app workspace

Se si incorporano report, dashboard o riquadri per i clienti, è necessario inserire il contenuto all'interno di un'area di lavoro per le app.If you're embedding reports, dashboards, or tiles for your customers, then you have to place your content within an app workspace. Esistono diversi tipi di aree di lavoro configurabili: le aree di lavoro tradizionali o le nuove aree di lavoro.There are different types of workspaces that you can set up: the traditional workspaces or the new workspaces. Se si usa un account master, non è importante il tipo di area di lavoro usato.If you're using a master account, then it doesn't matter which type of workspaces you use. Se invece si usa l' entità servizio per accedere all'applicazione, è necessario usare le nuove aree di lavoro.However, if you use service principal to sign into your application, then you're required to you use the new workspaces. In entrambi gli scenari sia l'account master sia l'entità servizio deve essere amministratore delle aree di lavoro per le app interessate dall'applicazione.In either scenario, both the master account or service principal must be an admin of the app workspaces involved with your application.

Creare e pubblicare i reportCreate and publish 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. Esistono due modi per eseguire questa attività. Un utente finale può pubblicare i report in un'area di lavoro per le app tradizionale usando un account master (licenza di Power BI Pro).There are two ways to accomplish this task: As an end user, you can publish reports to a traditional app workspace with a master account (Power BI Pro license). Se si usa l'entità servizio, è possibile pubblicare i report nelle nuove aree di lavoro usando le API REST di Power BI.If you're using service principal, you can publish reports to the new workspaces using the Power BI REST APIs.

La procedura seguente illustra come pubblicare il report in formato PBIX nell'area di lavoro di Power BI.The below steps walk through how to publish your PBIX report to your Power BI workspace.

  1. Scaricare l'esempio Blog Demo da GitHub.Download the sample Blog Demo from GitHub.

    Esempio di report

  2. Aprire il report in formato PBIX di esempio in Power BI Desktop.Open sample PBIX report in Power BI Desktop.

    Report di PBI Desktop

  3. Pubblicare nelle aree di lavoro per le app.Publish to app workspaces. Questo processo varia a seconda che si stia usando un account master (licenza di Power Pro) oppure un'entità servizio.This process differs depending on whether you're using a master account (Power Pro license), or service principal. Se si usa un account master, è possibile pubblicare il report tramite Power BI Desktop.If you're using a master account, then you can publish your report through Power BI Desktop. Se si usa l'entità servizio, è necessario usare le API REST di Power BI.Now if you're using service principal, you must use the Power BI REST APIs.

Incorporare il contenuto usando l'applicazione di esempioEmbed content using the sample application

Questo esempio è volutamente semplice per scopo dimostrativo.This sample is deliberately kept simple for demonstration purposes. Sarà l'utente o lo sviluppatore a scegliere se proteggere il segreto dell'applicazione o le credenziali dell'account master.It's up to the you or your developers to protect the application secret or the master account credentials.

Seguire questa procedura per avviare l'incorporamento del contenuto usando l'applicazione di esempio.Follow the steps below to start embedding your content using the sample application.

  1. Scaricare Visual Studio (2013 o versione successiva).Download Visual Studio (version 2013 or later). Assicurarsi di scaricare la versione più recente del pacchetto NuGet.Make sure to download the latest NuGet package.

  2. Scaricare l'esempio App Owns Data da GitHub per iniziare.Download the App Owns Data sample from GitHub to get started.

    Applicazione di esempio App Owns Data

  3. Aprire il file Web.config nell'applicazione di esempio.Open the Web.config file in the sample application. Per eseguire l'applicazione, è necessario compilare alcuni campi.There are fields you need to fill in to run the application. È possibile scegliere MasterUser oppure ServicePrincipal per AuthenticationType.You can choose MasterUser or ServicePrincipal for the AuthenticationType. A seconda del tipo di metodo di autenticazione scelto, è necessario compilare campi diversi.Depending on which type of authentication method you choose there are different fields to complete.

    Nota

    Il valore predefinito per AuthenticationType in questo esempio è MasterUser.The default AuthenticationType in this sample is MasterUser.

    MasterUserMasterUser
    (licenza di Power BI Pro)(Power BI Pro license)
    ServicePrincipalServicePrincipal
    (token solo app)(app-only token)
    applicationIdapplicationId applicationIdapplicationId
    workspaceIdworkspaceId workspaceIdworkspaceId
    reportIdreportId reportIdreportId
    pbiUsernamepbiUsername
    pbiPasswordpbiPassword
    applicationsecretapplicationsecret
    tenanttenant

    File Web.config

ID applicazioneApplication ID

Questo attributo è necessario per entrambe le opzioni di AuthenticationTypes (account master ed entità servizio).This attribute is needed for both AuthenticationTypes (master account and service principal).

In applicationId inserire il valore di ID applicazione di Azure.Fill in the applicationId information with the Application ID from Azure. Il valore applicationId viene usato per l'identificazione dell'applicazione per gli utenti ai quali si richiedono le autorizzazioni.The applicationId is used by the application to identify itself to the users from which you're requesting permissions.

Per ottenere il valore applicationId seguire questa procedura:To get the applicationId, follow these steps:

  1. Accedere al portale di Azure.Sign into the Azure portal.

  2. Nel riquadro di spostamento a sinistra, scegliere Tutti i servizi e selezionare Registrazioni app.In the left-hand navigation pane, select All Services, and select App Registrations.

    Ricerca di Registrazioni per l'app

  3. Selezionare l'applicazione che deve usare il valore applicationId.Select the application that needs the applicationId.

    Scelta dell'app

  4. Viene visualizzato un ID applicazione che viene elencato come GUID.There's an Application ID that is listed as a GUID. Usare questo ID applicazione come applicationId per l'applicazione.Use this Application ID as the applicationId for the application.

    applicationId

ID area di lavoroWorkspace ID

Questo attributo è necessario per entrambe le opzioni di AuthenticationTypes (account master ed entità servizio).This attribute is needed for both AuthenticationTypes (master account and service principal).

Compilare il campo workspaceId con il GUID (gruppo) dell'area di lavoro per le app di Power BI.Fill in the workspaceId information with the app workspace (group) GUID from Power BI. È possibile ottenere queste informazioni dall'URL di accesso al servizio Power BI o usando Powershell.You can get this information either from the URL when signed into the Power BI service or using Powershell.

URLURL

workspaceId

PowerShellPowershell

Get-PowerBIworkspace -name "App Owns Embed Test"

workspaceId ottenuto da Powershell

ID del reportReport ID

Questo attributo è necessario per entrambe le opzioni di AuthenticationTypes (account master ed entità servizio).This attribute is needed for both AuthenticationTypes (master account and service principal).

Compilare il campo reportId con il GUID del report di Power BI.Fill in the reportId information with the report GUID from Power BI. È possibile ottenere queste informazioni dall'URL di accesso al servizio Power BI o usando Powershell.You can get this information either from the URL when signed into the Power BI service or using Powershell.

URLURL

reportId

PowerShellPowershell

Get-PowerBIworkspace -name "App Owns Embed Test" | Get-PowerBIReport

reportId ottenuto da Powershell

Nome utente e password di Power BIPower BI username and password

Questi attributi sono necessari solo se per AuthenticationType si usa l'account master.These attributes are needed only for the master account AuthenticationType.

Se si usa l'entità servizio per eseguire l'autenticazione, non è necessario specificare gli attributi di nome utente o password.If you're using service principal to authenticate, then you don't need to fill in the username or password attributes.

  • Compilare il campo pbiUsername con l'account master Power BI.Fill in the pbiUsername with the Power BI master account.
  • Compilare il campo pbiPassword con la password per l'account master Power BI.Fill in the pbiPassword with the password for the Power BI master account.

Segreto dell'applicazioneApplication secret

Questo attributo è necessario solo se per AuthenticationType si usa l'opzione entità servizio.This attribute is needed only for the service principal AuthenticationType.

Specificare le informazioni per ApplicationSecret dalla sezione Chiavi in Registrazioni app in Azure.Fill in the ApplicationSecret information from the Keys section of your App registrations section in Azure. Questo attributo si usa con l'entità servizio.This attribute works when using service principal.

Per ottenere il valore ApplicationSecret, seguire questa procedura:To get the ApplicationSecret, follow these steps:

  1. Accedere al portale di Azure.Sign in to the Azure portal.

  2. Nel riquadro di spostamento a sinistra scegliere Tutti i servizi e selezionare Registrazioni per l'app.In the left-hand navigation pane, select All services and then select App registrations.

    Ricerca di Registrazioni per l'app

  3. Selezionare l'applicazione che deve usare il valore ApplicationSecret.Select the application that needs to use the ApplicationSecret.

    Scegliere un'app

  4. Selezionare certificati e i segreti sotto Gestisci.Select Certificates and secrets under Manage.

  5. Selezionare nuovi segreti client.Select New client secrets.

  6. Immettere un nome nella casella Descrizione e selezionare una durata.Enter a name in the Description box and select a duration. Quindi selezionare Salva per ottenere il Valore per l'applicazione.Then select Save to get the Value for your application. Chiudendo il riquadro Chiavi dopo aver salvato il valore della chiave, il campo del valore viene visualizzato solo come nascosto.When you close the Keys pane after saving the key value, the value field shows only as hidden. A questo punto, non è possibile recuperare il valore della chiave.At that point, you aren't able to retrieve the key value. Se il valore della chiave viene perso, crearne uno nuovo all'interno del portale di Azure.If you lose the key value, create a new one in the Azure portal.

    Valore chiave

TenantTenant

Questo attributo è necessario solo se per AuthenticationType si usa l'opzione entità servizio.This attribute is needed only for the service principal AuthenticationType.

Compilare il campo tenant con l'ID tenant di Azure.Fill in the tenant information with your azure tenant ID. È possibile ottenere queste informazioni dall'interfaccia di amministrazione di Azure AD quando si accede al servizio Power BI o tramite PowerShell.You can get this information from the Azure AD admin center when signed into the Power BI service or by using Powershell.

Eseguire l'applicazioneRun the application

  1. Selezionare Esegui in Visual Studio.Select Run in Visual Studio.

    Eseguire l'applicazione

  2. Selezionare quindi Incorpora report.Then select Embed Report. A seconda del contenuto con cui si sceglie di eseguire il test (report, dashboard o riquadri), selezionare l'opzione corrispondente nell'applicazione.Depending on which content you choose to test with - reports, dashboards or tiles - then select that option in the application.

    Selezionare il contenuto

  3. È ora possibile visualizzare il report nell'applicazione di esempio.Now you can view the report in the sample application.

    Visualizzare l'applicazione

Incorporare il contenuto all'interno dell'applicazioneEmbed content within your application

Anche se la procedura per incorporare il contenuto viene eseguita con le API REST di Power BI, i codici di esempio descritti in questo articolo vengono creati con .NET SDK.Even though the steps to embed your content are done with the Power BI REST APIs, the example codes described in this article are made with the .NET SDK.

L'incorporamento per i clienti all'interno dell'applicazione richiede l'ottenimento di un token di accesso per l'account master o l'entità servizio di Azure AD.Embedding for your customers within your application requires you to get an access token for your master account or service principal from Azure AD. È necessario ottenere un token di accesso di Azure AD per l'applicazione Power BI usando prima di effettuare chiamate alle API REST di Power BI.You're required to get an Azure AD access token for your Power BI application before you make calls to the Power BI REST APIs.

Per creare il client Power BI con il token di accesso è consigliabile creare l'oggetto client Power BI, che consente di interagire con le API REST di Power BI.To create the Power BI Client with your access token, you want to create your Power BI client object, which allows you to interact with the Power BI REST APIs. L'oggetto client Power BI viene creato eseguendo il wrapping di AccessToken in un oggetto Microsoft.Rest.TokenCredentials.You create the Power BI client object by wrapping the AccessToken with a Microsoft.Rest.TokenCredentials object.

using Microsoft.IdentityModel.Clients.ActiveDirectory;
using Microsoft.Rest;
using Microsoft.PowerBI.Api.V2;

var tokenCredentials = new TokenCredentials(authenticationResult.AccessToken, "Bearer");

// Create a Power BI Client object. it's used to call Power BI APIs.
using (var client = new PowerBIClient(new Uri(ApiUrl), tokenCredentials))
{
    // Your code to embed items.
}

Ottenere l'elemento di contenuto da incorporareGet the content item you want to embed

Usare l'oggetto client Power BI per recuperare un riferimento all'elemento da incorporare.You can use the Power BI client object to retrieve a reference to the item you want to embed.

Ecco un esempio del codice per recuperare il primo report da un'area di lavoro specifica.Here is a code sample of how to retrieve the first report from a given workspace.

Un esempio di come recuperare un elemento di contenuto da incorporare, che si tratti di un report, dashboard o riquadro, è disponibile all'interno del file Services\EmbedService.cs nell'applicazione di esempio.A sample of getting a content item whether it's a report, dashboard, or tile that you want to embed is available within the Services\EmbedService.cs file in the sample application.

using Microsoft.PowerBI.Api.V2;
using Microsoft.PowerBI.Api.V2.Models;

// You need to provide the workspaceId where the dashboard resides.
ODataResponseListReport reports = await client.Reports.GetReportsInGroupAsync(workspaceId);

// Get the first report in the group.
Report report = reports.Value.FirstOrDefault();

Creare il token di incorporamentoCreate the embed token

Generare un token di incorporamento che possa essere usato dall'API JavaScript.Generated an embed token, which can be used from the JavaScript API. Il token di incorporamento è specifico per l'elemento da incorporare.The embed token is specific to the item you're embedding. Ogni volta che si incorpora una parte di contenuto di Power BI, è pertanto necessario creare un nuovo token di incorporamento specifico.So at any time you embed a piece of Power BI content, you need to create a new embed token for it. Per altre informazioni, incluso il valore accessLevel da usare, vedere GenerateToken API (API GenerateToken).For more information, including which accessLevel to use, see GenerateToken API.

Un esempio di come creare un token di incorporamento per un report da incorporare, che si tratti di un report, dashboard o riquadro, è disponibile all'interno del file Services\EmbedService.cs nell'applicazione di esempio.A sample of creating an embed token for a report, dashboard, or tile want to embed is available within the Services\EmbedService.cs file in the sample application.

using Microsoft.PowerBI.Api.V2;
using Microsoft.PowerBI.Api.V2.Models;

// Generate Embed Token.
var generateTokenRequestParameters = new GenerateTokenRequest(accessLevel: "view");
EmbedToken tokenResponse = client.Reports.GenerateTokenInGroup(workspaceId, report.Id, generateTokenRequestParameters);

// Generate Embed Configuration.
var embedConfig = new EmbedConfig()
{
    EmbedToken = tokenResponse,
    EmbedUrl = report.EmbedUrl,
    Id = report.Id
};

Viene creata una classe per EmbedConfig e TileEmbedConfig.A class is created for EmbedConfig and TileEmbedConfig. Un esempio è disponibile nel file Models\EmbedConfig.cs e nel file Models\TileEmbedConfig.cs.A sample is available within the Models\EmbedConfig.cs file and the Models\TileEmbedConfig.cs file.

Caricare un elemento con JavaScriptLoad an item using JavaScript

È possibile usare JavaScript per caricare un report in un elemento div nella pagina Web.You can use JavaScript to load a report into a div element on your web page.

Per un esempio completo dell'uso dell'API JavaScript, è possibile usare lo strumento Playground,For a full sample of using the JavaScript API, you can use the Playground tool. Lo strumento Playground consente di riprodurre in modo rapido esempi di Power BI Embedded di tipo diverso.The Playground tool is a quick way to play with different types of Power BI Embedded samples. È anche possibile ottenere maggiori informazioni sull'API JavaScript visitando la pagina del wiki Power BI-JavaScript.You can also get more Information about the JavaScript API by visiting the PowerBI-JavaScript wiki page.

Segue un esempio che usa un modello EmbedConfig e un modello TileEmbedConfig insieme a visualizzazioni per un report.Here is a sample that uses an EmbedConfig model and a TileEmbedConfig model along with views for a report.

Un esempio di come aggiungere una visualizzazione per un report, dashboard o riquadro è disponibile nei file Views\Home\EmbedReport.cshtml, Views\Home\EmbedDashboard.cshtml o Views\Home\Embedtile.cshtml nell'applicazione di esempio.A sample of adding a view for a report, dashboard, or tile is available within the Views\Home\EmbedReport.cshtml, Views\Home\EmbedDashboard.cshtml, or Views\Home\Embedtile.cshtml files in the sample application.

<script src="~/scripts/powerbi.js"></script>
<div id="reportContainer"></div>
<script>
    // Read embed application token from Model
    var accessToken = "@Model.EmbedToken.Token";

    // Read embed URL from Model
    var embedUrl = "@Html.Raw(Model.EmbedUrl)";

    // Read report Id from Model
    var embedReportId = "@Model.Id";

    // Get models. models contains enums that can be used.
    var models = window['powerbi-client'].models;

    // Embed configuration used to describe what and how to embed.
    // This object is used when calling powerbi.embed.
    // This also includes settings and options such as filters.
    // You can find more information at https://github.com/Microsoft/PowerBI-JavaScript/wiki/Embed-Configuration-Details.
    var config = {
        type: 'report',
        tokenType: models.TokenType.Embed,
        accessToken: accessToken,
        embedUrl: embedUrl,
        id: embedReportId,
        permissions: models.Permissions.All,
        settings: {
            filterPaneEnabled: true,
            navContentPaneEnabled: true
        }
    };

    // Get a reference to the embedded report HTML element
    var reportContainer = $('#reportContainer')[0];

    // Embed the report and display it within the div container.
    var report = powerbi.embed(reportContainer, config);
</script>

Passare alla produzioneMove to production

Dopo aver terminato lo sviluppo dell'applicazione, è necessario eseguire il backup dell'area di lavoro dell'app con una capacità dedicata.Now that you've completed developing your application, it's time to back your app workspace with a dedicated capacity.

Importante

La capacità dedicata è necessaria per passare alla produzione.Dedicated capacity is required to move to production.

Creare una capacità dedicataCreate a dedicated capacity

Tramite la creazione di una capacità dedicata è possibile trarre vantaggio dalla disponibilità di una risorsa dedicata destinata ai clienti.By creating a dedicated capacity, you can take advantage of having a dedicated resource for your customer. È possibile acquistare una capacità dedicata all'interno del portale di Microsoft Azure.You can purchase a dedicated capacity within the Microsoft Azure portal. Per informazioni dettagliate su come creare una 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 a Power BI Embedded capacity, see Create Power BI Embedded capacity in the Azure portal.

Usare la tabella seguente per individuare la capacità di Power BI Embedded più adatta alle proprie esigenze.Use the table below to determine which Power BI Embedded capacity best fits your needs.

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
A1A1 1 vCore1 v-core(s) 0,5 core, 3 GB RAM0.5 core(s), 3-GB RAM 0,5 core0.5 cores 0-5 al secondo0 5 per second
A2A2 2 vCore2 v-core(s) 1 core, 5 GB RAM1 core(s), 5-GB RAM 1 core1 cor(e) 10 al secondo10 per second
A3A3 4 vCore4 v-core(s) 2 core, 10 GB RAM2 core(s), 10-GB RAM 2 core2 core(s) 15 al secondo15 per second
A4A4 8 vCore8 v-core(s) 4 core, 25 GB RAM4 core(s), 25-GB RAM 4 core4 core(s) 30 al secondo30 per second
A5A5 16 vCore16 v-core(s) 8 core, 50 GB RAM8 core(s), 50-GB RAM 8 core8 core(s) 60 al secondo60 per second
A6A6 32 vCore32 v-core(s) 16 core, 100 GB RAM16 core(s), 100-GB RAM 16 core16 core(s) 120 al secondo120 per second

Con gli SKU A, non è possibile accedere al contenuto di Power BI con una licenza di Power BI gratuita.With A SKUs, you can't access Power BI content with a FREE Power BI license.

I token di incorporamento con licenza Pro sono destinati al test dello sviluppo, pertanto il numero di token di incorporamento che un account master Power BI o un'entità servizio può generare è limitato.Using embed tokens with PRO licenses are intended for development testing, so the number of embed tokens a Power BI master account or service principal can generate is limited. È richiesta una capacità dedicata per l'incorporamento in un ambiente di produzione.A dedicated capacity requires embedding in a production environment. Con una capacità dedicata è possibile generare un numero illimitato di token di incorporamento.There's no limit on how many embed tokens you can generate with a dedicated capacity. Vedere Available Features (Funzionalità disponibili) per controllare il valore di utilizzo che indica l'attuale utilizzo incorporato espresso come percentuale.Go to Available Features to check the usage value that indicates the current embedded usage in percentage. La quantità di utilizzo è calcolata per ogni account master.The usage amount is based per master account.

Per altre informazioni, vedere Embedded analytics capacity planning whitepaper (White paper sulla pianificazione della capacità di analisi incorporata).For more information, see Embedded analytics capacity planning whitepaper.

Assegnare un'area di lavoro per le app a una capacità dedicataAssign an app workspace to a dedicated capacity

Dopo aver creato una capacità dedicata, è possibile assegnare l'area di lavoro dell'app alla capacità dedicata.Once you create a dedicated capacity, you can assign your app workspace to that dedicated capacity.

Per assegnare una capacità dedicata a un'area di lavoro con un'entità servizio, usare l'API REST di Power BI.To assign a dedicated capacity to a workspace using service principal, use the Power BI REST API. Quando si usano le API REST di Power BI, assicurarsi di usare l'ID oggetto dell'entità servizio.When you are using the Power BI REST APIs, make sure to use the service principal object ID.

Seguire questa procedura per assegnare una capacità dedicata a un'area di lavoro usando un account master.Follow the steps below to assign a dedicated capacity to a workspace using a master account.

  1. All'interno del servizio Power BI espandere le aree di lavoro e selezionare i puntini di sospensione relativi all'area di lavoro in cui incorporare il contenuto.Within the Power BI service, expand workspaces and select the ellipsis for the workspace you're using for embedding your content. Quindi selezionare Edit workspaces (Modifica aree di lavoro).Then select Edit workspaces.

    Modifica area di lavoro

  2. Espandere Avanzate, abilitare Capacità dedicata e quindi selezionare la capacità dedicata creata.Expand Advanced, then enable Dedicated capacity, then select the dedicated capacity you created. Selezionare quindi Salva.Then select Save.

    Assegnare la capacità dedicata

  3. Dopo aver selezionato Salva viene visualizzato un rombo accanto al nome dell'area di lavoro dell'app.After you select Save, you should see a diamond next to the app workspace name.

    area di lavoro dell'app assegnata a una capacità

Passaggi successiviNext steps

In questa esercitazione è stato descritto come incorporare il contenuto di Power BI in un'applicazione per i clienti.In this tutorial, you've learned how to embed Power BI content into an application for your customers. È anche possibile provare a incorporare il contenuto di Power BI per l'organizzazione.You can also try to embed Power BI content for your organization.

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