Bagikan melalui

Sembunyikan atau perlihatkan header visual

  • Artikel

Power BI melaporkan bahwa Anda menyematkan dalam aplikasi berisi visual, seperti bagan, peta panas, dan pengukur. Visual ini memiliki header yang membuat tindakan tersedia untuk pengguna. Saat Anda menggunakan Power BI, Anda bisa menyembunyikan atau memperlihatkan header setiap visual dalam laporan. Setiap visual memiliki kartu di bagian Pemformatan dari panel Visualisasi yang disebut header Visual . Anda dapat menggunakan kartu tersebut untuk mengaktifkan dan menonaktifkan header visual. Pelajari selengkapnya tentang header visual di header visual .

Contoh tindakan di header visual meliputi:

  • Membuka visual dalam mode fokus.
  • Menelusuri paling detail atau lebih.
  • Menampilkan filter dan pemotong mana yang saat ini diterapkan ke visual.
  • Membuka menu opsi visual.

Terkadang berguna untuk menyembunyikan tindakan ini. Misalnya, ketika dua visual tumpang tindih, Anda mungkin tidak ingin menampilkan kedua header visual.

API ini menyediakan cara untuk menyembunyikan atau menampilkan header semua visual dalam laporan atau hanya yang tertentu. Anda dapat mengonfigurasi visibilitas pada beban laporan, atau Anda dapat memanggil metode Laporkan updateSettings untuk mengubah visibilitas setelah laporan dimuat, lihat Memperbarui pengaturan laporan pada runtime.

Anda dapat menggunakan API dalam banyak skenario, termasuk kasus penggunaan berikut:

  • Sembunyikan hanya beberapa header visual dalam laporan.
  • Gunakan logika bisnis di aplikasi, seperti klik tombol, untuk menyembunyikan atau menampilkan header setelah laporan dimuat.

Cara menyembunyikan atau menampilkan header visual

Untuk menyembunyikan atau menampilkan header visual di API, Anda mengonfigurasi parameter tertentu dalam pengaturan laporan. Lihat Mengonfigurasi pengaturan laporan untuk informasi umum tentang mengonfigurasi opsi dalam laporan yang disematkan.

Pengaturan header visual

Dengan header visual, visibilitas saat ini adalah satu-satunya pengaturan yang dapat Anda konfigurasi. Untuk menyembunyikan atau menampilkan header, Anda menyediakan daftar objek konfigurasi header visual. Masing-masing berisi objek pengaturan dan juga dapat menyertakan pemilih. Pemilih mengidentifikasi visual tempat Anda menerapkan pengaturan. Pelajari selengkapnya tentang pemilih di pemilih .

Jenis objek konfigurasi yang Anda berikan ke API adalah IVisualSettings. Nantinya dalam artikel ini, Anda akan menemukan contoh yang menunjukkan cara menggunakan antarmuka ini dalam kode Anda. model Power BI mencantumkan semua definisi antarmuka yang digunakan contoh.

Perhatikan poin-poin berikut:

  • Pemilih bersifat opsional dalam pengaturan ini. Saat Anda tidak mencantumkan pemilih apa pun, API menerapkan pengaturan Anda ke semua visual dalam laporan.
  • Saat Anda menggunakan pemilih, Anda dapat menentukan visual baik berdasarkan nama atau berdasarkan jenis. Untuk mendapatkan nama dan jenis visual di halaman tertentu, gunakan metode GetVisuals Halaman.

Aturan prioritas

API menerapkan pengaturan konfigurasi dalam urutan berikut:

  • Pengaturan yang disimpan dalam laporan.
  • Pengaturan yang Anda tentukan dalam objek konfigurasi semat, yang diterapkan API saat dimuat.
  • Pengaturan yang Anda berikan ke API updateSettings.

Jika lebih dari satu pengaturan dapat berlaku untuk visual, API menggunakan pengaturan terakhir yang berlaku. Sembunyikan semua kecuali satu contoh header visual di bagian berikutnya mengilustrasikan titik ini.

Contoh

Contoh-contoh ini menunjukkan berbagai cara menggunakan API untuk menyembunyikan atau menampilkan header visual.

Sembunyikan semua header visual

Skenario sederhana ini memberi pelanggan tampilan laporan yang bersih dengan menyembunyikan semua header visual dalam laporan:

let embedConfig = {
    ...
    settings: {
        ...
        visualSettings: {
            visualHeaders: [
                {
                    settings: {
                        visible: false
                    }
                    /* No selector is listed. The API hides the headers of all the visuals in the report. */
                }
            ]
        }
    }
};
...
let report = powerbi.embed(embedContainer, embedConfig);

Menyembunyikan header visual tertentu

Contoh ini menggunakan pemilih untuk menerapkan pengaturan visibilitas ke satu visual. Skenario ini muncul ketika Anda ingin menyembunyikan fungsionalitas yang tidak masuk akal untuk visual. Gunakan kode ini dalam hal ini:

let embedConfig = {
    ...
    settings: {
        ...
        visualSettings: {
            visualHeaders: [
                {
                    settings: {
                        visible: false
                    },
                    selector: {
                        $schema: "http://powerbi.com/product/schema#visualSelector",
                        visualName: <The name of the visual>  // You can retrieve the name by using getVisuals.
                    }
                }
            ]
        }
    }
};
...
let report = powerbi.embed(embedContainer, embedConfig);

Sembunyikan semua kecuali satu header visual

Gunakan kode ini untuk menyembunyikan semua header visual dalam laporan kecuali header visual tertentu:

let embedConfig = {
    ...
    settings: {
        ...
        visualSettings: {
            visualHeaders: [
                {
                    settings: {
                        visible: false
                    }
                    /* No selector is listed. The API hides the headers of all the visuals in the report. */
                },
                {
                    settings: {
                        visible: true
                    },
                    selector: {
                        $schema: "http://powerbi.com/product/schema#visualSelector",
                        visualName: <The name of the visual> // You can retrieve the name by using getVisuals.
                    }
                }
            ]
        }
    }
};
...
let report = powerbi.embed(embedContainer, embedConfig);

Jika Anda ingin membuat lebih dari satu header terlihat, Anda dapat memperluas kode ini. Siapkan instans tambahan IVisualHeader dengan parameter visible di settings diatur ke true. Untuk setiap visual yang harus memiliki header yang terlihat, tambahkan satu instans IVisualHeader ke daftar.

Pertimbangan dan batasan

  • Anda hanya dapat mengontrol visibilitas header visual jika laporan yang Anda sematkan berada dalam mode tampilan.
  • Anda hanya dapat menyembunyikan atau menampilkan seluruh header visual. Anda tidak dapat mengonfigurasi visibilitas item tertentu di menu header.
  • Saat Anda menggunakan pemilih untuk menentukan nama atau jenis visual, gunakan metode GetVisuals Halaman untuk mendapatkan nama visual, yang merupakan pengidentifikasi unik. Jangan konfigurasikan pemilih dengan judul visual.
  • Jika pengguna menyimpan laporan yang Anda sematkan dengan API, pengaturan visual yang Anda tentukan akan disimpan ke laporan. Anda dapat menghindari situasi ini dengan mengonfigurasi laporan dengan tingkat izin View alih-alih Edit atau Save.

Konten terkait