Bagikan melalui

Menyematkan laporan

  • Artikel

Ujung

Coba sematkan laporan atau eksperimen dengan API klien kami di bagian Jelajahi APIPower BI Embedded Analytics Playground.

Artikel ini membahas langkah-langkah untuk menyematkan laporan Power BI di aplikasi Anda. Pelajari selengkapnya tentang laporan dalam Laporan di Power BI.

Cara menyematkan laporan

Saat Anda menyematkan konten Power BI di aplikasi, Anda menggunakan objek konfigurasi untuk menentukan konten yang Anda sematkan dan untuk menentukan pengaturan konten. Kemudian Anda meneruskan objek tersebut ke API. Lihat Mengonfigurasi pengaturan laporan untuk informasi selengkapnya.

Menyematkan laporan yang sudah ada

Saat Anda menyematkan laporan yang sudah ada, gunakan objek konfigurasi jenis 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;
}

Antarmuka ini mencakup properti ini:

  • accessToken - Token yang memberi Anda akses ke data Power BI yang Sedang Anda sematkan. Lihat Memahami berbagai solusi penyematan untuk mempelajari selengkapnya tentang token akses.

  • datasetBinding - Himpunan data yang menentukan skema data yang digunakan laporan yang disematkan. Lihat Mengikat himpunan data secara dinamis ke laporan untuk informasi selengkapnya tentang himpunan data.

  • embedUrl - URL laporan yang Anda sematkan. URL ini menjadi sumber elemen iframe HTML yang berisi laporan yang disematkan. Secara khusus, API menetapkan URL ke atribut src dari iframe. Anda dapat menggunakan API Laporan untuk mendapatkan URL ini. Dua contohnya adalah:

  • id - ID laporan Power BI yang Anda sematkan.

  • permissions - Operasi yang Anda berikan kepada pengguna untuk laporan yang disematkan. Nilai-nilai ini tersedia:

    • Read - Pengguna dapat melihat laporan.
    • ReadWrite - Pengguna dapat melihat, mengedit, dan menyimpan laporan.
    • Copy - Pengguna dapat menyimpan salinan laporan dengan menggunakan Simpan Sebagai.
    • Create - Pengguna dapat membuat laporan baru.
    • All - Pengguna dapat membuat, menampilkan, mengedit, menyimpan, dan menyimpan salinan laporan.

  • tokenType - Jenis token yang memberi Anda akses ke data Power BI yang Sedang Anda sematkan.

    • Gunakan models.TokenType.Aad jika Anda menyematkan untuk organisasi Anda (pengguna memiliki data).
    • Gunakan models.TokenType.Embed jika Anda menyematkan untuk pelanggan Anda (aplikasi memiliki data).

    Lihat Memahami berbagai solusi penyematan untuk informasi selengkapnya.

  • type - Jenis konten yang Anda sematkan. Gunakan 'report' untuk laporan Power BI.

Antarmuka IReportLoadConfiguration juga berisi properti lain. Lihat Mengonfigurasi pengaturan laporan untuk informasi tentang properti ini:

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

Menyematkan laporan baru

Saat Anda menyematkan laporan baru yang Anda buat dari himpunan data, gunakan objek konfigurasi jenis IReportCreateConfiguration.

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

Properti dalam antarmuka ini mirip dengan properti di antarmuka IReportLoadConfiguration, dengan pengecualian berikut:

  • datasetId - ID himpunan data yang menentukan skema data yang digunakan laporan baru.

  • embedUrl - URL himpunan data yang menentukan skema data yang digunakan laporan baru. URL ini menjadi sumber elemen iframe HTML yang berisi laporan yang disematkan. Secara khusus, API menetapkan URL ke atribut src dari iframe. Anda dapat menggunakan API Himpunan Data untuk mendapatkan URL ini. Dua contohnya adalah:

Lihat Membuat, mengedit, dan menyimpan laporan yang disematkan untuk informasi tentang pengeditan dan pembuatan laporan.

Contoh

Contoh berikut menunjukkan cara menyematkan laporan:

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

Isi Terkait