Langkau ke kandungan

Barcode Scanner Emulator

Awalan dan Akhiran pada Pengimbas Kod Bar: Panduan Lengkap

Awalan ialah data atau jujukan kawalan yang dihantar pengimbas kod bar sebelum kod bar yang telah dinyahkod. Akhiran ialah apa yang dihantar selepas nilai itu. Model yang sama boleh ditetapkan kepada awalan dan akhiran yang berbeza, dan pengimbas siri tidak menyampaikan keduanya dengan cara yang sama seperti pengimbas baji papan kekunci.

Pengimbas kod bar menghantar awalan sebelum nilai yang telah dinyahkod, dan menghantar akhiran selepas nilai itu. Sesebuah pengimbas boleh menghasilkan turutan begini:

Awalan: STX

Kod bar: 123456789

Akhiran: ENTER

Dalam manual, STX lazimnya merujuk aksara kawalan, bukan tiga huruf S, T dan X. Pada pengimbas baji papan kekunci, ENTER biasanya kekunci Enter, bukan dua aksara CR dan LF yang diselitkan ke dalam medan teks. Apa yang anda terima bergantung pada model, antara muka dan aplikasi. Tiada satu tetapan yang sesuai untuk semua keadaan.

Panduan Akhiran ENTER dan TAB pada Pengimbas Kod Bar kekal pada memilih dan menjejak dua penamat itu. Panduan ini pula tentang bingkai di keliling kod bar: apa yang datang dahulu, apa yang datang kemudian, dan bagaimana aplikasi web patut membaca kedua-duanya.

Apakah awalan pengimbas kod bar?

Awalan ialah jujukan yang telah ditetapkan, yang dihantar pengimbas sebelum muatan. Muatan ialah teks yang dinyahkod oleh simbologi, contohnya 123456789. Awalan bukan sebahagian daripada nyahkod itu melainkan pengimbas memang ditetapkan untuk menambahnya.

Kegunaan yang biasa:

  • Menandakan permulaan mesej. Protokol siri dan terminal kadang-kadang menghantar aksara kawalan, sering dipanggil STX, supaya hos tahu bingkai baharu telah bermula.
  • Menamakan simbologi. Apabila pengecam simbologi AIM dihidupkan, pengimbas boleh menghantar awalan pendek yang boleh dicetak, seperti ]C1 untuk Code 128 atau ]E0 untuk EAN, sebelum digit. Aplikasi boleh bercabang berdasarkan pengecam itu.
  • Menghala input dalam perisian POS atau terminal yang lama. Kod tetap di hadapan data memberitahu hos medan atau peranti mana yang memiliki imbasan itu.
  • Menanda stesen tertentu. Dua pengimbas boleh diberi awalan boleh cetak yang berbeza supaya log menunjukkan lorong mana yang menghantar kod.

Awalan yang boleh dicetak ialah aksara biasa. Aksara itu muncul di hadapan rentetan dalam medan teks. Awalan aksara kawalan, seperti STX (0x02), bukan huruf S, T dan X. Pengimbas baji papan kekunci mungkin langsung tidak dapat menaip aksara kawalan itu. Pengimbas siri boleh menghantarnya sebagai bait. Baca manual model yang anda ada sebelum menulis kod yang menjangkakan salah satu daripadanya.

Awalan tidak membuktikan bahawa pengimbas yang menghasilkan input. Seseorang, makro, atau Barcode Scanner Emulator boleh menaip aksara yang sama. Anggap awalan sebagai bingkai yang anda tetapkan, kemudian sahkan muatan seperti input pengguna yang lain.

Apakah akhiran pengimbas kod bar?

Akhiran ialah jujukan yang ditetapkan untuk dihantar selepas muatan. Tugas biasanya ialah memberitahu aplikasi bahawa imbasan sudah selesai, atau mengalih fokus. Pengimbas berbeza antara satu sama lain. Ada yang menawarkan Enter, Tab, CR, LF, CR+LF, rentetan tersuai, atau tiada langsung. Ada yang hanya menawarkan satu atau dua daripada pilihan itu.

ENTER. Kekunci Enter. Dalam pelayar ini ialah peristiwa papan kekunci, event.key === "Enter". Kekunci itu tidak diselitkan ke dalam input teks biasa.

TAB. Kekunci Tab, event.key === "Tab". Pelayar mengalih fokus ke kawalan seterusnya. Kekunci tidak masuk ke medan.

CR. Pulangan pengangkutan, ASCII 0x0D. Pada antara muka siri atau terminal, ini boleh menjadi bait sebenar selepas muatan. Pada baji papan kekunci, tetapan berlabel CR atau pulangan pengangkutan biasanya bermaksud kekunci Enter. Pelayar tetap melaporkan Enter. Nilai medan tidak mendapat aksara CR.

LF. Suapan baris, ASCII 0x0A. Ini aksara kawalan yang berbeza daripada CR. Pada aliran siri, LF boleh menjadi bait tersendiri. Baji papan kekunci tidak mempunyai kekunci Line Feed piawai seperti Enter dan Tab. Jangan anggap item menu bernama LF menaip aksara yang kelihatan, atau Enter kali kedua.

CRLF. CR diikuti LF, dua bait 0x0D 0x0A. Sesetengah hos siri dan terminal mengharapkan pasangan itu sebagai hujung baris. Medan teks pelayar tidak menyimpan pasangan itu apabila seseorang menekan Enter.

Aksara tersuai. Akhiran boleh cetak seperti # atau kod pendek ditaip selepas kod bar, jadi ia menjadi sebahagian rentetan melainkan aplikasi membuangnya. Aksara kawalan tersuai mengikut pemisahan yang sama seperti STX: bait pada port siri, ketukan kekunci pada baji, dan hanya ketukan yang antara muka papan kekunci benar-benar dapat hantar.

ENTER, CR dan LF ialah nama yang hampir untuk hujung baris dalam manual. Nama itu tidak boleh saling ganti dalam setiap aplikasi. Pengimbas baji, pengimbas siri, Notepad dan borang web masing-masing boleh menunjukkan hasil berbeza bagi tetapan yang bernama sama.

Awalan berbanding akhiran

Ciri Awalan Akhiran
Kedudukan Sebelum data kod bar Selepas data kod bar
Tujuan Menanda permulaan atau melabel input Menanda selesai atau mencetuskan tindakan
Contoh STX, atau pengecam AIM boleh cetak seperti ]C1 ENTER, TAB, atau aksara boleh cetak seperti #
Kegunaan biasa Membingkai atau mengenal pasti imbasan Menghantar borang atau mengalih fokus
Dalam medan teks Aksara boleh cetak berada di hadapan nilai Aksara boleh cetak berada di hujung. Enter dan Tab tidak
Sifat Penanda yang ditetapkan, sesiapa sahaja boleh menaipnya Penanda yang ditetapkan, sesiapa sahaja boleh menaipnya

Tanggalkan awalan atau akhiran tersuai hanya apabila anda menetapkan jujukan yang tepat itu dan rekod yang disimpan tidak patut mengandunginya. Biarkan pengecam AIM kekal sehingga aplikasi mempunyai peraturan untuknya.

ENTER, TAB, CR dan LF

Nama ini muncul pada helaian tetapan. Pihak penerima melihat ketukan kekunci atau bait, bergantung pada antara muka. Panduan Baji Papan Kekunci HID menerangkan laluan ketukan kekunci. Port siri ialah laluan lain: aplikasi membaca bait, dan fokus tidak memilih ke mana bait itu pergi.

ENTER

Pada pengimbas baji papan kekunci, ENTER ialah kekunci Enter. Dalam medan teks satu baris, pelayar semasa menggunakan kekunci itu untuk menghantar borang yang meliputinya. Kotak carian boleh mengunci imbasan pada peristiwa itu. Borang berbilang medan boleh dihantar sebelum medan seterusnya diisi. Panggil preventDefault() pada peristiwa submit, atau pada keydown Enter, apabila halaman perlu menyimpan nilai dan kekal di tempat. Kendalikan Enter di satu tempat sahaja. Pendengar keydown dan pendengar submit yang kedua-duanya menerima imbasan akan merekodkannya dua kali.

Sesetengah pengimbas menghantar NumPad Enter. event.key tetap "Enter". event.code mungkin "NumpadEnter", bukan "Enter". Uji event.key jika kedua-dua kekunci patut mengunci medan.

Panduan Akhiran ENTER dan TAB pada Pengimbas Kod Bar membandingkan dua pilihan itu untuk POS dan borang web. Pengimbas Kod Bar Tiada ENTER membincangkan pengimbas yang menaip kod bar kemudian berhenti.

TAB

TAB ialah kekunci Tab. Pelayar mengalih fokus selepas keydown. Baca medan dalam pengendali keydown itu, semasa medan masih berfokus, dan biarkan tindakan lalai jika kawalan seterusnya patut menerima kursor. preventDefault() menahan fokus pada medan semasa.

Shift+Tab ialah kekunci yang sama dengan Shift ditekan. Akhiran Tab pengimbas ialah Tab tanpa Shift. Abaikan event.shiftKey jika pengguna papan kekunci mesti dapat bergerak ke belakang dalam borang.

CR

Pulangan pengangkutan menggerakkan kursor ke permulaan baris pada terminal. Baitnya ialah 0x0D. Pengimbas siri boleh menambah bait itu pada muatan. Tetapan baji papan kekunci bernama CR biasanya menghantar kekunci Enter, bukan menyelitkan 0x0D ke dalam teks. Menekan Enter dalam input pelayar tidak menulis aksara CR ke input.value.

Jika hos ialah terminal atau pendengar port COM, cari bait itu. Jika hos ialah halaman web, cari event.key === "Enter".

LF

Suapan baris menurunkan kursor terminal satu baris. Baitnya ialah 0x0A. Sesetengah hos menganggap LF bersendirian sebagai baris baharu. Yang lain mengabaikannya melainkan CR datang dahulu. Pengimbas baji yang menyenaraikan LF sebagai akhiran mungkin menghantar kekunci yang tidak ditukar sistem pengendalian menjadi pemisah baris, atau menghantar sesuatu yang medan teks tidak akan simpan. Tangkap kekunci dalam Penguji Peristiwa Papan Kekunci sebelum anda mengendalikan LF yang disangka begitu dalam kod aplikasi.

CRLF

CRLF ialah jujukan dua kawalan, CR kemudian LF. Fail teks gaya Windows dan banyak peranti siri menggunakannya sebagai satu baris baharu. Halaman tetapan yang menulis akhiran CRLF bermaksud pengimbas akan cuba menghantar pasangan itu selepas muatan, pada antara muka yang sedang digunakan.

Dalam pelayar, menekan Enter tidak menghasilkan jujukan CRLF harfiah di dalam input teks. Borang menerima peristiwa papan kekunci. <textarea> boleh menyelitkan baris baharu apabila pengguna menekan Enter, dan baris baharu itu ialah kelakuan penyuntingan pelayar sendiri, bukan bukti bahawa pengimbas memancarkan bait 0x0D 0x0A. Pembaca siri boleh menerima dua bait itu dan hanya patut menganggapnya sebagai penamat jika pengimbas itu ditetapkan untuk menghantarnya. Jangan tanggalkan CR atau LF dari tengah muatan yang memang dibenarkan mengandunginya.

Bagaimana awalan dan akhiran mempengaruhi aplikasi web

Imbasan baji papan kekunci ialah rentetan ketukan kekunci ke kawalan yang sedang berfokus. Halaman tidak membuka pengimbas. Jika fokus berada pada medan lain, awalan, kod bar dan akhiran semuanya masuk ke situ.

keydown menyala untuk setiap kekunci, termasuk Enter dan Tab, sebelum pelayar menyelitkan aksara atau mengalih fokus. event.key ialah aksara atau nama kekunci selepas sistem pengendalian menggunakan susun atur papan kekunci. Aksara awalan dan akhiran yang boleh dicetak muncul dalam medan melalui peristiwa input. Enter dan Tab tidak.

Pendengar di bawah mengunci medan apabila Enter tiba. Pendengar itu tidak menambah akhiran yang ditinggalkan pengimbas. Jika pengimbas tidak menghantar Enter, nilai kekal dalam medan sehingga 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 = ''
})

Beri fokus kepada #barcode sebelum imbasan. preventDefault() menghentikan borang leluhur daripada menghantar kali kedua. Jika input tidak berada dalam borang dan anda mahu penghantaran asli pelayar, buang preventDefault().

Tanpa akhiran, tunggu tindakan yang jelas: butang, Enter kemudian daripada pengendali, atau langkah seterusnya dalam aliran kerja. Pemasa ketidakaktifan boleh menganggap jeda sebagai penghujung imbasan. Pemasa itu ialah tekaan. Pengimbas yang perlahan, lengah Bluetooth, atau penataip yang pantas boleh jatuh di sebelah yang salah. Utamakan akhiran yang telah ditetapkan apabila aliran kerja memerlukan penghujung yang pasti.

Awalan boleh cetak yang sudah diketahui boleh dibuang selepas anda membaca nilai:

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

Hantar hanya awalan yang anda tetapkan, contohnya ']C1'. Jangan potong bilangan aksara sembarangan daripada setiap imbasan.

Untuk borang penuh yang juga mengendalikan Tab, input kosong dan imbasan kedua, lihat Cara Menguji Pengimbas Kod Bar dalam Aplikasi Web.

Cara menetapkan awalan dan akhiran

Tetapan awalan dan akhiran berada pada pengimbas. Nama kekunci dan cara menukarnya khusus bagi setiap pengeluar. Tiada kod bar tetapan yang berfungsi pada setiap jenama, dan panduan ini tidak mencetaknya.

Cara yang biasa:

  • Imbas kod bar tetapan daripada manual model yang tepat itu. Helaian dikumpulkan mengikut tetapan: akhiran, awalan, susun atur papan kekunci, simbologi.
  • Gunakan program tetapan vendor, kemudian tulis hasilnya ke pengimbas melalui USB.
  • Gunakan utiliti pengurusan peranti bagi barisan produk itu apabila anda mengemas kini banyak unit.

Selepas perubahan, imbas kod bar yang nilainya sudah diketahui dan bandingkan hasil dengan huraian manual tentang tetapan yang anda pilih. Tetapan semula kilang daripada jenama lain boleh membiarkan pengimbas tidak berubah, atau memasukkannya ke mod yang tidak dijangka. Panduan Panduan Konfigurasi Pengimbas Kod Bar merumuskan tetapan yang biasanya penting. Panduan itu tidak menggantikan manual.

Barcode Scanner Emulator boleh menaip nilai yang anda pilih kemudian menghantar ENTER, TAB, atau tiada akhiran. Masukkan awalan boleh cetak ke dalam nilai itu apabila anda perlu melatih pengendalian awalan tanpa perkakasan. Emulator tidak memancarkan pasangan bait CR/LF siri, dan tidak membaca label.

Cara menguji kelakuan awalan dan akhiran

Gunakan pengimbas yang berada dalam mod papan kekunci, USB HID keyboard atau Bluetooth HID keyboard.

  1. Sambungkan dan tunggu sehingga pengimbas menunjukkan ia mempunyai kuasa.
  2. Buka Penguji Input Kod Bar.
  3. Klik Mula Ujian, atau klik kawasan imbasan. Kawasan itu menjadi biru apabila sedia. Halaman tidak mengambil fokus sendiri.
  4. Imbas kod bar yang muatannya sudah anda ketahui.
  5. Baca nilai yang ditangkap dan kiraan aksara. Aksara awalan atau akhiran yang boleh dicetak berada di dalam rentetan itu. Baris Awalan untuk kekunci bernama yang tiba sebelum aksara pertama, contohnya pengubah suai. Baris itu tidak menarik awalan yang ditaip seperti ]C1 keluar daripada teks kod bar.
  6. Semak akhiran. Penguji melaporkan ENTER, TAB, atau Tiada. Dengan Tangkap automatik dihidupkan, hasil muncul selepas Enter, Tab, atau jeda singkat sebaik sahaja kekunci berhenti. Matikan Tangkap automatik untuk menahan tangkapan sehingga anda menekan Henti. Enter dan Tab bukan sebahagian daripada rentetan kod bar.
  7. Bandingkan hasil itu dengan tetapan yang anda maksudkan. Kemudian buka Penguji Peristiwa Papan Kekunci dan imbas sekali lagi apabila anda perlu setiap keydown mengikut turutan, termasuk key, code dan masa.

Penguji input merekod peristiwa papan kekunci yang boleh dilihat pelayar. Penguji tidak dapat membaca port siri, jadi tidak dapat menunjukkan CR atau LF sebagai bait mentah. Ujian baji tidak membuktikan apa yang akan dihantar oleh tetapan siri.

Penyelesaian masalah

Pengimbas tidak menghantar ENTER. Kod bar muncul dan kursor kekal dalam medan. Penguji input melaporkan Tiada. Akhiran dimatikan, atau ditetapkan kepada sesuatu selain Enter. Lihat Pengimbas Kod Bar Tiada ENTER.

TAB mengalih fokus di luar jangkaan. Pengimbas sedang menghantar kekunci Tab. Itulah akhiran yang ditetapkan. Gunakan Enter apabila borang patut dihantar, atau baca nilai pada keydown Tab apabila aliran kerja patut maju. Butirannya ada dalam panduan Akhiran ENTER dan TAB pada Pengimbas Kod Bar.

Borang dihantar dua kali. Pelayar menghantar pada Enter, dan pendengar keydown juga menerima imbasan. Kekalkan satu laluan penyiapan dan panggil preventDefault() pada laluan yang satu lagi.

Awalan muncul di dalam kod bar. Awalan boleh cetak ialah sebahagian daripada rentetan yang ditangkap. Lumpuhkan pada pengimbas, atau buang jujukan yang tepat itu dalam aplikasi. Pengecam simbologi yang aktif ialah sumber biasa bagi ] di hadapan ditambah dua aksara lagi. Awalan kawalan yang tidak dapat ditaip oleh baji akan hilang, bukan kelihatan.

Aksara salah. Susun atur pengimbas dan susun atur sistem pengendalian boleh tidak sepadan, yang mengubah aksara awalan dan tanda baca sementara panjangnya kekal. Lihat Susun Atur Papan Kekunci Pengimbas Kod Bar Salah.

Aplikasi tidak pernah melihat penghujung imbasan. Tiada akhiran, dan halaman menunggu Enter. Tambah akhiran yang sepadan dengan borang, atau selesaikan nilai pada tindakan yang jelas. Tekaan masa akan terlepas sebahagian imbasan sebenar dan menerima sebahagian penaipan.

CR/LF berbeza antara aplikasi. Notepad menyelitkan baris baharu apabila menerima Enter. Input teks web menyimpan kod bar dan menembak peristiwa kekunci. Program siri boleh menerima 0x0D, 0x0A, atau kedua-duanya. Bandingkan antara muka sebelum anda menukar pengimbas. Jika tiada aplikasi yang menerima aksara, mulakan dengan Pengimbas Kod Bar Tidak Berfungsi.

Penelitian yang lebih luas tentang fokus, imbasan berulang dan aliran POS ada dalam Cara Menguji Input Pengimbas Kod Bar.

Matriks ujian

Lajur tetapan ialah apa yang anda tetapkan pada pengimbas, atau apa yang anda taip dengan emulator apabila kes itu ialah akhiran papan kekunci. Kelakuan yang dijangka ialah apa yang aplikasi patut lakukan. Kes CRLF siri bukan ujian yang sama dengan kekunci Enter dalam pelayar.

Tetapan Kelakuan aplikasi yang dijangka
Tiada awalan, tiada akhiran Nilai kod bar diterima dan tiada kekunci penyiapan yang tiba. Nilai kekal tersedia sehingga aplikasi membacanya.
Tiada awalan, akhiran ENTER Aplikasi menerima kekunci penyiapan sekali dan menyimpan muatan tanpa aksara penamat.
Tiada awalan, akhiran TAB Fokus boleh beralih ke kawalan seterusnya. Aplikasi membaca nilai sebelum peralihan itu.
Awalan boleh cetak tersuai Aksara awalan muncul sebelum data yang dinyahkod. Aplikasi sengaja menyimpan atau membuang awalan yang tepat itu.
Akhiran boleh cetak tersuai Aksara akhiran muncul selepas data yang dinyahkod. Enter dan Tab ialah kekunci, jadi tidak muncul dalam rentetan.
Jujukan CRLF Hos siri atau terminal memproses bait CR dan LF yang ditetapkan. Medan teks pelayar tidak memperoleh bait itu daripada tekanan Enter.

Jalankan baris papan kekunci pada pengimbas baji dan, apabila tiada perkakasan, dengan tetapan ENTER, TAB dan tiada akhiran pada emulator. Jalankan baris CRLF pada antara muka yang sepatutnya membawa bait itu. Hasil sebenar tetap bergantung pada antara muka itu dan pada aplikasi.