Bagikan melalui

Menyematkan petak dasbor

  • Artikel

Ujung

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

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

Cara menyematkan petak 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 petak dasbor, gunakan objek konfigurasi jenis ITileLoadConfiguration:

interface ITileLoadConfiguration {
    accessToken: string;
    dashboardId: string;
    embedUrl: string;
    id: string;
    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.

  • dashboardId - ID dasbor yang berisi petak peta yang Anda sematkan. Anda dapat menggunakan API Dasbor untuk mendapatkan ID ini. Dua contohnya adalah:

  • embedUrl - URL petak peta dasbor yang Anda sematkan. URL ini menjadi sumber elemen html iframe yang berisi petak peta 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 petak dasbor yang Anda sematkan. Anda dapat menggunakan API Dasbor untuk mendapatkan ID ini. Dua contohnya adalah:

  • 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 'tile' untuk petak dasbor.

Contoh

Contoh berikut menunjukkan kepada Anda cara menyematkan satu petak dasbor:

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

Konten terkait