Menggunakan parameter di Dasbor Real-Time (pratinjau)

Parameter digunakan sebagai blok penyusun untuk filter di Dasbor Real-Time. Mereka dikelola dalam cakupan dasbor, dan dapat ditambahkan ke kueri untuk memfilter data yang disajikan oleh visual yang mendasarinya. Kueri dapat menggunakan satu atau beberapa parameter.

Penting

Fitur ini dalam pratinjau.

Dokumen ini menjelaskan pembuatan dan penggunaan parameter dan filter tertaut di dasbor. Parameter dapat digunakan untuk memfilter visual dasbor baik dengan memilih nilai parameter di bilah filter atau dengan menggunakan filter silang.

Contoh kueri yang digunakan dalam artikel ini didasarkan pada tabel StormEvents dalam data sampel Analitik cuaca yang tersedia di galeri sampel.

Catatan

Manajemen parameter tersedia dalam mode Pengeditan ke editor dasbor.

Prasyarat

• Ruang kerja dengan kapasitas yang diaktifkan Microsoft Fabric
• Izin editor pada Dasbor Real-Time
• Dasbor dengan visual

Lihat daftar parameter

Untuk melihat daftar semua parameter dasbor, pilih Kelola>Parameter.

Membuat parameter

Untuk membuat parameter:

1. Pilih tombol Parameter Baru di menu atas. Panel Parameter terbuka.
2. Pilih tombol + Tambahkan di bagian atas panel kanan.
3. Isi properti yang relevan untuk parameter Anda.
4. Pilih Selesai untuk membuat parameter.

Properti

Di panel Tambahkan parameter , konfigurasikan properti berikut ini.

Bidang	Deskripsi
Label	Nama parameter yang ditampilkan di dasbor atau kartu edit.
Tipe parameter	Salah satu parameter berikut: - Pilihan tunggal: Hanya satu nilai yang dapat dipilih dalam filter sebagai input untuk parameter . - Beberapa pilihan: Satu atau beberapa nilai dapat dipilih dalam filter sebagai input untuk parameter . - Rentang waktu: Memungkinkan pembuatan parameter tambahan untuk memfilter kueri dan dasbor berdasarkan waktu. Setiap dasbor memiliki pemilih rentang waktu secara default. - Teks gratis: Tidak memiliki nilai apa pun yang diisi dalam filter. Pengguna dapat mengetik nilai atau menyalin/menempelkan nilai ke bidang teks. Filter menyimpan nilai terbaru yang digunakan.
Keterangan	Deskripsi opsional parameter.
Nama variabel	Nama parameter yang akan digunakan dalam kueri.
Jenis data	Jenis data nilai parameter.
Perlihatkan pada halaman	Pilih halaman tempat parameter ini ditampilkan. Opsi Pilih semua memperlihatkan parameter di semua halaman.
Sumber	Sumber nilai parameter: - Nilai tetap: Memperkenalkan nilai filter statis secara manual. - Kueri: Memperkenalkan nilai secara dinamis menggunakan kueri KQL.
Tambahkan nilai "Pilih semua"	Hanya berlaku untuk pilihan tunggal dan beberapa jenis parameter pilihan. Digunakan untuk mengambil data untuk semua nilai parameter. Nilai ini harus dibangun ke dalam kueri untuk menyediakan fungsionalitas. Lihat Menggunakan parameter berbasis kueri beberapa pilihan untuk contoh selengkapnya tentang membangun kueri tersebut.
Nilai default	Nilai default filter. Filter selalu dimulai dengan nilai default setelah penyajian awal dasbor.

Kelola parameter

Setelah memilih Parameter dari bilah atas, Anda dapat melihat daftar parameter yang ada. Di setiap kartu parameter, Anda dapat memilih widget pensil untuk mengedit parameter, atau memilih menu Lainnya [...] untuk Menduplikasi, Menghapus, atau memindahkan parameter.

Indikator berikut dapat dilihat dalam kartu parameter:

• Nama tampilan parameter
• Nama variabel
• Jumlah kueri tempat parameter digunakan
• Halaman tempat parameter disematkan ke

Anda dapat menyusun ulang kartu parameter dengan menyeret dan menghilangkan atau dengan menggunakan opsi Pindahkan ke > .

Menggunakan parameter dalam kueri Anda

Parameter harus digunakan dalam kueri untuk membuat filter berlaku untuk visual kueri tersebut. Setelah ditentukan, Anda dapat melihat parameter di bilah atas filter halaman > Kueri dan di intellisense kueri.

Catatan

Jika parameter tidak digunakan dalam kueri, filter tetap tidak aktif. Setelah parameter ditambahkan ke kueri, filter menjadi aktif.

Jenis parameter

Beberapa jenis parameter dasbor didukung, sebagai berikut:

• Parameter rentang waktu default
• Parameter nilai tetap pilihan tunggal
• Parameter nilai tetap beberapa pilihan
• Parameter berbasis kueri pilihan tunggal
• Parameter berbasis kueri beberapa pilihan
• Parameter teks gratis
• Parameter sumber data

Contoh berikut menjelaskan cara menggunakan parameter dalam kueri untuk berbagai jenis parameter.

Parameter rentang waktu default

Setiap dasbor memiliki parameter Rentang waktu secara default. Ini muncul di dasbor sebagai filter hanya saat digunakan dalam kueri. Gunakan kata kunci _startTime parameter dan _endTime untuk menggunakan parameter rentang waktu default dalam kueri seperti yang terlihat dalam contoh berikut:

StormEvents
| where StartTime between (_startTime.._endTime)
| summarize TotalEvents = count() by State
| top 5 by TotalEvents

Setelah disimpan, filter rentang waktu muncul di dasbor. Sekarang dapat digunakan untuk memfilter data pada kartu. Anda dapat memfilter dasbor dengan memilih dari menu drop-down: Rentang waktu (x menit/jam/hari terakhir) atau Rentang waktu kustom.

Parameter nilai tetap pilihan tunggal

Parameter nilai tetap didasarkan pada nilai yang telah ditentukan sebelumnya yang ditentukan oleh pengguna. Contoh berikut menunjukkan kepada Anda cara membuat parameter nilai tetap pilihan tunggal.

Membuat parameter nilai tetap pilihan tunggal

1. Pilih Parameter untuk membuka panel Parameter dan pilih Parameter baru.

2. Isi detailnya sebagai berikut:

   • Label: Jenis Peristiwa

   • Jenis parameter: Pilihan tunggal

   • Nama variabel: _eventType

   • Jenis data: String

   • Sematkan sebagai filter dasbor: dicentang

   • Sumber: Nilai tetap

     Dalam contoh ini, gunakan nilai berikut:

     Nilai	Nama tampilan parameter
     Angin Badai Petir	Angin badai petir
     Hujan es	Hujan es
     Banjir Bandang	Banjir bandang
     Kekeringan	Kekeringan
     Cuaca Musim Dingin	Cuaca musim dingin

   • Menambahkan Pilih semua nilai: Tidak dicentang

   • Nilai default: Thunderstorm Wind

3. Pilih Selesai untuk membuat parameter.

Parameter dapat dilihat di panel sisi Parameter , tetapi saat ini tidak digunakan dalam visual apa pun.

Menggunakan parameter nilai tetap pilihan tunggal

1. Jalankan kueri sampel menggunakan parameter Jenis Peristiwa baru dengan menggunakan _eventType nama variabel:

   StormEvents
   | where StartTime between (_startTime.._endTime)
   | where EventType == _eventType
   | summarize TotalEvents = count() by State
   | top 5 by TotalEvents
   

   Parameter baru muncul di daftar parameter di bagian atas dasbor.

2. Pilih nilai yang berbeda untuk memperbarui visual.

   

Parameter nilai tetap beberapa pilihan

Parameter nilai tetap didasarkan pada nilai yang telah ditentukan sebelumnya yang ditentukan oleh pengguna. Contoh berikut menunjukkan kepada Anda cara membuat dan menggunakan parameter nilai tetap beberapa pilihan.

Membuat parameter nilai tetap beberapa pilihan

1. Pilih Parameter untuk membuka panel Parameter dan pilih Parameter baru.

2. Isi detail seperti yang disebutkan dalam Menggunakan parameter nilai tetap pilihan tunggal dengan perubahan berikut:

   • Label: Jenis Peristiwa
   • Jenis parameter: Beberapa pilihan
   • Nama variabel: _eventType

3. Pilih Selesai untuk membuat parameter.

Parameter baru dapat dilihat di panel sisi Parameter , tetapi saat ini tidak digunakan dalam visual apa pun.

Menggunakan parameter nilai tetap beberapa pilihan

1. Jalankan kueri sampel menggunakan parameter Jenis Peristiwa baru dengan menggunakan _eventType variabel .

   StormEvents
   | where StartTime between (_startTime.._endTime)
   | where EventType in (_eventType) or isempty(_eventType)
   | summarize TotalEvents = count() by State
   | top 5 by TotalEvents
   

   Parameter baru muncul di daftar parameter di bagian atas dasbor.

2. Pilih satu atau beberapa nilai berbeda untuk memperbarui visual.

   

Parameter berbasis kueri pilihan tunggal

Nilai parameter berbasis kueri diambil selama pemuatan dasbor dengan menjalankan kueri parameter. Contoh berikut menunjukkan kepada Anda cara membuat dan menggunakan parameter berbasis kueri pilihan tunggal.

Membuat parameter berbasis kueri pilihan tunggal

1. Pilih Parameter untuk membuka panel Parameter dan pilih Parameter baru.

2. Isi detail seperti yang disebutkan dalam Menggunakan parameter nilai tetap pilihan tunggal dengan perubahan berikut:

   • Label: Status

   • Nama variabel: _state

   • Sumber: Kueri

   • Sumber data: StormEventsSample

   • Pilih Edit kueri dan masukkan kueri berikut. Pilih Selesai.

     StormEvents
     | where StartTime between (_startTime.._endTime)
     | where EventType in (_eventType) or isempty(_eventType)
     | summarize TotalEvents = count() by State
     | top 5 by TotalEvents
     | project State
     

   • Nilai: Status

   • Nama tampilan: Status

   • Nilai default: Pilih nilai default

3. Pilih Selesai untuk membuat parameter.

Menggunakan parameter berbasis kueri pilihan tunggal

1. Contoh kueri berikut dengan parameter Status baru menggunakan _state variabel :

   StormEvents
   | where StartTime between (_startTime.._endTime)
   | where EventType in (_eventType) or isempty(_eventType)
   | where State == _state
   | summarize TotalEvents = count() by State
   | top 5 by TotalEvents
   

   Parameter baru muncul di daftar parameter di bagian atas dasbor.

2. Pilih nilai yang berbeda untuk memperbarui visual.

Parameter berbasis kueri beberapa pilihan

Nilai parameter berbasis kueri diturunkan pada waktu pemuatan dasbor dengan menjalankan kueri yang ditentukan pengguna. Contoh berikut menunjukkan cara membuat parameter berbasis kueri beberapa pilihan:

Membuat parameter berbasis kueri beberapa pilihan

1. Pilih Parameter untuk membuka panel Parameter dan pilih + Parameter baru.

2. Isi detail seperti yang disebutkan dalam Menggunakan parameter nilai tetap pilihan tunggal dengan perubahan berikut:

   • Label: Status
   • Jenis parameter: Beberapa pilihan
   • Nama variabel: _state

3. Pilih Selesai untuk membuat parameter.

Menggunakan parameter berbasis kueri beberapa pilihan

1. Kueri sampel berikut menggunakan parameter Status baru dengan menggunakan _state variabel .

   StormEvents
   | where StartTime between (_startTime.._endTime)
   | where EventType in (_eventType) or isempty(_eventType)
   | where State in (_state) or isempty(_state)
   | summarize TotalEvents = count() by State
   | top 5 by TotalEvents
   

   Catatan

   Sampel ini menggunakan opsi Pilih Semua dengan memeriksa nilai kosong dengan isempty() fungsi .

   Parameter baru muncul di daftar parameter di bagian atas dasbor.

2. Pilih satu atau beberapa nilai berbeda untuk memperbarui visual.

Parameter teks gratis

Parameter teks gratis tidak berisi nilai apa pun. Mereka memungkinkan Anda untuk memperkenalkan nilai Anda sendiri.

Membuat parameter teks gratis

1. Pilih Parameter untuk membuka panel Parameter dan pilih + Parameter baru.
2. Isi detailnya sebagai berikut:
   • Label: Status
   • Jenis parameter: Teks gratis
   • Nama variabel: _state
   • Jenis data: String
   • Nilai default: Tidak ada nilai default

Menggunakan parameter teks gratis

1. Jalankan kueri sampel menggunakan parameter Status baru dengan menggunakan _state nama variabel:

   StormEvents
   | where StartTime between (_startTime.._endTime)
   | where EventType in (_eventType) or isempty(_eventType)
   | where State contains _state
   | summarize TotalEvents = count() by State
   | top 5 by TotalEvents
   

Parameter sumber data

Setelah menambahkan sumber data ke dasbor, Anda dapat membuat parameter yang memilih satu atau beberapa sumber data yang tersedia. Parameter ini dapat digunakan dalam petak peta dan parameter lainnya.

Membuat parameter sumber data

1. Pilih Parameter untuk membuka panel Parameter dan pilih + Parameter baru.

2. Isi detailnya sebagai berikut:

   • Label: Sumber
   • Jenis parameter: Sumber data
   • Perlihatkan pada halaman: Pilih semua
   • Nilai: Pilih semua
   • Nilai default: StormEvents

   

3. Pilih Selesai.

Parameter baru sekarang terlihat dalam daftar parameter di bagian atas dasbor.

Menggunakan parameter sumber data

1. Navigasikan ke kueri petak peta baru atau yang sudah ada.

2. Di Sumber, pilih nama parameter baru Anda di parameter Sumber data, seperti parameter Sumber baru.

   

3. Pilih Terapkan perubahan.

4. Gunakan parameter Sumber untuk mengubah sumber data untuk kueri tersambung ini.

Parameter filter silang

Filter silang adalah fitur di dasbor yang memungkinkan Anda memilih nilai dalam satu visual dan memfilter data di visual lain di dasbor yang sama. Menggunakan filter silang mencapai hasil yang sama dengan memilih nilai yang setara untuk parameter dalam daftar parameter di bagian atas dasbor.

Menentukan filter silang

Untuk membuat filter silang, Anda harus mengaktifkan opsi di visual, lalu menentukan parameter yang digunakan untuk memfilter data.

1. Navigasikan ke kueri petak di mana Anda ingin menambahkan filter silang.

2. Pilih Visual.

3. Di panel kanan, pilih Interaksi, lalu aktifkan filter silang.

4. Secara opsional, tentukan jenis Interaksi . Defaultnya adalah Titik tempat Anda dapat memilih nilai dalam visual. Untuk memilih rentang nilai, seperti dalam bagan waktu, pilih Seret.

5. Tentukan kolom yang digunakan untuk memberikan nilai, dan parameter yang digunakan untuk memfilter kueri visual.

   Penting

   Kolom dan parameter harus memiliki jenis data yang sama.

Berinteraksi dengan data Anda menggunakan filter silang

Setelah filter silang ditentukan, Anda dapat menggunakannya untuk berinteraksi dengan data Anda. Dalam visual tempat Anda menentukan filter silang, Anda dapat memilih titik data dan menggunakan nilainya untuk memfilter halaman dasbor saat ini. Untuk visual tabel, pilih titik data dengan mengklik kanan pada sel yang relevan lalu di menu konteks, pilih Filter silang.

Anda dapat mengatur ulang filter silang dengan memilih Reset di bagian atas visual tempat filter dipilih.

Menggunakan penelusuran sebagai parameter dasbor

Penelusuran memungkinkan Anda memilih nilai dalam visual dan menggunakannya untuk memfilter visual di halaman target dalam dasbor yang sama. Saat halaman target terbuka, nilai telah dipilih sebelumnya dalam filter yang relevan. Visual di halaman, seperti bagan garis atau sebar, difilter untuk hanya menampilkan data terkait. Fitur ini berguna untuk membuat dasbor dengan penelusuran dari halaman ringkasan ke halaman detail. Untuk informasi tentang membuat halaman, lihat Menambahkan halaman.

Menentukan penelusuran

Untuk membuat penelusuran, Anda harus mengaktifkan opsi di visual, lalu menentukan satu atau beberapa parameter penelusuran yang digunakan untuk memfilter data.

1. Di halaman utama Anda, masukkan mode Pengeditan .

2. Edit visual tempat Anda ingin menambahkan penelusuran. Pastikan tab Visual dipilih.

   

3. Di panel kanan, pilih Interaksi, lalu aktifkan penelusuran.

   

4. Di bawah Penelusuran, pilih Buat baru, dan tentukan informasi berikut. Secara opsional pilih Tambahkan pasangan lain untuk menambahkan beberapa parameter untuk halaman target. Ulangi langkah ini untuk menambahkan penelusuran ke halaman lain di dasbor saat ini menggunakan parameter yang berbeda.

   Bidang	Deskripsi
   Halaman tujuan	Satu atau beberapa halaman target yang akan dilalui untuk menggunakan parameter yang ditentukan.
   Kolom	Kolom hasil kueri yang akan digunakan sebagai nilai untuk parameter di halaman target.
   Parameter	Parameter yang digunakan untuk memfilter visual di halaman target menggunakan nilai kolom.
   Catatan	Deskripsi singkat opsional.

   Penting

   Pasangan kolom dan parameter harus berjenis data yang sama.

   

Berinteraksi dengan data Anda menggunakan penelusuran

Setelah penelusuran ditentukan, Anda dapat menggunakannya untuk berinteraksi dengan data Anda. Untuk melakukannya, dalam visual atau tabel tempat Anda menentukan penelusuran, klik kanan pada titik data, lalu pilih Telusuri paling detail ke>halaman tujuan. Nilai dari titik data digunakan sebagai parameter untuk memfilter visual pada halaman target.

Menggunakan pencarian filter untuk filter pilihan tunggal dan beberapa

Dalam filter pilihan tunggal dan beberapa, ketik nilai yang Anda inginkan. Filter diperbarui untuk hanya menampilkan nilai yang cocok dengan istilah pencarian.

Konten terkait

• Memvisualisasikan data dengan Dasbor Real-Time
• Menyesuaikan visual Dasbor Real Time