Menggunakan bilah tindakan untuk meningkatkan pengalaman pengguna

Saat Anda menyematkan laporan untuk organisasi, Anda mengharuskan pengguna aplikasi Anda untuk masuk ke Power BI untuk menampilkan konten yang disematkan. Setelah pengguna masuk, mereka memiliki akses ke laporan yang mereka miliki atau yang dibagikan oleh Anda atau anggota organisasi lainnya dengan mereka.

Konsumen laporan yang Anda sematkan untuk organisasi Anda dapat memanfaatkan kemampuan layanan mandiri seperti bilah tindakan, marka buku pribadi, dan filter persisten melalui API Klien .

Bilah tindakan

Saat Anda menyematkan laporan Power BI untuk organisasi Anda, konsumen laporan bisa menggunakan bilah tindakan laporan untuk mengekspor, berbagi, mengubah tampilan, atau mengambil beberapa tindakan lainnya.

Anda dapat mengaktifkan fungsionalitas penuh bilah tindakan untuk memungkinkan pengguna:

• Favoritkan laporan
• Menggunakan filter persisten
• Menggunakan marka buku pribadi

Penting

Untuk menyediakan fungsionalitas bilah tindakan penuh, Anda harus memberi pengguna izin UserState.ReadWrite.All untuk aplikasi Anda di Azure Active Directory (Azure AD).

Untuk menampilkan bilah tindakan ke konsumen laporan Anda, tambahkan pengaturan bars ke konfigurasi semat Anda, dan atur visibilitas actionBar ke true.

let embedConfig = {
   ...
   settings: {
      bars: {
         actionBar: {
            visible: true
         }
      }
   }
};

Memperlihatkan bilah tindakan menampilkan daftar vertikal halaman laporan, pengalaman yang sama seperti di layanan Power BI. Pengguna dapat menciutkan panel navigasi halaman untuk memberi laporan lebih banyak ruang.

Filter persisten

Filter persisten mempertahankan filter, pemotong, dan status laporan konsumen laporan lainnya selama sesi. Konsumen laporan dapat dengan cepat mendapatkan wawasan mereka tanpa mengulangi langkah-langkah pemfilteran yang sama setiap kali mereka kembali ke laporan. Pengguna dapat berbagi status laporan persisten yang sama di seluruh skenario layanan Power BI, seluler, dan semat.

Untuk mengaktifkan filter persisten dalam laporan yang disematkan untuk organisasi Anda:

1. Aktifkan filter persisten di layanan Power BI atau pengaturan laporan desktop.

2. Pastikan aplikasi Anda mengizinkan izin UserState.ReadWrite.All di Azure ACTIVE Directory.

3. Atur properti di pengaturan loadConfiguration yang disematkan ke :

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

Laporan dimuat dengan status laporan terbaru pengguna, jika ada. Dalam laporan yang disematkan, konsumen dapat menggunakan Reset ke tombol default di bilah tindakan untuk menerapkan filter persisten mereka.

Untuk informasi selengkapnya tentang filter persisten dan API yang relevan, lihat Filter persisten.

Marka buku pribadi

Dalam laporan yang Anda sematkan untuk organisasi Anda, konsumen laporan dapat membuat marka buku pribadi dengan menangkap status halaman laporan, termasuk filter, pemotong, dan status visual, dan memberi mereka nama yang mudah diingat. Pengguna kemudian dapat dengan cepat kembali ke status ini dengan memilih marka buku. Marka buku pribadi hanya tersedia untuk pembuatnya, dan membuatnya tidak memerlukan izin tulis untuk laporan.

Konsumen laporan dapat menggunakan marka buku pribadi yang sama dalam laporan yang disematkan dan di layanan Power BI. Pengguna dapat membuat bookmark pribadi tampilan default mereka, sehingga mereka melihat tampilan favorit mereka dari laporan setiap kali mereka membukanya.

Untuk mengaktifkan marka buku pribadi dalam laporan yang disematkan untuk organisasi Anda:

1. Pastikan aplikasi Anda mengizinkan izin UserState.ReadWrite.All di Azure ACTIVE Directory.

2. Atur properti di pengaturan loadConfiguration yang disematkan ke :

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

3. Buat panel bookmark terlihat dalam laporan.

Anda bisa membuat panel bookmark terlihat dalam laporan dengan dua cara. Opsi pertama adalah menampilkan bilah tindakan laporan, yang memiliki tombol Bookmark bagi pengguna untuk membuka dan menutup panel marka buku.

Opsi kedua adalah menampilkan dan menyembunyikan panel marka buku secara terprogram dengan menggunakan panel objek di pengaturan laporan.

let embedConfig = {
   ...
   settings: {
      panes: {
         bookmarks: {
            visible: true
         }
      }
   }
};

Anda dapat memperbarui pengaturan laporan saat runtime dengan menggunakan metode updateSettings, lihat Memperbarui pengaturan laporan saat runtime.

Untuk informasi selengkapnya tentang marka buku pribadi, lihat Bookmark Pribadi.

Pertimbangan dan batasan

• Di Analitik tersemat Power BI, filter persisten dan fitur marka buku pribadi dinonaktifkan secara default. Fitur-fitur ini hanya didukung saat Anda menyematkan laporan untuk organisasi Anda, bukan saat Anda menyematkan untuk pelanggan Anda.

• Saat Anda memperlihatkan bilah tindakan, Anda tidak dapat lagi mengontrol apakah navigasi halaman muncul sebagai panel di sebelah kiri atau sebagai tab di bagian bawah. Mengubah lokasi daftar halaman laporan hanya tersedia melalui pengaturan laporan layanan Power BI, bukan melalui objek panes.

• Tindakan marka buku pribadi tidak didukung oleh API. Untuk informasi tentang bookmark laporan, lihat Melaporkan bookmark.

Konten terkait

• Tingkatkan pengalaman pengguna Anda dengan bookmark
• Mengaktifkan filter persisten