Barcode Scanner Emulator
Vöötkoodiskanneri eesliide ja järelliide: täielik juhend
Eesliide on andmed või juhtjada, mille vöötkoodiskanner saadab enne dekodeeritud vöötkoodi. Järelliide on see, mille ta saadab pärast seda väärtust. Sama mudeli saab seada eri eesliidetele ja järelliidetele ning jadaskanner ei edasta neid samamoodi kui klaviatuurikiiluga skanner.
Vöötkoodiskanneri eesliide saadetakse enne dekodeeritud väärtust. Järelliide saadetakse pärast seda. Üks skanner võib anda sellise jada:
Eesliide: STX
Vöötkood: 123456789
Järelliide: ENTER
STX kasutusjuhendis tähendab sageli juhtmärki, mitte kolme tähte S, T ja X. ENTER klaviatuurikiiluga skanneril on tavaliselt Enter-klahv, mitte kaks märki CR ja LF, mis tekstivälja lisatakse. Kumba te saate, sõltub mudelist, liidesest ja rakendusest. Ükski säte ei ole universaalne.
Juhend ENTER ja TAB järelliited vöötkoodiskannerites jääb nende kahe lõpetaja valimise ja tõrkeotsingu juurde. See juhend käsitleb raami vöötkoodi ümber: mis tuleb enne, mis tuleb pärast ja kuidas veebirakendus peaks mõlemat lugema.
Mis on vöötkoodiskanneri eesliide?
Eesliide on seadistatud jada, mille skanner edastab enne andmesisu. Andmesisu on tekst, mille sümboloogia dekodeeris, näiteks 123456789. Eesliide ei kuulu selle dekodeeringu hulka, kui skannerit ei seatud seda lisama.
Levinud kasutused:
- Märkige sõnumi algus. Jada- ja terminaliprotokollid saadavad mõnikord juhtmärgi, mida sageli nimetatakse STX-iks, et host teaks, et uus raam on alanud.
- Nimetage sümboloogia. Kui AIM-sümboloogia identifikaator on lubatud, võib skanner saata numbrite ette lühikese prinditava eesliite, näiteks
]C1Code 128 jaoks või]E0EAN-i jaoks. Rakendus saab selle identifikaatori järgi hargneda. - Suunake sisend vanemas POS- või terminalitarkvaras. Püsikood andmete ees ütles hostile, millisele väljale või seadmele skann kuulus.
- Märgistage konkreetne töökoht. Kahele skannerile saab anda erinevad prinditavad eesliited, et logi näitaks, milline rida koodi saatis.
Prinditav eesliide on tavalised märgid. Need ilmuvad tekstiväljal stringi algusesse. Juhtmärgi eesliide, näiteks STX (0x02), ei ole tähed S, T ja X. Klaviatuurikiiluga skanner ei pruugi seda juhtmärki üldse tippida. Jadaskanner saab selle saata baidina. Lugege oma mudeli kasutusjuhendit, enne kui kirjutate koodi, mis ootab üht või teist.
Eesliide ei tõenda, et sisendi tekitas skanner. Inimene, makro või Barcode Scanner Emulator saab samu märke tippida. Käsitlege eesliidet raamistikuna, mille te seadistasite, ja kontrollige seejärel andmesisu nii, nagu kontrollite mis tahes muud kasutaja sisendit.
Mis on vöötkoodiskanneri järelliide?
Järelliide on seadistatud jada, mis saadetakse pärast andmesisu. Selle tavaline ülesanne on öelda rakendusele, et skann on lõppenud, või liigutada fookust. Skannerid erinevad. Mõni pakub Enterit, Tabi, CR-i, LF-i, CR+LF-i, kohandatud stringi või mitte midagi. Mõni pakub neist ainult üht või kaht.
ENTER. Enter-klahv. Brauseris on see klaviatuurisündmus, event.key === "Enter". Seda ei lisata tavalisse tekstisisendisse.
TAB. Tab-klahv, event.key === "Tab". Brauser viib fookuse järgmisele juhtelemendile. Klahvi ei lisata väljale.
CR. Kelgunaasmine, ASCII 0x0D. Jada- või terminaliliideses võib see olla tegelik bait pärast andmesisu. Klaviatuurikiilul tähendab säte nimega CR või kelgunaasmine tavaliselt Enter-klahvi. Brauser teatab ikka Enterist. Välja väärtus ei saa CR-märki.
LF. Reasööt, ASCII 0x0A. See on CR-ist erinev juhtmärk. Jadavoos võib see olla omaette bait. Klaviatuurikiilul ei ole standardset reasööduklahvi nii, nagu tal on Enter ja Tab. Ärge eeldage, et menüüelement nimega LF tipib nähtava märgi või teise Enteri.
CRLF. CR ja selle järel LF, kaks baiti 0x0D 0x0A. Mõni jada- ja terminalihost ootab seda paari rea lõpuks. Brauseri tekstiväli ei salvesta seda paari, kui keegi vajutab Enterit.
Kohandatud märgid. Prinditav järelliide, näiteks # või lühike kood, tipitakse vöötkoodi järele, nii et see saab stringi osaks, kui rakendus seda ei eemalda. Kohandatud juhtmärk järgib sama jaotust nagu STX: baidid jadapordis, klahvivajutused kiilul ja ainult need klahvivajutused, mida klaviatuuriliides tegelikult saata saab.
ENTER, CR ja LF on kasutusjuhendites seotud nimed tähendusele „rea lõpp”. Need ei ole igas rakenduses vahetatavad. Kiiluskanner, jadaskanner, Notepad ja veebivorm võivad sama nimega sätte puhul näidata erinevat tulemust.
Eesliide ja järelliide
| Omadus | Eesliide | Järelliide |
|---|---|---|
| Asukoht | Enne vöötkoodi andmeid | Pärast vöötkoodi andmeid |
| Eesmärk | Märkida algus või sildistada sisend | Märkida lõpetamine või käivitada toiming |
| Näide | STX või prinditav AIM-identifikaator, näiteks ]C1 |
ENTER, TAB või prinditav märk, näiteks # |
| Levinud kasutus | Raamida või tuvastada skann | Saata vorm või liigutada fookust |
| Tekstiväljal | Prinditavad märgid on väärtuse alguses | Prinditavad märgid on lõpus. Enter ja Tab ei ole |
| Identiteet | Seadistatud märgis, mida igaüks saab tippida | Seadistatud märgis, mida igaüks saab tippida |
Eemaldage eesliide või kohandatud järelliide ainult siis, kui seadistasite täpselt selle jada ja salvestatud kirje ei tohi seda sisaldada. Jätke AIM-identifikaator paigale, kuni rakendusel on selle jaoks reegel.
ENTER, TAB, CR ja LF
Need nimed ilmuvad seadistuslehtedel. Vastuvõttev pool näeb kas klahvivajutusi või baite, olenevalt liidesest. Juhend HID-klaviatuurikiil kirjeldab klahvivajutuste teed. Jadaport on teine tee: rakendus loeb baite ja fookus ei vali, kuhu need lähevad.
ENTER
Klaviatuurikiiluga skanneril on ENTER Enter-klahv. Üherealisel tekstiväljal kasutavad praegused brauserid seda klahvi ümbritseva vormi saatmiseks. Otsingukast saab skanni sellel sündmusel kinnitada. Mitme väljaga vorm võib saadetud saada enne, kui hilisemad väljad on täidetud. Kutsuge preventDefault() sündmusel submit või Enteri keydown-il, kui leht peab väärtuse alles hoidma ja paigale jääma. Käsitlege Enterit ühes kohas. keydown-kuulaja ja submit-kuulaja, mis mõlemad skanni vastu võtavad, salvestavad selle kaks korda.
Mõni skanner saadab NumPad Enter. event.key on ikka "Enter". event.code võib olla "NumpadEnter", mitte "Enter". Testige event.key, kui mõlemad klahvid peavad välja kinnitama.
Juhend ENTER ja TAB järelliited vöötkoodiskannerites võrdleb neid kahte valikut POS-i ja veebivormide jaoks. Vöötkoodiskanneril puudub ENTER käsitleb skannerit, mis tipib vöötkoodi ja seejärel peatub.
TAB
TAB on Tab-klahv. Brauser liigutab fookust pärast keydown-i. Lugege väli selles keydown-käsitluses, kui sellel on veel fookus, ja jätke vaiketoiming alles, kui järgmine juhtelement peab kursori saama. preventDefault() hoiab fookuse praegusel väljal.
Shift+Tab on sama klahv Shift all hoides. Skanneri Tab-järelliide on Tab ilma Shiftita. Ignoreerige event.shiftKey, kui klaviatuurikasutaja peab saama vormis tagasi liikuda.
CR
Kelgunaasmine viib kursori terminalis rea algusesse. Bait on 0x0D. Jadaskanner saab selle baidi andmesisule lisada. Klaviatuurikiilu säte nimega CR saadab tavaliselt Enter-klahvi, selle asemel et lisada 0x0D teksti. Enteri vajutamine brauseri sisendis ei kirjuta CR-märki väljale input.value.
Kui host on terminal või COM-pordi kuulaja, otsige baiti. Kui host on veebileht, otsige event.key === "Enter".
LF
Reasööt viib terminali kursori ühe rea võrra allapoole. Bait on 0x0A. Mõni host käsitleb ainult LF-i reavahetusena. Teine ignoreerib seda, kui CR ei tulnud enne. Kiiluskanner, mis loetleb LF-i järelliitena, võib saata klahvi, mida operatsioonisüsteem reavahetuseks ei muuda, või see võib saata midagi, mida tekstiväli alles ei hoia. Püüdke klahv klaviatuurisündmuste testeris, enne kui käsitlete oletatavat LF-i rakenduse koodis.
CRLF
CRLF on kahe juhtmärgi jada CR ja seejärel LF. Windowsi laadiga tekstifailid ja paljud jadaseadmed kasutavad seda ühe reavahetusena. Seadistusleht, mis ütleb „CRLF-järelliide”, tähendab, et skanner püüab seda paari pärast andmesisu saata liidesel, mida ta kasutab.
Brauseris ei tekita Enteri vajutamine tekstisisendisse sõnasõnalist CRLF-jada. Vorm saab klaviatuurisündmuse. <textarea> võib uue rea lisada, kui kasutaja vajutab Enterit, ja see uus rida on brauseri enda redigeerimiskäitumine, mitte tõend, et skanner väljastas baidid 0x0D 0x0A. Jadalugeja võib need kaks baiti vastu võtta ja peaks neid lõpetajana käsitlema ainult siis, kui see skanner oli seadistatud neid saatma. Ärge eemaldage CR-i ega LF-i andmesisu keskelt, millel on lubatud neid sisaldada.
Kuidas eesliited ja järelliited veebirakendusi mõjutavad
Klaviatuurikiilu skann on klahvivajutuste puhang fookuses olevasse juhtelementi. Leht ei ava skannerit. Kui fookus on teisel väljal, lähevad eesliide, vöötkood ja järelliide kõik sinna.
keydown käivitub iga klahvi puhul, sealhulgas Enteri ja Tabi puhul, enne kui brauser märgi lisab või fookust liigutab. event.key on märk või klahvi nimi pärast seda, kui operatsioonisüsteem on klaviatuuripaigutuse rakendanud. Prinditavad eesliite- ja järelliitemärgid ilmuvad väljale sündmuse input kaudu. Enter ja Tab ei ilmu.
Allolev kuulaja kinnitab välja, kui Enter saabub. See ei lisa järelliidet, mille skanner ära jättis. Kui skanner Enterit ei saada, jääb väärtus väljale, kuni miski muu selle loeb.
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 = ''
})
Fokuseerige #barcode enne skanni. preventDefault() peatab ülemvormi teistkordse saatmise. Kui sisend ei ole vormi sees ja soovite natiivset saatmist, jätke preventDefault() ära.
Ilma järelliiteta oodake selget toimingut: nuppu, hilisemat Enterit operaatorilt või järgmist sammu töövoos. Tegevusetuse taimer võib käsitada pausi skanni lõpuna. See taimer on heuristika. Aeglane skanner, Bluetoothi viivitus või kiiresti tippiv inimene võib jääda selle valele poolele. Eelistage seadistatud järelliidet, kui töövoog vajab kindlat lõppu.
Teadaoleva prinditava eesliite saab eemaldada pärast väärtuse lugemist:
function withoutConfiguredPrefix(value, prefix) {
if (prefix && value.startsWith(prefix)) {
return value.slice(prefix.length)
}
return value
}
Andke edasi ainult seadistatud eesliide, näiteks ']C1'. Ärge eemaldage igast skannist suvalist arvu märke.
Täisvormi kohta, mis käsitleb ka Tabi, tühja sisendit ja teist skanni, vt Kuidas testida vöötkoodiskannereid veebirakendustes.
Kuidas eesliiteid ja järelliiteid seadistada
Eesliite ja järelliite sätted on skanneril. Klahvide nimed ja viis, kuidas neid muuta, on tootjapõhised. Pole seadistusvöötkoodi, mis töötaks igal kaubamärgil, ja see juhend ei trüki ühtki.
Tavalised viisid:
- Skannige seadistusvöötkood selle täpse mudeli kasutusjuhendist. Leht on rühmitatud sätte järgi: järelliide, eesliide, klaviatuuripaigutus, sümboloogia.
- Kasutage tootja seadistusprogrammi ja kirjutage tulemus skannerisse USB kaudu.
- Kasutage selle tootesarja seadmehalduse utiliiti, kui uuendate paljusid seadmeid.
Pärast muudatust skannige tuntud vöötkood ja võrrelge tulemust kasutusjuhendi kirjeldusega sätte kohta, mille valisite. Teise kaubamärgi tehaseseadete lähtestamine võib jätta skanneri muutmata või panna selle ootamatusse režiimi. Juhend vöötkoodiskanneri seadistamine võtab kokku sätted, mis tavaliselt loevad. See ei asenda kasutusjuhendit.
Barcode Scanner Emulator saab tippida teie valitud väärtuse ja seejärel saata ENTER, TAB või järelliite puudumise. Pange prinditav eesliide sellesse väärtusse, kui peate eesliite käsitlemist ilma riistvarata läbi proovima. Emulaator ei väljasta jada CR/LF baidipaari ega loe silti.
Kuidas eesliite ja järelliite käitumist testida
Kasutage skannerit, mis on klaviatuurirežiimis, USB HID-klaviatuur või Bluetooth HID-klaviatuur.
- Ühendage see ja oodake, kuni see näitab, et tal on toide.
- Avage vöötkoodisisendi tester.
- Klõpsake Alusta testi või klõpsake skannimisala. See muutub valmisolekul siniseks. Leht ei võta fookust ise.
- Skannige vöötkood, mille andmesisu te juba teate.
- Lugege hõivatud väärtus ja märkide arv. Prinditavad eesliite- või järelliitemärgid on selle stringi sees. Rida Eesliide on nimeliste klahvide jaoks, mis saabuvad enne esimest märki, näiteks muuteklahv. See ei tõmba tipitud eesliidet nagu
]C1vöötkoodi tekstist välja. - Kontrollige järelliidet. Tester teatab ENTER, TAB või Puudub. Kui Automaatne jäädvustus on sees, ilmub tulemus pärast Enterit, Tabi või lühikest pausi, kui klahvid peatuvad. Lülitage Automaatne jäädvustus välja, et hõivet hoida, kuni vajutate Peata. Enter ja Tab ei kuulu vöötkoodi stringi.
- Võrrelge seda tulemust kavandatud seadistusega. Seejärel avage klaviatuurisündmuste tester ja skannige uuesti, kui vajate iga
keydown-i järjekorras, sealhulgaskey,codeja ajastust.
Sisendi tester salvestab klaviatuurisündmused, mida brauser näeb. See ei saa jadaporti lugeda, seega ei saa see näidata CR-i ega LF-i toorbaitidena. Kiilutest ei tõenda, mida jadaseade saadab.
Tõrkeotsing
Skanner ei saada ENTER-it. Vöötkood ilmub ja kursor jääb väljale. Sisendi tester teatab Puudub. Järelliide on väljas või seatud millelegi muule kui Enter. Vt Vöötkoodiskanneril puudub ENTER.
TAB liigutab fookust ootamatult. Skanner saadab Tab-klahvi. See on seadistatud järelliide. Kasutage Enterit, kui vorm peaks saatma, või lugege väärtus Tabi keydown-il, kui töövoog peaks edasi liikuma. Üksikasjad on juhendis ENTER ja TAB järelliited vöötkoodiskannerites.
Vorm saadetakse kaks korda. Brauser saadab Enteril ja keydown-kuulaja võtab skanni samuti vastu. Hoidke üks lõpetamistee ja kutsuge teisel preventDefault().
Eesliide ilmub vöötkoodi sisse. Prinditav eesliide on hõivatud stringi osa. Keelake see skanneril või eemaldage see täpne jada rakenduses. Lubatud sümboloogia identifikaator on levinud allikas algavale märgile ] ja veel kahele märgile. Juht-eesliide, mida kiil tippida ei saa, puudub, selle asemel et nähtav olla.
Märgid on valed. Skanneri paigutus ja operatsioonisüsteemi paigutus võivad lahkneda, mis muudab eesliitemärke ja kirjavahemärke, samas kui pikkus jääb samaks. Vt Vöötkoodiskanneri vale klaviatuuripaigutus.
Rakendus ei näe kunagi skanni lõppu. Järelliidet ei ole ja leht ootab Enterit. Lisage järelliide, mis vormiga sobib, või lõpetage väärtus selge toiminguga. Ajastuse oletus jätab mõne päris skanni vahele ja võtab mõne tippimise vastu.
CR/LF erineb rakenduste vahel. Notepad lisab uue rea, kui saab Enteri. Veebi tekstisisend hoiab vöötkoodi ja käivitab klahvisündmuse. Jadaprogramm võib saada 0x0D, 0x0A või mõlemad. Võrrelge liidest, enne kui skannerit muudate. Kui ükski rakendus märke ei saa, alustage juhendist Vöötkoodiskanner ei tööta.
Laiem ülevaade fookusest, korduvatest skannidest ja POS-i voogudest on juhendis Kuidas testida vöötkoodiskanneri sisendit.
Testimaatriks
Seadistuse veerg on see, mille skanneril määrate, või see, mille emulaatoriga tipite, kui juhtum on klaviatuuri järelliide. Oodatav käitumine on see, mida rakendus peaks tegema. Jada CRLF juhtum ei ole sama test mis Enter-klahv brauseris.
| Seadistus | Oodatav rakenduse käitumine |
|---|---|
| Eesliidet ei ole, järelliidet ei ole | Vöötkoodi väärtus võetakse vastu ja lõpetamisklahvi ei saabu. Väärtus jääb kättesaadavaks, kuni rakendus selle loeb. |
| Eesliidet ei ole, ENTER-järelliide | Rakendus saab lõpetamisklahvi ühe korra ja salvestab andmesisu ilma lõpetajamärgita. |
| Eesliidet ei ole, TAB-järelliide | Fookus võib liikuda järgmisele juhtelemendile. Rakendus loeb väärtuse enne seda liikumist. |
| Kohandatud prinditav eesliide | Eesliitemärgid ilmuvad enne dekodeeritud andmeid. Rakendus hoiab või eemaldab selle täpse eesliite teadlikult. |
| Kohandatud prinditav järelliide | Järelliitemärgid ilmuvad pärast dekodeeritud andmeid. Enter ja Tab on klahvid, seega ei ilmu need stringi. |
| CRLF-jada | Jada- või terminalihost töötleb seadistatud CR- ja LF-baidid. Brauseri tekstiväli ei saa neid baite Enteri klahvivajutusest. |
Käivitage klaviatuuriread kiiluskanneril ja riistvara puudumisel emulaatori sätetega ENTER, TAB ja järelliite puudumine. Käivitage CRLF-rida liidesel, mis peaks neid baite kandma. Tegelikud tulemused sõltuvad ikka sellest liidesest ja rakendusest.