Parameter drop-down buku kerja

  • Artikel

Dengan menggunakan parameter dropdown, Anda dapat mengumpulkan satu atau beberapa nilai input dari set yang diketahui. Misalnya, Anda dapat menggunakan parameter dropdown untuk memilih salah satu permintaan aplikasi Anda. Parameter dropdown juga menyediakan cara yang mudah digunakan untuk mengumpulkan input arbitrer dari pengguna. Parameter dropdown secara khusus berguna dalam mengaktifkan pemfilteran dalam laporan interaktif Anda.

Cara termudah untuk menentukan parameter dropdown adalah dengan menyediakan daftar statis dalam pengaturan parameter. Cara yang lebih menarik adalah mendapatkan daftar secara dinamis melalui kueri KQL. Anda juga dapat menentukan apakah itu tunggal atau multipilih dengan menggunakan pengaturan parameter. Jika multipilih, Anda dapat menentukan seperti apa tataan hasil harus diformat, misalnya, sebagai pemisah atau kutipan.

Membuat parameter dropdown statis

  1. Mulai dengan buku kerja kosong dalam mode edit.

  2. Pilih Tambahkan parameter>Tambahkan Parameter.

  3. Di panel parameter baru yang terbuka, masukkan:

    1. Nama parameter: Environment
    2. Jenis parameter: Drop down
    3. Diperlukan: checked
    4. Izinkan banyak pilihan: unchecked
    5. Dapatkan data dari: JSON

  4. Di blok teks Input JSON, sisipkan cuplikan kode JSON ini:

    [
    { "value":"dev", "label":"Development" },
    { "value":"ppe", "label":"Pre-production" },
    { "value":"prod", "label":"Production", "selected":true }
]

  5. Pilih Perbarui.

  6. Pilih Simpan untuk membuat parameter.

  7. Parameter Lingkungan adalah daftar dropdown dengan tiga nilai.

    Screenshot that shows the creation of a static dropdown parameter.

Membuat daftar dropdown statik dengan grup item

Jika hasil kueri/JSON Anda berisi group bidang, daftar dropdown menampilkan grup nilai. Ikuti sampel sebelumnya, tetapi gunakan JSON berikut:

[
    { "value":"dev", "label":"Development", "group":"Development" },
    { "value":"dev-cloud", "label":"Development (Cloud)", "group":"Development" },
    { "value":"ppe", "label":"Pre-production", "group":"Test" },
    { "value":"ppe-test", "label":"Pre-production (Test)", "group":"Test" },
    { "value":"prod1", "label":"Prod 1", "selected":true, "group":"Production" },
    { "value":"prod2", "label":"Prod 2", "group":"Production" }
]

Screenshot that shows an example of a grouped dropdown list.

Membuat parameter dropdown dinamis

  1. Mulai dengan buku kerja kosong dalam mode edit.

  2. Pilih Tambahkan parameter>Tambahkan Parameter.

  3. Di panel parameter baru yang terbuka, masukkan:

    1. Nama parameter: RequestName
    2. Jenis parameter: Drop down
    3. Diperlukan: checked
    4. Izinkan banyak pilihan: unchecked
    5. Dapatkan data dari: Query

  4. Di blok teks Input JSON, sisipkan cuplikan kode JSON ini:

        requests
    | summarize by name
    | order by name asc

  5. Pilih Jalankan Kueri.

  6. Pilih Simpan untuk membuat parameter.

  7. Parameter RequestName adalah daftar dropdown dengan nama semua permintaan di aplikasi.

    Screenshot that shows the creation of a dynamic dropdown parameter.

Mereferensikan parameter dropdown

Anda dapat mereferensikan parameter dropdown.

Dalam KQL

  1. Pilih Tambahkan kueri untuk menambahkan kontrol kueri, lalu pilih sumber daya Application Insights.

  2. Di editor KQL, masukkan cuplikan kode ini:

        requests
    | where name == '{RequestName}'
    | summarize Requests = count() by bin(timestamp, 1h)

  3. Cuplikan kode meluas pada waktu evaluasi kueri untuk:

        requests
    | where name == 'GET Home/Index'
    | summarize Requests = count() by bin(timestamp, 1h)

  4. Jalankan kueri untuk melihat hasilnya. Secara opsional, buat sebagai bagan.

    Screenshot that shows a dropdown parameter referenced in KQL.

Nilai parameter, label, pilihan, dan grup

Kueri yang digunakan dalam parameter dropdown dinamis sebelumnya mengembalikan daftar nilai yang dirender dengan benar di daftar dropdown. Namun, bagaimana jika Anda ingin nama tampilan lain atau salah satu dari nama untuk dipilih? Parameter dropdown menggunakan nilai, label, pilihan, dan kolom grup untuk fungsionalitas ini.

Contoh berikut ini menunjukkan cara mendapatkan daftar dependensi Application Insights yang nama tampilannya ditata dengan emoji, yang pertama dipilih, dan dikelompokkan menurut nama operasi:

dependencies
| summarize by operation_Name, name
| where name !contains ('.')
| order by name asc
| serialize Rank = row_number()
| project value = name, label = strcat('🌐 ', name), selected = iff(Rank == 1, true, false), group = operation_Name

Screenshot that shows a dropdown parameter using value, label, selection, and group options.

Parameter Deskripsi Contoh
{DependencyName} Nilai yang dipilih GET fabrikamaccount
{DependencyName:label} Label yang dipilih 🌐 GET fabrikamaccount
{DependencyName:value} Nilai yang dipilih GET fabrikamaccount

Beberapa pilihan

Contoh sejauh ini secara eksplisit mengatur parameter untuk memilih hanya satu nilai di daftar dropdown. Parameter dropdown juga mendukung beberapa pilihan. Untuk mengaktifkan opsi ini, pilih kotak centang Izinkan beberapa pilihan.

Anda dapat menentukan format tataan hasil melalui Pemisah dan Kutipan dengan pengaturan. Default mengembalikan nilai sebagai koleksi dalam formulir a, b, c. Anda juga dapat membatasi jumlah pilihan.

KQL yang mereferensikan parameter perlu berubah agar berfungsi dengan format hasilnya. Cara paling umum untuk mengaktifkannya adalah melalui operator in.

dependencies
| where name in ({DependencyName})
| summarize Requests = count() by bin(timestamp, 1h), name

Contoh ini menunjukkan parameter dropdown multipilih di tempat kerja:

Screenshot that shows a multi-select dropdown parameter.

Parameter dropdown juga memungkinkan Anda menentukan nilai khusus yang juga akan muncul di menu dropdown:

  • Yang mana saja
  • Ketiganya
  • ...
  • Setiap 100
  • Batas kustom apa pun
  • Semua

Ketika item khusus ini dipilih, nilai parameter secara otomatis diatur ke jumlah item tertentu, atau semua nilai.

Casing Khusus Semua

Saat Anda memilih opsi Semua , bidang tambahan muncul, yang memungkinkan Anda menentukan bahwa nilai khusus akan digunakan untuk parameter jika opsi Semua dipilih. Nilai khusus ini berguna untuk kasus di mana "Semua" bisa menjadi sejumlah besar item dan dapat menghasilkan kueri yang sangat besar.

Screenshot of the New Parameter window in the Azure portal. The All option is selected and the All option and Select All value field are highlighted.

Dalam kasus spesifik ini, string [] digunakan alih-alih nilai. String ini dapat digunakan untuk menghasilkan array kosong dalam kueri log, seperti:

let selection = dynamic([{Selection}]);
SomeQuery 
| where array_length(selection) == 0 or SomeField in (selection)

Jika semua item dipilih, nilainya Selection adalah [], menghasilkan array kosong untuk selection variabel dalam kueri. Jika tidak ada nilai yang dipilih, nilai Selection akan menjadi string kosong, juga menghasilkan array kosong. Jika ada nilai yang dipilih, nilai tersebut diformat di dalam bagian dinamis kueri, menyebabkan array memiliki nilai tersebut. Anda kemudian dapat menguji array_length 0 agar filter tidak diterapkan atau menggunakan in operator untuk memfilter nilai dalam array.

Contoh umum lainnya menggunakan '*' sebagai nilai penanda khusus saat parameter diperlukan, lalu uji dengan:

| where "*" in ({Selection}) or SomeField in ({Selection})

Langkah berikutnya

Pelajari tentang jenis visualisasi yang bisa Anda gunakan untuk membuat laporan visual yang kaya dengan Azure Workbooks.