Form
OTP / PIN
Menginput kode pendek di kotak-kotak terpisah
OTP / PIN digunakan untuk menginputkan kode pendek, 4 sampai 8 karakter, di kotak-kotak terpisah. Contohnya kode pengiriman di surat jalan, kode SMS, atau PIN. Komponen ini hanya mengumpulkan kode. Pengecekan kebenaran kode dilakukan oleh service task berikutnya, bukan oleh form.
Mapping ke Engine
| Tipe Variable | Tipe Kolom Report | Format Value | Contoh |
|---|---|---|---|
| String | text | satu teks tanpa spasi dan tanda pisah, nol di depan tetap ada, kosong "" | 048291 |
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.
- Length: Jumlah kotak, 4 sampai 8. Default 6.
- Characters: Jenis karakter yang diterima.
- Digits 0–9: hanya angka. Di ponsel muncul papan angka.
- Letters and digits: huruf dan angka. Huruf disimpan sebagai huruf besar.
- Group the boxes: No (satu baris kotak) atau In threes (482 913) (kotak dikelompokkan per tiga, dipisah tanda pisah). Tanda pisah tidak ikut tersimpan.
- Hide like a PIN: Bila aktif, kode tampil sebagai titik dengan tombol tampil/sembunyi. Kode tidak disimpan di draft.
- Tooltip: Teks bantuan singkat (maks. 255 karakter) yang muncul saat kursor diarahkan ke ikon informasi; diaktifkan lewat toggle.
- 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: Kode wajib diisi sebelum form disubmit. Kode yang baru terisi sebagian selalu ditolak, juga saat field tidak wajib.
Perilaku saat diisi
- Kode dapat diketik per kotak atau ditempel sekaligus. Spasi dan tanda pisah pada kode yang ditempel dibuang, lalu muncul keterangan seperti "Saved as 482913".
- Di bawah kotak tampil petunjuk, misalnya "6 digits · type it or paste the whole code".
- Pesan validasi:
- Name diikuti "is required" bila wajib dan kosong, misalnya "Delivery code on the delivery note is required".
- "Enter all 6 digits" (atau "Enter all 6 characters") bila kode belum lengkap.
- "Use digits only" atau "Use letters and digits only" bila ada karakter yang tidak diterima.
- Di history, nilai OTP selalu tampil tersamar seperti password, dengan tombol tampil/sembunyi.