Preskoči na vsebino

Barcode Scanner Emulator

Predpona in pripona v čitalnikih črtnih kod: popoln vodnik

Predpona so podatki ali krmilno zaporedje, ki ga čitalnik črtnih kod pošlje pred dekodirano črtno kodo. Pripona je tisto, kar pošlje za to vrednostjo. Isti model je mogoče nastaviti na različne predpone in pripone, zaporedni čitalnik pa jih ne dostavi enako kot čitalnik v načinu tipkovnega klina.

Predpona čitalnika črtnih kod se pošlje pred dekodirano vrednostjo. Pripona se pošlje za njo. En čitalnik lahko ustvari to zaporedje:

Predpona: STX

Črtna koda: 123456789

Pripona: ENTER

STX v priročniku običajno pomeni kontrolni znak, ne treh črk S, T in X. ENTER pri čitalniku v načinu tipkovnega klina je praviloma tipka Enter, ne znaka CR in LF, vstavljena v besedilno polje. Kaj od tega pride, je odvisno od modela, vmesnika in aplikacije. Nobena nastavitev ni univerzalna.

Vodnik Pripone ENTER in TAB v čitalnikih črtnih kod ostaja pri izbiri in preverjanju teh dveh zaključnih tipk. Ta vodnik govori o okviru okoli črtne kode: kaj pride pred njo, kaj pride za njo in kako naj spletna aplikacija prebere oboje.

Kaj je predpona čitalnika črtnih kod

Predpona je nastavljeno zaporedje, ki ga čitalnik odda pred vsebino. Vsebina je besedilo, ki ga je simbologija dekodirala, na primer 123456789. Predpona ni del tega dekodiranja, razen če je čitalnik nastavljen, da jo doda.

Pogoste rabe:

  • Označiti začetek sporočila. Zaporedni in terminalski protokoli včasih pošljejo kontrolni znak, pogosto imenovan STX, da gostitelj ve, da se je začel nov okvir.
  • Poimenovati simbologijo. Ko je vključen identifikator simbologije AIM, lahko čitalnik pošlje kratko natisljivo predpono, na primer ]C1 za Code 128 ali ]E0 za EAN, pred števkami. Aplikacija se lahko veji glede na ta identifikator.
  • Usmeriti vnos v starejši programski opremi za blagajno ali terminal. Nespremenljiva koda pred podatki je gostitelju povedala, kateremu polju ali napravi branje pripada.
  • Označiti določeno mesto. Dvema čitalnikoma je mogoče dati različni natisljivi predponi, da dnevnik pokaže, katera postaja je poslala kodo.

Natisljiva predpona so navadni znaki. Pojavijo se v besedilnem polju na začetku niza. Predpona iz kontrolnega znaka, kot je STX (0x02), niso črke S, T in X. Čitalnik v načinu tipkovnega klina tega kontrolnega znaka morda sploh ne zna vtipkati. Zaporedni čitalnik ga lahko pošlje kot bajt. Preberite priročnik za svoj model, preden napišete kodo, ki pričakuje eno ali drugo.

Predpona ne dokazuje, da je vnos ustvaril čitalnik. Oseba, makro ali Barcode Scanner Emulator lahko vtipkajo iste znake. Predpono vzemite kot okvir, ki ste ga nastavili, vsebino pa preverite tako, kot preverite vsak drug uporabniški vnos.

Kaj je pripona čitalnika črtnih kod

Pripona je nastavljeno zaporedje, poslano za vsebino. Običajno aplikaciji pove, da je branje končano, ali premakne fokus. Čitalniki se razlikujejo. Nekateri ponujajo Enter, Tab, CR, LF, CR+LF, lasten niz ali nič. Nekateri ponujajo le eno ali dve od teh možnosti.

ENTER. Tipka Enter. V brskalniku je to dogodek tipkovnice, event.key === "Enter". V navadno besedilno polje se ne vstavi.

TAB. Tipka Tab, event.key === "Tab". Brskalnik premakne fokus na naslednji element. Tipka se v polje ne vstavi.

CR. Vrnitev vozička, ASCII 0x0D. Na zaporednem ali terminalskem vmesniku je to lahko pravi bajt za vsebino. Pri tipkovnem klinu nastavitev z oznako CR ali vrnitev vozička običajno pomeni tipko Enter. Brskalnik še vedno sporoči Enter. Vrednost polja ne dobi znaka CR.

LF. Pomik vrstice, ASCII 0x0A. To je drug kontrolni znak kot CR. V zaporednem toku je lahko lasten bajt. Tipkovni klin nima standardne tipke za pomik vrstice tako, kot ima Enter in Tab. Ne predvidevajte, da postavka menija z imenom LF vtipka viden znak ali drugi Enter.

CRLF. CR in nato LF, dva bajta 0x0D 0x0A. Nekateri zaporedni in terminalski gostitelji ta par pričakujejo kot konec vrstice. Besedilno polje brskalnika tega para ne shrani, ko nekdo pritisne Enter.

Lastni znaki. Natisljiva pripona, na primer # ali kratka koda, se vtipka za črtno kodo, zato postane del niza, razen če jo aplikacija odstrani. Lasten kontrolni znak sledi isti delitvi kot STX: bajti na zaporednih vratih, pritiski na klinu in samo tisti pritiski, ki jih vmesnik tipkovnice zares lahko pošlje.

ENTER, CR in LF so v priročnikih sorodna imena za »konec vrstice«. V vsaki aplikaciji niso zamenljivi. Klinasti čitalnik, zaporedni čitalnik, Notepad in spletni obrazec lahko za nastavitev z istim imenom pokažejo različen rezultat.

Predpona in pripona

Lastnost Predpona Pripona
Položaj Pred podatki črtne kode Za podatki črtne kode
Namen Označiti začetek ali označiti vnos Označiti zaključek ali sprožiti dejanje
Primer STX ali natisljiv identifikator AIM, na primer ]C1 ENTER, TAB ali natisljiv znak, na primer #
Pogosta raba Uokviriti ali prepoznati branje Oddati obrazec ali premakniti fokus
V besedilnem polju Natisljivi znaki stojijo na začetku vrednosti Natisljivi znaki stojijo na koncu. Enter in Tab ne
Narava Nastavljena oznaka, ki jo lahko vtipka kdorkoli Nastavljena oznaka, ki jo lahko vtipka kdorkoli

Predpono ali lastno pripono odstranite samo takrat, ko ste nastavili natanko to zaporedje in shranjeni zapis je ne sme vsebovati. Identifikator AIM pustite, dokler aplikacija zanj nima pravila.

ENTER, TAB, CR in LF

Ta imena se pojavijo na nastavitvenih listih. Sprejemna stran vidi bodisi pritiske bodisi bajte, glede na vmesnik. Vodnik Tipkovni klin HID opisuje pot pritiskov. Zaporedna vrata so druga pot: aplikacija bere bajte, fokus pa ne izbira, kam gredo.

ENTER

Pri čitalniku v načinu tipkovnega klina je ENTER tipka Enter. V enovrstičnem besedilnem polju današnji brskalniki s to tipko oddajo obdajajoči obrazec. Iskalno polje lahko branje na tem dogodku potrdi. Obrazec z več polji se lahko odda, preden so izpolnjena poznejša polja. Pokličite preventDefault() na dogodku submit ali na keydown tipke Enter, ko naj stran vrednost obdrži in ostane. Enter obravnavajte na enem mestu. Poslušalec keydown in poslušalec submit, ki branje oba sprejmeta, ga bosta zabeležila dvakrat.

Nekateri čitalniki pošljejo NumPad Enter. event.key je še vedno "Enter". event.code je lahko "NumpadEnter", ne "Enter". Preverjajte event.key, če naj polje potrdita obe tipki.

Vodnik Pripone ENTER in TAB v čitalnikih črtnih kod primerja ti dve izbiri za POS in spletne obrazce. Čitalniku črtnih kod manjka ENTER opisuje čitalnik, ki vtipka črtno kodo in se nato ustavi.

TAB

TAB je tipka Tab. Brskalnik premakne fokus po keydown. Preberite polje v tem obravnavalcu keydown, dokler ima še fokus, in pustite privzeto dejanje, ko naj kurzor preide na naslednji element. preventDefault() zadrži fokus na trenutnem polju.

Shift+Tab je ista tipka s pritisnjenim Shift. Pripona Tab na čitalniku je Tab brez Shift. Prezrite event.shiftKey, če morajo uporabniki tipkovnice skozi obrazec nazaj.

CR

Vrnitev vozička premakne kurzor na začetek vrstice v terminalu. Bajt je 0x0D. Zaporedni čitalnik lahko ta bajt doda vsebini. Nastavitev tipkovnega klina z imenom CR običajno pošlje tipko Enter in ne vstavi 0x0D v besedilo. Pritisnjen Enter v polju brskalnika ne zapiše znaka CR v input.value.

Če je gostitelj terminal ali program, ki posluša vrata COM, iščite bajt. Če je gostitelj spletna stran, iščite event.key === "Enter".

LF

Pomik vrstice premakne kurzor terminala za eno vrstico navzdol. Bajt je 0x0A. Nekateri gostitelji sam LF obravnavajo kot novo vrstico. Drugi ga prezrejo, če pred njim ni prišel CR. Klinasti čitalnik, ki LF navaja kot pripono, lahko pošlje tipko, ki je operacijski sistem ne spremeni v prelom vrstice, ali ne pošlje ničesar, kar bi besedilno polje obdržalo. Ujemite tipko v preizkuševalniku dogodkov tipkovnice, preden v kodi aplikacije obravnavate domnevni LF.

CRLF

CRLF je zaporedje dveh kontrolnih znakov, najprej CR in nato LF. Besedilne datoteke v slogu Windows in številne zaporedne naprave ga uporabljajo kot eno novo vrstico. Nastavitvena stran, ki pravi »pripona CRLF«, pomeni, da bo čitalnik poskusil poslati ta par za vsebino po vmesniku, ki ga uporablja.

V brskalniku pritisk Enter ne ustvari dobesednega zaporedja CRLF znotraj besedilnega polja. Obrazec prejme dogodek tipkovnice. <textarea> lahko vstavi novo vrstico, ko uporabnik pritisne Enter, in ta nova vrstica je lastno urejevalno vedenje brskalnika, ne dokaz, da je čitalnik oddal bajta 0x0D 0x0A. Zaporedni bralnik lahko ta dva bajta prejme in ju sme obravnavati kot zaključek samo, če je bil čitalnik nastavljen, da ju pošilja. Ne odstranjujte CR ali LF iz sredine vsebine, ki ju sme vsebovati.

Kako predpone in pripone vplivajo na spletne aplikacije

Branje s tipkovnim klinom je niz pritiskov v element, ki ima fokus. Stran čitalnika ne odpre. Če je fokus na drugem polju, gredo tja predpona, črtna koda in pripona.

keydown se sproži za vsako tipko, vključno z Enter in Tab, preden brskalnik vstavi znak ali premakne fokus. event.key je znak ali ime tipke, potem ko operacijski sistem uporabi postavitev tipkovnice. Natisljivi znaki predpone in pripone se v polju pokažejo skozi dogodek input. Enter in Tab ne.

Poslušalec spodaj potrdi polje, ko prispe Enter. Ne doda pripone, ki jo je čitalnik izpustil. Če čitalnik ne pošilja Enter, vrednost ostane v polju, dokler je ne prebere nekaj drugega.

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 branjem. preventDefault() prepreči, da bi se nadrejeni obrazec oddal drugič. Če polje ni znotraj obrazca in želite izvorno oddajo, preventDefault() izpustite.

Brez pripone počakajte na izrecno dejanje: gumb, poznejši Enter od operaterja ali naslednji korak poteka. Časovna omejitev nedejavnosti lahko premor vzame za konec branja. Ta omejitev je hevristika. Počasen čitalnik, zakasnitev Bluetooth ali hitro tipkanje lahko padejo na napačno stran praga. Ko potek potrebuje določen konec, raje nastavite pripono.

Znano natisljivo predpono je mogoče odstraniti, ko preberete vrednost:

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

Posredujte samo predpono, ki ste jo nastavili, na primer ']C1'. Ne odrežite poljubnega števila znakov z vsakega branja.

Celoten obrazec, ki obravnava tudi Tab, prazen vnos in drugo branje, je v vodniku Kako preizkusiti čitalnike črtnih kod v spletnih aplikacijah.

Kako nastaviti predpone in pripone

Nastavitve predpone in pripone so na čitalniku. Imena postavk in način njihove spremembe so odvisni od izdelovalca. Ni konfiguracijske črtne kode, ki bi delovala pri vsaki znamki, in ta vodnik je ne natisne.

Običajni načini:

  • Preberite konfiguracijsko črtno kodo iz priročnika za natančen model. List je združen po nastavitvi: pripona, predpona, postavitev tipkovnice, simbologija.
  • Uporabite izdelovalčev nastavitveni program, nato rezultat zapišite v čitalnik prek USB.
  • Uporabite pripomoček za upravljanje naprav te linije, ko posodabljate veliko enot.

Po spremembi preberite znano črtno kodo in rezultat primerjajte z opisom izbrane nastavitve v priročniku. Tovarniška ponastavitev z druge znamke lahko čitalnik pusti nespremenjen ali ga prestavi v nepričakovan način. Vodnik Vodnik za nastavitev čitalnika črtnih kod povzame nastavitve, ki običajno štejejo. Priročnika naprave ne nadomesti.

Barcode Scanner Emulator lahko vtipka vrednost, ki jo izberete, in nato pošlje ENTER, TAB ali nobene pripone. V to vrednost vstavite natisljivo predpono, ko morate preizkusiti obravnavo predpone brez strojne opreme. Emulator ne odda zaporednega para bajtov CR/LF in ne bere nalepke.

Kako preizkusiti vedenje predpone in pripone

Uporabite čitalnik v načinu tipkovnice, tipkovnico USB HID ali tipkovnico Bluetooth HID.

  1. Priključite ga in počakajte, da pokaže, da ima napajanje.
  2. Odprite preizkuševalnik vnosa črtnih kod.
  3. Kliknite Začni preizkus ali kliknite območje branja. Pomodri, ko je pripravljeno. Stran sama ne prevzame fokusa.
  4. Preberite črtno kodo, katere vsebino že poznate.
  5. Preberite zajeto vrednost in število znakov. Natisljivi znaki predpone ali pripone so znotraj tega niza. Vrstica Predpona je za poimenovane tipke, ki prispejo pred prvim znakom, na primer modifikator. Ne izvleče vtipkane predpone, kot je ]C1, iz besedila črtne kode.
  6. Preverite pripono. Preizkuševalnik sporoči ENTER, TAB ali Brez. Ko je Samodejni zajem vklopljen, se rezultat pokaže po Enter, Tab ali kratkem premoru, ko tipke ponehajo. Izklopite Samodejni zajem, da zajem zadržite, dokler ne pritisnete Ustavi. Enter in Tab nista del niza črtne kode.
  7. Ta rezultat primerjajte z nastavitvijo, ki ste jo nameravali. Nato odprite preizkuševalnik dogodkov tipkovnice in berite znova, ko potrebujete vsak keydown po vrsti, vključno s key, code in časom.

Preizkuševalnik vnosa beleži dogodke tipkovnice, ki jih brskalnik vidi. Zaporednih vrat ne more brati, zato ne more pokazati CR ali LF kot surovih bajtov. Preizkus klina ne dokazuje, kaj bo poslala zaporedna nastavitev.

Odpravljanje težav

Čitalnik ne pošilja ENTER. Črtna koda se pojavi, kurzor pa ostane v polju. Preizkuševalnik vnosa sporoči Brez. Pripona je izklopljena ali je nastavljena na nekaj drugega kot Enter. Glejte Čitalniku črtnih kod manjka ENTER.

TAB nepričakovano premakne fokus. Čitalnik pošilja tipko Tab. To je nastavljena pripona. Uporabite Enter, ko naj se obrazec odda, ali berite vrednost ob keydown tipke Tab, ko naj potek napreduje. Podrobnosti so v vodniku Pripone ENTER in TAB v čitalnikih črtnih kod.

Obrazec se odda dvakrat. Brskalnik ga odda ob Enter, poslušalec keydown pa branje prav tako sprejme. Pustite eno pot zaključka in na drugi pokličite preventDefault().

Predpona se pojavi znotraj črtne kode. Natisljiva predpona je del zajetega niza. Ali jo na čitalniku izklopite, ali v aplikaciji odstranite natanko to zaporedje. Vključen identifikator simbologije je pogost vir vodilnega ] in še dveh znakov. Kontrolna predpona, ki je klin ne zna vtipkati, bo manjkala in ne bo vidna.

Znaki so napačni. Postavitev čitalnika in postavitev operacijskega sistema se lahko razideta, kar spremeni znake predpone in ločila, dolžina pa ostane enaka. Glejte Napačna postavitev tipkovnice čitalnika črtnih kod.

Aplikacija nikoli ne vidi konca branja. Pripone ni, stran pa čaka Enter. Dodajte pripono, ki ustreza obrazcu, ali vrednost dokončajte z izrecnim dejanjem. Ugibanje po času bo zgrešilo nekaj pravih branj in sprejelo del tipkanja.

CR/LF se med aplikacijami razlikuje. Notepad vstavi novo vrstico, ko prejme Enter. Spletno besedilno polje obdrži črtno kodo in sproži dogodek tipke. Zaporedni program lahko prejme 0x0D, 0x0A ali oba. Primerjajte vmesnik, preden spremenite čitalnik. Če nobena aplikacija ne prejme znakov, začnite z Čitalnik črtnih kod ne deluje.

Širši prehod čez fokus, ponovljena branja in poteke POS je v vodniku Kako preizkusiti vnos čitalnika črtnih kod.

Preizkusna matrika

Stolpec nastavitve je tisto, kar nastavite na čitalniku, ali tisto, kar vtipkate z emulatorjem, ko gre za tipkovno pripono. Pričakovano vedenje je tisto, kar naj naredi aplikacija. Primer zaporednega CRLF ni isti preizkus kot tipka Enter v brskalniku.

Nastavitev Pričakovano vedenje aplikacije
Brez predpone, brez pripone Vrednost črtne kode je prejeta in zaključna tipka ne prispe. Vrednost ostane na voljo, dokler je aplikacija ne prebere.
Brez predpone, pripona ENTER Aplikacija prejme zaključno tipko enkrat in shrani vsebino brez zaključnega znaka.
Brez predpone, pripona TAB Fokus se lahko premakne na naslednji element. Aplikacija prebere vrednost pred tem premikom.
Lastna natisljiva predpona Znaki predpone se pojavijo pred dekodiranimi podatki. Aplikacija to natančno predpono namenoma obdrži ali odstrani.
Lastna natisljiva pripona Znaki pripone se pojavijo za dekodiranimi podatki. Enter in Tab sta tipki, zato se v nizu ne pojavita.
Zaporedje CRLF Zaporedni ali terminalski gostitelj obdela nastavljena bajta CR in LF. Besedilno polje brskalnika teh bajtov od pritiska Enter ne dobi.

Vrstice tipkovnice zaženite na klinastem čitalniku in, ko strojne opreme ni, z nastavitvami emulatorja ENTER, TAB in brez pripone. Vrstico CRLF zaženite na vmesniku, ki naj te bajte nosi. Dejanski rezultat je še vedno odvisen od tega vmesnika in od aplikacije.