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 HTMLiframe
yang berisi dasbor yang disematkan. Secara khusus, API menetapkan URL ke atributsrc
dariiframe
. Anda dapat menggunakanDashboards API untuk mendapatkan URL ini. Dua contohnya adalah: - Dasbor - Dapatkan Dasbor Di Grup
- Dasbor - Dapatkan Dasbor Di Grup
id
- ID dasbor yang Anda sematkan. Gunakan API Dasboruntuk mendapatkan ID ini. Misalnya: - Dasbor - Dapatkan Dasbor Di Grup
- Dasbor - Dapatkan Dasbor Di Grup
pageView
- Format yang digunakan API untuk dasbor yang disematkan. Kemungkinannya meliputi:-
fitToWidth
- Lebar dasbor yang disematkan cocok dengan lebar elemendiv
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.
- Gunakan
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 nilaipageView
actualSize
saat menyematkan dasbor:- Jika dasbor lebih lebar dari elemen
div
, API menggunakan lebar elemendiv
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 elemendiv
terlihat di ruang yang tidak digunakan.
- Jika dasbor lebih lebar dari elemen
Konten terkait
- Menyematkan laporan
- Menyematkan petak peta dasbor
- Gunakan bootstrap untuk performa yang lebih baik