Preskočiť na obsah

Barcode Scanner Emulator

Predpona a prípona v skeneroch čiarových kódov: úplná príručka

Predpona sú údaje alebo riadiaca postupnosť, ktorú skener čiarových kódov odošle pred dekódovaným čiarovým kódom. Prípona je to, čo odošle po tejto hodnote. Rovnaký model sa dá nastaviť na rôzne predpony a prípony a sériový skener ich nedoručí tak ako skener v režime klávesnicového klinu.

Predpona skenera čiarových kódov sa posiela pred dekódovanou hodnotou. Prípona sa posiela za ňou. Jeden skener môže vytvoriť túto postupnosť:

Predpona: STX

Čiarový kód: 123456789

Prípona: ENTER

STX v návode zvyčajne znamená riadiaci znak, nie tri písmená S, T a X. ENTER na skeneri v režime klávesnicového klinu je spravidla kláves Enter, nie dva znaky CR a LF vložené do textového poľa. Čo z toho príde, závisí od modelu, rozhrania a aplikácie. Nijaké nastavenie nie je univerzálne.

Príručka Prípony ENTER a TAB v skeneroch čiarových kódov ostáva pri voľbe a overovaní týchto dvoch ukončovacích klávesov. Táto príručka je o rámci okolo čiarového kódu: čo príde pred ním, čo príde za ním a ako má webová aplikácia čítať oboje.

Čo je predpona skenera čiarových kódov

Predpona je nastavená postupnosť, ktorú skener odošle pred obsahom. Obsah je text, ktorý symbolika dekódovala, napríklad 123456789. Predpona do tohto dekódovania nepatrí, kým skener nebol nastavený tak, aby ju pridával.

Bežné použitia:

  • Označiť začiatok správy. Sériové a terminálové protokoly niekedy pošlú riadiaci znak, často nazývaný STX, aby hostiteľ vedel, že sa začal nový rámec.
  • Pomenovať symboliku. So zapnutým identifikátorom symboliky AIM môže skener poslať krátku tlačiteľnú predponu, napríklad ]C1 pre Code 128 alebo ]E0 pre EAN, pred číslice. Aplikácia sa podľa tohto identifikátora môže rozvetviť.
  • Smerovať vstup v staršom pokladničnom alebo terminálovom softvéri. Pevný kód pred údajmi hovoril hostiteľovi, ku ktorému poľu alebo zariadeniu sken patrí.
  • Označiť konkrétne stanovisko. Dvom skenerom možno dať rôzne tlačiteľné predpony, aby denník ukázal, ktoré stanovisko kód poslalo.

Tlačiteľná predpona sú obyčajné znaky. Objavia sa v textovom poli na začiatku reťazca. Predpona z riadiaceho znaku, napríklad STX (0x02), nie sú písmená S, T a X. Skener v režime klávesnicového klinu ten riadiaci znak nemusí vedieť napísať vôbec. Sériový skener ho môže poslať ako bajt. Prečítajte návod k svojmu modelu skôr, než napíšete kód, ktorý očakáva jedno alebo druhé.

Predpona nedokazuje, že vstup vytvoril skener. Človek, makro alebo Barcode Scanner Emulator môžu napísať tie isté znaky. Berte predponu ako rámec, ktorý ste nastavili, a obsah overujte rovnako ako akýkoľvek iný používateľský vstup.

Čo je prípona skenera čiarových kódov

Prípona je nastavená postupnosť odoslaná po obsahu. Zvyčajne povie aplikácii, že sken skončil, alebo presunie fokus. Skenery sa líšia. Niektoré ponúkajú Enter, Tab, CR, LF, CR+LF, vlastný reťazec alebo nič. Iné ponúkajú len jednu alebo dve z týchto možností.

ENTER. Kláves Enter. V prehliadači je to udalosť klávesnice, event.key === "Enter". Do bežného textového poľa sa nevkladá.

TAB. Kláves Tab, event.key === "Tab". Prehliadač presunie fokus na ďalší prvok. Kláves sa do poľa nevloží.

CR. Návrat vozíka, ASCII 0x0D. Na sériovom alebo terminálovom rozhraní to môže byť skutočný bajt za obsahom. Pri klávesnicovom kline nastavenie označené CR alebo návrat vozíka zvyčajne znamená kláves Enter. Prehliadač stále hlási Enter. Hodnota poľa znak CR nezíska.

LF. Posun riadka, ASCII 0x0A. Je to iný riadiaci znak ako CR. V sériovom prúde môže byť vlastným bajtom. Klávesnicový klin nemá štandardný kláves posunu riadka tak, ako má Enter a Tab. Nepredpokladajte, že položka ponuky s názvom LF napíše viditeľný znak alebo druhý Enter.

CRLF. CR a potom LF, dva bajty 0x0D 0x0A. Niektorí sérioví a termináloví hostitelia čakajú tento pár ako koniec riadka. Textové pole prehliadača tento pár neuloží, keď niekto stlačí Enter.

Vlastné znaky. Tlačiteľná prípona, napríklad # alebo krátky kód, sa napíše za čiarový kód, takže sa stane súčasťou reťazca, kým ju aplikácia neodstráni. Vlastný riadiaci znak sa delí rovnako ako STX: bajty na sériovom porte, stlačenia na kline a len tie stlačenia, ktoré rozhranie klávesnice skutočne vie poslať.

ENTER, CR a LF sú v návodoch príbuzné názvy pre „koniec riadka“. V každej aplikácii nie sú zameniteľné. Klinový skener, sériový skener, Notepad a webový formulár môžu pri nastavení s rovnakým názvom ukázať iný výsledok.

Predpona a prípona

Vlastnosť Predpona Prípona
Pozícia Pred údajmi čiarového kódu Za údajmi čiarového kódu
Účel Označiť začiatok alebo opísať vstup Označiť dokončenie alebo spustiť akciu
Príklad STX alebo tlačiteľný identifikátor AIM, napríklad ]C1 ENTER, TAB alebo tlačiteľný znak, napríklad #
Bežné použitie Orámovať alebo rozpoznať sken Odoslať formulár alebo presunúť fokus
V textovom poli Tlačiteľné znaky stoja na začiatku hodnoty Tlačiteľné znaky stoja na konci. Enter a Tab nie
Povaha Nastavená značka, ktorú môže napísať ktokoľvek Nastavená značka, ktorú môže napísať ktokoľvek

Predponu alebo vlastnú príponu odstraňujte len vtedy, keď ste nastavili presne túto postupnosť a uložený záznam ju nemá obsahovať. Identifikátor AIM nechajte na mieste, kým preň aplikácia nemá pravidlo.

ENTER, TAB, CR a LF

Tieto názvy sa objavujú na konfiguračných listoch. Prijímajúca strana vidí buď stlačenia, alebo bajty, podľa rozhrania. Príručka Klávesnicový klin HID opisuje cestu stlačení. Sériový port je iná cesta: aplikácia číta bajty a fokus nevyberá, kam pôjdu.

ENTER

Na skeneri v režime klávesnicového klinu je ENTER kláves Enter. V jednoriadkovom textovom poli súčasné prehliadače touto klávesou odošlú okolitý formulár. Vyhľadávacie pole môže sken na tejto udalosti potvrdiť. Formulár s viacerými poľami sa môže odoslať skôr, než sa vyplnia neskoršie polia. Zavolajte preventDefault() na udalosti submit alebo na keydown klávesu Enter, keď má stránka hodnotu podržať a ostať. Enter spracujte na jednom mieste. Poslucháč keydown a poslucháč submit, ktorí sken obaja prijmú, ho zaznamenajú dvakrát.

Niektoré skenery posielajú NumPad Enter. event.key je stále "Enter". event.code môže byť "NumpadEnter", nie "Enter". Testujte event.key, ak majú pole potvrdiť oba klávesy.

Príručka Prípony ENTER a TAB v skeneroch čiarových kódov tieto dve voľby porovnáva pre POS a webové formuláre. Skeneru čiarových kódov chýba ENTER opisuje skener, ktorý napíše čiarový kód a potom sa zastaví.

TAB

TAB je kláves Tab. Prehliadač presunie fokus po keydown. Prečítajte pole v tomto obslužnom keydown, kým má ešte fokus, a nechajte predvolenú akciu, keď má kurzor prejsť na ďalší prvok. preventDefault() drží fokus na aktuálnom poli.

Shift+Tab je ten istý kláves s podržaným Shift. Prípona Tab na skeneri je Tab bez Shift. Ignorujte event.shiftKey, ak používatelia klávesnice musia vedieť formulárom cúvať.

CR

Návrat vozíka presunie kurzor v termináli na začiatok riadka. Bajt je 0x0D. Sériový skener môže tento bajt pripojiť k obsahu. Nastavenie klávesnicového klinu s názvom CR zvyčajne pošle kláves Enter a nevloží 0x0D do textu. Stlačenie Enter vo vstupe prehliadača nezapíše znak CR do input.value.

Ak je hostiteľ terminál alebo program, ktorý počúva port COM, hľadajte bajt. Ak je hostiteľ webová stránka, hľadajte event.key === "Enter".

LF

Posun riadka posunie kurzor terminálu o jeden riadok nadol. Bajt je 0x0A. Niektorí hostitelia berú samotné LF ako nový riadok. Iní ho ignorujú, kým neprišlo CR. Klinový skener, ktorý uvádza LF ako príponu, môže poslať kláves, ktorý operačný systém nepremení na zalomenie riadka, alebo neposlať nič, čo textové pole podrží. Zachyťte kláves v testeri udalostí klávesnice, kým v kóde aplikácie budete pracovať s domnelým LF.

CRLF

CRLF je postupnosť dvoch riadiacich znakov, najprv CR a potom LF. Textové súbory v štýle Windows a mnohé sériové zariadenia ju používajú ako jeden nový riadok. Konfiguračná stránka, ktorá hovorí „prípona CRLF“, znamená, že skener sa pokúsi poslať tento pár po obsahu na rozhraní, ktoré používa.

V prehliadači stlačenie Enter nevytvorí doslovnú postupnosť CRLF vo vnútri textového vstupu. Formulár dostane udalosť klávesnice. <textarea> môže vložiť nový riadok, keď používateľ stlačí Enter, a tento nový riadok je vlastné editačné správanie prehliadača, nie dôkaz, že skener vyslal bajty 0x0D 0x0A. Sériový čítač môže tieto dva bajty prijať a má ich brať ako ukončenie len vtedy, keď bol skener nastavený ich posielať. Neodstraňujte CR ani LF zo stredu obsahu, ktorý ich smie obsahovať.

Ako predpony a prípony ovplyvňujú webové aplikácie

Sken klávesnicovým klinom je dávka stlačení do prvku, ktorý má fokus. Stránka skener neotvára. Keď je fokus na inom poli, idú tam predpona, čiarový kód aj prípona.

keydown sa spustí pre každý kláves, vrátane Enter a Tab, skôr než prehliadač vloží znak alebo presunie fokus. event.key je znak alebo názov klávesu po tom, čo operačný systém použil rozloženie klávesnice. Tlačiteľné znaky predpony a prípony sa v poli objavia cez udalosť input. Enter a Tab nie.

Poslucháč nižšie pole potvrdí, keď príde Enter. Nedopĺňa príponu, ktorú skener vynechal. Ak skener Enter neposiela, hodnota ostane v poli, kým ju neprečíta niečo iné.

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 pred skenom. preventDefault() zabráni nadradenému formuláru v druhom odoslaní. Ak vstup nie je vo vnútri formulára a chcete natívne odoslanie, preventDefault() vynechajte.

Bez prípony čakajte na výslovnú akciu: tlačidlo, neskorší Enter od obsluhy alebo ďalší krok postupu. Časovač nečinnosti môže pauzu brať ako koniec skenu. Ten časovač je heuristika. Pomalý skener, oneskorenie Bluetooth alebo rýchle písanie môžu spadnúť na nesprávnu stranu prahu. Keď postup potrebuje istý koniec, uprednostnite nastavenú príponu.

Známu tlačiteľnú predponu možno po prečítaní hodnoty odstrániť:

function withoutConfiguredPrefix(value, prefix) {
  if (prefix && value.startsWith(prefix)) {
    return value.slice(prefix.length)
  }
  return value
}

Odovzdávajte len predponu, ktorú ste nastavili, napríklad ']C1'. Neodrezávajte ľubovoľný počet znakov z každého skenu.

Úplný formulár, ktorý rieši aj Tab, prázdny vstup a druhý sken, je v príručke Ako testovať skenery čiarových kódov vo webových aplikáciách.

Ako nastaviť predpony a prípony

Nastavenie predpony a prípony je na skeneri. Názvy položiek a spôsob ich zmeny sú špecifické pre výrobcu. Neexistuje konfiguračný čiarový kód, ktorý funguje pri každej značke, a táto príručka žiadny netlačí.

Typické postupy:

  • Naskenujte konfiguračný čiarový kód z návodu presne k tomu modelu. Hárok je zoskupený podľa nastavenia: prípona, predpona, rozloženie klávesnice, symbolika.
  • Použite konfiguračný program výrobcu a výsledok zapíšte do skenera cez USB.
  • Použite nástroj na správu zariadení tejto rady, keď aktualizujete veľa kusov.

Po zmene naskenujte známy čiarový kód a porovnajte výsledok s opisom zvoleného nastavenia v návode. Výrobný reset od inej značky môže skener nechať bez zmeny alebo ho prepnúť do nečakaného režimu. Príručka konfigurácie skenera čiarových kódov zhŕňa nastavenia, na ktorých zvyčajne záleží. Návod k zariadeniu nenahrádza.

Barcode Scanner Emulator vie napísať hodnotu, ktorú zvolíte, a potom poslať ENTER, TAB alebo nijakú príponu. Vložte do tej hodnoty tlačiteľnú predponu, keď potrebujete vyskúšať spracovanie predpony bez hardvéru. Emulátor nevysiela sériový pár bajtov CR/LF a nečíta štítok.

Ako otestovať správanie predpony a prípony

Použite skener v režime klávesnice, klávesnicu USB HID alebo klávesnicu Bluetooth HID.

  1. Pripojte ho a počkajte, kým ukáže, že má napájanie.
  2. Otvorte tester vstupu čiarových kódov.
  3. Kliknite na Spustiť test, alebo kliknite na oblasť skenovania. Zmodrie, keď je pripravená. Stránka si fokus sama neberie.
  4. Naskenujte čiarový kód, ktorého obsah už poznáte.
  5. Prečítajte zachytenú hodnotu a počet znakov. Tlačiteľné znaky predpony alebo prípony sú vo vnútri tohto reťazca. Riadok Predpona je pre pomenované klávesy, ktoré prídu pred prvým znakom, napríklad modifikátor. Nevytiahne napísanú predponu ako ]C1 z textu čiarového kódu.
  6. Skontrolujte príponu. Tester hlási ENTER, TAB alebo Žiadna. Keď je Automatické zachytenie zapnuté, výsledok sa objaví po Enter, Tab alebo po krátkej pauze, keď klávesy ustanú. Vypnite Automatické zachytenie, aby zachytenie ostalo, kým nestlačíte Zastaviť. Enter a Tab nie sú súčasťou reťazca čiarového kódu.
  7. Porovnajte tento výsledok s nastavením, ktoré ste zamýšľali. Potom otvorte tester udalostí klávesnice a skenujte znova, keď potrebujete každé keydown v poradí, vrátane key, code a času.

Tester vstupu zaznamenáva udalosti klávesnice, ktoré prehliadač vidí. Sériový port čítať nevie, takže nemôže ukázať CR alebo LF ako surové bajty. Test klinu nedokazuje, čo pošle sériové nastavenie.

Riešenie problémov

Skener neposiela ENTER. Čiarový kód sa objaví a kurzor ostane v poli. Tester vstupu hlási Žiadna. Prípona je vypnutá, alebo je nastavená na niečo iné ako Enter. Pozrite Skeneru čiarových kódov chýba ENTER.

TAB presúva fokus nečakane. Skener posiela kláves Tab. To je nastavená prípona. Použite Enter, keď sa má formulár odoslať, alebo čítajte hodnotu na keydown klávesu Tab, keď má postup postúpiť. Podrobnosti sú v príručke Prípony ENTER a TAB v skeneroch čiarových kódov.

Formulár sa odošle dvakrát. Prehliadač ho odošle na Enter a poslucháč keydown sken tiež prijme. Nechajte jednu cestu dokončenia a na druhej zavolajte preventDefault().

Predpona sa objaví vo vnútri čiarového kódu. Tlačiteľná predpona je súčasťou zachyteného reťazca. Buď ju na skeneri vypnite, alebo v aplikácii odstráňte presne túto postupnosť. Zapnutý identifikátor symboliky je častý zdroj úvodného ] a dvoch ďalších znakov. Riadiaca predpona, ktorú klin nevie napísať, bude chýbať, nebude viditeľná.

Znaky sú nesprávne. Rozloženie skenera a rozloženie operačného systému sa môžu rozchádzať, čo zmení znaky predpony a interpunkciu, kým dĺžka ostane rovnaká. Pozrite Nesprávne rozloženie klávesnice skenera čiarových kódov.

Aplikácia nikdy neuvidí koniec skenu. Prípona nie je a stránka čaká na Enter. Pridajte príponu, ktorá formuláru zodpovedá, alebo hodnotu dokončite výslovnou akciou. Odhad podľa času niektoré skutočné skeny minie a niektoré písanie prijme.

CR/LF sa medzi aplikáciami líši. Notepad vloží nový riadok, keď dostane Enter. Webové textové pole čiarový kód podrží a spustí udalosť klávesu. Sériový program môže prijať 0x0D, 0x0A alebo oboje. Porovnajte rozhranie, kým skener zmeníte. Ak nijaká aplikácia znaky nedostáva, začnite na Skener čiarových kódov nefunguje.

Širší prechod fokusom, opakovanými skenmi a postupmi POS je v príručke Ako testovať vstup zo skenera čiarových kódov.

Testovacia matica

Stĺpec nastavenia je to, čo nastavíte na skeneri, alebo to, čo napíšete emulátorom, keď ide o klávesnicovú príponu. Očakávané správanie je to, čo má urobiť aplikácia. Prípad sériového CRLF nie je ten istý test ako kláves Enter v prehliadači.

Nastavenie Očakávané správanie aplikácie
Bez predpony, bez prípony Hodnota čiarového kódu je prijatá a ukončovací kláves nepríde. Hodnota ostane dostupná, kým ju aplikácia neprečíta.
Bez predpony, prípona ENTER Aplikácia prijme ukončovací kláves raz a uloží obsah bez ukončovacieho znaku.
Bez predpony, prípona TAB Fokus sa môže presunúť na ďalší prvok. Aplikácia prečíta hodnotu pred týmto presunom.
Vlastná tlačiteľná predpona Znaky predpony sa objavia pred dekódovanými údajmi. Aplikácia túto presnú predponu zámerne ponechá alebo odstráni.
Vlastná tlačiteľná prípona Znaky prípony sa objavia za dekódovanými údajmi. Enter a Tab sú klávesy, takže sa v reťazci neobjavia.
Postupnosť CRLF Sériový alebo terminálový hostiteľ spracuje nastavené bajty CR a LF. Textové pole prehliadača tieto bajty zo stlačenia Enter nezíska.

Klávesnicové riadky spustite na klinovom skeneri a, keď hardvér chýba, s nastavením emulátora ENTER, TAB a bez prípony. Riadok CRLF spustite na rozhraní, ktoré má tieto bajty niesť. Skutočný výsledok stále závisí od tohto rozhrania a od aplikácie.