Hidden field

Hidden field digunakan untuk mengirim nilai bersama form tanpa menampilkannya ke pengguna, misalnya email pemohon, kode sumber pengajuan, atau tanggal hari ini. Nilainya diambil dari nilai tetap, process variable, user yang membuka task, tanggal hari ini, atau parameter URL form publik. Komponen ini ada di grup Data pada palette.

Mapping ke Engine

Tipe variable mengikuti Value type.

Properties

• Name: Nama dalam dua bahasa (EN & ID). Hanya terlihat di builder, pengguna tidak pernah melihat hidden field.
• Key: Nama process variable yang menyimpan nilainya. Key yang berisi spasi atau sudah dipakai field lain membuat Save Changes nonaktif.
• Value type: Text, Number, True / false, atau JSON. Nilai dikonversi ke tipe ini sebelum dikirim.
• Source: Asal nilai.
  • Fixed value: Nilai tetap yang diketik di Fixed value.
  • Process variable: Nilai process variable lain, diketik di Process variable atau dipilih dari saran key field di langkah lain.
  • Current user: Data user yang membuka task, atau user yang memulai proses di halaman Start Process. User attribute hanya User ID atau Email. Keduanya teks, jadi hanya bisa dipakai dengan Value type = Text.
  • Today's date: Tanggal hari ini zona Asia/Jakarta, format YYYY-MM-DD. Tanggal diambil dari jam perangkat pengguna. Hanya bisa dipakai dengan Value type = Text.
  • URL parameter: Nilai parameter URL, misalnya utm_source dari ?utm_source=newsletter. Hanya terisi di form start publik. Di App nilainya kosong.
• Take the value: Tidak tampil untuk Fixed value.
  • When the form opens: Nilai diambil saat form dibuka, lalu dipakai sampai task selesai dan ikut tersimpan di draft.
  • On Complete Task: Nilai terbaru dihitung ulang dan tidak disimpan di draft.
• Logic: Tidak ada Hide If. Hidden field memang tidak pernah tampil.
• Validation: Tidak ada aturan validasi. Nilai tidak dicek di browser karena pengguna tidak bisa memperbaikinya. Validasi di server bila nilainya penting.

Pesan berikut menonaktifkan Save Changes:

• "Enter the fixed value": Fixed value kosong.
• "Enter a number, e.g. 410 or 12.5 (a dot for decimals)": Value type Number, tetapi Fixed value bukan angka, misalnya 12,5.
• "Enter true or false": Value type True / false, tetapi Fixed value bukan true atau false.
• Not valid JSON — check the quotes and commas, e.g. {"tier": "gold"}: Fixed value bukan JSON yang valid.
• Enter a JSON object in { }, e.g. {"tier": "gold"}: Fixed value JSON yang valid, tetapi bukan objek.
• "Today's date is text — set Value type to Text": Source Today's date dengan Value type selain Text.
• "The current user's id and email are text — set Value type to Text": Source Current user dengan Value type selain Text. Hidden field lama dengan kombinasi ini mengirim null. Buka Edit Element, ganti Value type ke Text, lalu simpan.
• "Enter the process variable": Source Process variable tanpa nama variabel.
• "Enter the parameter name" atau "Use letters, numbers, _ . or -": nama parameter URL kosong atau tidak valid.

Perilaku saat diisi

• Di App tidak ada apa pun yang dirender, sehingga field ini tidak bisa difokus.
• Di kanvas Studio, hidden field tampil sebagai strip putus-putus berisi key, sumber, dan waktu ambil nilai. Preview Studio menampilkan strip "Hidden field — not shown to the user" dengan nilai yang akan terkirim.
• Pada When the form opens, nilai dari draft dipertahankan. Pada On Complete Task dan Fixed value, nilai selalu ditulis ulang.
• History task menampilkan nilai sesuai tipenya.
• Nilai dari URL parameter tidak tepercaya. Editor menampilkan peringatan "Users can change URL parameters. Never trust them for prices, approvals or access." Jangan memakai nilai ini untuk harga, persetujuan, atau hak akses.