QR Code Display

QR Code Display digunakan untuk menampilkan kode QR di dalam form, misalnya label aset yang nanti dipindai dengan Barcode / QR scan. Isi kodenya bisa berupa teks tetap, nilai process variable dari langkah sebelumnya, atau templat tautan. Kode dibuat di browser setiap kali task dibuka. Komponen ini ada di grup Display pada palette.

Mapping ke Engine

Komponen ini tidak menyimpan process variable. Saat form disubmit, payload tidak berisi key kode QR. Spec form hanya menyimpan sumber isi dan pengaturan tampilannya, bukan kodenya.

Properties

• Name: Judul di atas kode, dalam dua bahasa (EN dan ID). Default "Asset label".
• Key: Identitas komponen di dalam form. Default asset_label_qr. Key ini bukan process variable. Key yang berisi spasi atau sudah dipakai field lain membuat Save Changes nonaktif.
• Source: Asal isi kode, pilih salah satu.
  • Fixed text: Teks atau tautan yang diketik di Text or link. Baris baru ikut disimpan. Bila kosong, muncul "Enter the text or link to encode".
  • Process variable: Nilai variabel yang diisi form di langkah lain, misalnya asset_tag. Daftar pilihan menampilkan key dan nama langkah pengisinya, misalnya "asset_tag — Mulai". Bila belum dipilih, muncul "Pick a process variable".
  • Template: Teks dengan placeholder {variable}, misalnya https://aset.javan.id/a/{asset_tag}. Tombol Insert menyisipkan variabel. Bila templat diawali http:// atau https://, nilai variabel di-URL-encode.
• Galat Template yang membuat Save Changes nonaktif:
  • Enter a template, e.g. https://aset.javan.id/a/{asset_tag}: templat kosong.
  • "Add at least one {variable}, or use Fixed text": templat tanpa placeholder.
  • "Write placeholders as {variable_key}: a key in braces, without spaces": kurung kurawal tidak lengkap atau key berisi spasi.
• Placeholder yang tidak diisi form mana pun memunculkan peringatan "No form in this process sets {asset_no}. Check the key, or make sure another step sets it." Peringatan ini tidak membuat Save Changes nonaktif, karena variabel juga bisa datang dari API atau script.
• Di bawah teks atau templat tampil ukuran kodenya, misalnya "14 bytes → version 2, 25 × 25 modules".
• Size: Lebar kode beserta margin putihnya, S · 128 px, M · 192 px, atau L · 256 px. Default M. Kode tidak pernah lebih lebar dari form.
• Error correction: Seberapa besar bagian kode yang boleh rusak dan tetap terbaca, L · 7%, M · 15%, Q · 25%, atau H · 30%. Default M. Pakai Q atau H untuk label cetak yang mudah tergores. Level lebih tinggi membuat kode lebih padat.
  • Isi maksimal per level: L 2953 byte, M 2331 byte, Q 1663 byte, H 1273 byte. Isi yang lebih panjang ditolak, misalnya "Too long for a QR code: 2400 bytes, level M holds at most 2331".
  • Untuk Fixed text dan Template, editor menampilkan jumlah px per modul. Di bawah 3 px per modul muncul peringatan "Too dense to scan reliably: pick a larger size, a lower level or shorter content."
• Show the text under the code: Menampilkan isi kode di bawahnya, untuk orang yang tidak bisa memindai.
• Allow download: Menampilkan tombol Download PNG.
• Caption: Keterangan opsional dalam dua bahasa, tampil di bawah kode.
• Disabled: Kode tampil redup dan tombol unduh nonaktif.
• Hide If (tab Logic): Ekspresi FEEL untuk menyembunyikan komponen. Komponen disembunyikan ketika ekspresi bernilai true, dievaluasi ulang saat nilai field lain berubah.
• Validation: Tidak ada aturan validasi. Tab Validation hanya berisi catatan "Display only — nothing to validate."

Perilaku saat diisi

• Di App, kode dibuat dari nilai variabel saat task dibuka, lengkap dengan teks di bawahnya, caption, dan tombol Download PNG.
• Kode selalu hitam di atas putih dengan margin putih 4 modul, juga di tema gelap.
• Bila variabelnya masih kosong, tampil "Not available yet" dan "asset_tag has no value yet.". Tombol unduh nonaktif. Templat dengan variabel kosong juga tidak dibuatkan kode, jadi tidak ada kode dari templat setengah terisi.
• Bila nilai variabel terlalu panjang untuk level yang dipilih, tampil "Can’t draw the code" beserta batas byte-nya.
• Download PNG mengunduh gambar sekitar 1024 px, misalnya 1044 × 1044 px, yang tetap tajam saat dicetak. Nama berkasnya adalah isi kode bila isinya kode pendek seperti AST-2026-00418.png, dan Key untuk isi lain, misalnya asset_label_qr.png. Setelah berhasil tampil "Downloaded AST-2026-00418.png".
• Di Studio, kanvas menampilkan contoh kode: Fixed text apa adanya, Template seperti yang ditulis, dan Process variable sebagai {asset_tag}. Di bawahnya tampil sumber, level, dan ukuran, misalnya "{asset_tag} · Level M · 192 px".
• Panel Preview di Studio tidak punya nilai variabel, sehingga kode dari Process variable atau Template selalu tampil "Not available yet".