Form
Cascading Select
Memilih opsi bertingkat dari satu pohon opsi
Cascading Select digunakan untuk memilih opsi bertingkat, 2 sampai 4 dropdown, dari satu pohon opsi yang disusun di builder. Contohnya Kategori, lalu Barang, lalu Masalah. Pilihan tingkat bawah hanya berisi anak dari pilihan tingkat di atasnya. Untuk wilayah Indonesia, gunakan Region (Indonesia).
Mapping ke Engine
| Tipe Variable | Tipe Kolom Report | Format Value | Contoh |
|---|---|---|---|
| String | text | objek JSON, satu key per tingkat, null bila belum dipilih | {"category":"building","item":"main_building","issue":"ac"} |
Properties
- Name: Label komponen yang ditampilkan di atas dropdown. Mendukung dua bahasa (EN & ID).
- Key: Mengikat komponen ke process variable yang menyimpan nilainya saat form disubmit. Digenerate otomatis dan dapat disesuaikan.
- Levels: Daftar tingkat, minimal 2 dan maksimal 4. Setiap tingkat punya label EN dan ID. Key tingkat dibuat dari label EN dan tampil kecil di bawahnya. Urutan tingkat dapat diubah dengan tombol ↑ dan ↓. Tambah tingkat lewat + Add level.
- Options per level: Pohon opsi, menjorok per tingkat. Setiap opsi punya label EN dan ID.
- Tombol + menambah opsi anak. Tombol ini nonaktif di tingkat terakhir.
- Tombol × menghapus opsi beserta seluruh anaknya.
- Tombol di bawah pohon menambah opsi tingkat pertama, misalnya + Add Category.
- Value opsi dibuat dari label EN. Value ganda di antara opsi satu induk ditandai "Duplicate sibling values".
- Layout: Stacked (dropdown bertumpuk) atau Side by side (dropdown berdampingan, kembali bertumpuk di layar sempit).
- Disabled: Menonaktifkan komponen sehingga nilainya hanya bisa dibaca dan tidak dapat diisi.
- Hide If: Ekspresi FEEL untuk menyembunyikan komponen. Komponen disembunyikan ketika ekspresi bernilai
true, dievaluasi ulang saat nilai field lain berubah. - Validation:
- Required: Komponen wajib diisi sebelum form disubmit.
- Must reach last level: Tampil bila Required aktif, dan aktif secara default. Bila aktif, setiap tingkat yang punya opsi wajib dipilih. Bila mati, memilih tingkat pertama sudah cukup.
Perilaku saat diisi
- Dropdown tingkat bawah nonaktif sampai induknya dipilih, dengan teks seperti "Pick category first".
- Mengganti pilihan induk mengosongkan semua tingkat di bawahnya.
- Bila wajib dan belum dipilih, pesan dibentuk dari label tingkat, misalnya "Pick a category" atau "Pick an item".
- Tingkat yang tidak punya opsi di cabang terpilih tidak diwajibkan.
- Bila dua tingkat memakai key yang sama, kanvas menampilkan "Duplicate level keys".
- Dalam mode baca saja, setiap tingkat menampilkan label opsi yang dipilih.