Salta al contingut

Barcode Scanner Emulator

Prefix i sufix de l'escàner de codis de barres: guia completa

Un prefix són dades o una seqüència de control que l'escàner de codis de barres envia abans del codi descodificat. Un sufix és el que envia després d'aquest valor. El mateix model es pot configurar amb prefixos i sufixos diferents, i un escàner sèrie no els lliura de la mateixa manera que un escàner de falca de teclat.

El prefix d'un escàner de codis de barres s'envia abans del valor descodificat. El sufix s'envia després. Un escàner pot produir aquesta seqüència:

Prefix: STX

Codi de barres: 123456789

Sufix: ENTER

STX en un manual sol voler dir el caràcter de control, no les lletres S, T i X. ENTER en un escàner de falca de teclat és normalment la tecla Retorn, no els caràcters CR i LF inserits en un camp de text. Quin dels dos rebeu depèn del model, de la interfície i de l'aplicació. Cap ajust no és universal.

La guia Sufixos ENTER i TAB es queda en l'elecció i la resolució d'aquests dos terminadors. Aquesta guia tracta el marc al voltant del codi de barres: què va abans, què va després i com una aplicació web ha de llegir tots dos.

Què és un prefix d'escàner de codis de barres?

Un prefix és una seqüència configurada que l'escàner transmet abans de la càrrega útil. La càrrega útil és el text que la simbologia ha descodificat, com ara 123456789. El prefix no forma part d'aquesta descodificació tret que l'escàner s'hagi configurat per afegir-lo.

Usos habituals:

  • Marcar l'inici d'un missatge. Els protocols sèrie i de terminal envien de vegades un caràcter de control, sovint anomenat STX, perquè l'amfitrió sàpiga que ha començat un marc nou.
  • Anomenar la simbologia. Amb l'identificador de simbologia AIM activat, un escàner pot enviar un prefix curt imprimible com ]C1 per a Code 128 o ]E0 per a EAN abans dels dígits. L'aplicació pot ramificar segons aquest identificador.
  • Encaminar l'entrada en programari antic de POS o de terminal. Un codi fix abans de les dades deia a l'amfitrió a quin camp o dispositiu pertanyia la lectura.
  • Etiquetar una estació concreta. Dos escàners poden rebre prefixos imprimibles diferents perquè un registre mostri quin carril ha enviat el codi.

Un prefix imprimible són caràcters normals. Apareixen en un camp de text al capdavant de la cadena. Un prefix de caràcter de control, com STX (0x02), no són les lletres S, T i X. Un escàner de falca pot ser incapaç d'escriure aquell caràcter de control. Un escàner sèrie el pot enviar com a byte. Llegiu el manual del model que teniu abans d'escriure codi que n'esperi un o l'altre.

Un prefix no demostra que un escàner hagi produït l'entrada. Una persona, una macro o el Barcode Scanner Emulator poden escriure els mateixos caràcters. Tracteu el prefix com un emmarcament que heu configurat i valideu després la càrrega útil tal com valideu qualsevol altra entrada d'usuari.

Què és un sufix d'escàner de codis de barres?

Un sufix és una seqüència configurada que s'envia després de la càrrega útil. La feina habitual és dir a l'aplicació que la lectura s'ha acabat, o moure el focus. Els escàners difereixen. Alguns ofereixen Retorn, Tab, CR, LF, CR+LF, una cadena pròpia o res. Alguns només n'ofereixen un o dos.

ENTER. La tecla Retorn. En un navegador és un esdeveniment de teclat, event.key === "Enter". No s'insereix en un camp de text normal.

TAB. La tecla de tabulació, event.key === "Tab". El navegador mou el focus al control següent. La tecla no s'insereix al camp.

CR. Retorn de carro, ASCII 0x0D. En una interfície sèrie o de terminal això pot ser un byte real després de la càrrega útil. En una falca, un ajust etiquetat CR o retorn de carro sol voler dir la tecla Retorn. El navegador continua informant Enter. El valor del camp no guanya un caràcter CR.

LF. Salt de línia, ASCII 0x0A. És un caràcter de control diferent de CR. En un flux sèrie pot ser el seu propi byte. Una falca de teclat no té una tecla Line Feed estàndard de la manera que té Retorn i Tab. No suposeu que un element de menú anomenat LF escriu un caràcter visible o un segon Retorn.

CRLF. CR seguit de LF, els dos bytes 0x0D 0x0A. Alguns amfitrions sèrie i de terminal esperen aquesta parella com a final de línia. Un camp de text del navegador no emmagatzema aquesta parella quan algú prem Retorn.

Caràcters personalitzats. Un sufix imprimible com # o un codi curt s'escriu després del codi de barres, de manera que passa a formar part de la cadena tret que l'aplicació el tregui. Un caràcter de control personalitzat segueix la mateixa divisió que STX: bytes en un port sèrie, pulsacions en una falca, i només les pulsacions que la interfície de teclat pot enviar de debò.

ENTER, CR i LF són noms emparentats per al final de línia als manuals. No són intercanviables en cada aplicació. Un escàner de falca, un escàner sèrie, el Notepad i un formulari web poden mostrar cadascun un resultat diferent per a un ajust amb el mateix nom.

Prefix i sufix

Característica Prefix Sufix
Posició Abans de les dades del codi de barres Després de les dades del codi de barres
Finalitat Marcar el començament o etiquetar l'entrada Marcar la compleció o desencadenar una acció
Exemple STX, o un identificador AIM imprimible com ]C1 ENTER, TAB o un caràcter imprimible com #
Ús habitual Emmarcar o identificar la lectura Enviar un formulari o moure el focus
En un camp de text Els caràcters imprimibles queden al principi del valor Els caràcters imprimibles queden al final. Retorn i Tab no
Identitat Un marcador configurat que qualsevol pot escriure Un marcador configurat que qualsevol pot escriure

Traieu un prefix o un sufix personalitzat només quan hàgiu configurat exactament aquella seqüència i el registre desat no l'hagi d'incloure. Deixeu un identificador AIM al seu lloc fins que l'aplicació tingui una regla per a ell.

ENTER, TAB, CR i LF

Aquests noms surten als fulls de configuració. El costat receptor veu pulsacions o bytes, segons la interfície. La guia Falca de teclat HID descriu el camí de les pulsacions. Un port sèrie és un camí diferent: l'aplicació llegeix bytes, i el focus no tria on van.

ENTER

En un escàner de falca de teclat, ENTER és la tecla Retorn. Dins d'un camp de text d'una línia, els navegadors actuals fan servir aquesta tecla per enviar el formulari que el conté. Un quadre de cerca pot confirmar la lectura en aquest esdeveniment. Un formulari de diversos camps es pot enviar abans que els camps posteriors estiguin emplenats. Crideu preventDefault() a l'esdeveniment submit, o al keydown de Retorn, quan la pàgina hagi de conservar el valor i quedar-se. Gestioneu Retorn en un sol lloc. Un escoltador keydown i un escoltador submit que acceptin tots dos la lectura la registraran dues vegades.

Alguns escàners envien NumPad Enter. event.key continua sent "Enter". event.code pot ser "NumpadEnter" en comptes de "Enter". Proveu event.key si totes dues tecles han de confirmar el camp.

La guia Sufixos ENTER i TAB compara aquestes dues opcions per al POS i els formularis web. A l'escàner de codis de barres li falta ENTER cobreix un escàner que escriu el codi i després s'atura.

TAB

TAB és la tecla de tabulació. El navegador mou el focus després de keydown. Llegiu el camp en aquest gestor de keydown, mentre encara té el focus, i deixeu l'acció per defecte al seu lloc quan el control següent hagi de rebre el cursor. preventDefault() manté el focus al camp actual.

Shift+Tab és la mateixa tecla amb Majúscules premut. Un sufix Tab de l'escàner és Tab sense Majúscules. Ignoreu event.shiftKey si els usuaris de teclat han de poder recular pel formulari.

CR

El retorn de carro mou un cursor al principi de la línia en un terminal. El byte és 0x0D. Un escàner sèrie pot afegir aquest byte a la càrrega útil. Un ajust de falca anomenat CR envia típicament la tecla Retorn en lloc d'inserir 0x0D al text. Prémer Retorn en un camp del navegador no escriu un caràcter CR a input.value.

Si l'amfitrió és un terminal o un escoltador de port COM, busqueu el byte. Si l'amfitrió és una pàgina web, busqueu event.key === "Enter".

LF

El salt de línia mou el cursor d'un terminal una línia avall. El byte és 0x0A. Alguns amfitrions tracten LF sol com un salt de línia. D'altres l'ignoren tret que CR hagi arribat abans. Un escàner de falca que llista LF com a sufix pot enviar una tecla que el sistema operatiu no converteix en un salt de línia, o pot no enviar res que un camp de text conservi. Captureu la tecla al Provador d'esdeveniments de teclat abans de gestionar un LF suposat al codi de l'aplicació.

CRLF

CRLF és la seqüència de dos controls, CR i després LF. Els fitxers de text a l'estil de Windows i molts dispositius sèrie la fan servir com un sol salt de línia. Una pàgina de configuració que diu sufix CRLF vol dir que l'escàner intentarà enviar aquesta parella després de la càrrega útil a la interfície que fa servir.

En un navegador, prémer Retorn no produeix una seqüència CRLF literal dins d'un camp de text. El formulari rep un esdeveniment de teclat. Un <textarea> pot inserir un salt de línia quan l'usuari prem Retorn, i aquest salt és el comportament d'edició propi del navegador, no una prova que l'escàner hagi emès els bytes 0x0D 0x0A. Un lector sèrie pot rebre aquests dos bytes i només els ha de tractar com a terminador si aquell escàner es va configurar per enviar-los. No traieu CR o LF del mig d'una càrrega útil que té permís per contenir-los.

Com els prefixos i els sufixos afecten les aplicacions web

Una lectura de falca de teclat és una ràfega de pulsacions cap al control que té el focus. La pàgina no obre l'escàner. Si el focus és en un altre camp, el prefix, el codi de barres i el sufix hi van tots.

keydown es dispara per a cada tecla, incloent-hi Retorn i Tab, abans que el navegador insereixi un caràcter o mogui el focus. event.key és el caràcter o el nom de la tecla després que el sistema operatiu apliqui la distribució de teclat. Els caràcters imprimibles de prefix i de sufix apareixen al camp mitjançant l'esdeveniment input. Retorn i Tab no.

L'escoltador de sota confirma el camp quan arriba Retorn. No afegeix un sufix que l'escàner hagi omès. Si l'escàner no envia Retorn, el valor es queda al camp fins que una altra cosa el llegeixi.

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

Doneu el focus a #barcode abans de la lectura. preventDefault() atura un formulari antecessor perquè no s'enviï una segona vegada. Si l'entrada no és dins d'un formulari i voleu l'enviament natiu, ometeu preventDefault().

Sense sufix, espereu una acció explícita: un botó, un Retorn posterior de l'operador o el pas següent del flux. Un temporitzador d'inactivitat pot tractar una pausa com el final de la lectura. Aquest temporitzador és una heurística. Un escàner lent, un retard de Bluetooth o algú que escriu de pressa poden caure al costat equivocat. Preferiu un sufix configurat quan el flux necessita un final definit.

Un prefix imprimible conegut es pot treure després de llegir el valor:

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

Passeu només el prefix que heu configurat, com ara ']C1'. No traieu un nombre arbitrari de caràcters de cada lectura.

Per a un formulari complet que també gestiona Tab, una entrada buida i una segona lectura, vegeu Com provar escàners de codis de barres en aplicacions web.

Com configurar prefixos i sufixos

Els ajustos de prefix i de sufix viuen a l'escàner. Els noms de les tecles i la manera de canviar-los són específics del fabricant. No hi ha un codi de configuració que funcioni en cada marca, i aquesta guia no en imprimeix cap.

Mètodes típics:

  • Llegiu un codi de configuració del manual d'aquell model exacte. El full s'agrupa per ajust: sufix, prefix, distribució de teclat, simbologia.
  • Feu servir el programa de configuració del proveïdor i escriviu el resultat a l'escàner per USB.
  • Feu servir la utilitat de gestió de dispositius d'aquella línia de producte quan actualitzeu moltes unitats.

Després d'un canvi, llegiu un codi conegut i compareu el resultat amb la descripció del manual de l'ajust que heu triat. Un restabliment de fàbrica d'una altra marca pot deixar l'escàner sense canvis o posar-lo en un mode inesperat. La guia Guia de configuració de l'escàner de codis de barres resumeix els ajustos que solen importar. No substitueix el manual.

El Barcode Scanner Emulator pot escriure un valor que trieu i després enviar ENTER, TAB o cap sufix. Poseu un prefix imprimible en aquest valor quan calgui exercitar el tractament del prefix sense maquinari. L'emulador no emet una parella de bytes sèrie CR/LF i no llegeix una etiqueta.

Com provar el comportament del prefix i del sufix

Feu servir un escàner en mode de teclat, USB HID keyboard o Bluetooth HID keyboard.

  1. Connecteu-lo i espereu fins que mostri que té alimentació.
  2. Obriu el Provador d'entrada de codis de barres.
  3. Feu clic a Start Test, o feu clic a la zona de lectura. Es torna blau quan està a punt. La pàgina no agafa el focus tota sola.
  4. Llegiu un codi de barres la càrrega útil del qual ja coneixeu.
  5. Llegiu el valor capturat i el nombre de caràcters. Els caràcters imprimibles de prefix o de sufix són dins d'aquesta cadena. La línia Prefix és per a tecles amb nom que arriben abans del primer caràcter, com un modificador. No extreu un prefix escrit com ]C1 del text del codi de barres.
  6. Comproveu el sufix. El provador informa ENTER, TAB o None. Amb Auto capture activat, el resultat apareix després de Retorn, Tab o una pausa curta quan les tecles s'aturen. Desactiveu Auto capture per retenir la captura fins que premeu Stop. Retorn i Tab no formen part de la cadena del codi de barres.
  7. Compareu aquest resultat amb la configuració que volíeu. Després obriu el Provador d'esdeveniments de teclat i torneu a llegir quan necessiteu cada keydown en ordre, incloent-hi key, code i el temps.

El provador d'entrada registra els esdeveniments de teclat que el navegador pot veure. No pot llegir un port sèrie, de manera que no pot mostrar CR o LF com a bytes en brut. Una prova de falca no demostra què enviarà un ajust sèrie.

Resolució de problemes

L'escàner no envia ENTER. El codi de barres apareix i el cursor es queda al camp. El provador d'entrada informa None. El sufix està apagat, o està posat en una altra cosa que no és Retorn. Vegeu A l'escàner de codis de barres li falta ENTER.

TAB mou el focus de manera inesperada. L'escàner envia la tecla de tabulació. Aquest és el sufix configurat. Feu servir Retorn quan el formulari s'hagi d'enviar, o llegiu el valor al keydown de Tab quan el flux hagi d'avançar. Els detalls són a la guia Sufixos ENTER i TAB.

El formulari s'envia dues vegades. El navegador envia amb Retorn, i un escoltador keydown també accepta la lectura. Conserveu un sol camí de compleció i crideu preventDefault() a l'altre.

Un prefix apareix dins del codi de barres. Un prefix imprimible forma part de la cadena capturada. O bé desactiveu-lo a l'escàner o bé traieu aquella seqüència exacta a l'aplicació. Un identificador de simbologia activat és una font habitual d'un ] inicial i de dos caràcters més. Un prefix de control que la falca no pot escriure faltarà en lloc de ser visible.

Els caràcters són incorrectes. La distribució de l'escàner i la del sistema operatiu poden no coincidir, cosa que canvia els caràcters del prefix i la puntuació mentre la llargada es manté. Vegeu Distribució de teclat incorrecta a l'escàner de codis de barres.

L'aplicació no veu mai el final de la lectura. No hi ha sufix, i la pàgina espera Retorn. Afegiu un sufix que encaixi amb el formulari, o completeu el valor amb una acció explícita. Una suposició de temps fallarà algunes lectures reals i acceptarà una mica d'escriptura.

CR/LF difereix entre aplicacions. El Notepad insereix una línia nova quan rep Retorn. Un camp de text web conserva el codi de barres i dispara un esdeveniment de tecla. Un programa sèrie pot rebre 0x0D, 0x0A o tots dos. Compareu la interfície abans de canviar l'escàner. Si cap aplicació no rep caràcters, comenceu per L'escàner de codis de barres no funciona.

Una passada més àmplia pel focus, les lectures repetides i els fluxos de POS és a Com provar l'entrada d'un escàner de codis de barres.

Matriu de proves

La columna de configuració és el que definiu a l'escàner, o el que escriviu amb l'emulador quan el cas és un sufix de teclat. El comportament esperat és el que ha de fer l'aplicació. Un cas CRLF sèrie no és la mateixa prova que la tecla Retorn en un navegador.

Configuració Comportament esperat de l'aplicació
Sense prefix, sense sufix Es rep el valor del codi de barres i no arriba cap tecla de compleció. El valor queda disponible fins que l'aplicació el llegeix.
Sense prefix, sufix ENTER L'aplicació rep la tecla de compleció una vegada i desa la càrrega útil sense un caràcter terminador.
Sense prefix, sufix TAB El focus es pot moure al control següent. L'aplicació llegeix el valor abans d'aquest moviment.
Prefix imprimible personalitzat Els caràcters del prefix apareixen abans de les dades descodificades. L'aplicació conserva o treu exactament aquest prefix a posta.
Sufix imprimible personalitzat Els caràcters del sufix apareixen després de les dades descodificades. Retorn i Tab són tecles, de manera que no apareixen a la cadena.
Seqüència CRLF Un amfitrió sèrie o de terminal processa els bytes CR i LF configurats. Un camp de text del navegador no obté aquests bytes d'una pulsació de Retorn.

Executeu les files de teclat a l'escàner de falca i, quan falta el maquinari, amb els ajustos ENTER, TAB i sense sufix de l'emulador. Executeu la fila CRLF a la interfície que ha de portar aquests bytes. Els resultats reals encara depenen d'aquesta interfície i de l'aplicació.