Hopp til innhold

Barcode Scanner Emulator

Prefiks og suffiks i strekkodeskannere: fullstendig veiledning

Et prefiks er data eller en styresekvens som en strekkodeskanner sender før den dekodede strekkoden. Et suffiks er det skanneren sender etter den verdien. Samme modell kan settes opp med ulike prefiks og suffiks, og en seriell skanner leverer dem på en annen måte enn en skanner med tastaturkile.

Prefikset til en strekkodeskanner går ut før den dekodede verdien. Suffikset går ut etterpå. En enkelt skanner kan gi denne rekkefølgen:

Prefiks: STX

Strekkode: 123456789

Suffiks: ENTER

Når en håndbok skriver STX, mener den som regel styretegnet, ikke bokstavene S, T og X. ENTER på en skanner med tastaturkile er vanligvis Enter-tasten, ikke tegnene CR og LF limt inn i et tekstfelt. Hva du faktisk får, henger på modell, grensesnitt og program. Ingen oppsett gjelder for alle.

Veiledningen ENTER- og TAB-suffikser holder seg til å velge og feilsøke de to avslutningene. Denne veiledningen tar for seg rammen rundt strekkoden: det som kommer foran, det som kommer etter, og hvordan et nettprogram bør lese begge deler.

Hva er et prefiks på en strekkodeskanner?

Et prefiks er en oppsatt sekvens som skanneren sender før lasten. Lasten er teksten symbologien dekodet, for eksempel 123456789. Prefikset hører ikke med i den dekodingen, med mindre skanneren er satt til å legge det til.

Vanlige oppgaver:

  • Merke starten på en melding. Serielle protokoller og terminalprotokoller sender av og til et styretegn, ofte kalt STX, slik at verten vet at en ny ramme har startet.
  • Navngi symbologien. Med AIM-symbologiidentifikatoren slått på kan en skanner sende et kort utskrivbart prefiks som ]C1 for Code 128 eller ]E0 for EAN foran sifrene. Programmet kan forgrene seg på den identifikatoren.
  • Rute inndata i eldre POS- eller terminalprogramvare. En fast kode foran dataene fortalte verten hvilket felt eller hvilken enhet skanningen hørte til.
  • Merke en bestemt stasjon. To skannere kan få ulike utskrivbare prefiks, slik at en logg kan vise hvilket spor som sendte koden.

Et utskrivbart prefiks er vanlige tegn. De ligger først i strengen i et tekstfelt. Et styretegnsprefiks, for eksempel STX (0x02), er ikke bokstavene S, T og X. En skanner med tastaturkile kan være ute av stand til å taste det styretegnet i det hele tatt. En seriell skanner kan sende det som en byte. Les håndboken for modellen du har, før du skriver kode som venter det ene eller det andre.

Et prefiks beviser ikke at en skanner laget inndataene. En person, en makro eller Barcode Scanner Emulator kan taste de samme tegnene. Behandle prefikset som en ramme du har satt opp, og valider deretter lasten slik du validerer annen brukerinndata.

Hva er et suffiks på en strekkodeskanner?

Et suffiks er en oppsatt sekvens som sendes etter lasten. Den vanlige jobben er å si fra til programmet at skanningen er ferdig, eller å flytte fokus. Skannere er ulike. Noen tilbyr Enter, Tab, CR, LF, CR+LF, en egen streng eller ingenting. Noen tilbyr bare én eller to av disse.

ENTER. Enter-tasten. I en nettleser er det en tastaturhendelse, event.key === "Enter". Den settes ikke inn i et vanlig tekstfelt.

TAB. Tab-tasten, event.key === "Tab". Nettleseren flytter fokus til neste kontroll. Tasten settes ikke inn i feltet.

CR. Vognretur, ASCII 0x0D. På et seriellt grensesnitt eller et terminalgrensesnitt kan det være en ekte byte etter lasten. På en tastaturkile betyr en innstilling merket CR eller vognretur vanligvis Enter-tasten. Nettleseren rapporterer fortsatt Enter. Feltverdien får ikke et CR-tegn.

LF. Linjemating, ASCII 0x0A. Det er et annet styretegn enn CR. I en seriell strøm kan det være en egen byte. En tastaturkile har ingen standardtast for Line Feed slik den har Enter og Tab. Ikke gå ut fra at et menypunkt som heter LF skriver et synlig tegn eller et ekstra Enter.

CRLF. CR etterfulgt av LF, de to bytene 0x0D 0x0A. Enkelte serielle verter og terminalverter venter det paret som linjeslutt. Et tekstfelt i nettleseren lagrer ikke det paret når noen trykker Enter.

Egne tegn. Et utskrivbart suffiks som # eller en kort kode tastes etter strekkoden, så det blir en del av strengen med mindre programmet fjerner det. Et eget styretegn følger samme skille som STX: byte på en seriell port, tastetrykk på en kile, og bare de tastetrykkene tastaturgrensesnittet faktisk kan sende.

ENTER, CR og LF er beslektede navn på linjeslutt i håndbøker. De kan ikke byttes fritt i alle program. En kileskanner, en seriell skanner, Notisblokk og et nettskjema kan hver for seg vise et annet resultat for en innstilling med samme navn.

Prefiks sammenlignet med suffiks

Egenskap Prefiks Suffiks
Plassering Før strekkodedataene Etter strekkodedataene
Formål Merke begynnelsen eller merke inndataene Merke fullføring eller utløse en handling
Eksempel STX, eller en utskrivbar AIM-identifikator som ]C1 ENTER, TAB eller et utskrivbart tegn som #
Vanlig bruk Ramme inn eller identifisere skanningen Sende et skjema eller flytte fokus
I et tekstfelt Utskrivbare tegn ligger først i verdien Utskrivbare tegn ligger sist. Enter og Tab gjør det ikke
Identitet En oppsatt markør som hvem som helst kan taste En oppsatt markør som hvem som helst kan taste

Fjern et prefiks eller et eget suffiks bare når du har satt opp nøyaktig den sekvensen, og den lagrede posten ikke skal inneholde den. La en AIM-identifikator stå til programmet har en regel for den.

ENTER, TAB, CR og LF

Disse navnene står på oppsettsark. Mottakersiden ser enten tastetrykk eller byte, alt etter grensesnittet. Veiledningen HID-tastaturkile beskriver tastetrykkveien. En seriell port er en annen vei: programmet leser byte, og fokus velger ikke hvor de havner.

ENTER

På en skanner med tastaturkile er ENTER Enter-tasten. I et tekstfelt på én linje bruker dagens nettlesere den tasten til å sende skjemaet rundt. Et oppslagsfelt kan bekrefte skanningen på den hendelsen. Et skjema med flere felt kan bli sendt før senere felt er fylt ut. Kall preventDefault() på hendelsen submit, eller på Enter-keydown, når siden skal beholde verdien og bli stående. Håndter Enter på ett sted. En keydown-lytter og en submit-lytter som begge tar imot skanningen, registrerer den to ganger.

Noen skannere sender NumPad Enter. event.key er fortsatt "Enter". event.code kan være "NumpadEnter" heller enn "Enter". Test event.key hvis begge tastene skal bekrefte feltet.

Veiledningen ENTER- og TAB-suffikser sammenligner de to valgene for POS og nettskjema. Strekkodeskanner mangler ENTER tar for seg en skanner som skriver strekkoden og deretter stopper.

TAB

TAB er Tab-tasten. Nettleseren flytter fokus etter keydown. Les feltet i den keydown-behandleren mens det fortsatt har fokus, og la standardhandlingen stå når neste kontroll skal få markøren. preventDefault() holder fokus på det gjeldende feltet.

Shift+Tab er samme tast med Shift holdt nede. Et Tab-suffiks fra skanneren er Tab uten Shift. Overse event.shiftKey hvis tastaturbrukere må kunne gå bakover i skjemaet.

CR

Vognretur flytter en markør til starten av linjen i en terminal. Byten er 0x0D. En seriell skanner kan hekte den byten på lasten. Et kileoppsett med navnet CR sender typisk Enter-tasten i stedet for å sette inn 0x0D i teksten. Et trykk på Enter i et nettleserfelt skriver ikke et CR-tegn inn i input.value.

Er verten en terminal eller en lytter på en COM-port, se etter byten. Er verten en nettside, se etter event.key === "Enter".

LF

Linjemating flytter en terminalmarkør én linje ned. Byten er 0x0A. Noen verter behandler LF alene som linjeskift. Andre overser det med mindre CR kom først. En kileskanner som lister LF som suffiks, kan sende en tast som operativsystemet ikke gjør om til linjeskift, eller den kan sende noe et tekstfelt ikke beholder. Fang tasten i tastaturhendelsestesten før du håndterer et antatt LF i programkoden.

CRLF

CRLF er tostyresekvensen CR og deretter LF. Tekstfiler i Windows-stil og mange serielle enheter bruker den som ett linjeskift. En oppsettsside som sier CRLF-suffiks, betyr at skanneren vil prøve å sende det paret etter lasten på grensesnittet den bruker.

I en nettleser gir et trykk på Enter ikke en bokstavelig CRLF-sekvens inne i et tekstfelt. Skjemaet mottar en tastaturhendelse. En <textarea> kan sette inn et linjeskift når brukeren trykker Enter, og det linjeskiftet er nettleserens egen redigeringsatferd, ikke et bevis på at skanneren sendte bytene 0x0D 0x0A. En seriell leser kan motta de to bytene og bør behandle dem som avslutning bare hvis akkurat den skanneren var satt opp til å sende dem. Ikke fjern CR eller LF fra midten av en last som har lov til å inneholde dem.

Slik virker prefiks og suffiks inn på nettprogrammer

En skanning med tastaturkile er en skur av tastetrykk inn i kontrollen som har fokus. Siden åpner ikke skanneren. Ligger fokus i et annet felt, havner prefikset, strekkoden og suffikset der.

keydown utløses for hver tast, også Enter og Tab, før nettleseren setter inn et tegn eller flytter fokus. event.key er tegnet eller tastens navn etter at operativsystemet har brukt tastaturoppsettet. Utskrivbare prefiks- og suffikstegn dukker opp i feltet via hendelsen input. Enter og Tab gjør det ikke.

Lytteren under bekrefter feltet når Enter kommer. Den legger ikke til et suffiks skanneren utelot. Sender skanneren ikke Enter, blir verdien liggende i feltet til noe annet leser den.

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

Gi #barcode fokus før skanningen. preventDefault() hindrer et overordnet skjema i å bli sendt en gang til. Ligger inndataene ikke i et skjema, og du vil ha den innebygde sendingen, utelat preventDefault().

Uten suffiks venter du på en tydelig handling: en knapp, et senere Enter fra operatøren, eller neste steg i arbeidsflyten. En inaktivitetstidtaker kan behandle en pause som slutten på skanningen. Den tidtakeren er et anslag. En treg skanner, en Bluetooth-forsinkelse eller en rask skriver kan havne på feil side av den. Foretrekk et oppsatt suffiks når arbeidsflyten trenger en sikker slutt.

Et kjent utskrivbart prefiks kan fjernes etter at du har lest verdien:

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

Send bare prefikset du har satt opp, for eksempel ']C1'. Ikke fjern et vilkårlig antall tegn fra hver skanning.

For et helt skjema som også håndterer Tab, tomme inndata og en ny skanning, se Slik tester du strekkodeskannere i webprogrammer.

Slik setter du opp prefiks og suffiks

Innstillingene for prefiks og suffiks ligger på skanneren. Tastnavnene og måten du endrer dem på, er spesifikke for produsenten. Det finnes ingen oppsettsstrekkode som virker på alle merker, og denne veiledningen skriver ikke ut en.

Vanlige metoder:

  • Skann en oppsettsstrekkode fra håndboken til akkurat den modellen. Arket er gruppert etter innstilling: suffiks, prefiks, tastaturoppsett, symbologi.
  • Bruk leverandørens oppsettsprogram, og skriv deretter resultatet til skanneren over USB.
  • Bruk enhetsverktøyet for den produktlinjen når du oppdaterer mange enheter.

Etter en endring skanner du en kjent strekkode og sammenligner resultatet med håndbokens beskrivelse av innstillingen du valgte. En tilbakestilling til fabrikk fra et annet merke kan la skanneren være uendret eller sette den i en uventet modus. Veiledningen Veiledning for konfigurering av strekkodeskanner oppsummerer innstillingene som vanligvis betyr noe. Den erstatter ikke håndboken.

Barcode Scanner Emulator kan skrive en verdi du velger, og deretter sende ENTER, TAB eller ingen suffiks. Legg et utskrivbart prefiks inn i den verdien når du må øve prefikshåndtering uten maskinvare. Emulatoren sender ikke et seriellt bytepar for CR/LF, og den leser ikke en etikett.

Slik tester du prefiks- og suffiksatferd

Bruk en skanner som står i tastaturmodus, USB HID keyboard eller Bluetooth HID keyboard.

  1. Koble den til, og vent til den viser at den har strøm.
  2. Åpne strekkodeinndatatesten.
  3. Klikk Start Test, eller klikk i skanneområdet. Det blir blått når det er klart. Siden tar ikke fokus av seg selv.
  4. Skann en strekkode du allerede kjenner lasten til.
  5. Les den fangede verdien og tegnantallet. Utskrivbare prefiks- eller suffikstegn ligger inne i den strengen. Linjen Prefix er for navngitte taster som kommer før det første tegnet, for eksempel en modifikator. Den trekker ikke et tastet prefiks som ]C1 ut av strekkodeteksten.
  6. Kontroller suffikset. Testen rapporterer ENTER, TAB eller None. Med Auto capture på vises resultatet etter Enter, Tab eller en kort pause når tastene stopper. Slå av Auto capture for å holde fangsten til du trykker Stop. Enter og Tab er ikke en del av strekkodestrengen.
  7. Sammenlign det resultatet med oppsettet du mente. Åpne deretter tastaturhendelsestesten og skann på nytt når du trenger hvert keydown i rekkefølge, inkludert key, code og tidsbruk.

Inndatatesten registrerer tastaturhendelser nettleseren kan se. Den kan ikke lese en seriell port, så den kan ikke vise CR eller LF som råe byte. En kiletest beviser ikke hva et seriellt oppsett vil sende.

Feilsøking

Skanneren sender ikke ENTER. Strekkoden vises, og markøren blir i feltet. Inndatatesten rapporterer None. Suffikset er slått av, eller det er satt til noe annet enn Enter. Se Strekkodeskanner mangler ENTER.

TAB flytter fokus uventet. Skanneren sender Tab-tasten. Det er det oppsatte suffikset. Bruk Enter når skjemaet skal sendes, eller les verdien på Tab-keydown når arbeidsflyten skal gå videre. Detaljene står i veiledningen ENTER- og TAB-suffikser.

Skjemaet sendes to ganger. Nettleseren sender ved Enter, og en keydown-lytter tar også imot skanningen. Behold én fullføringsvei, og kall preventDefault() på den andre.

Et prefiks vises inne i strekkoden. Et utskrivbart prefiks er en del av den fangede strengen. Enten slår du det av på skanneren, eller så fjerner du akkurat den sekvensen i programmet. En påslått symbologiidentifikator er en vanlig kilde til en innledende ] og to tegn til. Et styreprefiks kilen ikke kan taste, mangler i stedet for å være synlig.

Tegnene er feil. Skannerens oppsett og operativsystemets oppsett kan være uenige, noe som endrer prefikstegn og tegnsetting mens lengden blir den samme. Se Feil tastaturoppsett på strekkodeskanner.

Programmet ser aldri slutten på skanningen. Det finnes ingen suffiks, og siden venter på Enter. Legg til et suffiks som passer skjemaet, eller fullfør verdien med en tydelig handling. Et tidsanslag vil bomme på noen ekte skanninger og godta noe tasting.

CR/LF er ulikt mellom program. Notisblokk setter inn en ny linje når den mottar Enter. Et nett-tekstfelt beholder strekkoden og utløser en tastehendelse. Et seriellt program kan motta 0x0D, 0x0A eller begge. Sammenlign grensesnittet før du endrer skanneren. Hvis ingen program mottar tegn, start med Strekkodeskanner virker ikke.

En bredere gjennomgang av fokus, gjentatte skanninger og POS-flyter finnes i Slik tester du inndata fra strekkodeskanner.

Testmatrise

Oppsettskolonnen er det du setter på skanneren, eller det du taster med emulatoren når tilfellet er et tastatursuffiks. Den forventede atferden er det programmet skal gjøre. Et seriellt CRLF-tilfelle er ikke samme test som Enter-tasten i en nettleser.

Oppsett Forventet programatferd
Ingen prefiks, ingen suffiks Strekkodeverdien mottas, og ingen fullføringstast kommer. Verdien blir liggende til programmet leser den.
Ingen prefiks, ENTER-suffiks Programmet mottar fullføringstasten én gang og lagrer lasten uten et avslutningstegn.
Ingen prefiks, TAB-suffiks Fokus kan flytte seg til neste kontroll. Programmet leser verdien før den flyttingen.
Eget utskrivbart prefiks Prefikstegnene vises før de dekodede dataene. Programmet beholder eller fjerner akkurat det prefikset med vilje.
Eget utskrivbart suffiks Suffikstegnene vises etter de dekodede dataene. Enter og Tab er taster, så de vises ikke i strengen.
CRLF-sekvens En seriell vert eller en terminalvert behandler de oppsatte CR- og LF-bytene. Et tekstfelt i nettleseren får ikke de bytene fra et trykk på Enter.

Kjør tastaturradene på kileskanneren, og når maskinvaren mangler, med emulatorens innstillinger for ENTER, TAB og ingen suffiks. Kjør CRLF-raden på grensesnittet som skal bære de bytene. De faktiske resultatene avhenger fortsatt av det grensesnittet og av programmet.