Incorporare un report

Suggerimento

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

Questo articolo illustra i passaggi per l'incorporamento di un report di Power BI nell'applicazione. Altre informazioni sui report in Report in Power BI.

Come incorporare un report

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. Per altre informazioni, vedere Configurare le impostazioni del report .

Incorporare un report esistente

Quando si incorpora un report già esistente, usare un oggetto di configurazione di tipo IReportLoadConfiguration.

interface IReportLoadConfiguration {
    accessToken: string;
    bookmark?: models.IApplyBookmarkRequest;
    contrastMode?: models.ContrastMode;
    datasetBinding?: models.IDatasetBinding;
    embedUrl?: string;
    filters?: models.ReportLevelFilters[];
    id: string;
    pageName?: string;
    permissions?: models.Permissions;
    settings?: models.IEmbedSettings;
    slicers?: models.ISlicer[];
    theme?: models.IReportTheme;
    tokenType?: models.TokenType;
    type: string;
    viewMode?: models.ViewMode;
}

Questa interfaccia include queste proprietà:

• 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 .

• datasetBinding - Set di dati che definisce lo schema di dati usato dal report incorporato. Per altre informazioni sui set di dati, vedere Associare dinamicamente i set di dati a un report .

• embedUrl - URL del report incorporato. Questo URL diventa l'origine dell'elemento HTML iframe che contiene il report 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:

  • Report - Ottenere report nel gruppo
  • Report - Ottenere report nel gruppo

• id - ID del report di Power BI incorporato.

• permissions - Operazioni concesse agli utenti per il report incorporato. Questi valori sono disponibili:

  • Read - Gli utenti possono visualizzare il report.
  • ReadWrite - Gli utenti possono visualizzare, modificare e salvare il report.
  • Copy - Gli utenti possono salvare una copia del report usando Salva con nome.
  • Create - Gli utenti possono creare un nuovo report.
  • All - Gli utenti possono creare, visualizzare, modificare, salvare e salvare una copia del report.

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

  • Usare models.TokenType.Aad se si sta incorporando per l'organizzazione (l'utente possiede i dati).
  • Usare models.TokenType.Embed se si sta incorporando per i clienti (l'app possiede i dati).

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

• type - Tipo di contenuto incorporato. Usare 'report' per un report di Power BI.

L'interfaccia IReportLoadConfiguration contiene anche altre proprietà. Per informazioni su queste proprietà, vedere Configurare le impostazioni del report :

• bookmark
• contrastMode
• filters
• pageName
• settings
• slicers
• theme
• viewMode

Incorporare un nuovo report

Quando si incorpora un nuovo report creato da un set di dati, usare un oggetto di configurazione di tipo IReportCreateConfiguration.

interface IReportCreateConfiguration {
    accessToken: string;
    datasetId: string;
    embedUrl?: string;
    settings?: models.IEmbedSettings;
    theme?: IReportTheme;
    tokenType?: models.TokenType;
    type: string;
}

Le proprietà in questa interfaccia sono simili alle proprietà nell'interfaccia IReportLoadConfiguration , con le eccezioni seguenti:

• datasetId - ID del set di dati che definisce lo schema di dati usato dal nuovo report.

• embedUrl - URL del set di dati che definisce lo schema di dati usato dal nuovo report. Questo URL diventa l'origine dell'elemento HTML iframe che contiene il report incorporato. In particolare, l'API assegna l'URL all'attributo src di iframe. È possibile usare un'API Set di dati per ottenere questo URL. Di seguito sono riportati due esempi:

  • Set di dati - Ottenere set di dati in gruppo
  • Set di dati - Ottenere set di dati in gruppo

Per informazioni sulla modifica e la creazione di report , vedere Creare, modificare e salvare un report incorporato .

Esempio

Nell'esempio seguente viene illustrato come incorporare un report:

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

Passaggi successivi

Incorpora un oggetto visivo del report

Incorporare un report incorporato

Configurare le impostazioni rapporto

Creare, modificare e salvare un report

Usare bootstrap per migliorare le prestazioni