Autocomplete

Autocomplete digunakan untuk memilih satu opsi dari daftar yang panjang, misalnya nama bank. Pengguna mengetik beberapa huruf, lalu memilih dari saran yang muncul. Yang disimpan adalah value opsi, bukan labelnya. Komponen ini ada di grup Select pada palette.

Mapping ke Engine

• Bila Allow a value not in the list aktif, teks yang diketik pengguna disimpan apa adanya, misalnya BPR Arta Mas.
• Bila tidak diisi, nilai yang dikirim adalah "".

Properties

• Name: Label komponen yang ditampilkan ke pengguna. Mendukung dua bahasa (EN & ID).
• Key: Mengikat komponen ke process variable yang menyimpan nilainya saat form disubmit. Digenerate otomatis dan dapat disesuaikan.
• Placeholder: Teks petunjuk dua bahasa (EN & ID) yang tampil di dalam field selama masih kosong.
• Options: Daftar opsi, 1 sampai 500, ditambah lewat Add option. Tiap opsi punya label EN & ID. Teks kecil di bawah label EN adalah value yang disimpan. Value dibuat otomatis dari label EN, misalnya "Bank Jago" menjadi bank_jago. Value opsi yang sudah tersimpan tidak ikut berubah saat labelnya diubah. Value ganda ("Duplicate value") atau kosong ("value required") membuat Save Changes nonaktif.
• Allow a value not in the list: Bila mati, pengguna wajib memilih salah satu opsi. Bila hidup, pengguna boleh menyimpan teks yang tidak ada di daftar.
• Suggest after (characters): Jumlah huruf yang harus diketik sebelum saran muncul, 0 sampai 3. Default 1. Nilai 0 membuat saran langsung muncul saat field diklik.
• Maximum suggestions shown: Jumlah saran terbanyak yang ditampilkan, 3 sampai 20. Default 6.
• 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. Komponen ini tidak memiliki Required If.

Perilaku saat diisi

• Saran mencocokkan label EN, label ID, dan value opsi. Contoh: mengetik "bsi" memunculkan "Bank Syariah Indonesia (BSI)".
• Gunakan panah atas/bawah lalu Enter untuk memilih. Selama kosong, di bawah field tampil "Use ↑ ↓ and Enter to pick".
• Setelah memilih, di bawah field tampil "Saved as mandiri". Untuk teks di luar daftar tampil "Saved as typed: BPR Arta Mas".
• Bila Allow a value not in the list aktif, saran memuat pilihan "Use “BPR Arta Mas”" untuk menyimpan teks yang diketik.
• Tombol × mengosongkan isian.
• Pesan validasi:
  • "No option matches “xyz”": teks yang diketik tidak cocok dengan opsi mana pun.
  • "Pick a <name> from the list": teks diketik tetapi tidak dipilih dari saran, misalnya "Pick a bank from the list".
  • Dua pesan di atas hanya muncul bila Allow a value not in the list mati.
  • "<Name> is required": Required aktif dan field kosong, misalnya "Bank is required".
• Saat task dibuka ulang dan di history task, yang tampil adalah label opsi, bukan value-nya.