Ranking

Ranking digunakan untuk meminta pengguna mengurutkan opsi sesuai prioritas, misalnya pelatihan yang paling dibutuhkan. Pengguna bisa mengurutkan semua opsi, atau hanya memilih beberapa teratas lalu mengurutkannya. Yang disimpan adalah daftar key opsi, peringkat 1 di depan. Komponen ini ada di grup Survey pada palette.

Mapping ke Engine

• Bila belum dijawab, nilai yang dikirim adalah [].
• Mode Top few only hanya menyimpan N key terpilih. Mode Every option menyimpan semua key.
• Urutan awal yang diacak (Shuffle) tidak ikut tersimpan.

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. Default training_priorities. Key yang berisi spasi atau sudah dipakai field lain membuat Save Changes nonaktif.
• Options: Daftar opsi, 2 sampai 10, ditambah lewat Add option. Tiap opsi punya nama EN dan ID. Teks kecil di bawahnya adalah key yang disimpan di daftar peringkat. Tombol hapus nonaktif saat tersisa 2 opsi. Galat yang membuat Save Changes nonaktif: "Every option needs an English name", "Every option needs a key", dan "Two options share the key …".
• What to rank:
  • Every option: pengguna mengurutkan semua opsi.
  • Top few only: pengguna memilih N opsi lalu mengurutkannya; opsi lain tidak diberi peringkat.
• How many to pick (N): Hanya untuk Top few only, dari 2 sampai jumlah opsi. Nilai di luar batas ditolak dengan "Use 6 or less (the number of options)" atau "Use 2 or more".
• Shuffle the starting order: Mengacak urutan awal setiap kali task dibuka, supaya opsi pertama tidak diuntungkan.
• Tooltip: Teks bantuan singkat yang muncul saat kursor diarahkan ke ikon informasi; diaktifkan lewat toggle.
• Disabled: Menonaktifkan komponen sehingga nilainya hanya bisa dibaca dan tidak dapat diubah.
• Hide If: Ekspresi FEEL untuk menyembunyikan komponen. Komponen disembunyikan ketika ekspresi bernilai true, dievaluasi ulang saat nilai field lain berubah.
• Validation:
  • Required: Untuk Top few only, tepat N opsi harus dipilih. Untuk Every option, pengguna harus memindah opsi atau menekan Keep this order.

Perilaku saat diisi

• Top few only: area "Your top 3" berisi slot bernomor, dan "Other options" berisi opsi lain. Klik opsi untuk menambahkannya ke slot berikutnya. Tombol × mengembalikan opsi ke "Other options".
• Every option: semua opsi tampil bernomor abu-abu. Urutan awal belum dianggap jawaban sampai pengguna memindah opsi atau menekan Keep this order.
• Baris dipindah dengan menyeret pegangan di kiri, atau dengan tombol panah naik dan turun. Di ponsel halaman tetap bisa digulir di luar pegangan.
• Keyboard: Tab ke daftar, ↑ ↓ memilih baris, Spasi mengangkat baris, ↑ ↓ memindahnya, Spasi meletakkan, Esc membatalkan. Delete mengeluarkan opsi dari top list. Setiap perpindahan dibacakan, misalnya "Leadership moved to position 2 of 6".
• Pesan validasi:
  • "Pick your top 3": Required aktif dan opsi yang dipilih kurang dari N.
  • "Put the options in order, or confirm the current order": Required aktif, mode Every option, dan daftar belum disentuh.
• Bila Disabled aktif, peringkat tampil sebagai daftar bernomor tanpa pegangan. Mode Top few only menulis opsi yang tidak masuk, misalnya "Not in the top 3: …".
• Nilai ikut tersimpan di draft, tampil lagi saat task dibuka ulang, dan History menampilkan daftar key.
• Form start publik ikut mengirim nilainya dengan format yang sama.