Barcode Scanner Emulator
Prefiks i sufiks u skenerima barkoda: potpuni vodič
Prefiks su podaci ili upravljački niz koji skener barkoda pošalje prije dekodiranog barkoda. Sufiks je ono što pošalje nakon te vrijednosti. Isti se model može postaviti na različite prefikse i sufikse, a serijski skener ne isporučuje ih na isti način kao skener u načinu tipkovničkog klina.
Prefiks skenera barkoda šalje se prije dekodirane vrijednosti. Sufiks se šalje nakon nje. Jedan skener može proizvesti ovaj niz:
Prefiks: STX
Barkod: 123456789
Sufiks: ENTER
STX u priručniku obično znači kontrolni znak, a ne tri slova S, T i X. ENTER na skeneru u načinu tipkovničkog klina obično je tipka Enter, a ne dva znaka CR i LF umetnuta u tekstualno polje. Što od toga stigne ovisi o modelu, sučelju i aplikaciji. Nijedna postavka nije univerzalna.
Vodič Sufiksi ENTER i TAB u skenerima barkoda ostaje na odabiru i provjeri tih dvaju završnih tipki. Ovaj vodič govori o okviru oko barkoda: što dolazi prije, što dolazi poslije i kako web-aplikacija treba čitati oboje.
Što je prefiks skenera barkoda
Prefiks je konfigurirani niz koji skener prenese prije sadržaja. Sadržaj je tekst koji je simbologija dekodirala, na primjer 123456789. Prefiks nije dio tog dekodiranja osim ako skener nije postavljen da ga doda.
Uobičajene namjene:
- Označiti početak poruke. Serijski i terminalski protokoli ponekad pošalju kontrolni znak, često zvan STX, kako bi domaćin znao da je počeo novi okvir.
- Imenovati simbologiju. Kad je uključen identifikator simbologije AIM, skener može poslati kratki ispisivi prefiks, primjerice
]C1za Code 128 ili]E0za EAN, prije znamenki. Aplikacija se može granati prema tom identifikatoru. - Usmjeriti unos u starijem POS ili terminalskom softveru. Fiksni kod prije podataka govorio je domaćinu kojem polju ili uređaju skeniranje pripada.
- Označiti određeno mjesto. Dvama skenerima mogu se dati različiti ispisivi prefiksi kako bi zapisnik pokazao koja je traka poslala kod.
Ispisivi prefiks obični su znakovi. Pojavljuju se u tekstualnom polju na početku niza. Prefiks od kontrolnog znaka, poput STX (0x02), nisu slova S, T i X. Skener u načinu tipkovničkog klina taj kontrolni znak možda uopće ne može utipkati. Serijski ga skener može poslati kao bajt. Pročitajte priručnik za svoj model prije nego što napišete kod koji očekuje jedno ili drugo.
Prefiks ne dokazuje da je unos proizveo skener. Osoba, makro ili Barcode Scanner Emulator mogu utipkati iste znakove. Prefiks shvatite kao okvir koji ste konfigurirali, a sadržaj provjerite onako kako provjeravate svaki drugi korisnički unos.
Što je sufiks skenera barkoda
Sufiks je konfigurirani niz poslan nakon sadržaja. Uobičajeni mu je posao reći aplikaciji da je skeniranje gotovo ili premjestiti fokus. Skeneri se razlikuju. Neki nude Enter, Tab, CR, LF, CR+LF, vlastiti niz ili ništa. Neki nude samo jednu ili dvije od tih mogućnosti.
ENTER. Tipka Enter. U pregledniku to je događaj tipkovnice, event.key === "Enter". Ne umeće se u obično tekstualno polje.
TAB. Tipka Tab, event.key === "Tab". Preglednik premješta fokus na sljedeći element. Tipka se ne umeće u polje.
CR. Povratak retka, ASCII 0x0D. Na serijskom ili terminalskom sučelju to može biti stvarni bajt nakon sadržaja. Na tipkovničkom klinu postavka označena kao CR ili povratak retka obično znači tipku Enter. Preglednik i dalje javlja Enter. Vrijednost polja ne dobiva znak CR.
LF. Pomak retka, ASCII 0x0A. To je drugi kontrolni znak, različit od CR. U serijskom toku može biti vlastiti bajt. Tipkovnički klin nema standardnu tipku pomaka retka onako kako ima Enter i Tab. Ne pretpostavljajte da stavka izbornika imenovana LF utipka vidljivi znak ili drugi Enter.
CRLF. CR pa zatim LF, dva bajta 0x0D 0x0A. Neki serijski i terminalski domaćini očekuju taj par kao kraj retka. Tekstualno polje preglednika ne sprema taj par kad netko pritisne Enter.
Vlastiti znakovi. Ispisivi sufiks, primjerice # ili kratki kod, utipka se nakon barkoda, pa postaje dio niza osim ako ga aplikacija ne ukloni. Vlastiti kontrolni znak slijedi istu podjelu kao STX: bajtovi na serijskom priključku, pritisci na klinu i samo oni pritisci koje sučelje tipkovnice stvarno može poslati.
ENTER, CR i LF srodna su imena za „kraj retka” u priručnicima. Nisu međusobno zamjenjivi u svakoj aplikaciji. Klin-skener, serijski skener, Notepad i web-obrazac mogu pokazati različit rezultat za postavku s istim imenom.
Prefiks i sufiks
| Svojstvo | Prefiks | Sufiks |
|---|---|---|
| Položaj | Prije podataka barkoda | Nakon podataka barkoda |
| Svrha | Označiti početak ili označiti unos | Označiti završetak ili pokrenuti radnju |
| Primjer | STX ili ispisivi identifikator AIM, primjerice ]C1 |
ENTER, TAB ili ispisivi znak, primjerice # |
| Uobičajena uporaba | Uokviriti ili prepoznati skeniranje | Poslati obrazac ili premjestiti fokus |
| U tekstualnom polju | Ispisivi znakovi stoje na početku vrijednosti | Ispisivi znakovi stoje na kraju. Enter i Tab ne |
| Narav | Konfigurirana oznaka koju može utipkati bilo tko | Konfigurirana oznaka koju može utipkati bilo tko |
Uklonite prefiks ili vlastiti sufiks samo kad ste konfigurirali točno taj niz i spremljeni zapis ne smije ga sadržavati. Identifikator AIM ostavite dok aplikacija nema pravilo za njega.
ENTER, TAB, CR i LF
Ta se imena pojavljuju na listovima konfiguracije. Primateljska strana vidi ili pritiske, ili bajtove, ovisno o sučelju. Vodič Tipkovnički klin HID opisuje put pritisaka. Serijski priključak drugi je put: aplikacija čita bajtove, a fokus ne bira kamo idu.
ENTER
Na skeneru u načinu tipkovničkog klina ENTER je tipka Enter. U jednorednom tekstualnom polju današnji preglednici tom tipkom šalju okolni obrazac. Okvir za pretraživanje može potvrditi skeniranje na tom događaju. Obrazac s više polja može se poslati prije nego što se popune kasnija polja. Pozovite preventDefault() na događaju submit ili na keydown tipke Enter kad stranica treba zadržati vrijednost i ostati. Enter obradite na jednom mjestu. Slušatelj keydown i slušatelj submit koji oba prihvate skeniranje zapisat će ga dvaput.
Neki skeneri šalju NumPad Enter. event.key i dalje je "Enter". event.code može biti "NumpadEnter", a ne "Enter". Provjeravajte event.key ako obje tipke trebaju potvrditi polje.
Vodič Sufiksi ENTER i TAB u skenerima barkoda uspoređuje ta dva izbora za POS i web-obrasce. Skeneru barkoda nedostaje ENTER pokriva skener koji utipka barkod i zatim stane.
TAB
TAB je tipka Tab. Preglednik premješta fokus nakon keydown. Pročitajte polje u tom rukovatelju keydown, dok još ima fokus, i ostavite zadanu radnju kad sljedeći element treba primiti kursor. preventDefault() zadržava fokus na trenutačnom polju.
Shift+Tab ista je tipka s pritisnutim Shift. Sufiks Tab na skeneru jest Tab bez Shift. Zanemarite event.shiftKey ako korisnici tipkovnice moraju moći ići unatrag kroz obrazac.
CR
Povratak retka pomiče kursor na početak retka u terminalu. Bajt je 0x0D. Serijski skener može taj bajt dodati sadržaju. Postavka tipkovničkog klina imenovana CR obično šalje tipku Enter, a ne umeće 0x0D u tekst. Pritisak Enter u polju preglednika ne upisuje znak CR u input.value.
Ako je domaćin terminal ili program koji sluša COM priključak, tražite bajt. Ako je domaćin web-stranica, tražite event.key === "Enter".
LF
Pomak retka pomiče kursor terminala za jedan redak prema dolje. Bajt je 0x0A. Neki domaćini sam LF tretiraju kao novi redak. Drugi ga zanemaruju ako prije nije došao CR. Klin-skener koji navodi LF kao sufiks može poslati tipku koju operacijski sustav ne pretvara u prijelom retka, ili ne poslati ništa što će tekstualno polje zadržati. Uhvatite tipku u testeru događaja tipkovnice prije nego što u kodu aplikacije obradite navodni LF.
CRLF
CRLF je niz od dva kontrolna znaka, prvo CR pa LF. Tekstualne datoteke u stilu Windowsa i mnogi serijski uređaji rabe ga kao jedan novi redak. Stranica konfiguracije koja kaže „sufiks CRLF” znači da će skener pokušati poslati taj par nakon sadržaja na sučelju koje koristi.
U pregledniku pritisak Enter ne stvara doslovni niz CRLF unutar tekstualnog polja. Obrazac prima događaj tipkovnice. <textarea> može umetnuti novi redak kad korisnik pritisne Enter, a taj je novi redak vlastito ponašanje uređivanja preglednika, a ne dokaz da je skener odaslao bajtove 0x0D 0x0A. Serijski čitač može primiti ta dva bajta i treba ih tretirati kao završetak samo ako je taj skener bio konfiguriran da ih šalje. Ne uklanjajte CR ili LF iz sredine sadržaja kojemu je dopušteno da ih sadrži.
Kako prefiksi i sufiksi utječu na web-aplikacije
Skeniranje tipkovničkim klinom niz je pritisaka u element koji ima fokus. Stranica ne otvara skener. Ako je fokus na drugom polju, prefiks, barkod i sufiks odlaze onamo.
keydown se okida za svaku tipku, uključujući Enter i Tab, prije nego što preglednik umetne znak ili premjesti fokus. event.key je znak ili ime tipke nakon što operacijski sustav primijeni raspored tipkovnice. Ispisivi znakovi prefiksa i sufiksa pojavljuju se u polju kroz događaj input. Enter i Tab ne.
Slušatelj u nastavku potvrđuje polje kad stigne Enter. Ne dodaje sufiks koji je skener izostavio. Ako skener ne šalje Enter, vrijednost ostaje u polju dok je nešto drugo ne pročita.
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 = ''
})
Dajte fokus na #barcode prije skeniranja. preventDefault() sprječava da se nadređeni obrazac pošalje drugi put. Ako polje nije unutar obrasca i želite izvorno slanje, izostavite preventDefault().
Bez sufiksa čekajte izričitu radnju: gumb, kasniji Enter od operatera ili sljedeći korak tijeka. Vremensko ograničenje neaktivnosti može stanku uzeti kao kraj skeniranja. To je heuristika. Spor skener, kašnjenje Bluetootha ili brzo tipkanje mogu pasti na krivu stranu praga. Kad tijek treba siguran kraj, radije postavite konfigurirani sufiks.
Poznati ispisivi prefiks može se ukloniti nakon što pročitate vrijednost:
function withoutConfiguredPrefix(value, prefix) {
if (prefix && value.startsWith(prefix)) {
return value.slice(prefix.length)
}
return value
}
Proslijedite samo prefiks koji ste konfigurirali, primjerice ']C1'. Ne odrezujte proizvoljan broj znakova sa svakog skeniranja.
Potpuni obrazac koji obrađuje i Tab, prazan unos i drugo skeniranje opisan je u vodiču Kako testirati skenere barkoda u web-aplikacijama.
Kako konfigurirati prefikse i sufikse
Postavke prefiksa i sufiksa žive na skeneru. Nazivi stavki i način njihove promjene ovise o proizvođaču. Nema konfiguracijskog barkoda koji radi na svakoj marki, a ovaj vodič takav ne ispisuje.
Tipični načini:
- Skenirajte konfiguracijski barkod iz priručnika za točan model. List je grupiran po postavci: sufiks, prefiks, raspored tipkovnice, simbologija.
- Upotrijebite proizvođačev program za konfiguraciju, zatim rezultat zapišite u skener preko USB-a.
- Upotrijebite alat za upravljanje uređajima te linije proizvoda kad ažurirate mnogo jedinica.
Nakon promjene skenirajte poznati barkod i usporedite rezultat s opisom odabrane postavke u priručniku. Vraćanje na tvorničke postavke s druge marke može ostaviti skener nepromijenjenim ili ga staviti u neočekivani način. Vodič Konfiguracija skenera barkoda sažima postavke koje obično imaju značenje. Ne zamjenjuje priručnik uređaja.
Barcode Scanner Emulator može utipkati vrijednost koju odaberete i zatim poslati ENTER, TAB ili nikakav sufiks. Stavite ispisivi prefiks u tu vrijednost kad trebate provjeriti obradu prefiksa bez hardvera. Emulator ne odašilje serijski par bajtova CR/LF i ne čita naljepnicu.
Kako testirati ponašanje prefiksa i sufiksa
Upotrijebite skener u načinu tipkovnice, USB HID tipkovnicu ili Bluetooth HID tipkovnicu.
- Spojite ga i pričekajte dok ne pokaže da ima napajanje.
- Otvorite tester unosa barkoda.
- Kliknite Pokrenite test ili kliknite područje skeniranja. Poplavi kad je spremno. Stranica sama ne preuzima fokus.
- Skenirajte barkod čiji sadržaj već znate.
- Pročitajte uhvaćenu vrijednost i broj znakova. Ispisivi znakovi prefiksa ili sufiksa nalaze se unutar tog niza. Redak Prefiks namijenjen je imenovanim tipkama koje stignu prije prvog znaka, primjerice modifikatoru. Ne izvlači utipkani prefiks poput
]C1iz teksta barkoda. - Provjerite sufiks. Tester javlja ENTER, TAB ili Nema. Kad je Automatsko hvatanje uključeno, rezultat se pojavi nakon Enter, Tab ili kratke stanke čim tipke prestanu. Isključite Automatsko hvatanje kako biste hvatanje zadržali dok ne pritisnete Zaustavite. Enter i Tab nisu dio niza barkoda.
- Usporedite taj rezultat s konfiguracijom koju ste namjeravali. Zatim otvorite tester događaja tipkovnice i skenirajte ponovno kad vam treba svaki
keydownredom, uključujućikey,codei vrijeme.
Tester unosa bilježi događaje tipkovnice koje preglednik vidi. Ne može čitati serijski priključak, pa ne može pokazati CR ili LF kao sirove bajtove. Test klina ne dokazuje što će poslati serijska postavka.
Rješavanje problema
Skener ne šalje ENTER. Barkod se pojavi, a kursor ostaje u polju. Tester unosa javlja Nema. Sufiks je isključen ili je postavljen na nešto drugo osim Enter. Pogledajte Skeneru barkoda nedostaje ENTER.
TAB neočekivano premješta fokus. Skener šalje tipku Tab. To je konfigurirani sufiks. Upotrijebite Enter kad se obrazac treba poslati ili čitajte vrijednost na keydown tipke Tab kad tijek treba napredovati. Pojedinosti su u vodiču Sufiksi ENTER i TAB u skenerima barkoda.
Obrazac se šalje dvaput. Preglednik ga šalje na Enter, a slušatelj keydown također prihvaća skeniranje. Ostavite jedan put završetka i na drugome pozovite preventDefault().
Prefiks se pojavi unutar barkoda. Ispisivi prefiks dio je uhvaćenog niza. Ili ga isključite na skeneru, ili u aplikaciji uklonite točno taj niz. Uključeni identifikator simbologije čest je izvor vodećeg ] i još dva znaka. Kontrolni prefiks koji klin ne može utipkati nedostajat će, neće biti vidljiv.
Znakovi su pogrešni. Raspored tipkovnice skenera i raspored operacijskog sustava mogu se razići, što mijenja znakove prefiksa i interpunkciju, dok duljina ostaje ista. Pogledajte Pogrešan raspored tipkovnice skenera barkoda.
Aplikacija nikad ne vidi kraj skeniranja. Nema sufiksa, a stranica čeka Enter. Dodajte sufiks koji odgovara obrascu ili vrijednost dovršite izričitom radnjom. Procjena po vremenu propustit će neka stvarna skeniranja i prihvatiti dio tipkanja.
CR/LF razlikuje se među aplikacijama. Notepad umeće novi redak kad primi Enter. Web-tekstualno polje zadržava barkod i okida događaj tipke. Serijski program može primiti 0x0D, 0x0A ili oba. Usporedite sučelje prije nego što promijenite skener. Ako nijedna aplikacija ne prima znakove, počnite s Skener barkoda ne radi.
Širi prolaz kroz fokus, ponovljena skeniranja i POS tijekove nalazi se u vodiču Kako testirati unos skenera barkoda.
Testna matrica
Stupac konfiguracije jest ono što postavite na skeneru ili ono što utipkate emulatorom kad je slučaj tipkovnički sufiks. Očekivano ponašanje jest ono što aplikacija treba učiniti. Slučaj serijskog CRLF nije isti test kao tipka Enter u pregledniku.
| Konfiguracija | Očekivano ponašanje aplikacije |
|---|---|
| Bez prefiksa, bez sufiksa | Vrijednost barkoda je primljena i ne stiže završna tipka. Vrijednost ostaje dostupna dok je aplikacija ne pročita. |
| Bez prefiksa, sufiks ENTER | Aplikacija primi završnu tipku jednom i spremi sadržaj bez završnog znaka. |
| Bez prefiksa, sufiks TAB | Fokus se može premjestiti na sljedeći element. Aplikacija čita vrijednost prije tog premještanja. |
| Vlastiti ispisivi prefiks | Znakovi prefiksa pojavljuju se prije dekodiranih podataka. Aplikacija namjerno zadržava ili uklanja točno taj prefiks. |
| Vlastiti ispisivi sufiks | Znakovi sufiksa pojavljuju se nakon dekodiranih podataka. Enter i Tab su tipke, pa se ne pojavljuju u nizu. |
| Niz CRLF | Serijski ili terminalski domaćin obrađuje konfigurirane bajtove CR i LF. Tekstualno polje preglednika te bajtove ne dobiva od pritiska Enter. |
Tipkovničke retke pokrenite na klin-skeneru i, kad hardvera nema, s postavkama emulatora ENTER, TAB i bez sufiksa. Redak CRLF pokrenite na sučelju koje treba nositi te bajtove. Stvarni rezultat i dalje ovisi o tom sučelju i o aplikaciji.