Incorporare un dashboard

  • Articolo

Questo articolo illustra i passaggi per l'incorporamento di un dashboard nell'applicazione. Altre informazioni sui dashboard in Introduzione ai dashboard per le finestre di progettazione di Power BI.

Suggerimento

Provare a incorporare un dashboard o sperimentare con le API client nella sezione Esplora le API del Power BI Embedded Analytics Playground.

Come incorporare un dashboard

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

Quando si incorpora un dashboard, usare un oggetto di configurazione di tipo IDashboardLoadConfiguration:

interface IDashboardLoadConfiguration {
    accessToken: string;
    embedUrl?: string;
    id: string;
    pageView?: models.PageView 
    tokenType?: models.TokenType;
    type: string;
}

Questa interfaccia contiene le proprietà seguenti:

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

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

  • id - ID del dashboard incorporato. Usare un'API Dashboard per ottenere questo ID. Ad esempio:

  • pageView - Formato usato dall'API per il dashboard incorporato. Le possibilità includono:

    • fitToWidth: la larghezza del dashboard incorporato corrisponde alla larghezza dell'elemento div che contiene il dashboard.
    • oneColumn: il dashboard incorporato viene visualizzato in una colonna.
    • actualSize - L'API visualizza il dashboard incorporato a dimensioni complete.

  • tokenType - Tipo di token che consente di accedere ai dati di Power BI incorporati.

    • Usare models.TokenType.Aad per incorporare per l'organizzazione (dati proprietari dell'utente).
    • Usare models.TokenType.Embed per incorporare per i clienti (i propri dati dell'app).

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

  • type - Tipo di contenuto incorporato. Usare 'dashboard' per un dashboard.

Esempio

Nell'esempio seguente viene illustrato come incorporare un singolo dashboard:

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

Considerazioni e limitazioni

  • L'incorporamento di dashboard in SKU EM non è supportato

  • Quando si incorpora il contenuto, l'app visualizza il contenuto in un div elemento. Se si usa un valore di actualSize quando si incorpora un pageView dashboard:

    • Se il dashboard è più ampio dell'elemento div , l'API usa la larghezza dell'elemento div come larghezza del dashboard incorporato.
    • Se il dashboard è più stretto dell'elemento, l'API div riempie lo spazio inutilizzato con lo sfondo incorporato. Per impostazione predefinita, lo sfondo è bianco, ma è possibile configurarlo come trasparente. In tal caso, lo div stile dell'elemento è visibile nello spazio inutilizzato.

Passaggi successivi

Incorporare un report

Incorporare un riquadro del dashboard

Usare bootstrap per migliorare le prestazioni