Barcode Scanner Emulator
Předpona a přípona u čteček čárových kódů: úplná příručka
Předpona jsou data nebo řídicí posloupnost, kterou čtečka čárových kódů odešle před dekódovaným čárovým kódem. Přípona je to, co odešle po této hodnotě. Stejný model lze nastavit na různé předpony a přípony a sériová čtečka je nedoručí stejně jako čtečka v režimu klávesnicového klínu.
Předpona čtečky čárových kódů se odesílá před dekódovanou hodnotou. Přípona se odesílá po ní. Jedna čtečka může vytvořit tuto posloupnost:
Předpona: STX
Čárový kód: 123456789
Přípona: ENTER
STX v návodu obvykle znamená řídicí znak, ne tři písmena S, T a X. ENTER u čtečky v režimu klávesnicového klínu je zpravidla klávesa Enter, ne dva znaky CR a LF vložené do textového pole. Co z toho přijde, záleží na modelu, rozhraní a aplikaci. Žádné nastavení není univerzální.
Příručka Přípony ENTER a TAB u čteček čárových kódů zůstává u volby a ověřování těchto dvou ukončovacích kláves. Tato příručka je o rámci kolem čárového kódu: co přijde před ním, co přijde po něm a jak má webová aplikace číst obojí.
Co je předpona čtečky čárových kódů
Předpona je nastavená posloupnost, kterou čtečka odešle před datovou zátěží. Datová zátěž je text, který symbolika dekódovala, například 123456789. Předpona k tomuto dekódování nepatří, dokud čtečka nebyla nastavena tak, aby ji přidávala.
Běžná použití:
- Označit začátek zprávy. Sériové a terminálové protokoly někdy pošlou řídicí znak, často nazývaný STX, aby hostitel poznal, že začal nový rámec.
- Pojmenovat symboliku. Se zapnutým identifikátorem symboliky AIM může čtečka poslat krátkou tisknutelnou předponu, například
]C1pro Code 128 nebo]E0pro EAN, před číslice. Aplikace se podle tohoto identifikátoru může větvit. - Směrovat vstup ve starším pokladním nebo terminálovém softwaru. Pevný kód před daty říkal hostiteli, ke kterému poli nebo zařízení sken patří.
- Označit konkrétní stanoviště. Dvěma čtečkám lze dát různé tisknutelné předpony, aby protokol ukázal, které stanoviště kód poslalo.
Tisknutelná předpona jsou obyčejné znaky. Objeví se v textovém poli na začátku řetězce. Předpona z řídicího znaku, například STX (0x02), nejsou písmena S, T a X. Čtečka v režimu klávesnicového klínu ten řídicí znak nemusí umět napsat vůbec. Sériová čtečka ho může poslat jako bajt. Přečtěte návod ke svému modelu, než napíšete kód, který očekává jedno nebo druhé.
Předpona nedokazuje, že vstup vytvořila čtečka. Člověk, makro nebo Barcode Scanner Emulator mohou napsat stejné znaky. Berte předponu jako rámec, který jste nastavili, a datovou zátěž ověřujte stejně jako jakýkoli jiný uživatelský vstup.
Co je přípona čtečky čárových kódů
Přípona je nastavená posloupnost odeslaná po datové zátěži. Obvykle řekne aplikaci, že sken skončil, nebo přesune fokus. Čtečky se liší. Některé nabízejí Enter, Tab, CR, LF, CR+LF, vlastní řetězec nebo nic. Jiné nabízejí jen jednu nebo dvě z těchto možností.
ENTER. Klávesa Enter. V prohlížeči je to událost klávesnice, event.key === "Enter". Do běžného textového pole se nevkládá.
TAB. Klávesa Tab, event.key === "Tab". Prohlížeč přesune fokus na další prvek. Klávesa se do pole nevloží.
CR. Návrat vozíku, ASCII 0x0D. Na sériovém nebo terminálovém rozhraní to může být skutečný bajt za datovou zátěží. U klávesnicového klínu nastavení označené CR nebo návrat vozíku obvykle znamená klávesu Enter. Prohlížeč pořád hlásí Enter. Hodnota pole znak CR nezíská.
LF. Posuv řádku, ASCII 0x0A. Je to jiný řídicí znak než CR. V sériovém proudu může být vlastním bajtem. Klávesnicový klín nemá standardní klávesu posuvu řádku tak, jak má Enter a Tab. Nepředpokládejte, že položka nabídky pojmenovaná LF napíše viditelný znak nebo druhý Enter.
CRLF. CR a pak LF, dva bajty 0x0D 0x0A. Někteří sérioví a termináloví hostitelé čekají tento pár jako konec řádku. Textové pole prohlížeče tento pár neuloží, když někdo stiskne Enter.
Vlastní znaky. Tisknutelná přípona, například # nebo krátký kód, se napíše za čárový kód, takže se stane součástí řetězce, dokud ji aplikace neodstraní. Vlastní řídicí znak se dělí stejně jako STX: bajty na sériovém portu, stisky na klínu a jen ty stisky, které rozhraní klávesnice skutečně umí poslat.
ENTER, CR a LF jsou v návodech příbuzná jména pro „konec řádku“. V každé aplikaci nejsou zaměnitelné. Klínová čtečka, sériová čtečka, Notepad a webový formulář mohou u nastavení se stejným názvem ukázat jiný výsledek.
Předpona a přípona
| Vlastnost | Předpona | Přípona |
|---|---|---|
| Pozice | Před daty čárového kódu | Za daty čárového kódu |
| Účel | Označit začátek nebo popsat vstup | Označit dokončení nebo spustit akci |
| Příklad | STX nebo tisknutelný identifikátor AIM, například ]C1 |
ENTER, TAB nebo tisknutelný znak, například # |
| Běžné použití | Orámovat nebo rozpoznat sken | Odeslat formulář nebo přesunout fokus |
| V textovém poli | Tisknutelné znaky stojí na začátku hodnoty | Tisknutelné znaky stojí na konci. Enter a Tab ne |
| Povaha | Nastavená značka, kterou může napsat kdokoli | Nastavená značka, kterou může napsat kdokoli |
Předponu nebo vlastní příponu odebírejte jen tehdy, když jste nastavili přesně tuto posloupnost a uložený záznam ji nemá obsahovat. Identifikátor AIM nechte na místě, dokud pro něj aplikace nemá pravidlo.
ENTER, TAB, CR a LF
Tato jména se objevují na konfiguračních listech. Přijímající strana vidí buď stisky, nebo bajty, podle rozhraní. Příručka Klávesnicový klín HID popisuje cestu stisků. Sériový port je jiná cesta: aplikace čte bajty a fokus nevybírá, kam půjdou.
ENTER
U čtečky v režimu klávesnicového klínu je ENTER klávesa Enter. V jednořádkovém textovém poli současné prohlížeče touto klávesou odešlou obklopující formulář. Vyhledávací pole může sken na této události potvrdit. Formulář s více poli se může odeslat dřív, než se vyplní pozdější pole. Zavolejte preventDefault() na události submit nebo na keydown klávesy Enter, když má stránka hodnotu podržet a zůstat. Enter zpracujte na jednom místě. Posluchač keydown a posluchač submit, kteří sken oba přijmou, ho zaznamenají dvakrát.
Některé čtečky posílají NumPad Enter. event.key je pořád "Enter". event.code může být "NumpadEnter", ne "Enter". Testujte event.key, pokud mají pole potvrdit obě klávesy.
Příručka Přípony ENTER a TAB u čteček čárových kódů tyto dvě volby porovnává pro POS a webové formuláře. Čtečce čárových kódů chybí ENTER popisuje čtečku, která napíše čárový kód a pak se zastaví.
TAB
TAB je klávesa Tab. Prohlížeč přesune fokus po keydown. Přečtěte pole v tomto obslužném keydown, dokud má ještě fokus, a nechte výchozí akci, když má kurzor přejít na další prvek. preventDefault() drží fokus na aktuálním poli.
Shift+Tab je stejná klávesa s drženým Shift. Přípona Tab u čtečky je Tab bez Shift. Ignorujte event.shiftKey, pokud uživatelé klávesnice musí moci formulářem couvat.
CR
Návrat vozíku přesune kurzor v terminálu na začátek řádku. Bajt je 0x0D. Sériová čtečka může tento bajt připojit k datové zátěži. Nastavení klávesnicového klínu pojmenované CR obvykle pošle klávesu Enter a nevloží 0x0D do textu. Stisk Enter ve vstupu prohlížeče nezapíše znak CR do input.value.
Pokud je hostitel terminál nebo program poslouchající port COM, hledejte bajt. Pokud je hostitel webová stránka, hledejte event.key === "Enter".
LF
Posuv řádku posune kurzor terminálu o jeden řádek dolů. Bajt je 0x0A. Někteří hostitelé berou samotné LF jako nový řádek. Jiní ho ignorují, dokud nepřišlo CR. Klínová čtečka, která uvádí LF jako příponu, může poslat klávesu, kterou operační systém nepromění ve zalomení řádku, nebo neposlat nic, co textové pole podrží. Zachyťte klávesu v testeru událostí klávesnice, než v kódu aplikace budete pracovat s domnělým LF.
CRLF
CRLF je posloupnost dvou řídicích znaků, nejdřív CR a pak LF. Textové soubory ve stylu Windows a mnoho sériových zařízení ji používá jako jeden nový řádek. Konfigurační stránka, která říká „přípona CRLF“, znamená, že čtečka se pokusí poslat tento pár po datové zátěži na rozhraní, které používá.
V prohlížeči stisk Enter nevytvoří doslovnou posloupnost CRLF uvnitř textového vstupu. Formulář dostane událost klávesnice. <textarea> může vložit nový řádek, když uživatel stiskne Enter, a tento nový řádek je vlastní editační chování prohlížeče, ne důkaz, že čtečka vyslala bajty 0x0D 0x0A. Sériový čtenář může tyto dva bajty přijmout a má je brát jako ukončení jen tehdy, když byla čtečka nastavena je posílat. Neodebírejte CR ani LF ze středu datové zátěže, která je smí obsahovat.
Jak předpony a přípony ovlivňují webové aplikace
Sken klávesnicovým klínem je dávka stisků do prvku, který má fokus. Stránka čtečku neotevírá. Když je fokus na jiném poli, jdou tam předpona, čárový kód i přípona.
keydown se spustí pro každou klávesu, včetně Enter a Tab, dřív než prohlížeč vloží znak nebo přesune fokus. event.key je znak nebo název klávesy poté, co operační systém použil rozložení klávesnice. Tisknutelné znaky předpony a přípony se v poli objeví přes událost input. Enter a Tab ne.
Posluchač níže pole potvrdí, když přijde Enter. Nedoplňuje příponu, kterou čtečka vynechala. Pokud čtečka Enter neposílá, hodnota zůstane v poli, dokud ji nepřečte něco jiného.
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 = ''
})
Dejte fokus na #barcode před skenem. preventDefault() zabrání nadřazenému formuláři v druhém odeslání. Pokud vstup není uvnitř formuláře a chcete nativní odeslání, preventDefault() vynechte.
Bez přípony čekejte na výslovnou akci: tlačítko, pozdější Enter od obsluhy nebo další krok postupu. Časovač nečinnosti může pauzu brát jako konec skenu. Ten časovač je heuristika. Pomalá čtečka, zpoždění Bluetooth nebo rychlé psaní mohou spadnout na špatnou stranu prahu. Když postup potřebuje určitý konec, dejte přednost nastavené příponě.
Známou tisknutelnou předponu lze po přečtení hodnoty odebrat:
function withoutConfiguredPrefix(value, prefix) {
if (prefix && value.startsWith(prefix)) {
return value.slice(prefix.length)
}
return value
}
Předávejte jen předponu, kterou jste nastavili, například ']C1'. Neodřezávejte libovolný počet znaků z každého skenu.
Úplný formulář, který řeší i Tab, prázdný vstup a druhý sken, je v příručce Jak testovat čtečky čárových kódů ve webových aplikacích.
Jak nastavit předpony a přípony
Nastavení předpony a přípony je na čtečce. Názvy položek a způsob jejich změny jsou specifické pro výrobce. Neexistuje konfigurační čárový kód, který funguje u každé značky, a tato příručka žádný netiskne.
Typické postupy:
- Naskenujte konfigurační čárový kód z návodu přesně k tomu modelu. List je seskupený podle nastavení: přípona, předpona, rozložení klávesnice, symbolika.
- Použijte konfigurační program výrobce a výsledek zapište do čtečky přes USB.
- Použijte nástroj pro správu zařízení té řady, když aktualizujete mnoho kusů.
Po změně naskenujte známý čárový kód a porovnejte výsledek s popisem zvoleného nastavení v návodu. Tovární reset od jiné značky může čtečku nechat beze změny nebo ji přepnout do nečekaného režimu. Příručka nastavení čtečky čárových kódů shrnuje nastavení, na kterých obvykle záleží. Návod k zařízení nenahrazuje.
Barcode Scanner Emulator umí napsat hodnotu, kterou zvolíte, a pak poslat ENTER, TAB nebo žádnou příponu. Vložte do té hodnoty tisknutelnou předponu, když potřebujete vyzkoušet zpracování předpony bez hardwaru. Emulátor nevysílá sériový pár bajtů CR/LF a nečte štítek.
Jak otestovat chování předpony a přípony
Použijte čtečku v režimu klávesnice, klávesnici USB HID nebo klávesnici Bluetooth HID.
- Připojte ji a počkejte, až ukáže, že má napájení.
- Otevřete tester vstupu čárového kódu.
- Klepněte na Spustit test, nebo klepněte na oblast skenování. Zmodrá, když je připravena. Stránka si fokus sama nebere.
- Naskenujte čárový kód, jehož datovou zátěž už znáte.
- Přečtěte zachycenou hodnotu a počet znaků. Tisknutelné znaky předpony nebo přípony jsou uvnitř tohoto řetězce. Řádek Předpona je pro pojmenované klávesy, které přijdou před prvním znakem, například modifikátor. Nevytáhne napsanou předponu jako
]C1z textu čárového kódu. - Zkontrolujte příponu. Tester hlásí ENTER, TAB nebo Žádná. Když je Automatický záznam zapnutý, výsledek se objeví po Enter, Tab nebo po krátké pauze, jakmile klávesy ustanou. Vypněte Automatický záznam, aby záznam zůstal, dokud nestisknete Zastavit. Enter a Tab nejsou součástí řetězce čárového kódu.
- Porovnejte tento výsledek s nastavením, které jste zamýšleli. Pak otevřete tester událostí klávesnice a skenujte znovu, když potřebujete každé
keydownv pořadí, včetněkey,codea času.
Tester vstupu zaznamenává události klávesnice, které prohlížeč vidí. Sériový port číst neumí, takže nemůže ukázat CR nebo LF jako surové bajty. Test klínu nedokazuje, co pošle sériové nastavení.
Řešení problémů
Čtečka neposílá ENTER. Čárový kód se objeví a kurzor zůstane v poli. Tester vstupu hlásí Žádná. Přípona je vypnutá, nebo je nastavená na něco jiného než Enter. Viz Čtečce čárových kódů chybí ENTER.
TAB přesouvá fokus nečekaně. Čtečka posílá klávesu Tab. To je nastavená přípona. Použijte Enter, když se má formulář odeslat, nebo čtěte hodnotu na keydown klávesy Tab, když má postup postoupit. Podrobnosti jsou v příručce Přípony ENTER a TAB u čteček čárových kódů.
Formulář se odešle dvakrát. Prohlížeč ho odešle na Enter a posluchač keydown sken také přijme. Nechte jednu cestu dokončení a na druhé zavolejte preventDefault().
Předpona se objeví uvnitř čárového kódu. Tisknutelná předpona je součástí zachyceného řetězce. Buď ji na čtečce vypněte, nebo v aplikaci odeberte přesně tuto posloupnost. Zapnutý identifikátor symboliky je častý zdroj úvodního ] a dvou dalších znaků. Řídicí předpona, kterou klín neumí napsat, bude chybět, nebude vidět.
Znaky jsou špatně. Rozložení čtečky a rozložení operačního systému se mohou rozcházet, což změní znaky předpony a interpunkci, zatímco délka zůstane stejná. Viz Špatné rozložení klávesnice u čtečky čárových kódů.
Aplikace nikdy neuvidí konec skenu. Přípona není a stránka čeká na Enter. Přidejte příponu, která formuláři odpovídá, nebo hodnotu dokončete výslovnou akcí. Odhad podle času některé skutečné skeny mine a některé psaní přijme.
CR/LF se mezi aplikacemi liší. Notepad vloží nový řádek, když dostane Enter. Webové textové pole čárový kód podrží a spustí událost klávesy. Sériový program může přijmout 0x0D, 0x0A nebo obojí. Porovnejte rozhraní, než čtečku změníte. Pokud žádná aplikace znaky nedostává, začněte u Čtečka čárových kódů nefunguje.
Širší průchod fokusem, opakovanými skeny a postupy POS je v příručce Jak testovat vstup z čtečky čárových kódů.
Testovací matice
Sloupec nastavení je to, co nastavíte na čtečce, nebo to, co napíšete emulátorem, když jde o klávesnicovou příponu. Očekávané chování je to, co má udělat aplikace. Případ sériového CRLF není stejný test jako klávesa Enter v prohlížeči.
| Nastavení | Očekávané chování aplikace |
|---|---|
| Bez předpony, bez přípony | Hodnota čárového kódu je přijata a ukončovací klávesa nepřijde. Hodnota zůstane dostupná, dokud ji aplikace nepřečte. |
| Bez předpony, přípona ENTER | Aplikace přijme ukončovací klávesu jednou a uloží datovou zátěž bez ukončovacího znaku. |
| Bez předpony, přípona TAB | Fokus se může přesunout na další prvek. Aplikace přečte hodnotu před tímto přesunem. |
| Vlastní tisknutelná předpona | Znaky předpony se objeví před dekódovanými daty. Aplikace tuto přesnou předponu záměrně ponechá nebo odebere. |
| Vlastní tisknutelná přípona | Znaky přípony se objeví za dekódovanými daty. Enter a Tab jsou klávesy, takže se v řetězci neobjeví. |
| Posloupnost CRLF | Sériový nebo terminálový hostitel zpracuje nastavené bajty CR a LF. Textové pole prohlížeče tyto bajty ze stisku Enter nezíská. |
Klávesnicové řádky spusťte na klínové čtečce a, když hardware chybí, s nastavením emulátoru ENTER, TAB a bez přípony. Řádek CRLF spusťte na rozhraní, které má tyto bajty nést. Skutečný výsledek pořád závisí na tomto rozhraní a na aplikaci.