Duration

Duration digunakan untuk menginput lama sebuah pekerjaan dalam jam dan menit, atau dalam hari dan jam, misalnya waktu pengerjaan perbaikan. Nilainya disimpan sebagai satu angka: total menit.

Mapping ke Engine

Bila field kosong, nilai yang dikirim adalah null, bukan 0.

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. Key yang sudah dipakai field lain memunculkan "Field key (name) must be unique. This key is already used." dan Save Changes nonaktif.
• Units: Kotak isian yang ditampilkan: Hours + minutes (default), Days + hours, atau Days + hours + minutes.
• One day is: Hanya tampil bila Units memuat hari. Pilihannya 8 h · working day atau 24 h · calendar day, dipakai untuk mengubah hari menjadi menit.
• Quick picks: Tombol di bawah kotak yang mengisi durasi sekali klik, maksimal 6. Pilihan ketujuh memunculkan "Pick up to 6 quick picks". Setiap quick pick harus berada di antara Shortest duration dan Longest duration; bila tidak, muncul "Every quick pick must be within the shortest and longest duration" dan Save Changes nonaktif. Saat Units diganti ke Days + hours, quick pick yang bukan jam bulat dibuang.
• Show the total in minutes: Menampilkan total menit di samping kotak, misalnya "= 165 minutes".
• 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. Komponen ini tidak memiliki Required If.
  • Shortest duration: Durasi minimal dalam menit. Kosong berarti tanpa batas.
  • Longest duration: Durasi maksimal dalam menit, misalnya 720 untuk 12 jam. Bila lebih kecil dari Shortest duration, muncul "Longest duration is shorter than the shortest duration" dan Save Changes nonaktif.

Perilaku saat diisi

• Pengguna mengisi satu kotak per satuan, misalnya [2] h [45] m. Nilai tersimpan 165.
• Dengan Units yang memuat hari, satu hari dihitung sesuai One day is. Contoh: 1 d 2 h dengan hari 8 jam tersimpan 600.
• Di bawah kotak tampil batas yang berlaku, misalnya "Allowed: up to 12 h". Bila Units memuat hari, ditambah keterangan "1 day = 8 working hours" atau "1 day = 24 hours".
• Klik quick pick mengisi kotak, dan tombol yang cocok dengan nilai tampak aktif.
• Pesan validasi:
  • "Enter whole numbers only": kotak berisi selain angka bulat, misalnya 1.5. Isi kotak tidak diubah dan form tidak bisa disubmit.
  • "<Name> is required": Required aktif dan semua kotak kosong, misalnya "Time spent is required".
  • "Enter a duration longer than 0": durasi diisi 0, baik Required aktif maupun tidak.
  • "The duration must be at least <durasi>" dan "The duration can’t be more than <durasi>": durasi di luar Shortest duration atau Longest duration, misalnya "The duration can’t be more than 12 h".
• Nilai ikut tersimpan di draft dan tampil lagi di kotak saat task dibuka ulang.
• Bila Disabled aktif, kotak tetap tampil dengan nilainya tanpa quick pick, dan nilainya tidak ikut dikirim saat form disubmit.