Bagikan melalui

Menyematkan laporan yang dipaginasi

  • Artikel

Ujung

Coba sematkan laporan yang dipaginasi atau bereksperimen dengan API klien kami di bagian Jelajahi APIPower BI Embedded Analytics Playground.

Artikel ini membahas langkah-langkah untuk menyematkan laporan paginated di aplikasi Anda. Pelajari selengkapnya tentang laporan paginasi di Apa itu laporan paginasi di Power BI Premium?.

Cara menyematkan laporan yang dipaginasi

Saat Anda menyematkan konten Power BI di aplikasi, Anda menentukan konten dan menentukan pengaturannya dalam objek konfigurasi. Kemudian Anda meneruskan objek tersebut ke API.

Saat Anda menyematkan laporan paginated, gunakan objek konfigurasi jenis IPaginatedReportLoadConfiguration:

export interface IPaginatedReportLoadConfiguration {
    accessToken: string;
    id: string;
    embedUrl?: string;
    settings?: IPaginatedReportSettings;
    tokenType?: TokenType;
    type?: string;
    parameterValues?: IPaginatedReportParameter[];
}

Antarmuka ini berisi properti berikut:

  • accessToken - Token yang memberi Anda akses ke data Power BI yang Anda sematkan. Lihat Memahami berbagai solusi penyematan untuk mempelajari selengkapnya tentang token akses.

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

    Sebaiknya teruskan parameter laporan ke laporan menggunakan properti parameterValues yang dijelaskan di bawah ini. Namun, Anda juga dapat meneruskan parameter ke laporan dengan menambahkan string kueri ke akhir URL yang disematkan. Baca selengkapnya tentang meneruskan parameter URL dalam laporan paginasi. Lihat contoh parameter meneruskan ke URL.

  • id - ID laporan Power BI yang Anda sematkan.

  • nama host - Nilai hostname default adalah app.powerbi.com. Jika Anda menggunakan sovereign cloud, berikan URL di sini. Jika Anda memberikan nilai untuk embedURL, hostname akan diabaikan.

  • pengaturan - Objek konfigurasi jenis IPaginatedReportSettings. Objek ini menentukan informasi tentang tampilan panel parameter laporan. Panel parameter adalah bilah di bawah bilah tindakan yang dapat diperluas atau disembunyikan.

    Cuplikan layar yang memperlihatkan laporan halaman Power B I yang disematkan. Panel parameter berada di dekat bagian atas dan disorot dengan warna merah.

    • Anda dapat menampilkan atau menyembunyikan panel parameter dengan mengklik tombol Parameter pada bilah tindakan. Tombol tersebut tersedia secara default. Tetapi jika Anda mengonfigurasi properti panel untuk , tombol Parameter tidak tersedia.

    • Secara default, API menciutkan panel parameter. Jika Anda mengatur properti expanded panel ke true, API memuat laporan dengan panel ini diperluas.

    • Kode ini menunjukkan salah satu cara untuk mengonfigurasi properti settings:

      settings: {
    commands: {
        parameterPanel: {
            enabled: true,
            expanded: true
        }
    }
}

  • tokenType - Jenis token yang memberi Anda akses ke data Power BI yang 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.

  • parameterValues – Objek konfigurasi jenis IPaginatedReportParameter. Atur parameter laporan menggunakan properti ini. Metode ini menggunakan JavaScript SDK dan merupakan metode yang disukai untuk meneruskan parameter laporan. Misalnya:

    parameterValues: [
      {name: "State", value: "WA"},
      {name: "City", value: "Seattle"},
      {name: "City", value: "Bellevue"},
      {name: "City", value: "Redmond"}
]

    Metode ini hanya dapat digunakan untuk meneruskan parameter laporan (parameter yang memiliki awalan URL rp:) dan tidak parameter rdl (dengan awalan URL rdl:).

Contoh

Contoh berikut menunjukkan kepada Anda cara menyematkan laporan paginated:

// Set up the configuration object that determines what to embed and how to embed it.
let embedConfiguration = {
    accessToken: anAccessToken,
    embedUrl: anEmbedUrl,
    uniqueId: aReportId,
    tokenType: aTokenType,
    type: 'report',
    datasetBindings: [{
      sourceDatasetId: "originalDatasetId",
      targetDatasetId: "notOriginalDatasetId"
    }]
};
 
// Get a reference to the HTML element that contains the embedded report.
let embedContainer = $('#embedContainer')[0];
 
// Embed the report.
let report = powerbi.embed(embedContainer, embedConfiguration);

Pastikan Anda menyertakan semua DatasetId yang digunakan untuk pengikatan dalam token semat multi-sumber daya.

Pertimbangan dan batasan

  • Untuk menggunakan pengikatan dinamis, lihat Mengikat himpunan data secara dinamis ke laporan paginasi.
  • Metode bootstrap tidak didukung untuk laporan paginated.
  • Parameter multinilai tidak didukung saat menyematkan laporan yang dipaginasi.
  • Properti parameterValues hanya dapat digunakan untuk parameter laporan. Ini tidak dapat digunakan untuk parameter rdl.
  • Menyematkan laporan paginated dengan himpunan data real time (himpunan data push) tidak didukung.

Konten terkait