Barcode Scanner Emulator
Præfiks og suffiks i stregkodescannere: komplet vejledning
Et præfiks er data eller en styresekvens, som en stregkodescanner sender før den afkodede stregkode. Et suffiks er det, scanneren sender efter den værdi. Den samme model kan sættes op med forskellige præfikser og suffikser, og en seriel scanner afleverer dem anderledes end en scanner med tastaturkile.
Præfikset fra en stregkodescanner kommer før den afkodede værdi. Suffikset kommer bagefter. Én scanner kan for eksempel aflevere denne rækkefølge:
Præfiks: STX
Stregkode: 123456789
Suffiks: ENTER
I en manual betyder STX som regel styretegnet, ikke bogstaverne S, T og X. ENTER på en scanner med tastaturkile er normalt Enter-tasten, ikke tegnene CR og LF sat ind i et tekstfelt. Hvilket af dem du modtager, afhænger af modellen, grænsefladen og applikationen. Der findes ingen indstilling, der gælder alle steder.
Vejledningen ENTER- og TAB-suffikser bliver ved valget og fejlfindingen af de to afslutninger. Denne vejledning handler om rammen omkring stregkoden: hvad der ligger foran, hvad der ligger bagved, og hvordan en webapplikation bør læse begge dele.
Hvad er et præfiks på en stregkodescanner?
Et præfiks er en konfigureret sekvens, som scanneren sender før nyttelasten. Nyttelasten er den tekst, symbologien afkodede, for eksempel 123456789. Præfikset hører ikke til den afkodning, medmindre scanneren er sat til at tilføje det.
Almindelige formål:
- Markere starten på en meddelelse. Serielle protokoller og terminalprotokoller sender undertiden et styretegn, ofte kaldet STX, så værten ved, at en ny ramme er begyndt.
- Navngive symbologien. Når AIM-symbologiidentifikatoren er slået til, kan en scanner sende et kort udskrivbart præfiks som
]C1for Code 128 eller]E0for EAN foran cifrene. Applikationen kan forgrene sig ud fra den identifikator. - Styre input i ældre POS- eller terminalprogrammer. En fast kode foran dataene fortalte værten, hvilket felt eller hvilken enhed scanningen hørte til.
- Mærke en bestemt station. To scannere kan få forskellige udskrivbare præfikser, så en log kan vise, hvilken bane der sendte koden.
Et udskrivbart præfiks er almindelige tegn. De står forrest i strengen i et tekstfelt. Et styretegnspræfiks, for eksempel STX (0x02), er ikke bogstaverne S, T og X. En scanner med tastaturkile kan være ude af stand til at taste det styretegn overhovedet. En seriel scanner kan sende det som en byte. Læs manualen til den model, du har, før du skriver kode, der forventer det ene eller det andet.
Et præfiks beviser ikke, at en scanner frembragte inputtet. En person, en makro eller Barcode Scanner Emulator kan taste de samme tegn. Behandl præfikset som en ramme, du selv har konfigureret, og valider derefter nyttelasten på samme måde som alt andet brugerinput.
Hvad er et suffiks på en stregkodescanner?
Et suffiks er en konfigureret sekvens, der sendes efter nyttelasten. Det plejer at fortælle applikationen, at scanningen er færdig, eller at flytte fokus. Scannere er forskellige. Nogle tilbyder Enter, Tab, CR, LF, CR+LF, en egen streng eller ingenting. Andre tilbyder kun en eller to af mulighederne.
ENTER. Enter-tasten. I en browser er det en tastaturhændelse, event.key === "Enter". Den indsættes ikke i et almindeligt tekstfelt.
TAB. Tab-tasten, event.key === "Tab". Browseren flytter fokus til den næste kontrol. Tasten indsættes ikke i feltet.
CR. Vognretur, ASCII 0x0D. På en seriel grænseflade eller en terminalgrænseflade kan det være en rigtig byte efter nyttelasten. På en tastaturkile betyder en indstilling mærket CR eller vognretur normalt Enter-tasten. Browseren rapporterer stadig Enter. Feltværdien får ikke et CR-tegn.
LF. Linjefremføring, ASCII 0x0A. Det er et andet styretegn end CR. I en seriel strøm kan det være sin egen byte. En tastaturkile har ikke en standardtast for Line Feed, sådan som den har Enter og Tab. Gå ikke ud fra, at et menupunkt ved navn LF skriver et synligt tegn eller et ekstra Enter.
CRLF. CR efterfulgt af LF, de to byte 0x0D 0x0A. Nogle serielle værter og terminalværter forventer det par som afslutning på en linje. Et tekstfelt i browseren gemmer ikke det par, når nogen trykker på Enter.
Egne tegn. Et udskrivbart suffiks som # eller en kort kode tastes efter stregkoden, så det bliver en del af strengen, medmindre applikationen fjerner det. Et eget styretegn følger samme opdeling som STX: byte på en seriel port, tastetryk på en kile, og kun de tastetryk, som tastaturgrænsefladen faktisk kan sende.
ENTER, CR og LF er beslægtede navne for linjeslut i manualer. De kan ikke byttes om i enhver applikation. En kile-scanner, en seriel scanner, Notepad og en webformular kan hver især vise et andet resultat for en indstilling med samme navn.
Præfiks over for suffiks
| Egenskab | Præfiks | Suffiks |
|---|---|---|
| Placering | Før stregkodedataene | Efter stregkodedataene |
| Formål | Markere begyndelsen eller mærke inputtet | Markere afslutning eller udløse en handling |
| Eksempel | STX eller en udskrivbar AIM-identifikator som ]C1 |
ENTER, TAB eller et udskrivbart tegn som # |
| Almindelig brug | Indramme eller identificere scanningen | Sende en formular eller flytte fokus |
| I et tekstfelt | Udskrivbare tegn står i starten af værdien | Udskrivbare tegn står i slutningen. Enter og Tab gør ikke |
| Identitet | En konfigureret markør, som enhver kan taste | En konfigureret markør, som enhver kan taste |
Fjern kun et præfiks eller et eget suffiks, når du har konfigureret netop den sekvens, og den gemte post ikke skal indeholde den. Lad en AIM-identifikator blive stående, indtil applikationen har en regel for den.
ENTER, TAB, CR og LF
Navnene står på konfigurationsark. Modtagersiden ser enten tastetryk eller byte, alt efter grænsefladen. Vejledningen HID-tastaturkile beskriver tastetryksvejen. En seriel port er en anden vej: applikationen læser byte, og fokus bestemmer ikke, hvor de havner.
ENTER
På en scanner med tastaturkile er ENTER Enter-tasten. I et tekstfelt på én linje bruger aktuelle browsere den tast til at sende den omgivende formular. Et opslagsfelt kan bekræfte scanningen på den hændelse. En formular med flere felter kan blive sendt, før senere felter er udfyldt. Kald preventDefault() på hændelsen submit, eller på Enter-keydown, når siden skal beholde værdien og blive stående. Håndter Enter ét sted. En keydown-lytter og en submit-lytter, der begge accepterer scanningen, registrerer den to gange.
Nogle scannere sender NumPad Enter. event.key er stadig "Enter". event.code kan være "NumpadEnter" frem for "Enter". Test event.key, hvis begge taster skal bekræfte feltet.
Vejledningen ENTER- og TAB-suffikser sammenligner de to valg til POS og webformularer. Stregkodescanneren mangler ENTER dækker en scanner, der skriver stregkoden og derefter standser.
TAB
TAB er Tab-tasten. Browseren flytter fokus efter keydown. Læs feltet i den keydown-håndtering, mens det stadig har fokus, og lad standardhandlingen blive, når den næste kontrol skal have markøren. preventDefault() holder fokus på det aktuelle felt.
Shift+Tab er den samme tast med Shift holdt nede. Et Tab-suffiks fra scanneren er Tab uden Shift. Ignorer event.shiftKey, hvis tastaturbrugere skal kunne gå baglæns gennem formularen.
CR
Vognretur flytter en markør til starten af linjen i en terminal. Byten er 0x0D. En seriel scanner kan hægte den byte på nyttelasten. En kileindstilling ved navn CR sender typisk Enter-tasten i stedet for at indsætte 0x0D i teksten. Et tryk på Enter i et browserfelt skriver ikke et CR-tegn ind i input.value.
Er værten en terminal eller en lytter på en COM-port, så led efter byten. Er værten en webside, så led efter event.key === "Enter".
LF
Linjefremføring flytter en terminalmarkør én linje ned. Byten er 0x0A. Nogle værter behandler LF alene som en ny linje. Andre ignorerer det, medmindre CR kom først. En kile-scanner, der opregner LF som suffiks, kan sende en tast, som operativsystemet ikke omsætter til et linjeskift, eller den kan sende noget, som et tekstfelt ikke beholder. Indfang tasten i Tastaturhændelsestesteren, før du håndterer et formodet LF i applikationskoden.
CRLF
CRLF er tostyresekvensen CR og derefter LF. Tekstfiler i Windows-stil og mange serielle enheder bruger den som én ny linje. En konfigurationsside, der siger CRLF-suffiks, betyder, at scanneren vil forsøge at sende det par efter nyttelasten på den grænseflade, den bruger.
I en browser giver et tryk på Enter ikke en bogstavelig CRLF-sekvens inde i et tekstfelt. Formularen modtager en tastaturhændelse. En <textarea> kan indsætte en ny linje, når brugeren trykker på Enter, og den nye linje er browserens egen redigeringsadfærd, ikke et bevis på, at scanneren udsendte bytene 0x0D 0x0A. En seriel læser kan modtage de to byte og bør behandle dem som afslutning kun, hvis netop den scanner var konfigureret til at sende dem. Fjern ikke CR eller LF fra midten af en nyttelast, der må indeholde dem.
Sådan påvirker præfikser og suffikser webapplikationer
En scanning med tastaturkile er et byge af tastetryk ind i den kontrol, der har fokus. Siden åbner ikke scanneren. Ligger fokus i et andet felt, havner præfikset, stregkoden og suffikset der.
keydown udløses for hver tast, også Enter og Tab, før browseren indsætter et tegn eller flytter fokus. event.key er tegnet eller tastens navn, efter at operativsystemet har anvendt tastaturlayoutet. Udskrivbare præfiks- og suffikstegn dukker op i feltet via hændelsen input. Enter og Tab gør det ikke.
Lytteren herunder bekræfter feltet, når Enter ankommer. Den tilføjer ikke et suffiks, som scanneren udelod. Sender scanneren ikke Enter, bliver værdien liggende i feltet, indtil noget andet læser 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 = ''
})
Sæt fokus i #barcode før scanningen. preventDefault() standser en overordnet formular i at blive sendt en gang til. Ligger inputtet ikke i en formular, og vil du have den indbyggede afsendelse, så udelad preventDefault().
Uden et suffiks venter du på en udtrykkelig handling: en knap, et senere Enter fra operatøren eller næste trin i arbejdsgangen. En inaktivitetstimer kan behandle en pause som scanningens afslutning. Den timer er et skøn. En langsom scanner, en Bluetooth-forsinkelse eller en hurtig skriver kan lande på den forkerte side af den. Foretræk et konfigureret suffiks, når arbejdsgangen har brug for en sikker afslutning.
Et kendt udskrivbart præfiks kan fjernes, efter at du har læst værdien:
function withoutConfiguredPrefix(value, prefix) {
if (prefix && value.startsWith(prefix)) {
return value.slice(prefix.length)
}
return value
}
Send kun det præfiks, du har konfigureret, for eksempel ']C1'. Fjern ikke et vilkårligt antal tegn fra hver scanning.
Til en hel formular, der også håndterer Tab, tomt input og en anden scanning, se Sådan tester du stregkodescannere i webapplikationer.
Sådan konfigurerer du præfikser og suffikser
Indstillingerne for præfiks og suffiks ligger på scanneren. Tastnavnene og måden, du ændrer dem på, er specifikke for producenten. Der findes ingen konfigurationsstregkode, der virker på alle mærker, og denne vejledning udskriver ikke en.
Typiske metoder:
- Scan en konfigurationsstregkode fra manualen til netop den model. Arket er grupperet efter indstilling: suffiks, præfiks, tastaturlayout, symbologi.
- Brug leverandørens konfigurationsprogram, og skriv derefter resultatet til scanneren over USB.
- Brug enhedsstyringsværktøjet til den produktlinje, når du opdaterer mange enheder.
Efter en ændring scanner du en kendt stregkode og sammenligner resultatet med manualens beskrivelse af den indstilling, du valgte. En fabriksnulstilling fra et andet mærke kan lade scanneren være uændret eller sætte den i en uventet tilstand. Vejledningen Vejledning til konfiguration af stregkodescannere opsummerer de indstillinger, der som regel betyder noget. Den erstatter ikke manualen.
Barcode Scanner Emulator kan skrive en værdi, du vælger, og derefter sende ENTER, TAB eller intet suffiks. Læg et udskrivbart præfiks ind i den værdi, når du skal øve præfikshåndtering uden hardware. Emulatoren udsender ikke et serielt bytepar for CR/LF, og den læser ikke en etiket.
Sådan tester du præfiks- og suffiksadfærd
Brug en scanner, der er i tastaturtilstand, USB HID keyboard eller Bluetooth HID keyboard.
- Tilslut den, og vent, til den viser, at den har strøm.
- Åbn Stregkodeinput-testeren.
- Klik på Start Test, eller klik i scanningsområdet. Det bliver blåt, når det er klar. Siden tager ikke selv fokus.
- Scan en stregkode, hvis nyttelast du allerede kender.
- Læs den indfangede værdi og tegnantallet. Udskrivbare præfiks- eller suffikstegn ligger inde i den streng. Linjen Prefix er til navngivne taster, der ankommer før det første tegn, for eksempel en modifikator. Den trækker ikke et tastet præfiks som
]C1ud af stregkodeteksten. - Kontrollér suffikset. Testeren rapporterer ENTER, TAB eller None. Med Auto capture slået til vises resultatet efter Enter, Tab eller en kort pause, når tasterne standser. Slå Auto capture fra for at holde indfangningen, indtil du trykker på Stop. Enter og Tab er ikke en del af stregkodestrengen.
- Sammenlign det resultat med den konfiguration, du havde til hensigt. Åbn derefter Tastaturhændelsestesteren, og scan igen, når du har brug for hvert
keydowni rækkefølge, inklusivekey,codeog timing.
Inputtesteren registrerer de tastaturhændelser, browseren kan se. Den kan ikke læse en seriel port, så den kan ikke vise CR eller LF som rå byte. En kiletest beviser ikke, hvad en seriel indstilling vil sende.
Fejlfinding
Scanneren sender ikke ENTER. Stregkoden vises, og markøren bliver i feltet. Inputtesteren rapporterer None. Suffikset er slået fra, eller det er sat til noget andet end Enter. Se Stregkodescanneren mangler ENTER.
TAB flytter fokus uventet. Scanneren sender Tab-tasten. Det er det konfigurerede suffiks. Brug Enter, når formularen skal sendes, eller læs værdien på Tab-keydown, når arbejdsgangen skal gå videre. Detaljerne står i vejledningen ENTER- og TAB-suffikser.
Formularen sendes to gange. Browseren sender ved Enter, og en keydown-lytter accepterer også scanningen. Behold én afslutningsvej, og kald preventDefault() på den anden.
Et præfiks dukker op inde i stregkoden. Et udskrivbart præfiks er en del af den indfangede streng. Enten slår du det fra på scanneren, eller også fjerner du netop den sekvens i applikationen. En slået til symbologiidentifikator er en hyppig kilde til et indledende ] og to tegn mere. Et styrepræfiks, som kilen ikke kan taste, mangler i stedet for at være synligt.
Tegnene er forkerte. Scannerens layout og operativsystemets layout kan være uenige, hvilket ændrer præfikstegn og tegnsætning, mens længden bliver den samme. Se Forkert tastaturlayout på stregkodescanneren.
Applikationen ser aldrig slutningen på scanningen. Der er intet suffiks, og siden venter på Enter. Tilføj et suffiks, der passer til formularen, eller afslut værdien med en udtrykkelig handling. Et tidsgæt vil misse nogle rigtige scanninger og acceptere noget indtastning.
CR/LF er forskelligt mellem applikationer. Notepad indsætter en ny linje, når den modtager Enter. Et webtekstfelt beholder stregkoden og udløser en tasthændelse. Et serielt program kan modtage 0x0D, 0x0A eller begge dele. Sammenlign grænsefladen, før du ændrer scanneren. Hvis ingen applikation modtager tegn, så start med Stregkodescanneren virker ikke.
En bredere gennemgang af fokus, gentagne scanninger og POS-forløb findes i Sådan tester du input fra en stregkodescanner.
Testmatrix
Konfigurationskolonnen er det, du sætter på scanneren, eller det, du taster med emulatoren, når tilfældet er et tastatursuffiks. Den forventede adfærd er det, applikationen skal gøre. Et serielt CRLF-tilfælde er ikke den samme test som Enter-tasten i en browser.
| Konfiguration | Forventet applikationsadfærd |
|---|---|
| Intet præfiks, intet suffiks | Stregkodeværdien modtages, og der ankommer ingen afslutningstast. Værdien bliver tilgængelig, indtil applikationen læser den. |
| Intet præfiks, ENTER-suffiks | Applikationen modtager afslutningstasten én gang og gemmer nyttelasten uden et afslutningstegn. |
| Intet præfiks, TAB-suffiks | Fokus kan flytte sig til den næste kontrol. Applikationen læser værdien før den flytning. |
| Eget udskrivbart præfiks | Præfikstegnene vises før de afkodede data. Applikationen beholder eller fjerner netop det præfiks med vilje. |
| Eget udskrivbart suffiks | Suffikstegnene vises efter de afkodede data. Enter og Tab er taster, så de vises ikke i strengen. |
| CRLF-sekvens | En seriel vært eller en terminalvært behandler de konfigurerede CR- og LF-byte. Et tekstfelt i browseren får ikke de byte fra et tryk på Enter. |
Kør tastaturrækkerne på kile-scanneren og, når hardwaren mangler, med emulatorens indstillinger for ENTER, TAB og intet suffiks. Kør CRLF-rækken på den grænseflade, der skal bære de byte. De faktiske resultater afhænger stadig af den grænseflade og af applikationen.