Naar inhoud springen

Barcode Scanner Emulator

Voorvoegsel en achtervoegsel bij barcodescanners: volledige gids

Een voorvoegsel is data of een besturingsreeks die een barcodescanner vóór de gedecodeerde barcode stuurt. Een achtervoegsel is wat hij daarna stuurt. Hetzelfde model kan andere voorvoegsels en achtervoegsels krijgen, en een seriële scanner levert ze niet op dezelfde manier als een toetsenbordwig.

Een voorvoegsel van een barcodescanner wordt vóór de gedecodeerde waarde gestuurd. Een achtervoegsel wordt erna gestuurd. Een scanner kan deze reeks produceren:

Voorvoegsel: STX

Barcode: 123456789

Achtervoegsel: ENTER

STX in een handleiding betekent vaak het stuurteken, niet de drie letters S, T en X. ENTER op een toetsenbordwig is meestal de Enter-toets, niet de twee tekens CR en LF die in een tekstveld worden gezet. Wat je ontvangt, hangt af van het model, de interface en de toepassing. Geen enkele instelling geldt voor elk apparaat.

De gids ENTER- en TAB-achtervoegsels bij barcodescanners blijft bij het kiezen en het oplossen van die twee afsluiters. Deze gids gaat over het kader rond de barcode: wat ervoor komt, wat erna komt en hoe een webtoepassing beide moet lezen.

Wat is een voorvoegsel van een barcodescanner?

Een voorvoegsel is een ingestelde reeks die de scanner vóór de gegevens verstuurt. De gegevens zijn de tekst die de symbologie heeft gedecodeerd, zoals 123456789. Het voorvoegsel hoort niet bij die decodering, tenzij de scanner is ingesteld om het toe te voegen.

Gangbare toepassingen:

  • Het begin van een bericht markeren. Seriële en terminalprotocollen sturen soms een stuurteken, vaak STX genoemd, zodat de host weet dat een nieuw frame is begonnen.
  • De symbologie benoemen. Met de AIM-symbologie-id aan kan een scanner een kort afdrukbaar voorvoegsel sturen, zoals ]C1 voor Code 128 of ]E0 voor EAN, vóór de cijfers. De toepassing kan op die id vertakken.
  • Invoer sturen in oudere POS- of terminalsoftware. Een vaste code vóór de gegevens vertelde de host bij welk veld of apparaat de scan hoorde.
  • Een bepaald station labelen. Twee scanners kunnen verschillende afdrukbare voorvoegsels krijgen, zodat een log laat zien welke baan de code stuurde.

Een afdrukbaar voorvoegsel bestaat uit gewone tekens. Ze verschijnen in een tekstveld aan het begin van de tekenreeks. Een stuurteken als voorvoegsel, zoals STX (0x02), zijn niet de letters S, T en X. Een toetsenbordwig kan dat stuurteken misschien helemaal niet typen. Een seriële scanner kan het als byte sturen. Lees de handleiding van het model dat je hebt voordat je code schrijft die het ene of het andere verwacht.

Een voorvoegsel bewijst niet dat een scanner de invoer heeft gemaakt. Een persoon, een macro of de Barcode Scanner Emulator kan dezelfde tekens typen. Behandel een voorvoegsel als de omkadering die je hebt ingesteld en valideer de gegevens zoals je elke andere gebruikersinvoer valideert.

Wat is een achtervoegsel van een barcodescanner?

Een achtervoegsel is een ingestelde reeks die na de gegevens wordt gestuurd. De gebruikelijke taak is de toepassing laten weten dat de scan klaar is, of de focus verplaatsen. Scanners verschillen. Sommige bieden Enter, Tab, CR, LF, CR+LF, een eigen tekenreeks of niets. Sommige bieden er maar een of twee van.

ENTER. De Enter-toets. In een browser is dat een toetsenbordgebeurtenis, event.key === "Enter". Hij wordt niet in een gewoon tekstveld gezet.

TAB. De Tab-toets, event.key === "Tab". De browser verplaatst de focus naar het volgende besturingselement. De toets wordt niet in het veld gezet.

CR. Carriage return, ASCII 0x0D. Op een seriële of terminalinterface kan dat een echte byte na de gegevens zijn. Op een toetsenbordwig betekent een instelling met het label CR of carriage return meestal de Enter-toets. De browser meldt nog steeds Enter. De veldwaarde krijgt geen CR-teken.

LF. Line feed, ASCII 0x0A. Het is een ander stuurteken dan CR. Op een seriële stroom kan het een eigen byte zijn. Een toetsenbordwig heeft geen standaard Line Feed-toets zoals Enter en Tab. Ga er niet van uit dat een menu-item met de naam LF een zichtbaar teken of een tweede Enter typt.

CRLF. CR gevolgd door LF, de twee bytes 0x0D 0x0A. Sommige seriële hosts en terminals verwachten dat paar als regeleinde. Een tekstveld in de browser bewaart dat paar niet wanneer iemand op Enter drukt.

Eigen tekens. Een afdrukbaar achtervoegsel zoals # of een korte code wordt na de barcode getypt en wordt dus deel van de tekenreeks, tenzij de toepassing het verwijdert. Een eigen stuurteken volgt dezelfde splitsing als STX: bytes op een seriële poort, toetsaanslagen op een wig, en alleen de toetsaanslagen die de toetsenbordinterface echt kan sturen.

ENTER, CR en LF zijn in handleidingen verwante namen voor regeleinde. Ze zijn niet in elke toepassing uitwisselbaar. Een wigscanner, een seriële scanner, Notepad en een webformulier kunnen bij een instelling met dezelfde naam elk een ander resultaat laten zien.

Voorvoegsel en achtervoegsel

Kenmerk Voorvoegsel Achtervoegsel
Positie Vóór de barcodegegevens Na de barcodegegevens
Doel Het begin markeren of de invoer labelen De voltooiing markeren of een actie starten
Voorbeeld STX, of een afdrukbare AIM-id zoals ]C1 ENTER, TAB of een afdrukbaar teken zoals #
Gangbaar gebruik De scan omkaderen of herkennen Een formulier verzenden of de focus verplaatsen
In een tekstveld Afdrukbare tekens staan aan het begin van de waarde Afdrukbare tekens staan aan het einde. Enter en Tab niet
Identiteit Een ingestelde markering die iedereen kan typen Een ingestelde markering die iedereen kan typen

Verwijder een voorvoegsel of een eigen achtervoegsel alleen wanneer je precies die reeks hebt ingesteld en het opgeslagen record hem niet mag bevatten. Laat een AIM-id staan tot de toepassing een regel ervoor heeft.

ENTER, TAB, CR en LF

Deze namen staan op configuratiebladen. De ontvangende kant ziet toetsaanslagen of bytes, afhankelijk van de interface. De gids HID-toetsenbordwig beschrijft het pad van de toetsaanslagen. Een seriële poort is een ander pad: de toepassing leest bytes, en de focus kiest niet waar ze naartoe gaan.

ENTER

Op een toetsenbordwig is ENTER de Enter-toets. In een tekstveld van één regel gebruiken huidige browsers die toets om het omvattende formulier te verzenden. Een zoekvak kan de scan bij die gebeurtenis vastleggen. Een formulier met meerdere velden kan verzenden voordat latere velden zijn ingevuld. Roep preventDefault() aan op de gebeurtenis submit, of op de Enter-keydown, wanneer de pagina de waarde moet houden en op zijn plaats moet blijven. Handel Enter op één plek af. Een keydown-listener en een submit-listener die de scan allebei accepteren, leggen hem twee keer vast.

Sommige scanners sturen NumPad Enter. event.key is nog steeds "Enter". event.code kan "NumpadEnter" zijn in plaats van "Enter". Test event.key als beide toetsen het veld moeten vastleggen.

De gids ENTER- en TAB-achtervoegsels bij barcodescanners vergelijkt die twee keuzes voor POS en webformulieren. Barcodescanner mist ENTER behandelt een scanner die de barcode typt en dan stopt.

TAB

TAB is de Tab-toets. De browser verplaatst de focus na keydown. Lees het veld in die keydown-handler, zolang het nog de focus heeft, en laat de standaardactie staan wanneer het volgende element de cursor moet krijgen. preventDefault() houdt de focus op het huidige veld.

Shift+Tab is dezelfde toets met Shift ingedrukt. Een Tab-achtervoegsel van de scanner is Tab zonder Shift. Negeer event.shiftKey als toetsenbordgebruikers achteruit door het formulier moeten kunnen.

CR

Carriage return zet in een terminal de cursor aan het begin van de regel. De byte is 0x0D. Een seriële scanner kan die byte aan de gegevens toevoegen. Een toetsenbordwig-instelling met de naam CR stuurt doorgaans de Enter-toets in plaats van 0x0D in de tekst te zetten. Enter indrukken in een browserveld schrijft geen CR-teken in input.value.

Als de host een terminal of een programma op een COM-poort is, zoek dan naar de byte. Als de host een webpagina is, zoek dan naar event.key === "Enter".

LF

Line feed zet de cursor in een terminal één regel omlaag. De byte is 0x0A. Sommige hosts behandelen LF alleen als het regeleinde. Andere negeren het tenzij CR eerst kwam. Een wigscanner die LF als achtervoegsel noemt, kan een toets sturen die het besturingssysteem niet in een regeleinde verandert, of niets sturen dat een tekstveld bewaart. Vang de toets in de toetsenbordevenemententester voordat je een veronderstelde LF in applicatiecode afhandelt.

CRLF

CRLF is de reeks van twee stuurtekens, eerst CR en dan LF. Tekstbestanden in Windows-stijl en veel seriële apparaten gebruiken die als één regeleinde. Een configuratiepagina die een CRLF-achtervoegsel noemt, betekent dat de scanner dat paar na de gegevens probeert te sturen op de interface die hij gebruikt.

In een browser levert een druk op Enter geen letterlijke CRLF-reeks op in een tekstveld. Het formulier ontvangt een toetsenbordgebeurtenis. Een <textarea> kan een regeleinde invoegen wanneer de gebruiker op Enter drukt, en dat regeleinde is het eigen bewerkingsgedrag van de browser, geen bewijs dat de scanner de bytes 0x0D 0x0A heeft uitgezonden. Een serieel leesprogramma kan die twee bytes ontvangen en moet ze alleen als afsluiter behandelen als die scanner zo is ingesteld dat hij ze stuurt. Haal CR of LF niet uit het midden van gegevens die ze mogen bevatten.

Hoe voorvoegsels en achtervoegsels webtoepassingen raken

Een scan via een toetsenbordwig is een reeks toetsaanslagen in het element met focus. De pagina opent de scanner niet. Staat de focus op een ander veld, dan gaan voorvoegsel, barcode en achtervoegsel daar allemaal heen.

keydown vuurt voor elke toets, inclusief Enter en Tab, voordat de browser een teken invoegt of de focus verplaatst. event.key is het teken of de toetsnaam nadat het besturingssysteem de toetsenbordindeling heeft toegepast. Afdrukbare voorvoegsel- en achtervoegseltekens verschijnen in het veld via de gebeurtenis input. Enter en Tab verschijnen daar niet.

De listener hieronder legt het veld vast wanneer Enter aankomt. Hij voegt geen achtervoegsel toe dat de scanner heeft weggelaten. Stuurt de scanner geen Enter, dan blijft de waarde in het veld tot iets anders hem leest.

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 = ''
})

Geef #barcode focus vóór de scan. preventDefault() houdt een bovenliggend formulier tegen om een tweede keer te verzenden. Staat de invoer niet in een formulier en wil je de native verzending, laat preventDefault() dan weg.

Zonder achtervoegsel wacht je op een expliciete actie: een knop, een latere Enter van de operator of de volgende stap in de workflow. Een inactiviteitstimer kan een pauze als het einde van de scan zien. Die timer is een heuristiek. Een trage scanner, een Bluetooth-vertraging of iemand die snel typt, kan aan de verkeerde kant vallen. Geef de voorkeur aan een ingesteld achtervoegsel wanneer de workflow een duidelijk einde nodig heeft.

Een bekend afdrukbaar voorvoegsel kun je verwijderen nadat je de waarde hebt gelezen:

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

Geef alleen het voorvoegsel door dat je hebt ingesteld, zoals ']C1'. Haal niet bij elke scan een willekeurig aantal tekens weg.

Voor een volledig formulier dat ook Tab, lege invoer en een tweede scan afhandelt, zie Barcodescanners testen in webtoepassingen.

Voorvoegsels en achtervoegsels configureren

Voorvoegsel- en achtervoegselinstellingen staan op de scanner. De toetsnamen en de manier waarop je ze wijzigt, hangen van de fabrikant af. Er is geen configuratiebarcode die op elk merk werkt, en deze gids drukt er geen af.

Gebruikelijke methoden:

  • Scan een configuratiebarcode uit de handleiding van precies dat model. Het blad is gegroepeerd per instelling: achtervoegsel, voorvoegsel, toetsenbordindeling, symbologie.
  • Gebruik het configuratieprogramma van de fabrikant en schrijf het resultaat daarna via USB naar de scanner.
  • Gebruik het apparaatbeheer van die productlijn wanneer je veel exemplaren bijwerkt.

Scan na een wijziging een bekende barcode en vergelijk het resultaat met de beschrijving van de gekozen instelling in de handleiding. Een fabrieksreset van een ander merk kan de scanner ongewijzigd laten of in een onverwachte modus zetten. De Configuratiehandleiding voor barcodescanners vat de instellingen samen die meestal van belang zijn. Hij vervangt de handleiding niet.

De Barcode Scanner Emulator kan een waarde typen die je kiest en daarna ENTER, TAB of geen achtervoegsel sturen. Zet een afdrukbaar voorvoegsel in die waarde wanneer je de afhandeling van een voorvoegsel zonder hardware wilt oefenen. De emulator zendt geen serieel CR/LF-bytepaar uit en leest geen etiket.

Gedrag van voorvoegsel en achtervoegsel testen

Gebruik een scanner in toetsenbordmodus, USB-HID-toetsenbord of Bluetooth-HID-toetsenbord.

  1. Sluit hem aan en wacht tot hij laat zien dat hij stroom heeft.
  2. Open de barcode-invoertester.
  3. Klik op Start Test of op het scangebied. Het wordt blauw wanneer het klaar is. De pagina neemt niet uit zichzelf de focus.
  4. Scan een barcode waarvan je de gegevens al kent.
  5. Lees de vastgelegde waarde en het aantal tekens. Afdrukbare voorvoegsel- of achtervoegseltekens zitten in die tekenreeks. De regel Prefix is voor benoemde toetsen die vóór het eerste teken aankomen, zoals een modifier. Hij haalt een getypt voorvoegsel zoals ]C1 niet uit de barcodetekst.
  6. Controleer het achtervoegsel. De tester meldt ENTER, TAB of None. Met Auto capture aan verschijnt het resultaat na Enter, Tab of een korte pauze zodra de toetsen stoppen. Zet Auto capture uit om de vastlegging vast te houden tot je op Stop drukt. Enter en Tab horen niet bij de barcodestring.
  7. Vergelijk dat resultaat met de configuratie die je bedoelde. Open daarna de toetsenbordevenemententester en scan opnieuw wanneer je elke keydown op volgorde nodig hebt, inclusief key, code en de timing.

De invoertester legt toetsenbordgebeurtenissen vast die de browser kan zien. Hij kan geen seriële poort lezen en dus CR of LF niet als ruwe bytes tonen. Een wigtest bewijst niet wat een seriële instelling zal sturen.

Problemen oplossen

De scanner stuurt geen ENTER. De barcode verschijnt en de cursor blijft in het veld. De invoertester meldt None. Het achtervoegsel staat uit, of het staat op iets anders dan Enter. Zie Barcodescanner mist ENTER.

TAB verplaatst de focus onverwacht. De scanner stuurt de Tab-toets. Dat is het ingestelde achtervoegsel. Gebruik Enter wanneer het formulier moet verzenden, of lees de waarde bij de Tab-keydown wanneer de workflow moet doorgaan. Details staan in de gids ENTER- en TAB-achtervoegsels bij barcodescanners.

Het formulier wordt twee keer verzonden. De browser verzendt bij Enter, en een keydown-listener accepteert de scan ook. Houd één afrondingspad en roep op het andere preventDefault() aan.

Een voorvoegsel verschijnt in de barcode. Een afdrukbaar voorvoegsel maakt deel uit van de vastgelegde tekenreeks. Zet het uit op de scanner of verwijder precies die reeks in de toepassing. Een ingeschakelde symbologie-id is een veelvoorkomende bron van een leidende ] en nog twee tekens. Een stuurvoorvoegsel dat de wig niet kan typen, ontbreekt in plaats van zichtbaar te zijn.

De tekens zijn fout. De indeling van de scanner en die van het besturingssysteem kunnen uiteenlopen, waardoor voorvoegseltekens en leestekens veranderen terwijl de lengte gelijk blijft. Zie Verkeerde toetsenbordindeling van de barcodescanner.

De toepassing ziet nooit het einde van de scan. Er is geen achtervoegsel en de pagina wacht op Enter. Voeg een achtervoegsel toe dat bij het formulier past, of rond de waarde af met een expliciete actie. Een timinggok mist sommige echte scans en accepteert wat getyp.

CR/LF verschilt tussen toepassingen. Notepad voegt een nieuwe regel in wanneer hij Enter ontvangt. Een webtekstveld houdt de barcode en vuurt een toetsgebeurtenis. Een serieel programma kan 0x0D, 0x0A of beide ontvangen. Vergelijk de interface voordat je de scanner wijzigt. Als geen enkele toepassing tekens ontvangt, begin dan bij Barcodescanner werkt niet.

Een bredere ronde over focus, herhaalde scans en POS-workflows staat in Scannerinvoer van barcodes testen.

Testmatrix

De kolom configuratie is wat je op de scanner instelt, of wat je met de emulator typt wanneer het geval een toetsenbordachtervoegsel is. Het verwachte gedrag is wat de toepassing moet doen. Een seriële CRLF-rij is niet dezelfde test als een Enter-toets in een browser.

Configuratie Verwacht gedrag van de toepassing
Geen voorvoegsel, geen achtervoegsel De barcodewaarde wordt ontvangen en er komt geen voltooiingstoets aan. De waarde blijft beschikbaar tot de toepassing hem leest.
Geen voorvoegsel, achtervoegsel ENTER De toepassing ontvangt de voltooiingstoets één keer en bewaart de gegevens zonder een afsluiterteken.
Geen voorvoegsel, achtervoegsel TAB De focus kan naar het volgende element gaan. De toepassing leest de waarde vóór die verplaatsing.
Eigen afdrukbaar voorvoegsel De voorvoegseltekens verschijnen vóór de gedecodeerde gegevens. De toepassing houdt of verwijdert precies dat voorvoegsel met opzet.
Eigen afdrukbaar achtervoegsel De achtervoegseltekens verschijnen na de gedecodeerde gegevens. Enter en Tab zijn toetsen, dus ze verschijnen niet in de tekenreeks.
CRLF-reeks Een seriële host of een terminal verwerkt de ingestelde bytes CR en LF. Een tekstveld in de browser krijgt die bytes niet van een Enter-toetsdruk.

Voer de toetsenbordrijen uit op de wigscanner en, als er geen hardware is, met de instellingen ENTER, TAB en geen achtervoegsel van de emulator. Voer de CRLF-rij uit op de interface die die bytes moet dragen. De echte resultaten hangen nog steeds van die interface en van de toepassing af.