Barcode / QR Scan

Barcode / QR Scan digunakan untuk mengisi kode dari label barcode atau QR, misalnya label aset atau nomor resi. Pengguna memindai kode dengan kamera perangkat, atau mengetik kodenya bila diizinkan. Kode disimpan sebagai teks huruf besar.

Mapping ke Engine

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.
• Accepted formats: Format kode yang dibaca kamera: QR Code, Code 128, Code 39, dan EAN-13. Pilih minimal satu. Bila tidak ada yang dipilih, muncul "Pick at least one format".
• Allow typing the code: Bila aktif (default), pengguna juga dapat mengetik kode. Biarkan aktif, karena kamera bisa gagal membaca label yang aus dan tidak semua browser mendukung kamera.
• Expected format: Pola kode yang diterima. # berarti angka, A berarti huruf, * berarti huruf atau angka. Karakter lain harus sama persis. Contoh: AST-####-#####. Kosongkan untuk menerima kode apa pun.
• Hide If: Ekspresi FEEL untuk menyembunyikan komponen. Komponen disembunyikan ketika ekspresi bernilai true, dievaluasi ulang saat nilai field lain berubah.
• Validation: Bila properti berikut diisi, form hanya dapat disubmit ketika kondisinya terpenuhi; jika tidak, muncul pesan validasi. Expected format selalu dicek, juga saat field tidak wajib.
  • Required: Komponen wajib diisi sebelum form disubmit.
  • Required If: Komponen wajib diisi hanya bila ekspresi FEEL terpenuhi (validasi bersyarat).

Perilaku saat diisi

• Kamera hanya bisa dipakai lewat HTTPS (atau localhost) dan setelah pengguna memberi izin kamera di browser.
• Klik Scan with camera untuk membuka kamera belakang, lalu arahkan ke kode. Klik Cancel scan untuk menutup kamera.
• Kode yang terbaca tampil dalam kartu, misalnya "Scanned · Code 128", dan tidak bisa diubah. Klik Scan again untuk memindai ulang.
• Kode yang diketik manual diberi keterangan "Typed by hand". Huruf kecil otomatis menjadi huruf besar.
• Bila izin kamera ditolak atau kamera tidak tersedia, muncul "Camera access is blocked". Kursor pindah ke kolom ketik.
• Kode yang tidak cocok dengan Expected format ditolak, misalnya "“AST-26-417” does not match AST-####-#####". Aturan ini berlaku untuk hasil pindai dan ketik.
• Bila wajib dan kosong, muncul "Scan or type the asset tag". Bila Allow typing the code mati, pesannya "Scan the asset tag".
• Di bawah field tampil format yang diterima, misalnya "Accepted: QR Code, Code 128 · format AST-####-#####".
• Saat pengaturan disimpan, Expected format ikut tersimpan sebagai pola di spec, sehingga server juga dapat mengecek format kode.