Bagikan melalui

Menyematkan visual laporan

  • Artikel

Ujung

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

Artikel ini membahas langkah-langkah untuk menyematkan visual di aplikasi Anda. Pelajari selengkapnya tentang visual di Visual di Power BI.

Cara menyematkan visual

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 visual, gunakan objek konfigurasi jenis IVisualLoadConfiguration:

interface IVisualLoadConfiguration {
    accessToken?: string;
    embedUrl?: string;
    id?: string;
    pageName: string;
    tokenType?: models.TokenType;
    type: string;
    visualName: string;
}

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.

  • embedUrl - URL laporan yang berisi visual yang Anda sematkan. URL ini menjadi sumber elemen html iframe yang berisi visual 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 berisi visual yang Anda sematkan.

  • pageName - Nama halaman yang berisi visual yang Anda sematkan. Anda dapat menggunakan metode Laporan getPages untuk mendapatkan halaman dalam 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 'visual' untuk visual.

  • visualName - Nama visual yang Anda sematkan. Anda dapat menggunakan metode Halaman getVisuals untuk mendapatkan visual di halaman.

Contoh

Contoh berikut menunjukkan kepada Anda cara menyematkan satu visual:

// Set up the configuration object that determines what to embed and how to embed it.
let embedConfiguration = {
    accessToken: anAccessToken,
    embedUrl: anEmbedUrl,
    id: aReportId,
    pageName: aPageName,
    tokenType: aTokenType,
    type: 'visual',
    visualName: aVisualName
};
 
// Get a reference to the HTML element that contains the embedded report.
let embedContainer = $('#embedContainer')[0];
 
// Embed the visual.
let visual = powerbi.embed(embedContainer, embedConfiguration);

Filter

Secara default API updateFilters akan menerapkan filter tingkat visual saat menyematkan satu visual laporan. Ini dapat menyebabkan konflik dengan filter yang diterapkan di objek konfigurasi semat, karena ini diterapkan pada tingkat laporan. Untuk memperbaiki masalah ini, Anda dapat mengatur tingkat filter dengan API:

await visual.updateFilters(FiltersOperations.Add, filters, FiltersLevel.Report);

Pelajari selengkapnya tentang filter di filter laporan Kontrol .

Konten terkait