Barcode Scanner Emulator
Brūkšninių kodų skaitytuvo priešdėlis ir priesaga: išsamus vadovas
Priešdėlis yra duomenys arba valdymo seka, kurią brūkšninių kodų skaitytuvas siunčia prieš dekoduotą brūkšninį kodą. Priesaga yra tai, ką jis siunčia po tos reikšmės. Tą patį modelį galima nustatyti skirtingiems priešdėliams ir priesagoms, o nuoseklusis skaitytuvas jų neperduoda taip, kaip klaviatūros pleišto skaitytuvas.
Brūkšninių kodų skaitytuvo priešdėlis siunčiamas prieš dekoduotą reikšmę. Priesaga siunčiama po jos. Vienas skaitytuvas gali duoti tokią seką:
Priešdėlis: STX
Brūkšninis kodas: 123456789
Priesaga: ENTER
STX vadove dažnai reiškia valdymo ženklą, o ne tris raides S, T ir X. ENTER klaviatūros pleišto skaitytuve paprastai yra Enter klavišas, o ne du ženklai CR ir LF, įterpiami į teksto lauką. Kurį iš jų gausite, priklauso nuo modelio, sąsajos ir programos. Joks nustatymas nėra universalus.
Vadovas ENTER ir TAB priesagos brūkšninių kodų skaitytuvuose lieka prie tų dviejų užbaigiklių pasirinkimo ir trikčių šalinimo. Šis vadovas yra apie rėmą aplink brūkšninį kodą: kas eina prieš, kas eina po ir kaip žiniatinklio programa turėtų skaityti abu.
Kas yra brūkšninių kodų skaitytuvo priešdėlis?
Priešdėlis yra sukonfigūruota seka, kurią skaitytuvas perduoda prieš apkrovą. Apkrova yra tekstas, kurį dekodavo simbologija, pavyzdžiui 123456789. Priešdėlis nėra tos dekoduotės dalis, nebent skaitytuvas buvo nustatytas jį pridėti.
Įprasti naudojimo atvejai:
- Pažymėkite pranešimo pradžią. Nuosekliojo ryšio ir terminalo protokolai kartais siunčia valdymo ženklą, dažnai vadinamą STX, kad kompiuteris-šeimininkas žinotų, jog prasidėjo naujas kadras.
- Įvardykite simbologiją. Įjungus AIM simbologijos identifikatorių, skaitytuvas gali prieš skaitmenis nusiųsti trumpą spausdinamą priešdėlį, pavyzdžiui
]C1Code 128 arba]E0EAN. Programa gali šakotis pagal tą identifikatorių. - Nukreipkite įvestį senesnėje POS arba terminalo programinėje įrangoje. Fiksuotas kodas prieš duomenis sakydavo šeimininkui, kuriam laukui ar įrenginiui priklausė nuskaitymas.
- Pažymėkite konkrečią stotį. Dviem skaitytuvams galima duoti skirtingus spausdinamus priešdėlius, kad žurnalas rodytų, kuri juosta nusiuntė kodą.
Spausdinamas priešdėlis yra paprasti ženklai. Jie atsiranda teksto lauke eilutės pradžioje. Valdymo ženklo priešdėlis, pavyzdžiui STX (0x02), nėra raidės S, T ir X. Klaviatūros pleišto skaitytuvas gali iš viso negalėti įvesti to valdymo ženklo. Nuoseklusis skaitytuvas gali jį nusiųsti kaip baitą. Perskaitykite turimo modelio vadovą prieš rašydami kodą, kuris tikisi vieno arba kito.
Priešdėlis neįrodo, kad įvestį sukūrė skaitytuvas. Asmuo, makrokomanda arba Barcode Scanner Emulator gali įvesti tuos pačius ženklus. Laikykite priešdėlį rėmu, kurį sukonfigūravote, tada tikrinkite apkrovą taip, kaip tikrinate bet kurią kitą naudotojo įvestį.
Kas yra brūkšninių kodų skaitytuvo priesaga?
Priesaga yra sukonfigūruota seka, siunčiama po apkrovos. Įprasta jos užduotis yra pasakyti programai, kad nuskaitymas baigtas, arba perkelti fokusą. Skaitytuvai skiriasi. Vieni siūlo Enter, Tab, CR, LF, CR+LF, pasirinktinę eilutę arba nieko. Kiti siūlo tik vieną ar du iš jų.
ENTER. Enter klavišas. Naršyklėje tai klaviatūros įvykis, event.key === "Enter". Jis neįterpiamas į įprastą teksto įvestį.
TAB. Tab klavišas, event.key === "Tab". Naršyklė perkelia fokusą į kitą valdiklį. Klavišas neįterpiamas į lauką.
CR. Grįžimas į eilutės pradžią, ASCII 0x0D. Nuosekliojoje arba terminalo sąsajoje tai gali būti tikras baitas po apkrovos. Klaviatūros pleište nustatymas, pažymėtas CR arba grįžimu į eilutės pradžią, paprastai reiškia Enter klavišą. Naršyklė vis tiek praneša Enter. Lauko reikšmė negauna CR ženklo.
LF. Eilutės patraukimas, ASCII 0x0A. Tai kitas valdymo ženklas nei CR. Nuosekliajame sraute jis gali būti atskiras baitas. Klaviatūros pleištas neturi standartinio eilutės patraukimo klavišo taip, kaip turi Enter ir Tab. Nemanykite, kad meniu elementas pavadinimu LF įveda matomą ženklą arba antrą Enter.
CRLF. CR, po jo LF, du baitai 0x0D 0x0A. Kai kurie nuosekliojo ryšio ir terminalo šeimininkai tikisi tos poros kaip eilutės pabaigos. Naršyklės teksto laukas tos poros neįrašo, kai kas nors paspaudžia Enter.
Pasirinktiniai ženklai. Spausdinama priesaga, pavyzdžiui # arba trumpas kodas, įvedama po brūkšninio kodo, todėl tampa eilutės dalimi, nebent programa ją pašalina. Pasirinktinis valdymo ženklas laikosi to paties skirstymo kaip STX: baitai nuosekliajame prievade, klavišų paspaudimai pleište ir tik tie klavišų paspaudimai, kuriuos klaviatūros sąsaja iš tikrųjų gali nusiųsti.
ENTER, CR ir LF vadovuose yra susiję pavadinimai reikšmei „eilutės pabaiga”. Jie nėra sukeičiami kiekvienoje programoje. Pleišto skaitytuvas, nuoseklusis skaitytuvas, Notepad ir žiniatinklio forma gali parodyti skirtingą rezultatą nustatymui tuo pačiu pavadinimu.
Priešdėlis ir priesaga
| Savybė | Priešdėlis | Priesaga |
|---|---|---|
| Vieta | Prieš brūkšninio kodo duomenis | Po brūkšninio kodo duomenų |
| Paskirtis | Pažymėti pradžią arba pažymėti įvestį | Pažymėti pabaigą arba suaktyvinti veiksmą |
| Pavyzdys | STX arba spausdinamas AIM identifikatorius, pavyzdžiui ]C1 |
ENTER, TAB arba spausdinamas ženklas, pavyzdžiui # |
| Įprastas naudojimas | Įrėminti arba atpažinti nuskaitymą | Pateikti formą arba perkelti fokusą |
| Teksto lauke | Spausdinami ženklai yra reikšmės pradžioje | Spausdinami ženklai yra pabaigoje. Enter ir Tab nėra |
| Tapatybė | Sukonfigūruotas žymeklis, kurį gali įvesti bet kas | Sukonfigūruotas žymeklis, kurį gali įvesti bet kas |
Šalinkite priešdėlį arba pasirinktinę priesagą tik tada, kai sukonfigūravote būtent tą seką ir įrašytas įrašas neturi jos apimti. Palikite AIM identifikatorių vietoje, kol programa turi jam taisyklę.
ENTER, TAB, CR ir LF
Šie pavadinimai pasirodo konfigūravimo lapuose. Priimančioji pusė mato arba klavišų paspaudimus, arba baitus, priklausomai nuo sąsajos. Vadovas HID klaviatūros pleištas aprašo klavišų paspaudimų kelią. Nuoseklusis prievadas yra kitas kelias: programa skaito baitus, o fokusas nepasirenka, kur jie eina.
ENTER
Klaviatūros pleišto skaitytuve ENTER yra Enter klavišas. Vienos eilutės teksto lauke dabartinės naršyklės tuo klavišu pateikia apimančią formą. Paieškos laukas gali patvirtinti nuskaitymą tuo įvykiu. Kelių laukų forma gali būti pateikta dar neužpildžius vėlesnių laukų. Kvieskite preventDefault() įvykyje submit arba Enter keydown, kai puslapis turi pasilikti reikšmę ir likti vietoje. Apdorokite Enter vienoje vietoje. keydown klausytojas ir submit klausytojas, kurie abu priima nuskaitymą, įrašys jį du kartus.
Kai kurie skaitytuvai siunčia NumPad Enter. event.key vis tiek yra "Enter". event.code gali būti "NumpadEnter", o ne "Enter". Tikrinkite event.key, jei abu klavišai turi patvirtinti lauką.
Vadovas ENTER ir TAB priesagos brūkšninių kodų skaitytuvuose lygina tuos du pasirinkimus POS ir žiniatinklio formoms. Brūkšninių kodų skaitytuvui trūksta ENTER apima skaitytuvą, kuris įveda brūkšninį kodą ir tada sustoja.
TAB
TAB yra Tab klavišas. Naršyklė perkelia fokusą po keydown. Skaitykite lauką tame keydown apdorojime, kol jis dar turi fokusą, ir palikite numatytąjį veiksmą, kai kitas valdiklis turi gauti žymeklį. preventDefault() išlaiko fokusą dabartiniame lauke.
Shift+Tab yra tas pats klavišas laikant Shift. Skaitytuvo Tab priesaga yra Tab be Shift. Ignoruokite event.shiftKey, jei klaviatūros naudotojai turi galėti judėti atgal per formą.
CR
Grįžimas į eilutės pradžią perkelia žymeklį į eilutės pradžią terminale. Baitas yra 0x0D. Nuoseklusis skaitytuvas gali tą baitą pridėti prie apkrovos. Klaviatūros pleišto nustatymas pavadinimu CR paprastai siunčia Enter klavišą, užuot įterpęs 0x0D į tekstą. Enter paspaudimas naršyklės įvestyje neįrašo CR ženklo į input.value.
Jei šeimininkas yra terminalas arba COM prievado klausytojas, ieškokite baito. Jei šeimininkas yra tinklalapis, ieškokite event.key === "Enter".
LF
Eilutės patraukimas perkelia terminalo žymeklį viena eilute žemyn. Baitas yra 0x0A. Kai kurie šeimininkai vien LF laiko nauja eilute. Kiti jį ignoruoja, jei CR neatėjo pirmas. Pleišto skaitytuvas, kuris LF nurodo kaip priesagą, gali nusiųsti klavišą, kurio operacinė sistema nepaverčia eilutės lūžiu, arba gali nusiųsti nieko, ką teksto laukas išsaugotų. Užfiksuokite klavišą klaviatūros įvykių testeryje, prieš apdorodami tariamą LF programos kode.
CRLF
CRLF yra dviejų valdymo ženklų seka CR, tada LF. Windows stiliaus tekstiniai failai ir daugelis nuosekliųjų įrenginių naudoja ją kaip vieną naują eilutę. Konfigūravimo puslapis, kuriame parašyta „CRLF priesaga”, reiškia, kad skaitytuvas bandys nusiųsti tą porą po apkrovos sąsaja, kurią naudoja.
Naršyklėje Enter paspaudimas nesukuria pažodinės CRLF sekos teksto įvestyje. Forma gauna klaviatūros įvykį. <textarea> gali įterpti naują eilutę, kai naudotojas paspaudžia Enter, ir ta nauja eilutė yra pačios naršyklės redagavimo elgsena, o ne įrodymas, kad skaitytuvas išleido baitus 0x0D 0x0A. Nuoseklusis skaitytuvas gali gauti tuos du baitus ir turėtų juos laikyti užbaigikliu tik jei tas skaitytuvas buvo sukonfigūruotas juos siųsti. Nešalinkite CR arba LF iš apkrovos vidurio, kuriai leidžiama juos turėti.
Kaip priešdėliai ir priesagos veikia žiniatinklio programas
Klaviatūros pleišto nuskaitymas yra klavišų paspaudimų pliūpsnis į sufokusuotą valdiklį. Puslapis neatidaro skaitytuvo. Jei fokusas yra kitame lauke, priešdėlis, brūkšninis kodas ir priesaga visi nueina ten.
keydown suveikia kiekvienam klavišui, įskaitant Enter ir Tab, prieš naršyklei įterpiant ženklą arba perkeliant fokusą. event.key yra ženklas arba klavišo pavadinimas po to, kai operacinė sistema pritaiko klaviatūros išdėstymą. Spausdinami priešdėlio ir priesagos ženklai lauke pasirodo per įvykį input. Enter ir Tab nepasirodo.
Žemiau esantis klausytojas patvirtina lauką, kai ateina Enter. Jis neprideda priesagos, kurią skaitytuvas praleido. Jei skaitytuvas nesiunčia Enter, reikšmė lieka lauke, kol kas nors kitas ją perskaito.
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 = ''
})
Sufokusuokite #barcode prieš nuskaitymą. preventDefault() sustabdo protėvio formą nuo antro pateikimo. Jei įvestis nėra formoje ir norite savitojo pateikimo, praleiskite preventDefault().
Be priesagos palaukite aiškaus veiksmo: mygtuko, vėlesnio operatoriaus Enter arba kito darbo eigos žingsnio. Neveiklos laikmatis gali pauzę laikyti nuskaitymo pabaiga. Tas laikmatis yra euristika. Lėtas skaitytuvas, Bluetooth delsa arba greitai spausdinantis žmogus gali atsidurti neteisingoje jo pusėje. Rinkitės sukonfigūruotą priesagą, kai darbo eigai reikia aiškios pabaigos.
Žinomą spausdinamą priešdėlį galima pašalinti perskaičius reikšmę:
function withoutConfiguredPrefix(value, prefix) {
if (prefix && value.startsWith(prefix)) {
return value.slice(prefix.length)
}
return value
}
Perduokite tik sukonfigūruotą priešdėlį, pavyzdžiui ']C1'. Nešalinkite bet kokio ženklų skaičiaus iš kiekvieno nuskaitymo.
Visa forma, kuri taip pat apdoroja Tab, tuščią įvestį ir antrą nuskaitymą, aprašyta vadove Kaip testuoti brūkšninių kodų skaitytuvus žiniatinklio programose.
Kaip konfigūruoti priešdėlius ir priesagas
Priešdėlio ir priesagos nustatymai yra skaitytuve. Klavišų pavadinimai ir būdas, kuriuo juos keičiate, priklauso nuo gamintojo. Nėra konfigūravimo brūkšninio kodo, kuris veiktų kiekviename prekės ženkle, ir šis vadovas jo nespausdina.
Įprasti būdai:
- Nuskaitykite konfigūravimo brūkšninį kodą iš būtent to modelio vadovo. Lapas sugrupuotas pagal nustatymą: priesaga, priešdėlis, klaviatūros išdėstymas, simbologija.
- Naudokite gamintojo konfigūravimo programą, tada įrašykite rezultatą į skaitytuvą per USB.
- Naudokite tos produktų linijos įrenginių valdymo priemonę, kai atnaujinate daug vienetų.
Po pakeitimo nuskaitykite žinomą brūkšninį kodą ir palyginkite rezultatą su vadovo aprašymu nustatyme, kurį pasirinkote. Kito prekės ženklo gamyklinis atkūrimas gali palikti skaitytuvą nepakeistą arba įjungti netikėtą režimą. Vadovas Brūkšninių kodų skaitytuvo konfigūravimas apibendrina nustatymus, kurie paprastai svarbūs. Jis nepakeičia vadovo.
Barcode Scanner Emulator gali įvesti jūsų pasirinktą reikšmę ir tada nusiųsti ENTER, TAB arba jokios priesagos. Įdėkite spausdinamą priešdėlį į tą reikšmę, kai reikia išbandyti priešdėlio apdorojimą be aparatinės įrangos. Emuliatorius neišleidžia nuosekliosios CR/LF baitų poros ir neskaito etiketės.
Kaip testuoti priešdėlio ir priesagos elgseną
Naudokite skaitytuvą, kuris yra klaviatūros režimu, USB HID klaviatūra arba Bluetooth HID klaviatūra.
- Prijunkite jį ir palaukite, kol jis parodys, kad turi maitinimą.
- Atidarykite brūkšninio kodo įvesties testerį.
- Spustelėkite Pradėti testą arba spustelėkite nuskaitymo sritį. Ji tampa mėlyna, kai yra pasirengusi. Puslapis pats neperima fokuso.
- Nuskaitykite brūkšninį kodą, kurio apkrovą jau žinote.
- Perskaitykite užfiksuotą reikšmę ir ženklų skaičių. Spausdinami priešdėlio arba priesagos ženklai yra toje eilutėje. Eilutė Priešdėlis skirta įvardytiems klavišams, kurie ateina prieš pirmą ženklą, pavyzdžiui modifikatoriui. Ji neištraukia įvesto priešdėlio, tokio kaip
]C1, iš brūkšninio kodo teksto. - Patikrinkite priesagą. Testeris praneša ENTER, TAB arba Nėra. Kai Automatinis fiksavimas įjungtas, rezultatas pasirodo po Enter, Tab arba trumpos pauzės, kai klavišai sustoja. Išjunkite Automatinis fiksavimas, kad fiksavimas būtų laikomas, kol paspausite Stabdyti. Enter ir Tab nėra brūkšninio kodo eilutės dalis.
- Palyginkite tą rezultatą su konfigūracija, kurios siekėte. Tada atidarykite klaviatūros įvykių testerį ir nuskaitykite dar kartą, kai reikia kiekvieno
keydowniš eilės, įskaitantkey,codeir laiką.
Įvesties testeris registruoja klaviatūros įvykius, kuriuos naršyklė gali matyti. Jis negali skaityti nuosekliojo prievado, todėl negali parodyti CR arba LF kaip neapdorotų baitų. Pleišto testas neįrodo, ką nusiųs nuoseklusis nustatymas.
Trikčių šalinimas
Skaitytuvas nesiunčia ENTER. Brūkšninis kodas pasirodo ir žymeklis lieka lauke. Įvesties testeris praneša Nėra. Priesaga išjungta arba nustatyta kam nors kitam nei Enter. Žr. Brūkšninių kodų skaitytuvui trūksta ENTER.
TAB netikėtai perkelia fokusą. Skaitytuvas siunčia Tab klavišą. Tai sukonfigūruota priesaga. Naudokite Enter, kai forma turi būti pateikta, arba skaitykite reikšmę per Tab keydown, kai darbo eiga turi judėti pirmyn. Išsamiau vadove ENTER ir TAB priesagos brūkšninių kodų skaitytuvuose.
Forma pateikiama du kartus. Naršyklė pateikia paspaudus Enter, o keydown klausytojas taip pat priima nuskaitymą. Palikite vieną užbaigimo kelią ir kitame kvieskite preventDefault().
Priešdėlis pasirodo brūkšninio kodo viduje. Spausdinamas priešdėlis yra užfiksuotos eilutės dalis. Išjunkite jį skaitytuve arba pašalinkite būtent tą seką programoje. Įjungtas simbologijos identifikatorius yra dažnas šaltinis priekyje esančio ] ir dar dviejų ženklų. Valdymo priešdėlis, kurio pleištas negali įvesti, bus dingęs, o ne matomas.
Ženklai neteisingi. Skaitytuvo išdėstymas ir operacinės sistemos išdėstymas gali nesutapti, todėl keičiasi priešdėlio ženklai ir skyryba, o ilgis lieka toks pat. Žr. Neteisingas brūkšninių kodų skaitytuvo klaviatūros išdėstymas.
Programa niekada nemato nuskaitymo pabaigos. Priesagos nėra, o puslapis laukia Enter. Pridėkite priesagą, kuri atitinka formą, arba užbaikite reikšmę aiškiu veiksmu. Laiko spėjimas praleis kai kuriuos tikrus nuskaitymus ir priims šiek tiek spausdinimo.
CR/LF skiriasi tarp programų. Notepad įterpia naują eilutę, kai gauna Enter. Žiniatinklio teksto įvestis išlaiko brūkšninį kodą ir paleidžia klavišo įvykį. Nuoseklioji programa gali gauti 0x0D, 0x0A arba abu. Palyginkite sąsają prieš keisdami skaitytuvą. Jei jokia programa negauna ženklų, pradėkite nuo Brūkšninių kodų skaitytuvas neveikia.
Platesnė apžvalga apie fokusą, pakartotinius nuskaitymus ir POS srautus yra vadove Kaip testuoti brūkšninių kodų skaitytuvo įvestį.
Testų matrica
Konfigūracijos stulpelis yra tai, ką nustatote skaitytuve, arba tai, ką įvedate emuliatoriumi, kai atvejis yra klaviatūros priesaga. Laukiama elgsena yra tai, ką programa turėtų daryti. Nuoseklusis CRLF atvejis nėra tas pats testas kaip Enter klavišas naršyklėje.
| Konfigūracija | Laukiama programos elgsena |
|---|---|
| Nėra priešdėlio, nėra priesagos | Brūkšninio kodo reikšmė gaunama ir užbaigimo klavišas neateina. Reikšmė lieka prieinama, kol programa ją perskaito. |
| Nėra priešdėlio, ENTER priesaga | Programa užbaigimo klavišą gauna vieną kartą ir išsaugo apkrovą be užbaigiklio ženklo. |
| Nėra priešdėlio, TAB priesaga | Fokusas gali persikelti į kitą valdiklį. Programa perskaito reikšmę prieš tą perkėlimą. |
| Pasirinktinis spausdinamas priešdėlis | Priešdėlio ženklai pasirodo prieš dekoduotus duomenis. Programa sąmoningai palieka arba pašalina būtent tą priešdėlį. |
| Pasirinktinė spausdinama priesaga | Priesagos ženklai pasirodo po dekoduotų duomenų. Enter ir Tab yra klavišai, todėl eilutėje nepasirodo. |
| CRLF seka | Nuoseklusis arba terminalo šeimininkas apdoroja sukonfigūruotus CR ir LF baitus. Naršyklės teksto laukas tų baitų negauna iš Enter klavišo paspaudimo. |
Klaviatūros eilutes vykdykite pleišto skaitytuve ir, kai nėra aparatinės įrangos, emuliatoriaus nustatymais ENTER, TAB ir be priesagos. CRLF eilutę vykdykite sąsajoje, kuri turi nešti tuos baitus. Tikrieji rezultatai vis tiek priklauso nuo tos sąsajos ir nuo programos.