Bagikan melalui

Tangkap tampilan laporan yang ditampilkan

Bookmark laporan Power BI menangkap status halaman laporan yang disematkan saat ini, termasuk status visualnya dan pemotongan atau pemfilteran apa pun. Pengguna dapat mengembalikan laporan ke status tersebut dengan mengakses bookmark yang diambil atau dibagikan. Anda bisa menggunakan API Klien Power BI untuk menyimpan tampilan marka buku dengan laporan, dan untuk memungkinkan pengguna melaporkan mengambil dan berbagi marka buku mereka sendiri.

Tampilan laporan Capture ditampilkan di playground analitik tersemat Power BI menggunakan API marka buku untuk memungkinkan pengguna mengakses, mengambil, menyimpan, dan berbagi marka buku.

Pengguna dapat:

  • Lihat tampilan marka buku yang disimpan sebagai bagian dari laporan.
  • Gunakan filter, pemotong, dan kontrol lainnya untuk membuat tampilan laporan yang dikustomisasi.
  • Ambil tampilan saat ini dengan menyimpan marka buku.
  • Bagikan tampilan yang diambil dengan orang lain dengan mengirimi mereka tautan.
  • Kembali ke tampilan marka buku yang mereka buat selama sesi tampilan saat ini.

Menangkap pengalaman tampilan laporan yang ditampilkan

Dalam tampilan laporan Capture ditampilkan, konglomerat imajiner bernama Contoso memperlihatkan data performa mereka dalam laporan yang disematkan Power BI. Laporan ini menggunakan Q&A, dua kartu multirow, matriks, dan bagan kolom untuk memperlihatkan data 2014 untuk semua produsen, produk, dan wilayah mereka. Visual memiliki kontrol filter dan pemotong, sehingga pengguna dapat mempersempit dan melihat bagian data.

Mengonfigurasi tampilan

Manajer Penjualan di wilayah Barat memilih Barat untuk melihat hanya data wilayah Barat, dan menggunakan penggeser tanggal untuk mempersempit jangka waktu ke paruh kedua tahun ini.

Cuplikan layar memperlihatkan visualisasi dan kontrol dalam tampilan Ambil tampilan laporan.

Manajer Penjualan dapat menyimpan atau berbagi tampilan yang dikonfigurasi dengan memilih tampilan Capture. Kotak dialog pop-up memberikan opsi untuk Simpan ke 'Tampilan Saya' atau Salin Link.

Cuplikan layar memperlihatkan kotak dialog Tangkap tampilan.

Menyimpan bookmark

Untuk menyimpan marka buku, Manajer Penjualan memilih Simpan ke'Tampilan Saya', memasukkan nama untuk tampilan, dan memilih Simpan.

Kotak dialog ditutup, dan panel yang memperlihatkan daftar marka buku tersimpan muncul, dengan marka buku baru yang disimpan disorot. Memilih bookmark apa pun dalam daftar menyoroti marka buku dan menampilkan tampilan tersebut. Memilih simbol tutup atau tombol Tampilan tersimpan menutup panel marka buku.

Cuplikan layar memperlihatkan daftar marka buku dengan tampilan yang baru dibuat dipilih.

Berbagi marka buku

Untuk mendapatkan tautan ke tampilan yang akan dikirim ke pemangku kepentingan, Manajer Penjualan memilih Salin Link dalam kotak dialog tampilan Pengambilan , lalu memilih Salin untuk menyalin tautan. Memilih simbol tutup atau memilih di mana saja di luar kotak dialog menutupnya.

Cuplikan layar memperlihatkan kotak dialog Salin Tautan dengan tautan ke tampilan saat ini.

Lihat tampilan marka buku

Untuk masuk ke tampilan bookmark tersimpan selama sesi tampilan laporan saat ini, pengguna dapat memilih Tampilan tersimpan untuk menurun daftar bookmark, dan memilih tampilan yang ingin mereka lihat. Nama bookmark disorot, dan laporan menampilkan tampilan marka buku.

Marka buku yang Anda simpan pada pembuatan laporan tersedia untuk semua pengguna di semua sesi. Anda juga dapat menyimpan marka buku yang dibuat pengguna di antara sesi, tetapi dalam showcase ini, marka buku yang dibuat pengguna hanya tersedia selama sesi tampilan yang sama, atau dengan URL langsung.

Penerima tautan marka buku bersama dapat menggunakan tautan di browser mereka untuk membuka laporan langsung ke tampilan marka buku.

Mengambil kode showcase tampilan laporan

Kode untuk mengimplementasikan showcase ada di PowerBI-Embedded-Showcases repositori GitHub.

  • Aplikasi kode HTML membangun kontainer dan elemen laporan, tampilan tersimpan tombol dan daftar drop-down, dan kotak dialog dan tombol tampilan Pengambilan .

  • Laporan JavaScript menyematkan laporan dengan daftar marka buku yang disimpan, memuat laporan dengan tampilan marka buku pertama Sepanjang Tahun 2014 aktif, dan mengimplementasikan fungsi penangkapan, penyimpanan, berbagi, dan pemilihan marka buku.

Dalam laporan kelas BookmarksManager, apply menerapkan bookmark yang disimpan sebelumnya berdasarkan nama, capture mengambil dan mengembalikan string yang mewakili status laporan saat ini, dan applyState menerapkan status yang diambil sebelumnya. Saat menerapkan bookmark yang disimpan, Anda dapat menentukan bookmark baik dengan name atau dengan state.

Untuk informasi selengkapnya tentang operasi bookmark dan API, lihat Melaporkan bookmark.

Menerapkan tampilan marka buku pada pemuatan laporan

Kode showcase mendekode nama bookmark dari url tampilan id argumen dan mendapatkan marka buku tersebut dari penyimpanan lokal. Showcase menggunakan penyimpanan lokal untuk kesederhanaan, tetapi Anda dapat menggunakan database apa pun. Atribut bookmark dalam laporan embedConfiguration menerapkan bookmark saat dimuat.

async function embedSharedBookmarkReport() {
    ...
    // Get the bookmark name from url param
    let bookmarkName = getBookmarkNameFromURL();

    // Get the bookmark state from local storage
    let bookmarkState = localStorage.getItem(bookmarkName);

    // Embed configuration used to describe the what and how to embed
    let config = {
        ...
        // Adding bookmark attribute will apply the bookmark on load
        bookmark: {
            state: bookmarkState
        }
    };

Mengambil tampilan dan menyimpannya ke daftar marka buku

Kode showcase mengambil status laporan saat ini, menambahkan nama bookmark baru ke daftar bookmark, dan membuka daftar bookmark drop-down dengan bookmark baru aktif.

        // Capture the report's current state with personalized visuals
        const capturedBookmark = await bookmarkShowcaseState.report.bookmarksManager.capture({ personalizeVisuals: true });

        // Build bookmark element
        let bookmark = {
            name: "bookmark_" + bookmarkShowcaseState.bookmarkCounter,
            displayName: capturedViewname,
            state: capturedBookmark.state
        }

        // Add the new bookmark to the HTML list
        bookmarksList.append(buildBookmarkElement(bookmark));

        // Open the bookmarks list div and show the applied bookmark
        bookmarksList.addClass("show position");

        bookmarksDropdown.addClass(displayClass);
        ...

        // Set the captured bookmark as active
        const newBookmark = "bookmark_" + bookmarkShowcaseState.bookmarkCounter;
        setBookmarkActive($(newBookmark));

Perlihatkan tampilan terpilih dari daftar marka buku

Kode ini menetapkan marka buku yang dipilih sebagai aktif, menyorotinya dalam daftar bookmark, dan menerapkan status aktif.

function onBookmarkClicked(element) {

    // Set the clicked bookmark as active
    setBookmarkActive($(element));

    // Apply respective color to the label of the bookmark
    applyColor(element.id);

    // Get bookmark ID from HTML
    const bookmarkId = $(element).attr("id");

    // Find the bookmark in the bookmarks array
    let currentBookmark = getBookmarkByID(bookmarkId);

    // Apply the bookmark state
    bookmarkShowcaseState.report.bookmarksManager.applyState(currentBookmark.state);
}

Konten terkait

  • Last updated on