Bagikan melalui

Gunakan bootstrap untuk performa yang lebih baik

  • Artikel

powerbi.bootstrap adalah metode yang diperkenalkan di Client SDK versi 2.9.0 untuk membantu pengembang menyematkan entitas Power BI lebih cepat dan mendapatkan performa yang lebih baik.

Menyematkan laporan menggunakan powerbi.embed memerlukan beberapa parameter, seperti reportId, embedURL, dan accessToken. Parameter ini tidak selalu tersedia segera.

powerbi.bootstrap memungkinkan Anda untuk mulai menyematkan sebelum semua parameter yang diperlukan tersedia. API bootstrap menyiapkan dan menginisialisasi iframe.

Setelah parameter yang diperlukan diterima, powerbi.embed(element, config) harus dipanggil pada elemen HTML yang sama.

Bootstrap API

Metode powerbi.bootstrap(element, config) menerima elemen dan konfigurasi, sama dengan powerbi.embed(...).

/**
    * Given an HTML element and entityType, creates a new component instance, and bootstrap the iframe for embedding.
    *
    * @param {HTMLElement} an HTML Element where you need to embed. must be the same div element you will use in powerbi.embed.
    * @param {IBootstrapEmbedConfiguration} config: a bootstrap config.
    */
bootstrap(element: HTMLElement, config: IBootstrapEmbedConfiguration): embed.Embed;

Konfigurasi semat Bootstrap

interface IBootstrapEmbedConfiguration {
  type: string;
  hostname?: string;
  embedUrl?: string;
  settings?: ISettings;
}

Parameter konfigurasi:

  • ketik (diperlukan): Jenis entitas yang ingin Anda sematkan, seperti 'report', 'dashboard', 'tile', 'qna', atau 'visual'.
  • nama host: Jika Anda belum memiliki embedURL, Anda dapat memberikan nama host. Nama host adalah nama domain URL yang disematkan. Misalnya, jika URL yang disematkan adalah 'https://app.powerbi.com/reportEmbed' maka nama host adalah 'https://app.powerbi.com/'. Jika tidak ada nama host atau embedUrl yang disediakan, nama host default, https://app.powerbi.com/, digunakan.
  • embedUrl: URL semat yang sama yang akan Anda berikan nanti ke powerbi.embed. Jika tidak ada nama host atau embedUrl yang disediakan, nama host default, https://app.powerbi.com/, digunakan.
  • pengaturan: Untuk menyematkan laporan dalam tata letak seluler atau untuk menyediakan lokal (bahasa), sertakan parameter ini dalam pengaturan awal.

Sampel bootstrap

Sampel berikut ini menyediakan referensi untuk metode bootstrap saat menyematkan entitas Power BI.

Nota

Pastikan Anda memanggil powerbi.embed setelah menerima parameter semat.

Untuk bootstrap untuk menyematkan laporan:

powerbi.bootstrap(
        reportContainerDivElement,
        {
            type: 'report',
        }
    );

Untuk bootstrap untuk menyematkan dasbor:

powerbi.bootstrap(
        reportContainerDivElement,
        {
            type: 'dashboard',
            embedUrl: "https://app.powerbi.com/dashboardEmbed?dashboardId=06e3ba63-47ea-4579-b010-fdb5484b325a&config=eyJjbHVzdGVyVXJsIjoiaHR0cHM6mLndpbmRvd3MubmV0In0="
        }
    );

Untuk bootstrap untuk menyematkan laporan dengan nama host saja:

powerbi.bootstrap(
        reportContainerDivElement,
        {
            type: 'report',
            hostname: "https://app.powerbi.com"
        }
    );

Untuk bootstrap untuk menyematkan laporan dengan tata letak seluler:

powerbi.bootstrap(
        reportContainerDivElement,
        {
            type: 'report',
            hostname: "https://app.powerbi.com",
            settings: {
	            layoutType: models.LayoutType.MobilePortrait
            }
        }
    );

Pertimbangan dan batasan

  • Entitas yang di-bootstrap berikut tidak dapat diubah tanpa memanggil powerbi.reset(element).

    • Jenis komponen (laporan, dasbor): Misalnya, jika Anda melakukan bootstrap laporan, Anda hanya dapat menyematkan laporan dalam elemen HTML yang sama.
    • Tata letak (desktop/seluler)
    • Lokal (bahasa)

  • Metode powerbi.bootstrap tidak didukung saat menyematkan laporan paginated.

Konten terkait