Incorporare un report

  • Articolo

Mancia

Provare a incorporare un report o un esperimento 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 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 che si sta incorporando e per specificare le impostazioni del contenuto. Passare 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 da incorporare. 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 set di dati in modo dinamico a un report.

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

  • 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 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 '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 dei dati usato dal nuovo report.

  • embedUrl : URL del set di dati che definisce lo schema dei 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 dell'iframe. È possibile usare un'API set di dati per ottenere questo URL. Di seguito sono riportati due esempi:

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);

Contenuto correlato