Integrasi visual sistem Power BI

Artikel ini menjelaskan Visual API, dan bagaimana Power BI menangani interaksi antara Anda, visual, dan host.

Tindakan dan pembaruan berikutnya di Power BI dapat dimulai secara manual atau otomatis. Jenis pembaruan:

Gambar berikut menunjukkan bagaimana memproses tindakan berbasis visual umum, seperti memilih penanda buku, di Power BI.

Diagram proses visual Power BI.

Berinteraksi dengan visual melalui Power BI

Anda bisa memperbarui visual dengan Power BI sebagai berikut:

  • Buka panel properti visual.

    Saat Anda membuka panel properti visual, Power BI mengambil objek dan properti yang didukung dari file capabilities.json visual. Untuk menerima nilai properti aktual, Power BI memanggil metode getFormattingModel dari visual (API versi lebih lama dari 5.0 memanggil enumerateObjectInstances sebagai gantinya). API mengembalikan komponen model panel dalam format modern, properti, dan nilai aktualnya.

    Untuk informasi selengkapnya, lihat Kemampuan dan properti visual Power BI.

  • Kustomisasi judul visualisasi, latar belakang, label, dan legenda.

    Saat Anda mengubah nilai properti di panel Format, Power BI memanggil update metode . Power BI meneruskan objek baru options ke update metode , dan objek berisi nilai baru.

    Untuk informasi selengkapnya, lihat Objek dan properti visual Power BI.

  • Ubah ukuran visual.

    Saat Anda mengubah ukuran visual, Power BI memanggil metode update dan mengoper objek baru options. Objek options tersebut memiliki objek viewport yang bersarang dan berisi lebar serta tinggi baru dari visual tersebut.

  • Terapkan filter di tingkat laporan, halaman, atau visual.

    Power BI memfilter data berdasarkan kondisi filter. Power BI memanggil metode update dari visual untuk memperbarui visual dengan data baru.

    Visual mendapatkan pembaruan baru dari objek options ketika ada data baru di salah satu objek bersarang. Bagaimana pembaruan terjadi tergantung konfigurasi pemetaan tampilan data visual.

    Untuk informasi selengkapnya, lihat Memahami pemetaan tampilan data di visual Power BI.

  • Pilih titik data di visual lain dalam laporan.

    Saat Anda memilih titik data di visual lain dalam laporan, Power BI memfilter atau menyoroti titik data yang dipilih dan memanggil metode visual update . Visualisasi ini mendapatkan data baru yang difilter, atau mendapatkan data yang identik dengan rangkaian sorotan.

    Untuk informasi selengkapnya, lihat Menyoroti titik data di Visual Power BI.

  • Pilih bookmark di panel Bookmark laporan.

    Saat Anda memilih bookmark di panel Bookmarks, Anda memiliki opsi sebagai berikut:

    • Power BI memanggil fungsi yang diteruskan dan didaftarkan oleh metode registerOnSelectionCallback. Fungsi panggilan balik mendapatkan array pilihan untuk bookmark yang sesuai.

    • Power BI memanggil metode update dengan objek filter yang sesuai di dalam objek options.

      Dalam kedua kasus, visual mengubah statusnya sesuai dengan pilihan atau filter objek yang diterima.

      Untuk informasi selengkapnya tentang bookmark dan filter, lihat API Visual Filter dalam visual Power BI.

Berinteraksi dengan visual secara langsung

Anda juga dapat berinteraksi langsung dengan visual untuk memperbaruinya:

  • Arahkan mouse ke atas elemen data.

    Visual dapat menampilkan informasi selengkapnya tentang titik data melalui API tooltip Power BI. Saat Anda mengarahkan mouse ke elemen visual, visual tersebut dapat menangani kejadian dan menampilkan data tentang elemen tooltip terkait. Visual dapat menampilkan tooltip standar atau tooltip halaman laporan.

    Untuk informasi selengkapnya, lihat Menambahkan tooltip ke visual Power BI Anda.

  • Ubah properti visual (misalnya, dengan memperluas pohon), dan tampilan tersebut menyimpan status baru dalam properti visualnya.

    Visual dapat menyimpan nilai properti melalui API Power BI. Misalnya, saat Anda berinteraksi dengan visual dan visual perlu menyimpan atau memperbarui nilai properti, visual dapat memanggil persistProperties metode .

  • Pilih URL.

    Secara default, visual tidak dapat membuka URL secara langsung. Untuk membuka URL di tab baru, visual tersebut dapat memanggil metode launchUrl dan meneruskan URL sebagai parameter.

    Untuk informasi selengkapnya, lihat Buat URL yang diluncurkan.

  • Terapkan filter melalui visualisasi.

    Visual dapat memanggil metode applyJsonFilter dan meneruskan kondisi untuk memfilter data di visual lain. Beberapa jenis filter tersedia, termasuk filter Dasar, Tingkat Lanjut, dan Tuple.

    Untuk informasi selengkapnya, lihat API Visual Filter dalam visual Power BI.

  • Pilih elemen di visual.

    Untuk informasi selengkapnya tentang pilihan dalam visual Power BI, lihat Menambahkan interaktivitas ke dalam visual menurut pilihan visual Power BI.

Visual berinteraksi dengan Power BI

Terkadang visual memulai komunikasi dengan host Power BI tanpa input apa pun dari Anda:

  • Visual meminta lebih banyak data dari Power BI.

    Visual memproses bagian demi bagian data. Metode fetchMoreData API meminta fragmen data berikutnya dalam model semantik.

    Untuk informasi selengkapnya, lihat Mengambil lebih banyak data dari Power BI.

  • Layanan acara dijalankan.

    Power BI dapat mengekspor laporan ke PDF atau mengirim laporan melalui email (hanya berlaku untuk visual bersertifikat). Untuk memberi tahu Power BI bahwa rendering telah selesai dan visual siap untuk diambil sebagai PDF atau email, visual harus memanggil API Rendering Events.

    Untuk informasi selengkapnya, lihat Mengekspor laporan dari Power BI ke PDF.

    Untuk mempelajari tentang layanan acara, lihat Rendering peristiwa di visual Power BI.

Konten terkait

Tertarik untuk membuat visualisasi dan menambahkannya ke Microsoft AppSource? Lihat artikel ini:

  • Last updated on