Condividi tramite

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 i progettisti di Power BI.

Mancia

Provare a incorporare un dashboard o sperimentare con le API client nella sezione esplorare le API della di 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 che si sta incorporando e per specificare le impostazioni del contenuto. Passare 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 da incorporare. Per altre informazioni sui token di accesso, vedere Informazioni sulle diverse soluzioni di incorporamento.

  • embedUrl: URL del dashboard che si sta incorporando. Questo URL diventa l'origine dell'elemento html iframe che contiene il 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 dashboard che si sta incorporando. Usare un API dashboard per ottenere questo ID. Per 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 intere.

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

    • Usare models.TokenType.Aad per incorporare per l'organizzazione (utente è proprietario di dati).
    • Usare models.TokenType.Embed per incorporare per i clienti ('app possiede dati).

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

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

Esempio

L'esempio seguente illustra 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 elemento div. Se si usa un valore pageView di actualSize quando si incorpora un 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ù piccolo dell'elemento div, l'API riempie lo spazio inutilizzato con lo sfondo incorporato. Per impostazione predefinita, lo sfondo è bianco, ma è possibile configurarlo in modo che sia trasparente. In tal caso, lo stile dell'elemento div è visibile nello spazio inutilizzato.

Contenuto correlato