Incorporare un oggetto visivo del report

  • Articolo

Suggerimento

Provare a incorporare un oggetto visivo del report o sperimentare le API client nella sezione Esplorare le API di Power BI Embedded Analytics Playground.

Questo articolo illustra i passaggi per incorporare un oggetto visivo nell'applicazione. Altre informazioni sugli oggetti visivi in Oggetti visivi in Power BI.

Come incorporare un oggetto visivo

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

Quando si incorpora un oggetto visivo, usare un oggetto di configurazione di tipo IVisualLoadConfiguration:

interface IVisualLoadConfiguration {
    accessToken?: string;
    embedUrl?: string;
    id?: string;
    pageName: string;
    tokenType?: models.TokenType;
    type: string;
    visualName: string;
}

Questa interfaccia include queste proprietà:

  • 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 report che contiene l'oggetto visivo che si sta incorporando. Questo URL diventa l'origine dell'elemento HTML iframe che contiene l'oggetto visivo incorporato. In particolare, l'API assegna l'URL all'attributo src di iframe. È possibile usare un'API report per ottenere questo URL. Di seguito sono riportati due esempi:

  • id - ID del report di Power BI che contiene l'oggetto visivo che si sta incorporando.

  • pageName - Nome della pagina che contiene l'oggetto visivo che si sta incorporando. È possibile utilizzare il metodo GetPages report per ottenere le pagine di un report.

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

    • 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 è proprietaria dei dati).

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

  • type - Tipo di contenuto da incorporare. Usare 'visual' per un oggetto visivo.

  • visualName - Nome dell'oggetto visivo da incorporare. È possibile utilizzare il metodo Page getVisuals per ottenere gli oggetti visivi in una pagina.

Esempio

L'esempio seguente illustra come incorporare un singolo oggetto visivo:

// Set up the configuration object that determines what to embed and how to embed it.
let embedConfiguration = {
    accessToken: anAccessToken,
    embedUrl: anEmbedUrl,
    id: aReportId,
    pageName: aPageName,
    tokenType: aTokenType,
    type: 'visual',
    visualName: aVisualName
};
 
// Get a reference to the HTML element that contains the embedded report.
let embedContainer = $('#embedContainer')[0];
 
// Embed the visual.
let visual = powerbi.embed(embedContainer, embedConfiguration);

Filtri

Per impostazione predefinita, l'API updateFilters applicherà filtri a livello di oggetto visivo durante l'incorporamento di un singolo oggetto visivo del report. Ciò può causare un conflitto con i filtri applicati nell'oggetto di configurazione di incorporamento, perché vengono applicati a livello di report. Per risolvere questo problema, è possibile impostare il livello di filtri con l'API:

await visual.updateFilters(FiltersOperations.Add, filters, FiltersLevel.Report);

Altre informazioni sui filtri in Controllare i filtri dei report.

Passaggi successivi

Incorporare un report

Incorporare un report incorporato

Incorporare un oggetto visivo Q&A autonomo

Usare bootstrap per ottenere prestazioni migliori