Condividi tramite

Incorporare un riquadro del dashboard

  • Articolo

Mancia

Provare a incorporare un riquadro del dashboard o provare a usare le API client nella sezione Esplorare le API della Power BI Embedded Analytics Playground.

Questo articolo illustra i passaggi per l'incorporamento di un riquadro del dashboard nell'applicazione. Altre informazioni sui riquadri del dashboard in Introduzione ai riquadri del dashboard per i progettisti di Power BI.

Come incorporare un riquadro del dashboard

Quando si incorpora il contenuto di Power BI in un'app, si usa un oggetto di configurazione per definire il contenuto che si sta incorporando e per specificare le impostazioni del contenuto. Passare quindi l'oggetto all'API.

Quando si incorpora un riquadro del dashboard, usare un oggetto di configurazione di tipo ITileLoadConfiguration:

interface ITileLoadConfiguration {
    accessToken: string;
    dashboardId: string;
    embedUrl: string;
    id: string;
    tokenType?: models.TokenType;
    type: string;
}

Questa interfaccia contiene le proprietà seguenti:

  • accessToken: token che consente di accedere ai dati di Power BI da incorporare. Per altre informazioni sui token di accesso, vedere Informazioni sulle diverse soluzioni di incorporamento.

  • dashboardId: ID del dashboard che contiene il riquadro che si sta incorporando. È possibile usare un API dashboard per ottenere questo ID. Di seguito sono riportati due esempi:

  • embedUrl: URL del riquadro del dashboard che si sta incorporando. Questo URL diventa l'origine dell'elemento html iframe che contiene il riquadro del dashboard incorporato. In particolare, l'API assegna l'URL all'attributo src dell'iframe. È possibile usare un API dashboard per ottenere questo URL. Di seguito sono riportati due esempi:

  • id: ID del riquadro del dashboard che si sta incorporando. È possibile usare un API dashboard per ottenere questo ID. Di seguito sono riportati due esempi:

  • tokenType: tipo di token che consente di accedere ai dati di Power BI da incorporare.

    • Usare models.TokenType.Aad se si esegue l'incorporamento per l'organizzazione (l'utente è proprietario dei dati).
    • Usa models.TokenType.Embed se stai incorporando per i tuoi clienti (l'app possiede i dati).

    Per altre informazioni, vedere Informazioni sulle diverse soluzioni di incorporamento.

  • type: tipo di contenuto che si sta incorporando. Usare 'tile' per un riquadro del dashboard.

Esempio

L'esempio seguente illustra come incorporare un singolo riquadro del dashboard:

// Set up the configuration object that determines what to embed and how to embed it.
let embedConfiguration = {
    accessToken: anAccessToken,
    dashboardId: aDashboardId,
    embedUrl: anEmbedUrl,
    id: aTileId,
    tokenType: aTokenType,
    type: 'tile'
};
 
// Get a reference to the HTML element that contains the embedded dashboard tile.
let tileContainer = $('#tileContainer')[0];
 
// Embed the dashboard.
let tile = powerbi.embed(tileContainer, embedConfiguration);

Contenuto correlato