Bagikan melalui

Mengaktifkan filter persisten

  • Artikel

Dalam laporan yang Anda sematkan untuk organisasi Anda, saat fitur filter persisten diaktifkan, laporan mempertahankan statusnya, termasuk filter, pemotong, dan perubahan tampilan data lainnya. Saat pengguna Anda membuka laporan, status pengguna yang disimpan dimuat ke dalam laporan. Selain itu, pengguna mendapatkan status pengguna yang sama dalam skenario yang berbeda jika filter persisten diaktifkan.

Untuk mereset filter persisten dalam skenario semat, Anda harus menerapkan tombol dan menggunakan API resetPersistentFilters, atau memperlihatkan bilah tindakan untuk mendapatkan Power BI Reset ke tombol default pada bilah tindakan.

Cara mengaktifkan filter persisten

Filter persisten dinonaktifkan secara default. Untuk mengaktifkan filter persisten, ikuti langkah-langkah di bagian ini.

  1. Verifikasi bahwa filter persisten diaktifkan dalam pengaturan laporan di layanan Power BI atau desktop.

  2. Verifikasi bahwa aplikasi Azure Active Directory (Azure AD) Anda memiliki izin UserState.ReadWrite.All.

  3. Tetapkan persistentFiltersEnabled properti ke true.

    let config = {
        type: 'report',
        ...
        settings: {
            persistentFiltersEnabled: true
        }
    };

Laporan dimuat dengan status laporan pengguna terbaru, jika status ada. Status laporan pengguna secara otomatis disimpan setelah 60 detik, tanpa perubahan apa pun.

Nota

  • Hanya pembaruan untuk filter yang ada yang disimpan. Filter baru ditambahkan oleh API setFilters tidak disimpan.
  • Filter persisten tidak dapat diubah setelah laporan dimuat. Untuk mengubah status filter persisten, reset iframe dengan memanggil powerbi.reset(element), lalu sematkan laporan lagi.

API filter persisten

Mereset filter persisten

Reset filter, pemotong, dan perubahan tampilan data pengguna lainnya ke status default laporan.

    resetPersistentFilters(): Promise<void>

Menyimpan filter persisten

Simpan filter laporan pengguna, pemotong, dan perubahan tampilan data lainnya.

    savePersistentFilters(): Promise<void>

Filter persisten diterapkan

Mengembalikan filter, pemotong, atau perubahan tampilan data pengguna lainnya yang diterapkan pada laporan, jika ada. Jika filter persisten dinonaktifkan, ini mengembalikan false.

Anda dapat menggunakan API ini untuk menentukan status tombol reset.

    arePersistentFiltersApplied(): Promise<boolean>

Pertimbangan dan batasan

Filter persisten hanya didukung untuk yang disematkan untuk solusi organisasi Anda (data pemilik pengguna).

Konten terkait