Bagikan melalui


Menyematkan dasbor

Artikel ini membahas langkah-langkah untuk menyematkan dasbor di aplikasi Anda. Pelajari selengkapnya tentang dasbor di Pengenalan dasbor untuk perancang Power BI.

Ujung

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

Cara menyematkan dasbor

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.

Saat Anda menyematkan dasbor, gunakan objek konfigurasi jenis IDashboardLoadConfiguration:

interface IDashboardLoadConfiguration {
    accessToken: string;
    embedUrl?: string;
    id: string;
    pageView?: models.PageView 
    tokenType?: models.TokenType;
    type: string;
}

Antarmuka ini berisi properti berikut:

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

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

  • id - ID dasbor yang Anda sematkan. Gunakan API Dasbor untuk mendapatkan ID ini. Misalnya:

  • pageView - Format yang digunakan API untuk dasbor yang disematkan. Kemungkinannya meliputi:

    • fitToWidth - Lebar dasbor yang disematkan cocok dengan lebar elemen div yang berisi dasbor.
    • oneColumn - Dasbor yang disematkan muncul dalam satu kolom.
    • actualSize - API menampilkan dasbor yang disematkan pada ukuran penuh.
  • tokenType - Jenis token yang memberi Anda akses ke data Power BI yang Sedang Anda sematkan.

    • Gunakan models.TokenType.Aad untuk menyematkan organisasi Anda (penggunamemiliki data).
    • Gunakan models.TokenType.Embed untuk menyematkan bagi pelanggan Anda (aplikasimemiliki data).

    Lihat Memahami berbagai solusi penyematan untuk informasi selengkapnya.

  • type - Jenis konten yang Anda sematkan. Gunakan 'dashboard' untuk dasbor.

Contoh

Contoh berikut menunjukkan kepada Anda cara menyematkan satu dasbor:

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

Pertimbangan dan batasan

  • Menyematkan dasbor pada SKU EM tidak didukung

  • Saat Anda menyematkan konten, aplikasi Anda menampilkan konten dalam elemen div. Jika Anda menggunakan nilai pageViewactualSize saat menyematkan dasbor:

    • Jika dasbor lebih lebar dari elemen div, API menggunakan lebar elemen div sebagai lebar dasbor yang disematkan.
    • Jika dasbor lebih sempit dari elemen div, API mengisi ruang yang tidak digunakan dengan latar belakang yang disematkan. Secara default, latar belakang tersebut berwarna putih, tetapi Anda dapat mengonfigurasinya agar transparan. Dalam hal ini, gaya elemen div terlihat di ruang yang tidak digunakan.