Matrix

Matrix digunakan untuk menanyakan beberapa pernyataan sekaligus dengan pilihan jawaban yang sama, misalnya tingkat kepuasan terhadap beberapa layanan kantor. Pernyataan menjadi baris, pilihan jawaban menjadi kolom. Semua jawaban disimpan dalam satu process variable. Komponen ini ada di grup Survey pada palette.

Mapping ke Engine

• Semua key baris selalu ada di nilai. Baris yang belum dijawab bernilai null.
• Bila Answers per row = Several, isi tiap baris berupa array value kolom, urut sesuai urutan kolom. Contoh: {"room_cleanliness":["neutral","satisfied"],"canteen_food":[]}. Baris yang belum dijawab bernilai [].

Properties

• Name (the question): Pertanyaan yang ditampilkan ke pengguna, berupa textarea dua bahasa (EN & ID).
• Key: Mengikat komponen ke process variable yang menyimpan nilainya saat form disubmit. Default office_services. Ganti Key bila form memuat lebih dari satu Matrix.
• Rows (statements): Daftar pernyataan, 1 sampai 15 baris, ditambah lewat Add row. Tiap baris punya label EN & ID. Teks kecil di bawah label EN adalah key baris yang disimpan di data. Key dibuat otomatis dari label EN, misalnya "Parking area" menjadi parking_area. Key baris yang sudah tersimpan tidak ikut berubah saat labelnya diubah.
• Columns (answer scale): Daftar pilihan jawaban, 2 sampai 7 kolom, ditambah lewat Add column. Teks kecil di bawah label EN adalah value kolom yang disimpan di data.
• Answers per row: One (satu jawaban per baris, berupa radio) atau Several (boleh beberapa jawaban per baris, berupa checkbox).
• Hide If: Ekspresi FEEL untuk menyembunyikan komponen. Komponen disembunyikan ketika ekspresi bernilai true, dievaluasi ulang saat nilai field lain berubah.
• Validation:
  • Required: Matrix wajib dijawab sebelum form disubmit. Komponen ini tidak memiliki Required If.
  • Rows that must be answered: Hanya tampil bila Required aktif. Every row mewajibkan semua baris dijawab. At least… mewajibkan sejumlah baris minimal.
  • Minimum rows answered: Jumlah baris minimal untuk aturan At least…. Bila lebih besar dari jumlah baris, muncul "More than the number of rows" dan Save Changes nonaktif.

Key baris atau value kolom yang ganda ditandai merah ("Duplicate key", "Duplicate value"), begitu juga yang kosong ("key required", "value required"). Selama ada tanda merah, Save Changes nonaktif. Kanvas builder juga menampilkan peringatan "Duplicate keys".

Perilaku saat diisi

• Di bawah tabel tampil penghitung, misalnya "0 of 4 rows answered".
• Di layar dengan lebar di bawah 640 px, tabel berubah menjadi satu kartu per baris dengan pilihan tersusun ke bawah.
• Pesan validasi:
  • "<label baris>: pick an answer": aturan Every row dan ada baris yang belum dijawab, misalnya "Canteen food: pick an answer". Baris yang belum dijawab ditandai merah.
  • "Answer at least N rows (M answered)": aturan At least… belum terpenuhi, misalnya "Answer at least 3 rows (2 answered)".
• Saat Complete Task, server juga menolak Matrix yang tidak memenuhi aturan baris atau berisi value di luar daftar kolom.
• Jawaban ikut tersimpan di draft dan tampil lagi saat task dibuka ulang. Membuka form tanpa menjawab tidak membuat draft.
• History task menampilkan jawaban sebagai tabel: label baris dan label jawabannya.