Lewati ke konten

Barcode Scanner Emulator

Awalan dan akhiran pada pemindai kode batang: panduan lengkap

Awalan adalah data atau urutan kendali yang dikirim pemindai kode batang sebelum kode batang yang sudah didekode. Akhiran adalah apa yang dikirim setelah nilai itu. Model yang sama bisa diatur ke awalan dan akhiran yang berbeda, dan pemindai serial tidak mengantarkannya dengan cara yang sama seperti pemindai keyboard wedge.

Awalan pemindai kode batang dikirim sebelum nilai yang sudah didekode. Akhiran dikirim sesudah nilai itu. Satu pemindai bisa menghasilkan urutan berikut:

Awalan: STX

Kode batang: 123456789

Akhiran: ENTER

STX di buku panduan biasanya berarti karakter kendali, bukan tiga huruf S, T, dan X. ENTER pada pemindai keyboard wedge biasanya tombol Enter, bukan dua karakter CR dan LF yang disisipkan ke bidang teks. Mana yang Anda terima bergantung pada model, antarmuka, dan aplikasi. Tidak ada pengaturan yang berlaku untuk semua kasus.

Panduan Akhiran ENTER vs TAB pada pemindai kode batang tetap pada memilih dan menelusuri dua penutup itu. Panduan ini membahas bingkai di sekeliling kode batang: apa yang datang lebih dulu, apa yang datang kemudian, dan bagaimana aplikasi web sebaiknya membaca keduanya.

Apa itu awalan pemindai kode batang?

Awalan adalah urutan yang sudah diatur, yang dipancarkan pemindai sebelum muatan. Muatan adalah teks yang didekode simbologi, misalnya 123456789. Awalan bukan bagian dari dekode itu kecuali pemindai memang diatur untuk menambahkannya.

Pemakaian yang umum:

  • Menandai awal pesan. Protokol serial dan terminal kadang mengirim karakter kendali, sering disebut STX, supaya host tahu bingkai baru sudah mulai.
  • Menyebut simbologi. Dengan pengenal simbologi AIM diaktifkan, pemindai dapat mengirim awalan pendek yang bisa dicetak, seperti ]C1 untuk Code 128 atau ]E0 untuk EAN, sebelum digit. Aplikasi dapat bercabang berdasarkan pengenal itu.
  • Mengarahkan masukan pada perangkat lunak POS atau terminal yang lama. Kode tetap di depan data memberitahu host bidang atau perangkat mana yang memiliki pemindaian itu.
  • Menandai stasiun tertentu. Dua pemindai dapat diberi awalan tercetak yang berbeda supaya log menunjukkan jalur mana yang mengirim kode.

Awalan yang bisa dicetak adalah karakter biasa. Karakter itu muncul di depan string dalam bidang teks. Awalan berupa karakter kendali, seperti STX (0x02), bukan huruf S, T, dan X. Pemindai keyboard wedge mungkin sama sekali tidak bisa mengetik karakter kendali itu. Pemindai serial dapat mengirimnya sebagai byte. Baca buku panduan model yang Anda punya sebelum menulis kode yang mengharapkan salah satu dari keduanya.

Awalan tidak membuktikan bahwa pemindai yang menghasilkan masukan. Orang, makro, atau Barcode Scanner Emulator dapat mengetik karakter yang sama. Perlakukan awalan sebagai bingkai yang Anda atur, lalu validasi muatan seperti masukan pengguna yang lain.

Apa itu akhiran pemindai kode batang?

Akhiran adalah urutan yang diatur untuk dikirim setelah muatan. Tugas biasanya adalah memberitahu aplikasi bahwa pemindaian sudah selesai, atau memindahkan fokus. Pemindai berbeda-beda. Ada yang menawarkan Enter, Tab, CR, LF, CR+LF, string kustom, atau tidak sama sekali. Ada yang hanya menawarkan satu atau dua di antaranya.

ENTER. Tombol Enter. Di peramban ini adalah peristiwa papan ketik, event.key === "Enter". Tombol itu tidak disisipkan ke masukan teks biasa.

TAB. Tombol Tab, event.key === "Tab". Peramban memindahkan fokus ke kontrol berikutnya. Tombol tidak masuk ke bidang.

CR. Carriage return, ASCII 0x0D. Pada antarmuka serial atau terminal, ini bisa menjadi byte sungguhan setelah muatan. Pada keyboard wedge, pengaturan berlabel CR atau carriage return biasanya berarti tombol Enter. Peramban tetap melaporkan Enter. Nilai bidang tidak mendapat karakter CR.

LF. Line feed, ASCII 0x0A. Ini karakter kendali yang berbeda dari CR. Pada aliran serial, LF bisa menjadi byte tersendiri. Keyboard wedge tidak punya tombol Line Feed standar seperti halnya Enter dan Tab. Jangan menganggap item menu bernama LF mengetik karakter yang terlihat, atau Enter kedua.

CRLF. CR diikuti LF, dua byte 0x0D 0x0A. Sebagian host serial dan terminal mengharapkan pasangan itu sebagai akhir baris. Bidang teks peramban tidak menyimpan pasangan itu ketika seseorang menekan Enter.

Karakter kustom. Akhiran tercetak seperti # atau kode pendek diketik setelah kode batang, jadi menjadi bagian string kecuali aplikasi menghapusnya. Karakter kendali kustom mengikuti pemisahan yang sama dengan STX: byte di port serial, ketukan tombol di wedge, dan hanya ketukan yang benar-benar dapat dikirim antarmuka papan ketik.

ENTER, CR, dan LF adalah nama yang berdekatan untuk akhir baris di buku panduan. Keduanya tidak saling menggantikan di setiap aplikasi. Pemindai wedge, pemindai serial, Notepad, dan formulir web masing-masing dapat menunjukkan hasil berbeda untuk pengaturan bernama sama.

Awalan dan akhiran

Ciri Awalan Akhiran
Posisi Sebelum data kode batang Sesudah data kode batang
Tujuan Menandai awal atau memberi label pada masukan Menandai selesai atau memicu tindakan
Contoh STX, atau pengenal AIM tercetak seperti ]C1 ENTER, TAB, atau karakter tercetak seperti #
Pemakaian umum Membingkai atau mengenali pemindaian Mengirim formulir atau memindahkan fokus
Di bidang teks Karakter tercetak berada di awal nilai Karakter tercetak berada di akhir. Enter dan Tab tidak
Sifat Penanda yang diatur, siapa pun bisa mengetiknya Penanda yang diatur, siapa pun bisa mengetiknya

Lepas awalan atau akhiran kustom hanya ketika Anda mengatur urutan yang persis itu dan rekaman yang disimpan tidak boleh memuatnya. Biarkan pengenal AIM tetap ada sampai aplikasi punya aturan untuknya.

ENTER, TAB, CR, dan LF

Nama-nama ini muncul di lembar konfigurasi. Sisi penerima melihat ketukan tombol atau byte, tergantung antarmuka. Panduan HID keyboard wedge menjelaskan jalur ketukan tombol. Port serial adalah jalur lain: aplikasi membaca byte, dan fokus tidak memilih ke mana byte itu pergi.

ENTER

Pada pemindai keyboard wedge, ENTER adalah tombol Enter. Di dalam bidang teks satu baris, peramban saat ini memakai tombol itu untuk mengirim formulir yang melingkupinya. Kotak pencarian dapat mengunci pemindaian pada peristiwa itu. Formulir banyak bidang dapat terkirim sebelum bidang berikutnya terisi. Panggil preventDefault() pada peristiwa submit, atau pada keydown Enter, ketika halaman harus menyimpan nilai dan tetap di tempat. Tangani Enter di satu tempat. Pendengar keydown dan pendengar submit yang sama-sama menerima pemindaian akan mencatatnya dua kali.

Sebagian pemindai mengirim NumPad Enter. event.key tetap "Enter". event.code bisa "NumpadEnter", bukan "Enter". Uji event.key jika kedua tombol harus mengunci bidang.

Panduan Akhiran ENTER vs TAB pada pemindai kode batang membandingkan dua pilihan itu untuk POS dan formulir web. Pemindai kode batang tidak mengirim ENTER membahas pemindai yang mengetik kode batang lalu berhenti.

TAB

TAB adalah tombol Tab. Peramban memindahkan fokus setelah keydown. Baca bidang di penangan keydown itu, selagi bidang masih fokus, dan biarkan tindakan bawaan jika kontrol berikutnya harus menerima kursor. preventDefault() menahan fokus di bidang saat ini.

Shift+Tab adalah tombol yang sama dengan Shift ditekan. Akhiran Tab pemindai adalah Tab tanpa Shift. Abaikan event.shiftKey jika pengguna papan ketik harus bisa bergerak mundur di formulir.

CR

Carriage return memindahkan kursor ke awal baris di terminal. Byte-nya 0x0D. Pemindai serial dapat menambahkan byte itu ke muatan. Pengaturan keyboard wedge bernama CR biasanya mengirim tombol Enter, bukan menyisipkan 0x0D ke teks. Menekan Enter di masukan peramban tidak menulis karakter CR ke input.value.

Jika host adalah terminal atau pendengar port COM, cari byte itu. Jika host adalah halaman web, cari event.key === "Enter".

LF

Line feed menurunkan kursor terminal satu baris. Byte-nya 0x0A. Sebagian host memperlakukan LF sendiri sebagai baris baru. Yang lain mengabaikannya kecuali CR datang lebih dulu. Pemindai wedge yang mencantumkan LF sebagai akhiran mungkin mengirim tombol yang tidak diubah sistem operasi menjadi pemisah baris, atau mengirim sesuatu yang tidak akan disimpan bidang teks. Tangkap tombol di penguji peristiwa papan ketik sebelum Anda menangani LF yang dikira demikian di kode aplikasi.

CRLF

CRLF adalah urutan dua kendali, CR lalu LF. Berkas teks gaya Windows dan banyak perangkat serial memakainya sebagai satu baris baru. Halaman konfigurasi yang menulis akhiran CRLF berarti pemindai akan mencoba mengirim pasangan itu setelah muatan, pada antarmuka yang sedang dipakai.

Di peramban, menekan Enter tidak menghasilkan urutan CRLF harfiah di dalam masukan teks. Formulir menerima peristiwa papan ketik. <textarea> dapat menyisipkan baris baru ketika pengguna menekan Enter, dan baris baru itu adalah perilaku penyuntingan peramban sendiri, bukan bukti bahwa pemindai memancarkan byte 0x0D 0x0A. Pembaca serial dapat menerima dua byte itu dan hanya boleh memperlakukannya sebagai penutup jika pemindai itu diatur untuk mengirimnya. Jangan melepas CR atau LF dari tengah muatan yang memang boleh memuatnya.

Bagaimana awalan dan akhiran memengaruhi aplikasi web

Pemindaian keyboard wedge adalah rentetan ketukan tombol ke kontrol yang sedang fokus. Halaman tidak membuka pemindai. Jika fokus ada di bidang lain, awalan, kode batang, dan akhiran semuanya masuk ke sana.

keydown menyala untuk setiap tombol, termasuk Enter dan Tab, sebelum peramban menyisipkan karakter atau memindahkan fokus. event.key adalah karakter atau nama tombol setelah sistem operasi menerapkan tata letak papan ketik. Karakter awalan dan akhiran yang bisa dicetak muncul di bidang lewat peristiwa input. Enter dan Tab tidak.

Pendengar di bawah mengunci bidang ketika Enter tiba. Pendengar itu tidak menambahkan akhiran yang dilewati pemindai. Jika pemindai tidak mengirim Enter, nilai tetap di bidang sampai sesuatu yang lain membacanya.

const field = document.querySelector('#barcode')

if (!(field instanceof HTMLInputElement)) {
  throw new Error('Barcode field was not found.')
}

field.addEventListener('keydown', (event) => {
  if (event.key !== 'Enter') {
    return
  }

  event.preventDefault()
  const value = field.value.trim()
  if (!value) {
    return
  }

  console.log(value)
  field.value = ''
})

Fokuskan #barcode sebelum pemindaian. preventDefault() menghentikan formulir leluhur agar tidak mengirim untuk kedua kalinya. Jika masukan tidak berada di dalam formulir dan Anda ingin pengiriman bawaan peramban, hilangkan preventDefault().

Tanpa akhiran, tunggu tindakan yang jelas: tombol, Enter kemudian dari operator, atau langkah berikutnya dalam alur kerja. Pewaktu ketidakaktifan dapat memperlakukan jeda sebagai akhir pemindaian. Pewaktu itu adalah perkiraan. Pemindai yang lambat, tunda Bluetooth, atau pengetik yang cepat dapat jatuh di sisi yang salah. Utamakan akhiran yang sudah diatur ketika alur kerja butuh akhir yang pasti.

Awalan tercetak yang sudah diketahui dapat dihapus setelah Anda membaca nilai:

function withoutConfiguredPrefix(value, prefix) {
  if (prefix && value.startsWith(prefix)) {
    return value.slice(prefix.length)
  }
  return value
}

Oper hanya awalan yang Anda atur, misalnya ']C1'. Jangan memotong sejumlah karakter sembarang dari setiap pemindaian.

Untuk formulir lengkap yang juga menangani Tab, masukan kosong, dan pemindaian kedua, lihat Cara menguji pemindai kode batang di aplikasi web.

Cara mengatur awalan dan akhiran

Pengaturan awalan dan akhiran ada di pemindai. Nama tombol dan cara mengubahnya khas tiap produsen. Tidak ada kode batang konfigurasi yang bekerja di setiap merek, dan panduan ini tidak mencetaknya.

Cara yang biasa:

  • Pindai kode batang konfigurasi dari buku panduan model yang persis itu. Lembar dikelompokkan menurut pengaturan: akhiran, awalan, tata letak papan ketik, simbologi.
  • Pakai program konfigurasi vendor, lalu tulis hasilnya ke pemindai lewat USB.
  • Pakai utilitas pengelolaan perangkat untuk lini produk itu ketika Anda memperbarui banyak unit.

Setelah perubahan, pindai kode batang yang nilainya sudah diketahui dan bandingkan hasil dengan uraian buku panduan tentang pengaturan yang Anda pilih. Pengaturan ulang pabrik dari merek lain dapat membiarkan pemindai tidak berubah, atau memasukkannya ke mode yang tidak terduga. Panduan Panduan konfigurasi pemindai kode batang merangkum pengaturan yang biasanya penting. Panduan itu tidak menggantikan buku panduan.

Barcode Scanner Emulator dapat mengetik nilai yang Anda pilih lalu mengirim ENTER, TAB, atau tanpa akhiran. Masukkan awalan tercetak ke nilai itu ketika Anda perlu melatih penanganan awalan tanpa perangkat keras. Emulator tidak memancarkan pasangan byte CR/LF serial, dan tidak membaca label.

Cara menguji perilaku awalan dan akhiran

Pakai pemindai yang berada dalam mode papan ketik, USB HID keyboard atau Bluetooth HID keyboard.

  1. Hubungkan dan tunggu sampai pemindai menunjukkan bahwa dayanya menyala.
  2. Buka penguji masukan kode batang.
  3. Klik Mulai pengujian, atau klik area pindaian. Area itu menjadi biru ketika siap. Halaman tidak mengambil fokus sendiri.
  4. Pindai kode batang yang muatannya sudah Anda ketahui.
  5. Baca nilai yang tertangkap dan jumlah karakternya. Karakter awalan atau akhiran yang bisa dicetak berada di dalam string itu. Baris Awalan untuk tombol bernama yang tiba sebelum karakter pertama, misalnya pengubah. Baris itu tidak menarik awalan yang diketik seperti ]C1 keluar dari teks kode batang.
  6. Periksa akhiran. Penguji melaporkan ENTER, TAB, atau Tidak ada. Dengan Tangkapan otomatis menyala, hasil muncul setelah Enter, Tab, atau jeda singkat begitu tombol berhenti. Matikan Tangkapan otomatis untuk menahan tangkapan sampai Anda menekan Berhenti. Enter dan Tab bukan bagian dari string kode batang.
  7. Bandingkan hasil itu dengan konfigurasi yang Anda maksudkan. Lalu buka penguji peristiwa papan ketik dan pindai lagi ketika Anda perlu setiap keydown berurutan, termasuk key, code, dan waktu.

Penguji masukan merekam peristiwa papan ketik yang dapat dilihat peramban. Penguji tidak dapat membaca port serial, jadi tidak dapat menampilkan CR atau LF sebagai byte mentah. Uji wedge tidak membuktikan apa yang akan dikirim pengaturan serial.

Pemecahan masalah

Pemindai tidak mengirim ENTER. Kode batang muncul dan kursor tetap di bidang. Penguji masukan melaporkan Tidak ada. Akhiran mati, atau diatur ke sesuatu selain Enter. Lihat Pemindai kode batang tidak mengirim ENTER.

TAB memindahkan fokus di luar dugaan. Pemindai sedang mengirim tombol Tab. Itulah akhiran yang diatur. Pakai Enter ketika formulir harus terkirim, atau baca nilai pada keydown Tab ketika alur kerja harus maju. Rinciannya ada di panduan Akhiran ENTER vs TAB pada pemindai kode batang.

Formulir terkirim dua kali. Peramban mengirim pada Enter, dan pendengar keydown juga menerima pemindaian. Pertahankan satu jalur penyelesaian dan panggil preventDefault() pada jalur yang lain.

Awalan muncul di dalam kode batang. Awalan tercetak adalah bagian dari string yang tertangkap. Nonaktifkan di pemindai, atau hapus urutan yang persis itu di aplikasi. Pengenal simbologi yang aktif adalah sumber umum dari ] di depan ditambah dua karakter lagi. Awalan kendali yang tidak dapat diketik wedge akan hilang, bukan terlihat.

Karakternya salah. Tata letak pemindai dan tata letak sistem operasi dapat tidak cocok, yang mengubah karakter awalan dan tanda baca sementara panjangnya tetap. Lihat Tata letak papan ketik pemindai kode batang salah.

Aplikasi tidak pernah melihat akhir pemindaian. Tidak ada akhiran, dan halaman menunggu Enter. Tambahkan akhiran yang cocok dengan formulir, atau selesaikan nilai pada tindakan yang jelas. Tebakan waktu akan melewatkan sebagian pemindaian sungguhan dan menerima sebagian pengetikan.

CR/LF berbeda antaraplikasi. Notepad menyisipkan baris baru ketika menerima Enter. Masukan teks web menyimpan kode batang dan menembakkan peristiwa tombol. Program serial dapat menerima 0x0D, 0x0A, atau keduanya. Bandingkan antarmuka sebelum Anda mengubah pemindai. Jika tidak ada aplikasi yang menerima karakter, mulai dari Pemindai kode batang tidak bekerja.

Tinjauan yang lebih luas atas fokus, pemindaian berulang, dan alur POS ada di Cara menguji masukan pemindai kode batang.

Matriks uji

Kolom konfigurasi adalah apa yang Anda atur di pemindai, atau apa yang Anda ketik dengan emulator ketika kasusnya adalah akhiran papan ketik. Perilaku yang diharapkan adalah apa yang harus dilakukan aplikasi. Kasus CRLF serial bukan uji yang sama dengan tombol Enter di peramban.

Konfigurasi Perilaku aplikasi yang diharapkan
Tanpa awalan, tanpa akhiran Nilai kode batang diterima dan tidak ada tombol penyelesaian yang tiba. Nilai tetap tersedia sampai aplikasi membacanya.
Tanpa awalan, akhiran ENTER Aplikasi menerima tombol penyelesaian sekali dan menyimpan muatan tanpa karakter penutup.
Tanpa awalan, akhiran TAB Fokus dapat berpindah ke kontrol berikutnya. Aplikasi membaca nilai sebelum perpindahan itu.
Awalan tercetak kustom Karakter awalan muncul sebelum data yang didekode. Aplikasi sengaja menyimpan atau menghapus awalan yang persis itu.
Akhiran tercetak kustom Karakter akhiran muncul setelah data yang didekode. Enter dan Tab adalah tombol, jadi tidak muncul di string.
Urutan CRLF Host serial atau terminal memproses byte CR dan LF yang diatur. Bidang teks peramban tidak memperoleh byte itu dari penekanan Enter.

Jalankan baris papan ketik pada pemindai wedge dan, ketika perangkat keras tidak ada, dengan pengaturan ENTER, TAB, dan tanpa akhiran pada emulator. Jalankan baris CRLF pada antarmuka yang seharusnya membawa byte itu. Hasil nyata tetap bergantung pada antarmuka itu dan pada aplikasi.