Barcode Scanner Emulator
Préfixe et suffixe du scanneur de codes à barres : guide complet
Un préfixe est une donnée ou une séquence de contrôle qu'un scanneur de codes à barres envoie avant le code à barres décodé. Un suffixe est ce qu'il envoie après cette valeur. Le même modèle peut être réglé avec des préfixes et des suffixes différents, et un scanneur sériel ne les livre pas de la même façon qu'un scanneur en mode en coin.
Un préfixe de scanneur de codes à barres est envoyé avant la valeur décodée. Un suffixe est envoyé après. Un scanneur peut produire cette séquence :
Préfixe : STX
Code à barres : 123456789
Suffixe : ENTER
Dans un guide, STX désigne souvent le caractère de contrôle, et non les trois lettres S, T et X. Sur un scanneur en mode en coin, ENTER est habituellement la touche Entrée, et non les deux caractères CR et LF insérés dans une zone de texte. Ce que vous recevez dépend du modèle, de l'interface et de l'application. Aucun réglage ne convient à tous les appareils.
Le guide Suffixes ENTER et TAB des scanneurs de codes à barres reste sur le choix et le dépannage de ces deux touches de fin. Ce guide porte sur le cadre autour du code à barres : ce qui précède, ce qui suit, et la façon dont une application Web doit lire les deux.
En quoi consiste un préfixe de scanneur de codes à barres?
Un préfixe est une séquence réglée que le scanneur transmet avant le contenu. Le contenu est le texte décodé par la symbologie, par exemple 123456789. Le préfixe ne fait pas partie de ce décodage, à moins que le scanneur n'ait été réglé pour l'ajouter.
Usages courants :
- Marquer le début d'un message. Les protocoles sériels et de terminal envoient parfois un caractère de contrôle, souvent appelé STX, pour que l'hôte sache qu'une nouvelle trame a commencé.
- Nommer la symbologie. Lorsque l'identifiant de symbologie AIM est activé, un scanneur peut envoyer un court préfixe imprimable comme
]C1pour le Code 128 ou]E0pour l'EAN, avant les chiffres. L'application peut bifurquer selon cet identifiant. - Aiguiller la saisie dans un ancien logiciel de POS ou de terminal. Un code fixe avant les données indiquait à l'hôte à quelle zone ou à quel appareil la lecture appartenait.
- Étiqueter un poste précis. Deux scanneurs peuvent recevoir des préfixes imprimables différents, afin qu'un journal montre quelle voie a envoyé le code.
Un préfixe imprimable est fait de caractères ordinaires. Ils apparaissent dans une zone de texte au début de la chaîne. Un préfixe de caractère de contrôle, comme STX (0x02), n'est pas les lettres S, T et X. Un scanneur en mode en coin peut être incapable de taper ce caractère de contrôle. Un scanneur sériel peut l'envoyer comme un octet. Lisez le guide du modèle que vous avez avant d'écrire du code qui attend l'un ou l'autre.
Un préfixe ne prouve pas qu'un scanneur a produit la saisie. Une personne, une macro ou le Barcode Scanner Emulator peut taper les mêmes caractères. Traitez un préfixe comme un cadrage que vous avez réglé, puis validez le contenu comme toute autre saisie de l'utilisateur.
En quoi consiste un suffixe de scanneur de codes à barres?
Un suffixe est une séquence réglée, envoyée après le contenu. Son rôle habituel est d'indiquer à l'application que la lecture est terminée, ou de déplacer le focus. Les scanneurs diffèrent. Certains offrent Entrée, Tabulation, CR, LF, CR+LF, une chaîne personnalisée ou rien du tout. Certains n'en offrent qu'une ou deux.
ENTER. La touche Entrée. Dans un navigateur, c'est un événement clavier, event.key === "Enter". Elle n'est pas insérée dans une zone de texte ordinaire.
TAB. La touche de tabulation, event.key === "Tab". Le navigateur déplace le focus vers le prochain élément. La touche n'est pas insérée dans la zone.
CR. Retour de chariot, ASCII 0x0D. Sur une interface sérielle ou de terminal, il peut s'agir d'un octet réel après le contenu. Sur un mode en coin, un réglage nommé CR ou retour de chariot signifie habituellement la touche Entrée. Le navigateur signale toujours Entrée. La valeur de la zone ne gagne pas un caractère CR.
LF. Saut de ligne, ASCII 0x0A. C'est un caractère de contrôle distinct de CR. Sur un flux sériel, il peut former son propre octet. Un scanneur en mode en coin n'a pas de touche Saut de ligne standard comme il a Entrée et Tabulation. Ne supposez pas qu'un élément de menu nommé LF tape un caractère visible ou une seconde Entrée.
CRLF. CR suivi de LF, les deux octets 0x0D 0x0A. Certains hôtes sériels et de terminal attendent cette paire comme fin de ligne. Une zone de texte du navigateur ne conserve pas cette paire lorsque quelqu'un appuie sur Entrée.
Caractères personnalisés. Un suffixe imprimable comme # ou un code court est tapé après le code à barres. Il devient donc une partie de la chaîne, à moins que l'application ne le retire. Un caractère de contrôle personnalisé suit le même partage que STX : des octets sur un port sériel, des frappes en mode en coin, et seulement les frappes que l'interface clavier peut vraiment envoyer.
ENTER, CR et LF sont des noms apparentés pour la fin de ligne dans les guides. Ils ne sont pas interchangeables dans chaque application. Un scanneur en mode en coin, un scanneur sériel, Notepad et un formulaire Web peuvent chacun afficher un résultat différent pour un réglage du même nom.
Préfixe et suffixe
| Caractéristique | Préfixe | Suffixe |
|---|---|---|
| Position | Avant les données du code à barres | Après les données du code à barres |
| Rôle | Marquer le début ou étiqueter la saisie | Marquer la fin ou déclencher une action |
| Exemple | STX, ou un identifiant AIM imprimable comme ]C1 |
ENTER, TAB, ou un caractère imprimable comme # |
| Usage courant | Encadrer ou reconnaître la lecture | Envoyer un formulaire ou déplacer le focus |
| Dans une zone de texte | Les caractères imprimables sont au début de la valeur | Les caractères imprimables sont à la fin. Entrée et Tabulation, non |
| Identité | Un marqueur réglé que n'importe qui peut taper | Un marqueur réglé que n'importe qui peut taper |
Ne retirez un préfixe ou un suffixe personnalisé que si vous avez réglé exactement cette séquence et que l'enregistrement conservé ne doit pas l'inclure. Laissez un identifiant AIM en place jusqu'à ce que l'application ait une règle pour lui.
ENTER, TAB, CR et LF
Ces noms figurent sur les feuilles de réglage. Le côté qui reçoit voit soit des frappes, soit des octets, selon l'interface. Le guide Mode en coin de clavier HID décrit le chemin des frappes. Un port sériel est un autre chemin : l'application lit des octets, et le focus ne choisit pas où ils vont.
ENTER
Sur un scanneur en mode en coin, ENTER est la touche Entrée. Dans une zone de texte d'une seule ligne, les navigateurs actuels utilisent cette touche pour envoyer le formulaire qui l'entoure. Une zone de recherche peut valider la lecture sur cet événement. Un formulaire à plusieurs zones peut s'envoyer avant que les zones suivantes soient remplies. Appelez preventDefault() sur l'événement submit, ou sur le keydown d'Entrée, lorsque la page doit garder la valeur et rester en place. Traitez Entrée à un seul endroit. Un écouteur keydown et un écouteur submit qui acceptent tous les deux la lecture l'enregistrent deux fois.
Certains scanneurs envoient NumPad Enter. event.key demeure "Enter". event.code peut être "NumpadEnter" plutôt que "Enter". Vérifiez event.key si les deux touches doivent valider la zone.
Le guide Suffixes ENTER et TAB des scanneurs de codes à barres compare ces deux choix pour les POS et les formulaires Web. Le scanneur de codes à barres n'envoie pas ENTER traite un scanneur qui tape le code à barres, puis s'arrête.
TAB
TAB est la touche de tabulation. Le navigateur déplace le focus après keydown. Lisez la zone dans ce gestionnaire keydown, pendant qu'elle a encore le focus, et laissez l'action par défaut en place lorsque le prochain élément doit recevoir le curseur. preventDefault() garde le focus sur la zone actuelle.
Maj+Tab est la même touche avec Maj maintenue. Un suffixe Tab de scanneur est Tab sans Maj. Ignorez event.shiftKey si les personnes au clavier doivent pouvoir reculer dans le formulaire.
CR
Le retour de chariot place le curseur au début de la ligne dans un terminal. L'octet est 0x0D. Un scanneur sériel peut ajouter cet octet au contenu. Un réglage de mode en coin nommé CR envoie habituellement la touche Entrée au lieu d'insérer 0x0D dans le texte. Une pression sur Entrée dans une zone du navigateur n'écrit pas un caractère CR dans input.value.
Si l'hôte est un terminal ou un programme à l'écoute d'un port COM, cherchez l'octet. Si l'hôte est une page Web, cherchez event.key === "Enter".
LF
Le saut de ligne descend le curseur du terminal d'une ligne. L'octet est 0x0A. Certains hôtes traitent LF seul comme le saut de ligne. D'autres l'ignorent tant que CR n'est pas arrivé d'abord. Un scanneur en mode en coin qui offre LF comme suffixe peut envoyer une touche que le système d'exploitation ne transforme pas en saut de ligne, ou n'envoyer rien qu'une zone de texte conserve. Capturez la touche dans l'outil d'essai des événements clavier avant de traiter un LF supposé dans le code de l'application.
CRLF
CRLF est la séquence de deux contrôles, CR puis LF. Les fichiers texte de style Windows et de nombreux appareils sériels l'utilisent comme un seul saut de ligne. Une page de réglage qui indique un suffixe CRLF signifie que le scanneur essaiera d'envoyer cette paire après le contenu, sur l'interface qu'il utilise.
Dans un navigateur, une pression sur Entrée ne produit pas une séquence CRLF littérale dans une zone de texte. Le formulaire reçoit un événement clavier. Un <textarea> peut insérer un saut de ligne lorsque l'utilisateur appuie sur Entrée, et ce saut de ligne est le comportement d'édition propre au navigateur, pas la preuve que le scanneur a émis les octets 0x0D 0x0A. Un programme de lecture sériel peut recevoir ces deux octets et ne doit les traiter comme fin que si ce scanneur a été réglé pour les envoyer. Ne retirez pas CR ou LF du milieu d'un contenu qui a le droit de les contenir.
Comment les préfixes et les suffixes touchent les applications Web
Une lecture en mode en coin est une rafale de frappes dans l'élément qui a le focus. La page n'ouvre pas le scanneur. Si le focus est sur une autre zone, le préfixe, le code à barres et le suffixe s'y rendent tous.
keydown se déclenche pour chaque touche, y compris Entrée et Tabulation, avant que le navigateur n'insère un caractère ou ne déplace le focus. event.key est le caractère ou le nom de touche une fois que le système d'exploitation a appliqué la disposition du clavier. Les caractères imprimables du préfixe et du suffixe apparaissent dans la zone par l'événement input. Entrée et Tabulation n'y apparaissent pas.
L'écouteur ci-dessous valide la zone lorsque Entrée arrive. Il n'ajoute pas un suffixe que le scanneur a omis. Si le scanneur n'envoie pas Entrée, la valeur reste dans la zone jusqu'à ce qu'autre chose la lise.
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 = ''
})
Donnez le focus à #barcode avant la lecture. preventDefault() empêche un formulaire parent de s'envoyer une seconde fois. Si la zone n'est pas dans un formulaire et que vous voulez l'envoi natif, omettez preventDefault().
Sans suffixe, attendez une action explicite : un bouton, une Entrée ultérieure de l'opérateur ou l'étape suivante du processus. Une minuterie d'inactivité peut traiter une pause comme la fin de la lecture. Cette minuterie est une heuristique. Un scanneur lent, un délai Bluetooth ou une frappe rapide peuvent tomber du mauvais côté. Préférez un suffixe réglé lorsque le processus a besoin d'une fin certaine.
Un préfixe imprimable connu peut être retiré après la lecture de la valeur :
function withoutConfiguredPrefix(value, prefix) {
if (prefix && value.startsWith(prefix)) {
return value.slice(prefix.length)
}
return value
}
Ne passez que le préfixe que vous avez réglé, par exemple ']C1'. Ne retirez pas un nombre arbitraire de caractères de chaque lecture.
Pour un formulaire complet qui gère aussi la tabulation, une saisie vide et une seconde lecture, consultez Comment mettre à l'essai les scanneurs de codes à barres dans les applications web.
Comment régler les préfixes et les suffixes
Les réglages de préfixe et de suffixe se trouvent sur le scanneur. Les noms de touches et la façon de les changer dépendent du fabricant. Il n'existe pas de code à barres de configuration qui fonctionne sur toutes les marques, et ce guide n'en imprime pas.
Méthodes habituelles :
- Lisez un code à barres de configuration tiré du guide de ce modèle exact. La feuille est groupée par réglage : suffixe, préfixe, disposition du clavier, symbologie.
- Utilisez le programme de configuration du fabricant, puis écrivez le résultat sur le scanneur par USB.
- Utilisez l'utilitaire de gestion des appareils de cette gamme lorsque vous mettez à jour de nombreuses unités.
Après un changement, lisez un code à barres connu et comparez le résultat à la description, dans le guide, du réglage choisi. Une réinitialisation d'usine d'une autre marque peut laisser le scanneur inchangé ou le placer dans un mode inattendu. Le Guide de configuration du scanneur de codes à barres résume les réglages qui comptent en général. Il ne remplace pas le guide de l'appareil.
Le Barcode Scanner Emulator peut taper une valeur que vous choisissez, puis envoyer ENTER, TAB ou aucun suffixe. Placez un préfixe imprimable dans cette valeur lorsque vous devez exercer le traitement du préfixe sans matériel. L'émulateur n'émet pas une paire d'octets CR/LF sériels, et il ne lit pas une étiquette.
Comment mettre à l'essai le comportement du préfixe et du suffixe
Utilisez un scanneur en mode clavier, clavier HID USB ou clavier HID Bluetooth.
- Branchez-le et attendez qu'il indique qu'il est sous tension.
- Ouvrez l'outil d'essai de saisie de codes à barres.
- Cliquez sur Start Test, ou cliquez sur la zone de lecture. Elle devient bleue lorsqu'elle est prête. La page ne prend pas le focus d'elle-même.
- Lisez un code à barres dont vous connaissez déjà le contenu.
- Lisez la valeur captée et le nombre de caractères. Les caractères imprimables du préfixe ou du suffixe sont dans cette chaîne. La ligne Prefix concerne les touches nommées qui arrivent avant le premier caractère, comme un modificateur. Elle ne retire pas un préfixe tapé comme
]C1du texte du code à barres. - Vérifiez le suffixe. L'outil signale ENTER, TAB ou None. Avec Auto capture activé, le résultat apparaît après Entrée, Tabulation ou une courte pause une fois les touches arrêtées. Désactivez Auto capture pour garder la capture jusqu'à ce que vous appuyiez sur Stop. Entrée et Tabulation ne font pas partie de la chaîne du code à barres.
- Comparez ce résultat au réglage voulu. Ouvrez ensuite l'outil d'essai des événements clavier et relisez lorsque vous avez besoin de chaque
keydowndans l'ordre, y compriskey,codeet le minutage.
L'outil de saisie enregistre les événements clavier que le navigateur peut voir. Il ne peut pas lire un port sériel, donc il ne peut pas montrer CR ou LF comme octets bruts. Un essai en mode en coin ne prouve pas ce qu'un réglage sériel enverra.
Dépannage
Le scanneur n'envoie pas ENTER. Le code à barres apparaît et le curseur reste dans la zone. L'outil de saisie signale None. Le suffixe est désactivé, ou il est réglé sur autre chose qu'Entrée. Consultez Le scanneur de codes à barres n'envoie pas ENTER.
TAB déplace le focus de façon inattendue. Le scanneur envoie la touche de tabulation. C'est le suffixe réglé. Utilisez Entrée lorsque le formulaire doit s'envoyer, ou lisez la valeur sur le keydown de tabulation lorsque le processus doit avancer. Les détails sont dans le guide Suffixes ENTER et TAB des scanneurs de codes à barres.
Le formulaire s'envoie deux fois. Le navigateur envoie sur Entrée, et un écouteur keydown accepte aussi la lecture. Gardez un seul chemin de fin et appelez preventDefault() sur l'autre.
Un préfixe apparaît dans le code à barres. Un préfixe imprimable fait partie de la chaîne captée. Désactivez-le sur le scanneur, ou retirez exactement cette séquence dans l'application. Un identifiant de symbologie activé est une source fréquente d'un ] au début et de deux caractères de plus. Un préfixe de contrôle que le mode en coin ne peut pas taper sera absent au lieu d'être visible.
Les caractères sont erronés. La disposition du scanneur et celle du système d'exploitation peuvent diverger, ce qui change les caractères du préfixe et la ponctuation alors que la longueur reste la même. Consultez Mauvaise disposition du clavier du scanneur de codes à barres.
L'application ne voit jamais la fin de la lecture. Il n'y a pas de suffixe, et la page attend Entrée. Ajoutez un suffixe qui correspond au formulaire, ou terminez la valeur par une action explicite. Une estimation de temps manquera certaines lectures réelles et acceptera certaines frappes.
CR/LF diffère d'une application à l'autre. Notepad insère une nouvelle ligne lorsqu'il reçoit Entrée. Une zone de texte Web conserve le code à barres et déclenche un événement de touche. Un programme sériel peut recevoir 0x0D, 0x0A ou les deux. Comparez l'interface avant de modifier le scanneur. Si aucune application ne reçoit de caractères, commencez par Le scanneur de codes à barres ne fonctionne pas.
Un tour plus large du focus, des lectures répétées et des processus de POS se trouve dans Comment mettre à l'essai la saisie d'un scanneur de codes à barres.
Matrice d'essai
La colonne de réglage est ce que vous réglez sur le scanneur, ou ce que vous tapez avec l'émulateur lorsque le cas est un suffixe clavier. Le comportement attendu est ce que l'application doit faire. Un cas CRLF sériel n'est pas le même essai qu'une touche Entrée dans un navigateur.
| Réglage | Comportement attendu de l'application |
|---|---|
| Aucun préfixe, aucun suffixe | La valeur du code à barres est reçue et aucune touche de fin n'arrive. La valeur reste disponible jusqu'à ce que l'application la lise. |
| Aucun préfixe, suffixe ENTER | L'application reçoit la touche de fin une fois et conserve le contenu sans caractère de terminaison. |
| Aucun préfixe, suffixe TAB | Le focus peut passer à l'élément suivant. L'application lit la valeur avant ce déplacement. |
| Préfixe imprimable personnalisé | Les caractères du préfixe apparaissent avant les données décodées. L'application garde ou retire exactement ce préfixe, de façon voulue. |
| Suffixe imprimable personnalisé | Les caractères du suffixe apparaissent après les données décodées. Entrée et Tabulation sont des touches, donc elles n'apparaissent pas dans la chaîne. |
| Séquence CRLF | Un hôte sériel ou de terminal traite les octets CR et LF réglés. Une zone de texte du navigateur ne gagne pas ces octets à partir d'une pression sur Entrée. |
Exécutez les lignes clavier sur le scanneur en mode en coin et, en l'absence de matériel, avec les réglages ENTER, TAB et aucun suffixe de l'émulateur. Exécutez la ligne CRLF sur l'interface qui est censée porter ces octets. Les résultats réels dépendent encore de cette interface et de l'application.