Barcode Scanner Emulator
Prefix și sufix la scanerele de coduri de bare: ghid complet
Un prefix este o dată sau o secvență de control pe care scanerul de coduri de bare o trimite înaintea codului de bare decodificat. Un sufix este ceea ce trimite după acea valoare. Același model poate fi setat cu prefixe și sufixe diferite, iar un scaner serial nu le livrează la fel ca un scaner în mod pană de tastatură.
Un prefix de scaner de coduri de bare este trimis înaintea valorii decodificate. Un sufix este trimis după ea. Un scaner poate produce această secvență:
Prefix: STX
Cod de bare: 123456789
Sufix: ENTER
STX într-un manual înseamnă de obicei caracterul de control, nu cele trei litere S, T și X. ENTER la un scaner în mod pană de tastatură este de regulă tasta Enter, nu cele două caractere CR și LF inserate într-un câmp de text. Care dintre ele ajunge la dumneavoastră depinde de model, de interfață și de aplicație. Nicio setare nu este universală.
Ghidul Sufixe ENTER și TAB la scanerele de coduri de bare rămâne la alegerea și verificarea acestor două taste de încheiere. Acest ghid este despre cadrul din jurul codului de bare: ce vine înainte, ce vine după și cum trebuie o aplicație web să citească ambele părți.
Ce este un prefix de scaner de coduri de bare
Un prefix este o secvență configurată pe care scanerul o transmite înaintea sarcinii. Sarcina este textul decodificat de simbologie, de exemplu 123456789. Prefixul nu face parte din acea decodare decât dacă scanerul a fost setat să îl adauge.
Utilizări frecvente:
- Marchează începutul unui mesaj. Protocoalele seriale și de terminal trimit uneori un caracter de control, adesea numit STX, ca gazda să știe că a început un cadru nou.
- Numește simbologia. Cu identificatorul de simbologie AIM activat, un scaner poate trimite un prefix scurt tipăribil, cum ar fi
]C1pentru Code 128 sau]E0pentru EAN, înaintea cifrelor. Aplicația se poate ramifica după acel identificator. - Dirijează introducerea în software POS sau de terminal mai vechi. Un cod fix înaintea datelor spunea gazdei cărui câmp sau dispozitiv îi aparține scanarea.
- Etichetează un post anume. Două scanere pot primi prefixe tipăribil diferite, ca un jurnal să arate ce post a trimis codul.
Un prefix tipăribil înseamnă caractere obișnuite. Apar într-un câmp de text la începutul șirului. Un prefix din caracter de control, cum este STX (0x02), nu este literele S, T și X. Un scaner în mod pană de tastatură poate să nu poată tasta deloc acel caracter de control. Un scaner serial îl poate trimite ca octet. Citiți manualul modelului pe care îl aveți înainte să scrieți cod care așteaptă una sau alta.
Un prefix nu dovedește că un scaner a produs introducerea. O persoană, un macro sau Barcode Scanner Emulator pot tasta aceleași caractere. Tratați prefixul ca pe cadrul pe care l-ați configurat, apoi validați sarcina așa cum validați orice altă introducere de utilizator.
Ce este un sufix de scaner de coduri de bare
Un sufix este o secvență configurată, trimisă după sarcină. Rolul lui obișnuit este să spună aplicației că scanarea s-a terminat sau să mute focalizarea. Scanerele diferă. Unele oferă Enter, Tab, CR, LF, CR+LF, un șir propriu sau nimic. Altele oferă doar una sau două dintre acestea.
ENTER. Tasta Enter. Într-un browser aceasta este un eveniment de tastatură, event.key === "Enter". Nu este inserată într-un câmp de text obișnuit.
TAB. Tasta Tab, event.key === "Tab". Browserul mută focalizarea la controlul următor. Tasta nu este inserată în câmp.
CR. Revenire de car, ASCII 0x0D. Pe o interfață serială sau de terminal acesta poate fi un octet real după sarcină. La o pană de tastatură, o setare etichetată CR sau revenire de car înseamnă de obicei tasta Enter. Browserul raportează în continuare Enter. Valoarea câmpului nu câștigă un caracter CR.
LF. Salt de linie, ASCII 0x0A. Este un caracter de control diferit de CR. Într-un flux serial poate fi propriul octet. O pană de tastatură nu are o tastă standard de salt de linie așa cum are Enter și Tab. Nu presupuneți că un element de meniu numit LF tastează un caracter vizibil sau un al doilea Enter.
CRLF. CR urmat de LF, cei doi octeți 0x0D 0x0A. Unele gazde seriale și de terminal așteaptă acea pereche ca sfârșit de linie. Un câmp de text din browser nu stochează acea pereche când cineva apasă Enter.
Caractere proprii. Un sufix tipăribil, cum ar fi # sau un cod scurt, este tastat după codul de bare, deci devine parte din șir, dacă aplicația nu îl elimină. Un caracter de control propriu urmează aceeași despărțire ca STX: octeți pe un port serial, apăsări pe o pană și doar apăsările pe care interfața de tastatură le poate trimite cu adevărat.
ENTER, CR și LF sunt nume înrudite pentru „sfârșit de linie” în manuale. Nu sunt interschimbabile în orice aplicație. Un scaner pană, un scaner serial, Notepad și un formular web pot arăta fiecare un rezultat diferit pentru o setare cu același nume.
Prefix și sufix
| Caracteristică | Prefix | Sufix |
|---|---|---|
| Poziție | Înaintea datelor codului de bare | După datele codului de bare |
| Scop | Marchează începutul sau etichetează introducerea | Marchează încheierea sau declanșează o acțiune |
| Exemplu | STX sau un identificator AIM tipăribil, cum ar fi ]C1 |
ENTER, TAB sau un caracter tipăribil, cum ar fi # |
| Utilizare frecventă | Încadrează sau identifică scanarea | Trimite un formular sau mută focalizarea |
| Într-un câmp de text | Caracterele tipăribile stau la începutul valorii | Caracterele tipăribile stau la sfârșit. Enter și Tab nu |
| Identitate | Un marcaj configurat pe care îl poate tasta oricine | Un marcaj configurat pe care îl poate tasta oricine |
Eliminați un prefix sau un sufix propriu doar când ați configurat exact acea secvență și înregistrarea stocată nu trebuie să o includă. Lăsați un identificator AIM pe loc până când aplicația are o regulă pentru el.
ENTER, TAB, CR și LF
Aceste nume apar pe fișele de configurare. Partea care primește vede fie apăsări, fie octeți, după interfață. Ghidul Pană de tastatură HID descrie calea apăsărilor. Un port serial este o cale diferită: aplicația citește octeți, iar focalizarea nu alege unde merg.
ENTER
La un scaner în mod pană de tastatură, ENTER este tasta Enter. Într-un câmp de text pe un singur rând, browserele actuale folosesc acea tastă ca să trimită formularul care îl cuprinde. O casetă de căutare poate confirma scanarea la acel eveniment. Un formular cu mai multe câmpuri se poate trimite înainte să fie completate câmpurile de după. Apelați preventDefault() pe evenimentul submit sau pe keydown al tastei Enter, când pagina trebuie să păstreze valoarea și să rămână pe loc. Tratați Enter într-un singur loc. Un ascultător keydown și un ascultător submit care acceptă amândoi scanarea o vor înregistra de două ori.
Unele scanere trimit NumPad Enter. event.key este tot "Enter". event.code poate fi "NumpadEnter", nu "Enter". Testați event.key dacă ambele taste trebuie să confirme câmpul.
Ghidul Sufixe ENTER și TAB la scanerele de coduri de bare compară cele două alegeri pentru POS și formulare web. Scanerului de coduri de bare îi lipsește ENTER acoperă un scaner care tastează codul de bare și apoi se oprește.
TAB
TAB este tasta Tab. Browserul mută focalizarea după keydown. Citiți câmpul în acel handler keydown, cât încă are focalizarea, și lăsați acțiunea implicită când controlul următor trebuie să primească cursorul. preventDefault() ține focalizarea pe câmpul curent.
Shift+Tab este aceeași tastă cu Shift ținut. Un sufix Tab al scanerului este Tab fără Shift. Ignorați event.shiftKey dacă utilizatorii de la tastatură trebuie să poată merge înapoi prin formular.
CR
Revenirea de car mută un cursor la începutul liniei într-un terminal. Octetul este 0x0D. Un scaner serial poate adăuga acel octet la sarcină. O setare de pană de tastatură numită CR trimite de obicei tasta Enter, în loc să insereze 0x0D în text. Apăsarea Enter într-un câmp de browser nu scrie un caracter CR în input.value.
Dacă gazda este un terminal sau un program care ascultă un port COM, căutați octetul. Dacă gazda este o pagină web, căutați event.key === "Enter".
LF
Saltul de linie mută cursorul terminalului cu o linie în jos. Octetul este 0x0A. Unele gazde tratează LF singur ca linie nouă. Altele îl ignoră dacă nu a venit mai întâi CR. Un scaner pană care listează LF ca sufix poate trimite o tastă pe care sistemul de operare nu o transformă într-o întrerupere de linie, sau poate să nu trimită nimic ce un câmp de text va păstra. Capturați tasta în testerul de evenimente de tastatură înainte să tratați un presupus LF în codul aplicației.
CRLF
CRLF este secvența de două caractere de control, CR apoi LF. Fișierele text în stil Windows și multe dispozitive seriale o folosesc ca o singură linie nouă. O pagină de configurare care spune „sufix CRLF” înseamnă că scanerul va încerca să trimită acea pereche după sarcină pe interfața pe care o folosește.
Într-un browser, apăsarea Enter nu produce o secvență CRLF literală în interiorul unui câmp de text. Formularul primește un eveniment de tastatură. Un <textarea> poate insera o linie nouă când utilizatorul apasă Enter, iar acea linie nouă este comportamentul propriu de editare al browserului, nu dovada că scanerul a emis octeții 0x0D 0x0A. Un cititor serial poate primi acei doi octeți și trebuie să îi trateze ca terminator doar dacă acel scaner a fost configurat să îi trimită. Nu eliminați CR sau LF din mijlocul unei sarcini care are voie să le conțină.
Cum afectează prefixele și sufixele aplicațiile web
O scanare cu pană de tastatură este o rafală de apăsări în controlul care are focalizarea. Pagina nu deschide scanerul. Dacă focalizarea este pe alt câmp, prefixul, codul de bare și sufixul merg toate acolo.
keydown se declanșează pentru fiecare tastă, inclusiv Enter și Tab, înainte ca browserul să insereze un caracter sau să mute focalizarea. event.key este caracterul sau numele tastei după ce sistemul de operare aplică dispunerea tastaturii. Caracterele tipăribile de prefix și de sufix apar în câmp prin evenimentul input. Enter și Tab nu.
Ascultătorul de mai jos confirmă câmpul când sosește Enter. Nu adaugă un sufix pe care scanerul l-a omis. Dacă scanerul nu trimite Enter, valoarea rămâne în câmp până când altceva o citește.
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 = ''
})
Puneți focalizarea pe #barcode înainte de scanare. preventDefault() oprește un formular părinte să se trimită a doua oară. Dacă intrarea nu este într-un formular și vreți trimiterea nativă, omiteți preventDefault().
Fără sufix, așteptați o acțiune explicită: un buton, un Enter ulterior de la operator sau pasul următor din flux. Un temporizator de inactivitate poate trata o pauză ca sfârșitul scanării. Acel temporizator este o euristică. Un scaner lent, o întârziere Bluetooth sau un dactilograf rapid pot cădea de partea greșită a pragului. Preferați un sufix configurat când fluxul are nevoie de un sfârșit sigur.
Un prefix tipăribil cunoscut poate fi eliminat după ce citiți valoarea:
function withoutConfiguredPrefix(value, prefix) {
if (prefix && value.startsWith(prefix)) {
return value.slice(prefix.length)
}
return value
}
Transmiteți doar prefixul pe care l-ați configurat, de exemplu ']C1'. Nu tăiați un număr arbitrar de caractere din fiecare scanare.
Pentru un formular complet care tratează și Tab, introducerea goală și o a doua scanare, vedeți Cum se testează scanerele de coduri de bare în aplicațiile web.
Cum se configurează prefixele și sufixele
Setările de prefix și de sufix stau pe scaner. Numele opțiunilor și felul în care le schimbați sunt specifice producătorului. Nu există un cod de configurare care să meargă pe orice marcă, iar acest ghid nu tipărește unul.
Metode tipice:
- Scanați un cod de configurare din manualul acelui model exact. Foaia este grupată după setare: sufix, prefix, dispunere a tastaturii, simbologie.
- Folosiți programul de configurare al producătorului, apoi scrieți rezultatul în scaner prin USB.
- Folosiți utilitarul de administrare a dispozitivelor pentru acea linie de produse când actualizați multe unități.
După o schimbare, scanați un cod de bare cunoscut și comparați rezultatul cu descrierea din manual a setării alese. O resetare din fabrică de la o altă marcă poate lăsa scanerul neschimbat sau îl poate pune într-un mod neașteptat. Ghidul Configurarea scanerului de coduri de bare rezumă setările care contează de obicei. Nu înlocuiește manualul.
Barcode Scanner Emulator poate tasta o valoare pe care o alegeți și apoi trimite ENTER, TAB sau niciun sufix. Puneți un prefix tipăribil în acea valoare când trebuie să exersați tratarea prefixului fără hardware. Emulatorul nu emite o pereche serială de octeți CR/LF și nu citește o etichetă.
Cum se testează comportamentul prefixului și al sufixului
Folosiți un scaner aflat în mod tastatură, tastatură USB HID sau tastatură Bluetooth HID.
- Conectați-l și așteptați până arată că are alimentare.
- Deschideți testerul de introducere a codurilor de bare.
- Faceți clic pe Pornește testul sau faceți clic pe zona de scanare. Devine albastră când este gata. Pagina nu ia focalizarea de una singură.
- Scanați un cod de bare a cărui sarcină o cunoașteți deja.
- Citiți valoarea capturată și numărul de caractere. Caracterele tipăribile de prefix sau de sufix sunt în interiorul acelui șir. Linia Prefix este pentru tastele numite care sosesc înaintea primului caracter, cum ar fi un modificator. Nu scoate un prefix tastat precum
]C1din textul codului de bare. - Verificați sufixul. Testerul raportează ENTER, TAB sau Niciunul. Cu Captură automată pornită, rezultatul apare după Enter, Tab sau o pauză scurtă, odată ce tastele se opresc. Opriți Captură automată ca să țineți captura până apăsați Oprește. Enter și Tab nu fac parte din șirul codului de bare.
- Comparați acel rezultat cu configurarea pe care ați intenționat-o. Apoi deschideți testerul de evenimente de tastatură și scanați din nou când aveți nevoie de fiecare
keydownîn ordine, inclusivkey,codeși timpul.
Testerul de introducere înregistrează evenimentele de tastatură pe care browserul le poate vedea. Nu poate citi un port serial, deci nu poate arăta CR sau LF ca octeți bruți. Un test de pană nu dovedește ce va trimite o setare serială.
Depanare
Scanerul nu trimite ENTER. Codul de bare apare și cursorul rămâne în câmp. Testerul de introducere raportează Niciunul. Sufixul este oprit sau este setat la altceva decât Enter. Vedeți Scanerului de coduri de bare îi lipsește ENTER.
TAB mută focalizarea pe neașteptate. Scanerul trimite tasta Tab. Acesta este sufixul configurat. Folosiți Enter când formularul trebuie trimis sau citiți valoarea la keydown al tastei Tab când fluxul trebuie să avanseze. Detaliile sunt în ghidul Sufixe ENTER și TAB la scanerele de coduri de bare.
Formularul se trimite de două ori. Browserul îl trimite la Enter, iar un ascultător keydown acceptă și el scanarea. Păstrați o singură cale de încheiere și apelați preventDefault() pe cealaltă.
Un prefix apare în interiorul codului de bare. Un prefix tipăribil face parte din șirul capturat. Fie îl dezactivați pe scaner, fie eliminați acea secvență exactă în aplicație. Un identificator de simbologie activat este o sursă frecventă a unui ] la început și a încă două caractere. Un prefix de control pe care pana nu îl poate tasta va lipsi, nu va fi vizibil.
Caracterele sunt greșite. Dispunerea scanerului și dispunerea sistemului de operare pot să nu coincidă, ceea ce schimbă caracterele prefixului și punctuația, în timp ce lungimea rămâne aceeași. Vedeți Dispunere greșită a tastaturii scanerului de coduri de bare.
Aplicația nu vede niciodată sfârșitul scanării. Nu există sufix, iar pagina așteaptă Enter. Adăugați un sufix care se potrivește formularului sau finalizați valoarea printr-o acțiune explicită. O presupunere după timp va rata unele scanări reale și va accepta o parte din tastare.
CR/LF diferă între aplicații. Notepad inserează o linie nouă când primește Enter. Un câmp de text web păstrează codul de bare și declanșează un eveniment de tastă. Un program serial poate primi 0x0D, 0x0A sau pe amândoi. Comparați interfața înainte să schimbați scanerul. Dacă nicio aplicație nu primește caractere, începeți cu Scanerul de coduri de bare nu funcționează.
O trecere mai largă peste focalizare, scanări repetate și fluxuri POS este în Cum se testează introducerea de la scanerul de coduri de bare.
Matrice de test
Coloana de configurare este ceea ce setați pe scaner sau ceea ce tastați cu emulatorul când cazul este un sufix de tastatură. Comportamentul așteptat este ceea ce trebuie să facă aplicația. Un caz CRLF serial nu este același test ca o tastă Enter într-un browser.
| Configurare | Comportamentul așteptat al aplicației |
|---|---|
| Fără prefix, fără sufix | Valoarea codului de bare este primită și nu sosește nicio tastă de încheiere. Valoarea rămâne disponibilă până când aplicația o citește. |
| Fără prefix, sufix ENTER | Aplicația primește tasta de încheiere o dată și stochează sarcina fără un caracter terminator. |
| Fără prefix, sufix TAB | Focalizarea se poate muta la controlul următor. Aplicația citește valoarea înainte de acea mutare. |
| Prefix tipăribil propriu | Caracterele prefixului apar înaintea datelor decodificate. Aplicația păstrează sau elimină exact acel prefix în mod intenționat. |
| Sufix tipăribil propriu | Caracterele sufixului apar după datele decodificate. Enter și Tab sunt taste, deci nu apar în șir. |
| Secvență CRLF | O gazdă serială sau de terminal prelucrează octeții CR și LF configurați. Un câmp de text din browser nu câștigă acei octeți de la o apăsare Enter. |
Rulați rândurile de tastatură pe scanerul pană și, când hardware-ul lipsește, cu setările emulatorului ENTER, TAB și fără sufix. Rulați rândul CRLF pe interfața care trebuie să poarte acei octeți. Rezultatele reale depind în continuare de acea interfață și de aplicație.