Barcode Scanner Emulator
Präfix und Suffix beim Barcodescanner: Vollständiger Leitfaden
Ein Präfix besteht aus Daten oder einer Steuerfolge, die ein Barcodescanner vor dem decodierten Barcode sendet. Ein Suffix ist das, was er nach diesem Wert sendet. Dasselbe Modell lässt sich auf unterschiedliche Präfixe und Suffixe einstellen, und ein serieller Scanner liefert sie nicht auf dieselbe Weise wie ein Tastatur-Wedge-Scanner.
Ein Präfix eines Barcodescanners wird vor dem decodierten Wert gesendet. Ein Suffix wird danach gesendet. Ein Scanner kann diese Folge erzeugen:
Präfix: STX
Barcode: 123456789
Suffix: ENTER
STX in einer Anleitung meint oft das Steuerzeichen, nicht die drei Buchstaben S, T und X. ENTER bei einem Tastatur-Wedge-Scanner ist gewöhnlich die Enter-Taste, nicht die beiden Zeichen CR und LF, die in ein Textfeld eingefügt werden. Was davon ankommt, hängt vom Modell, von der Schnittstelle und von der Anwendung ab. Keine Einstellung gilt für jedes Gerät.
Der Leitfaden Suffixe ENTER und TAB bei Barcodescannern bleibt bei der Wahl und der Fehlersuche für diese beiden Abschlusszeichen. Dieser Leitfaden behandelt den Rahmen um den Barcode: was davor kommt, was danach kommt und wie eine Webanwendung beides lesen sollte.
Was ist ein Präfix beim Barcodescanner?
Ein Präfix ist eine konfigurierte Folge, die der Scanner vor der Nutzlast überträgt. Die Nutzlast ist der Text, den die Symbologie decodiert hat, etwa 123456789. Das Präfix gehört nicht zu dieser Decodierung, sofern der Scanner nicht so eingestellt wurde, es hinzuzufügen.
Übliche Verwendungen:
- Den Anfang einer Nachricht markieren. Serielle und Terminalprotokolle senden manchmal ein Steuerzeichen, oft STX genannt, damit der Host weiß, dass ein neuer Rahmen begonnen hat.
- Die Symbologie benennen. Ist die AIM-Symbologiekennung aktiv, kann ein Scanner ein kurzes druckbares Präfix senden, etwa
]C1für Code 128 oder]E0für EAN, vor den Ziffern. Die Anwendung kann anhand dieser Kennung verzweigen. - Eingaben in älterer POS- oder Terminalsoftware lenken. Ein fester Code vor den Daten sagte dem Host, zu welchem Feld oder Gerät der Scan gehörte.
- Einen bestimmten Platz kennzeichnen. Zwei Scanner können unterschiedliche druckbare Präfixe erhalten, damit ein Protokoll zeigt, welche Spur den Code gesendet hat.
Ein druckbares Präfix besteht aus gewöhnlichen Zeichen. Sie erscheinen in einem Textfeld am Anfang der Zeichenfolge. Ein Steuerzeichen-Präfix wie STX (0x02) sind nicht die Buchstaben S, T und X. Ein Tastatur-Wedge-Scanner kann dieses Steuerzeichen möglicherweise gar nicht tippen. Ein serieller Scanner kann es als Byte senden. Lesen Sie die Anleitung des vorhandenen Modells, bevor Sie Code schreiben, der das eine oder das andere erwartet.
Ein Präfix beweist nicht, dass ein Scanner die Eingabe erzeugt hat. Eine Person, ein Makro oder der Barcode Scanner Emulator kann dieselben Zeichen tippen. Behandeln Sie ein Präfix als Rahmen, den Sie konfiguriert haben, und prüfen Sie die Nutzlast so, wie Sie jede andere Benutzereingabe prüfen.
Was ist ein Suffix beim Barcodescanner?
Ein Suffix ist eine konfigurierte Folge, die nach der Nutzlast gesendet wird. Seine übliche Aufgabe ist, der Anwendung mitzuteilen, dass der Scan fertig ist, oder den Fokus zu verschieben. Scanner unterscheiden sich. Manche bieten Enter, Tab, CR, LF, CR+LF, eine eigene Zeichenfolge oder nichts. Manche bieten nur eine oder zwei dieser Möglichkeiten.
ENTER. Die Enter-Taste. In einem Browser ist das ein Tastaturereignis, event.key === "Enter". Es wird nicht in ein normales Texteingabefeld eingefügt.
TAB. Die Tabulatortaste, event.key === "Tab". Der Browser verschiebt den Fokus zum nächsten Steuerelement. Die Taste wird nicht in das Feld eingefügt.
CR. Wagenrücklauf, ASCII 0x0D. An einer seriellen oder Terminalschnittstelle kann das ein echtes Byte nach der Nutzlast sein. Bei einem Tastatur-Wedge bedeutet eine Einstellung mit der Bezeichnung CR oder Wagenrücklauf gewöhnlich die Enter-Taste. Der Browser meldet weiterhin Enter. Der Feldwert erhält kein CR-Zeichen.
LF. Zeilenvorschub, ASCII 0x0A. Es ist ein anderes Steuerzeichen als CR. In einem seriellen Datenstrom kann es ein eigenes Byte sein. Ein Tastatur-Wedge hat keine Standardtaste für den Zeilenvorschub, so wie er Enter und Tab hat. Nehmen Sie nicht an, dass ein Menüpunkt namens LF ein sichtbares Zeichen oder ein zweites Enter tippt.
CRLF. CR gefolgt von LF, die beiden Bytes 0x0D 0x0A. Manche seriellen Hosts und Terminals erwarten dieses Paar als Zeilenende. Ein Textfeld im Browser speichert dieses Paar nicht, wenn jemand Enter drückt.
Eigene Zeichen. Ein druckbares Suffix wie # oder ein kurzer Code wird nach dem Barcode getippt und wird damit Teil der Zeichenfolge, sofern die Anwendung es nicht entfernt. Ein eigenes Steuerzeichen folgt derselben Trennung wie STX: Bytes an einem seriellen Port, Tastenanschläge an einem Wedge, und nur die Tastenanschläge, die die Tastaturschnittstelle tatsächlich senden kann.
ENTER, CR und LF sind in Anleitungen verwandte Namen für das Zeilenende. Sie sind nicht in jeder Anwendung austauschbar. Ein Wedge-Scanner, ein serieller Scanner, Notepad und ein Webformular können bei einer Einstellung mit demselben Namen jeweils ein anderes Ergebnis zeigen.
Präfix und Suffix
| Merkmal | Präfix | Suffix |
|---|---|---|
| Position | Vor den Barcodedaten | Nach den Barcodedaten |
| Zweck | Den Anfang markieren oder die Eingabe kennzeichnen | Den Abschluss markieren oder eine Aktion auslösen |
| Beispiel | STX oder eine druckbare AIM-Kennung wie ]C1 |
ENTER, TAB oder ein druckbares Zeichen wie # |
| Übliche Verwendung | Den Scan einrahmen oder erkennen | Ein Formular absenden oder den Fokus verschieben |
| In einem Textfeld | Druckbare Zeichen stehen am Anfang des Werts | Druckbare Zeichen stehen am Ende. Enter und Tab nicht |
| Identität | Eine konfigurierte Markierung, die jede Person tippen kann | Eine konfigurierte Markierung, die jede Person tippen kann |
Entfernen Sie ein Präfix oder ein eigenes Suffix nur, wenn Sie genau diese Folge konfiguriert haben und der gespeicherte Datensatz sie nicht enthalten soll. Lassen Sie eine AIM-Kennung stehen, bis die Anwendung eine Regel dafür hat.
ENTER, TAB, CR und LF
Diese Namen stehen auf Konfigurationsblättern. Die empfangende Seite sieht entweder Tastenanschläge oder Bytes, je nach Schnittstelle. Der Leitfaden HID-Tastatur-Wedge beschreibt den Weg der Tastenanschläge. Ein serieller Port ist ein anderer Weg: Die Anwendung liest Bytes, und der Fokus entscheidet nicht, wohin sie gehen.
ENTER
Bei einem Tastatur-Wedge-Scanner ist ENTER die Enter-Taste. In einem einzeiligen Textfeld nutzen aktuelle Browser diese Taste, um das umgebende Formular abzusenden. Ein Suchfeld kann den Scan bei diesem Ereignis übernehmen. Ein Formular mit mehreren Feldern kann absenden, bevor spätere Felder gefüllt sind. Rufen Sie preventDefault() beim Ereignis submit oder beim Enter-keydown auf, wenn die Seite den Wert behalten und an Ort und Stelle bleiben soll. Behandeln Sie Enter an einer Stelle. Ein keydown-Listener und ein submit-Listener, die den Scan beide annehmen, zeichnen ihn zweimal auf.
Manche Scanner senden NumPad Enter. event.key ist weiterhin "Enter". event.code kann "NumpadEnter" sein statt "Enter". Prüfen Sie event.key, wenn beide Tasten das Feld abschließen sollen.
Der Leitfaden Suffixe ENTER und TAB bei Barcodescannern vergleicht diese beiden Möglichkeiten für POS und Webformulare. Barcodescanner sendet kein ENTER behandelt einen Scanner, der den Barcode tippt und dann anhält.
TAB
TAB ist die Tabulatortaste. Der Browser verschiebt den Fokus nach keydown. Lesen Sie das Feld in diesem keydown-Handler, solange es noch den Fokus hat, und lassen Sie die Standardaktion bestehen, wenn das nächste Steuerelement den Cursor erhalten soll. preventDefault() hält den Fokus auf dem aktuellen Feld.
Umschalt+Tab ist dieselbe Taste mit gehaltener Umschalttaste. Ein Tab-Suffix des Scanners ist Tab ohne Umschalt. Ignorieren Sie event.shiftKey, wenn die Tastaturbedienung im Formular rückwärts möglich bleiben muss.
CR
Der Wagenrücklauf setzt in einem Terminal den Cursor an den Zeilenanfang. Das Byte ist 0x0D. Ein serieller Scanner kann dieses Byte an die Nutzlast anhängen. Eine Tastatur-Wedge-Einstellung namens CR sendet typischerweise die Enter-Taste, statt 0x0D in den Text einzufügen. Enter in einem Browser-Eingabefeld schreibt kein CR-Zeichen in input.value.
Wenn der Host ein Terminal oder ein Programm an einem COM-Port ist, suchen Sie nach dem Byte. Wenn der Host eine Webseite ist, suchen Sie nach event.key === "Enter".
LF
Der Zeilenvorschub bewegt den Cursor im Terminal eine Zeile nach unten. Das Byte ist 0x0A. Manche Hosts behandeln LF allein als Zeilenumbruch. Andere ignorieren es, sofern nicht zuerst CR kam. Ein Wedge-Scanner, der LF als Suffix auflistet, sendet möglicherweise eine Taste, die das Betriebssystem nicht in einen Zeilenumbruch verwandelt, oder er sendet nichts, das ein Textfeld behält. Erfassen Sie die Taste im Tastaturereignis-Tester, bevor Sie ein vermeintliches LF im Anwendungscode behandeln.
CRLF
CRLF ist die Folge aus zwei Steuerzeichen: zuerst CR, dann LF. Textdateien im Windows-Stil und viele serielle Geräte nutzen sie als einen Zeilenumbruch. Eine Konfigurationsseite mit der Angabe CRLF-Suffix meint, dass der Scanner dieses Paar nach der Nutzlast über die Schnittstelle senden will, die er verwendet.
In einem Browser erzeugt das Drücken von Enter keine buchstäbliche CRLF-Folge in einem Texteingabefeld. Das Formular erhält ein Tastaturereignis. Ein <textarea> kann einen Zeilenumbruch einfügen, wenn Enter gedrückt wird, und dieser Zeilenumbruch ist das eigene Bearbeitungsverhalten des Browsers, kein Beweis dafür, dass der Scanner die Bytes 0x0D 0x0A ausgegeben hat. Ein serielles Leseprogramm kann diese beiden Bytes empfangen und sollte sie nur dann als Abschluss behandeln, wenn dieser Scanner so konfiguriert wurde, sie zu senden. Entfernen Sie CR oder LF nicht aus der Mitte einer Nutzlast, die sie enthalten darf.
Wie Präfixe und Suffixe Webanwendungen beeinflussen
Ein Tastatur-Wedge-Scan ist ein Stoß von Tastenanschlägen in das fokussierte Steuerelement. Die Seite öffnet den Scanner nicht. Liegt der Fokus auf einem anderen Feld, gehen Präfix, Barcode und Suffix alle dorthin.
keydown feuert für jede Taste, einschließlich Enter und Tab, bevor der Browser ein Zeichen einfügt oder den Fokus verschiebt. event.key ist das Zeichen oder der Tastenname, nachdem das Betriebssystem das Tastaturlayout angewendet hat. Druckbare Präfix- und Suffixzeichen erscheinen im Feld über das Ereignis input. Enter und Tab erscheinen dort nicht.
Der Listener unten übernimmt das Feld, wenn Enter ankommt. Er fügt kein Suffix hinzu, das der Scanner weggelassen hat. Sendet der Scanner kein Enter, bleibt der Wert im Feld, bis etwas anderes ihn liest.
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 = ''
})
Fokussieren Sie #barcode vor dem Scan. preventDefault() hält ein übergeordnetes Formular davon ab, ein zweites Mal abzusenden. Liegt die Eingabe nicht in einem Formular und Sie wollen das native Absenden, lassen Sie preventDefault() weg.
Ohne Suffix warten Sie auf eine ausdrückliche Aktion: eine Schaltfläche, ein späteres Enter der bedienenden Person oder den nächsten Schritt im Ablauf. Ein Inaktivitätszeitgeber kann eine Pause als Ende des Scans behandeln. Dieser Zeitgeber ist eine Heuristik. Ein langsamer Scanner, eine Bluetooth-Verzögerung oder schnelles Tippen kann auf der falschen Seite davon liegen. Bevorzugen Sie ein konfiguriertes Suffix, wenn der Ablauf ein eindeutiges Ende braucht.
Ein bekanntes druckbares Präfix lässt sich entfernen, nachdem Sie den Wert gelesen haben:
function withoutConfiguredPrefix(value, prefix) {
if (prefix && value.startsWith(prefix)) {
return value.slice(prefix.length)
}
return value
}
Übergeben Sie nur das Präfix, das Sie konfiguriert haben, etwa ']C1'. Entfernen Sie nicht bei jedem Scan eine beliebige Anzahl von Zeichen.
Ein vollständiges Formular, das auch Tab, leere Eingabe und einen zweiten Scan behandelt, steht in So testen Sie Barcodescanner in Webanwendungen.
So konfigurieren Sie Präfixe und Suffixe
Präfix- und Suffixeinstellungen liegen auf dem Scanner. Die Namen der Tasten und die Art, sie zu ändern, sind herstellerspezifisch. Es gibt keinen Konfigurationsbarcode, der bei jeder Marke funktioniert, und dieser Leitfaden druckt keinen ab.
Übliche Wege:
- Scannen Sie einen Konfigurationsbarcode aus der Anleitung genau dieses Modells. Das Blatt ist nach Einstellung gruppiert: Suffix, Präfix, Tastaturlayout, Symbologie.
- Nutzen Sie das Konfigurationsprogramm des Herstellers und schreiben Sie das Ergebnis dann über USB auf den Scanner.
- Nutzen Sie das Geräteverwaltungsprogramm dieser Produktlinie, wenn Sie viele Geräte aktualisieren.
Nach einer Änderung scannen Sie einen bekannten Barcode und vergleichen Sie das Ergebnis mit der Beschreibung der gewählten Einstellung in der Anleitung. Ein Werksreset einer anderen Marke kann den Scanner unverändert lassen oder in einen unerwarteten Modus versetzen. Der Leitfaden zur Konfiguration von Barcodescannern fasst die Einstellungen zusammen, auf die es gewöhnlich ankommt. Er ersetzt die Anleitung nicht.
Der Barcode Scanner Emulator kann einen Wert tippen, den Sie wählen, und danach ENTER, TAB oder kein Suffix senden. Setzen Sie ein druckbares Präfix in diesen Wert, wenn Sie die Präfixbehandlung ohne Hardware üben müssen. Der Emulator gibt kein serielles CR/LF-Bytepaar aus, und er liest kein Etikett.
So testen Sie das Verhalten von Präfix und Suffix
Verwenden Sie einen Scanner im Tastaturmodus, als USB-HID-Tastatur oder als Bluetooth-HID-Tastatur.
- Schließen Sie ihn an und warten Sie, bis er anzeigt, dass er Strom hat.
- Öffnen Sie den Barcode-Eingabetester.
- Klicken Sie auf Start Test oder auf den Scanbereich. Er wird blau, wenn er bereit ist. Die Seite nimmt den Fokus nicht von selbst.
- Scannen Sie einen Barcode, dessen Nutzlast Sie bereits kennen.
- Lesen Sie den erfassten Wert und die Zeichenzahl. Druckbare Präfix- oder Suffixzeichen stehen in dieser Zeichenfolge. Die Zeile Prefix gilt für benannte Tasten, die vor dem ersten Zeichen ankommen, etwa einen Modifikator. Sie zieht ein getipptes Präfix wie
]C1nicht aus dem Barcodetext. - Prüfen Sie das Suffix. Der Tester meldet ENTER, TAB oder None. Bei eingeschaltetem Auto capture erscheint das Ergebnis nach Enter, Tab oder einer kurzen Pause, sobald die Tasten aufhören. Schalten Sie Auto capture aus, um die Erfassung zu halten, bis Sie Stop drücken. Enter und Tab gehören nicht zur Barcodezeichenfolge.
- Vergleichen Sie dieses Ergebnis mit der Konfiguration, die Sie beabsichtigt haben. Öffnen Sie dann den Tastaturereignis-Tester und scannen Sie erneut, wenn Sie jedes
keydownder Reihe nach brauchen, einschließlichkey,codeund der Zeitabstände.
Der Eingabetester zeichnet Tastaturereignisse auf, die der Browser sehen kann. Er kann keinen seriellen Port lesen und deshalb CR oder LF nicht als rohe Bytes zeigen. Ein Wedge-Test beweist nicht, was eine serielle Einstellung senden wird.
Fehlersuche
Der Scanner sendet kein ENTER. Der Barcode erscheint, und der Cursor bleibt im Feld. Der Eingabetester meldet None. Das Suffix ist aus, oder es ist auf etwas anderes als Enter gesetzt. Siehe Barcodescanner sendet kein ENTER.
TAB verschiebt den Fokus unerwartet. Der Scanner sendet die Tabulatortaste. Das ist das konfigurierte Suffix. Nutzen Sie Enter, wenn das Formular absenden soll, oder lesen Sie den Wert beim Tab-keydown, wenn der Ablauf weitergehen soll. Einzelheiten stehen im Leitfaden Suffixe ENTER und TAB bei Barcodescannern.
Das Formular wird zweimal abgesendet. Der Browser sendet bei Enter ab, und ein keydown-Listener nimmt den Scan ebenfalls an. Behalten Sie einen Abschlussweg und rufen Sie auf dem anderen preventDefault() auf.
Ein Präfix erscheint im Barcode. Ein druckbares Präfix ist Teil der erfassten Zeichenfolge. Schalten Sie es am Scanner ab oder entfernen Sie genau diese Folge in der Anwendung. Eine aktivierte Symbologiekennung ist eine häufige Quelle für ein führendes ] und zwei weitere Zeichen. Ein Steuerpräfix, das der Wedge nicht tippen kann, fehlt, statt sichtbar zu sein.
Die Zeichen sind falsch. Das Layout des Scanners und das Layout des Betriebssystems können voneinander abweichen. Dadurch ändern sich Präfixzeichen und Satzzeichen, während die Länge gleich bleibt. Siehe Falsches Tastaturlayout am Barcodescanner.
Die Anwendung sieht nie das Ende des Scans. Es gibt kein Suffix, und die Seite wartet auf Enter. Fügen Sie ein Suffix hinzu, das zum Formular passt, oder schließen Sie den Wert mit einer ausdrücklichen Aktion ab. Eine Vermutung über die Zeit verpasst manche echten Scans und nimmt manches Tippen an.
CR/LF unterscheidet sich zwischen Anwendungen. Notepad fügt eine neue Zeile ein, wenn es Enter empfängt. Ein Textfeld im Web behält den Barcode und löst ein Tastenereignis aus. Ein serielles Programm kann 0x0D, 0x0A oder beides empfangen. Vergleichen Sie die Schnittstelle, bevor Sie den Scanner ändern. Wenn keine Anwendung Zeichen empfängt, beginnen Sie mit Barcodescanner funktioniert nicht.
Ein weiterer Durchgang zu Fokus, wiederholten Scans und POS-Abläufen steht in So testen Sie die Eingabe eines Barcodescanners.
Testmatrix
Die Spalte Konfiguration ist das, was Sie am Scanner einstellen, oder das, was Sie mit dem Emulator tippen, wenn der Fall ein Tastatursuffix ist. Das erwartete Verhalten ist das, was die Anwendung tun soll. Ein serieller CRLF-Fall ist nicht derselbe Test wie eine Enter-Taste im Browser.
| Konfiguration | Erwartetes Verhalten der Anwendung |
|---|---|
| Kein Präfix, kein Suffix | Der Barcodewert wird empfangen, und es kommt keine Abschlusstaste an. Der Wert bleibt verfügbar, bis die Anwendung ihn liest. |
| Kein Präfix, Suffix ENTER | Die Anwendung empfängt die Abschlusstaste einmal und speichert die Nutzlast ohne Abschlusszeichen. |
| Kein Präfix, Suffix TAB | Der Fokus kann zum nächsten Steuerelement wandern. Die Anwendung liest den Wert vor dieser Bewegung. |
| Eigenes druckbares Präfix | Die Präfixzeichen erscheinen vor den decodierten Daten. Die Anwendung behält oder entfernt genau dieses Präfix absichtlich. |
| Eigenes druckbares Suffix | Die Suffixzeichen erscheinen nach den decodierten Daten. Enter und Tab sind Tasten, deshalb erscheinen sie nicht in der Zeichenfolge. |
| CRLF-Folge | Ein serieller Host oder ein Terminal verarbeitet die konfigurierten Bytes CR und LF. Ein Textfeld im Browser erhält diese Bytes nicht durch einen Enter-Tastendruck. |
Führen Sie die Tastaturzeilen am Wedge-Scanner aus und, wenn keine Hardware vorhanden ist, mit den Einstellungen ENTER, TAB und kein Suffix des Emulators. Führen Sie die CRLF-Zeile an der Schnittstelle aus, die diese Bytes tragen soll. Die tatsächlichen Ergebnisse hängen weiterhin von dieser Schnittstelle und von der Anwendung ab.