Condividi tramite


Incorporare un oggetto visivo del report

Mancia

Provare a incorporare un oggetto visivo del report o sperimentare con le API client nella sezione esplorare le API della power BI Embedded Analytics Playground.

Questo articolo illustra i passaggi per l'incorporamento di un oggetto visivo nell'applicazione. Altre informazioni sugli oggetti visivi in oggetti visivi di 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 che si sta incorporando 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 dell'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 contenente l'oggetto visivo che si sta incorporando. Per ottenere le pagine in un report, è possibile utilizzare il metodo getPages getPages.

  • 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 'visual' per un oggetto visivo.

  • visualName: nome dell'oggetto visivo che si sta incorporando. È possibile usare il metodo getVisuals Page 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 di 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 nei filtri dei report di controllo .