Barcode Scanner Emulator
Prefixo e sufixo no leitor de códigos de barras: guia completo
Um prefixo é um dado ou uma sequência de controlo que um leitor de códigos de barras envia antes do código de barras descodificado. Um sufixo é o que envia a seguir a esse valor. O mesmo modelo pode ser definido com prefixos e sufixos diferentes, e um leitor série não os entrega da mesma forma que um leitor em cunha de teclado.
Um prefixo de leitor de códigos de barras é enviado antes do valor descodificado. Um sufixo é enviado a seguir. Um leitor pode produzir esta sequência:
Prefixo: STX
Código de barras: 123456789
Sufixo: ENTER
Num manual, STX significa muitas vezes o carácter de controlo, e não as três letras S, T e X. Num leitor em cunha de teclado, ENTER é habitualmente a tecla Enter, e não os dois caracteres CR e LF inseridos num campo de texto. O que se recebe depende do modelo, da interface e da aplicação. Nenhuma definição vale para todos os aparelhos.
O guia Sufixos ENTER e TAB nos leitores de códigos de barras fica na escolha e na resolução desses dois terminadores. Este guia trata da moldura à volta do código de barras: o que vem antes, o que vem depois e como uma aplicação web deve ler ambos.
O que é um prefixo de leitor de códigos de barras?
Um prefixo é uma sequência configurada que o leitor transmite antes da carga. A carga é o texto que a simbologia descodificou, como 123456789. O prefixo não faz parte dessa descodificação, salvo se o leitor tiver sido definido para o acrescentar.
Utilizações habituais:
- Marcar o início de uma mensagem. Os protocolos série e de terminal enviam por vezes um carácter de controlo, muitas vezes chamado STX, para o anfitrião saber que uma trama nova começou.
- Nomear a simbologia. Com o identificador de simbologia AIM activado, um leitor pode enviar um prefixo imprimível curto, como
]C1para Code 128 ou]E0para EAN, antes dos algarismos. A aplicação pode ramificar com base nesse identificador. - Encaminhar a introdução em software antigo de POS ou de terminal. Um código fixo antes dos dados indicava ao anfitrião a que campo ou dispositivo a leitura pertencia.
- Etiquetar um posto concreto. Dois leitores podem receber prefixos imprimíveis diferentes para um registo mostrar que via enviou o código.
Um prefixo imprimível são caracteres comuns. Surgem num campo de texto no início da cadeia. Um prefixo de carácter de controlo, como STX (0x02), não são as letras S, T e X. Um leitor em cunha de teclado pode ser incapaz de escrever esse carácter de controlo. Um leitor série pode enviá-lo como um byte. Leia o manual do modelo que tem antes de escrever código que espere um ou outro.
Um prefixo não prova que um leitor produziu a introdução. Uma pessoa, uma macro ou o Barcode Scanner Emulator podem escrever os mesmos caracteres. Trate um prefixo como o enquadramento que configurou e valide a carga como qualquer outra introdução do utilizador.
O que é um sufixo de leitor de códigos de barras?
Um sufixo é uma sequência configurada enviada a seguir à carga. A função habitual é dizer à aplicação que a leitura terminou, ou deslocar o foco. Os leitores diferem. Alguns oferecem Enter, Tab, CR, LF, CR+LF, uma cadeia personalizada ou nada. Alguns oferecem apenas uma ou duas dessas opções.
ENTER. A tecla Enter. Num navegador é um evento de teclado, event.key === "Enter". Não é inserida num campo de texto comum.
TAB. A tecla Tab, event.key === "Tab". O navegador desloca o foco para o controlo seguinte. A tecla não é inserida no campo.
CR. Retorno de carro, ASCII 0x0D. Numa interface série ou de terminal pode ser um byte real a seguir à carga. Numa cunha de teclado, uma definição com o nome CR ou retorno de carro significa habitualmente a tecla Enter. O navegador continua a indicar Enter. O valor do campo não ganha um carácter CR.
LF. Avanço de linha, ASCII 0x0A. É um carácter de controlo distinto de CR. Num fluxo série pode ser o seu próprio byte. Uma cunha de teclado não tem uma tecla padrão de avanço de linha como tem Enter e Tab. Não presuma que um item de menu chamado LF escreve um carácter visível ou um segundo Enter.
CRLF. CR seguido de LF, os dois bytes 0x0D 0x0A. Alguns anfitriões série e de terminal esperam esse par como fim de linha. Um campo de texto do navegador não guarda esse par quando alguém prime Enter.
Caracteres personalizados. Um sufixo imprimível como # ou um código curto é escrito a seguir ao código de barras, pelo que passa a fazer parte da cadeia, salvo se a aplicação o retirar. Um carácter de controlo personalizado segue a mesma divisão de STX: bytes numa porta série, premidas numa cunha e apenas as premidas que a interface de teclado consegue enviar de facto.
ENTER, CR e LF são nomes aparentados de fim de linha nos manuais. Não são permutáveis em todas as aplicações. Um leitor em cunha, um leitor série, o Notepad e um formulário web podem mostrar cada um um resultado diferente para uma definição com o mesmo nome.
Prefixo e sufixo
| Característica | Prefixo | Sufixo |
|---|---|---|
| Posição | Antes dos dados do código de barras | Depois dos dados do código de barras |
| Finalidade | Marcar o início ou rotular a introdução | Marcar a conclusão ou desencadear uma acção |
| Exemplo | STX, ou um identificador AIM imprimível como ]C1 |
ENTER, TAB ou um carácter imprimível como # |
| Utilização habitual | Enquadrar ou identificar a leitura | Submeter um formulário ou deslocar o foco |
| Num campo de texto | Os caracteres imprimíveis ficam no início do valor | Os caracteres imprimíveis ficam no fim. Enter e Tab, não |
| Identidade | Um marcador configurado que qualquer pessoa pode escrever | Um marcador configurado que qualquer pessoa pode escrever |
Retire um prefixo ou um sufixo personalizado apenas quando configurou exactamente essa sequência e o registo guardado não a deve incluir. Deixe um identificador AIM no lugar até a aplicação ter uma regra para ele.
ENTER, TAB, CR e LF
Estes nomes surgem nas folhas de configuração. O lado que recebe vê premidas ou bytes, consoante a interface. O guia Cunha de teclado HID descreve o percurso das premidas. Uma porta série é outro percurso: a aplicação lê bytes, e o foco não escolhe para onde vão.
ENTER
Num leitor em cunha de teclado, ENTER é a tecla Enter. Dentro de um campo de texto de uma linha, os navegadores actuais usam essa tecla para submeter o formulário que o envolve. Uma caixa de pesquisa pode confirmar a leitura nesse evento. Um formulário de vários campos pode ser submetido antes de os campos seguintes estarem preenchidos. Chame preventDefault() no evento submit, ou no keydown de Enter, quando a página deve manter o valor e ficar onde está. Trate Enter num só sítio. Um ouvinte keydown e um ouvinte submit que aceitam ambos a leitura registam-na duas vezes.
Alguns leitores enviam NumPad Enter. event.key continua a ser "Enter". event.code pode ser "NumpadEnter" em vez de "Enter". Teste event.key se ambas as teclas devem confirmar o campo.
O guia Sufixos ENTER e TAB nos leitores de códigos de barras compara essas duas escolhas para POS e formulários web. Leitor de códigos de barras sem ENTER trata um leitor que escreve o código de barras e depois pára.
TAB
TAB é a tecla Tab. O navegador desloca o foco depois de keydown. Leia o campo nesse processador keydown, enquanto ainda tem o foco, e deixe a acção predefinida no lugar quando o controlo seguinte deve receber o cursor. preventDefault() mantém o foco no campo actual.
Shift+Tab é a mesma tecla com Shift premido. Um sufixo Tab do leitor é Tab sem Shift. Ignore event.shiftKey se quem usa o teclado tiver de recuar no formulário.
CR
O retorno de carro leva o cursor ao início da linha num terminal. O byte é 0x0D. Um leitor série pode acrescentar esse byte à carga. Uma definição de cunha de teclado chamada CR envia tipicamente a tecla Enter em vez de inserir 0x0D no texto. Premir Enter num campo do navegador não escreve um carácter CR em input.value.
Se o anfitrião for um terminal ou um programa à escuta de uma porta COM, procure o byte. Se o anfitrião for uma página web, procure event.key === "Enter".
LF
O avanço de linha desce o cursor do terminal uma linha. O byte é 0x0A. Alguns anfitriões tratam LF sozinho como a quebra de linha. Outros ignoram-no, salvo se CR tiver chegado primeiro. Um leitor em cunha que lista LF como sufixo pode enviar uma tecla que o sistema operativo não transforma em quebra de linha, ou não enviar nada que um campo de texto conserve. Capture a tecla no testador de eventos de teclado antes de tratar um suposto LF no código da aplicação.
CRLF
CRLF é a sequência de dois controlos, CR e depois LF. Ficheiros de texto ao estilo do Windows e muitos dispositivos série usam-na como uma quebra de linha. Uma página de configuração que indica sufixo CRLF significa que o leitor tentará enviar esse par a seguir à carga na interface que estiver a usar.
Num navegador, premir Enter não produz uma sequência CRLF literal dentro de um campo de texto. O formulário recebe um evento de teclado. Um <textarea> pode inserir uma quebra de linha quando o utilizador prime Enter, e essa quebra é o comportamento de edição do próprio navegador, não uma prova de que o leitor emitiu os bytes 0x0D 0x0A. Um leitor série pode receber esses dois bytes e só os deve tratar como terminador se esse leitor tiver sido configurado para os enviar. Não retire CR ou LF do meio de uma carga que os pode conter.
Como os prefixos e os sufixos afectam as aplicações web
Uma leitura em cunha de teclado é uma rajada de premidas no controlo com foco. A página não abre o leitor. Se o foco estiver noutro campo, o prefixo, o código de barras e o sufixo vão todos para lá.
keydown dispara para cada tecla, incluindo Enter e Tab, antes de o navegador inserir um carácter ou deslocar o foco. event.key é o carácter ou o nome da tecla depois de o sistema operativo aplicar a disposição do teclado. Os caracteres imprimíveis do prefixo e do sufixo surgem no campo pelo evento input. Enter e Tab não surgem.
O ouvinte abaixo confirma o campo quando Enter chega. Não acrescenta um sufixo que o leitor omitiu. Se o leitor não enviar Enter, o valor permanece no campo até outra coisa o ler.
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 = ''
})
Dê foco a #barcode antes da leitura. preventDefault() impede que um formulário ascendente submeta uma segunda vez. Se o campo não estiver dentro de um formulário e quiser a submissão nativa, omita preventDefault().
Sem sufixo, aguarde uma acção explícita: um botão, um Enter posterior do operador ou o passo seguinte do fluxo. Um temporizador de inactividade pode tratar uma pausa como o fim da leitura. Esse temporizador é uma heurística. Um leitor lento, um atraso de Bluetooth ou alguém que escreve depressa podem cair do lado errado. Prefira um sufixo configurado quando o fluxo precisa de um fim definido.
Um prefixo imprimível conhecido pode ser retirado depois de ler o valor:
function withoutConfiguredPrefix(value, prefix) {
if (prefix && value.startsWith(prefix)) {
return value.slice(prefix.length)
}
return value
}
Passe apenas o prefixo que configurou, como ']C1'. Não retire um número arbitrário de caracteres de cada leitura.
Para um formulário completo que também trata Tab, introdução vazia e uma segunda leitura, consulte Como testar leitores de códigos de barras em aplicações web.
Como configurar prefixos e sufixos
As definições de prefixo e sufixo estão no leitor. Os nomes das teclas e a forma de os alterar dependem do fabricante. Não existe um código de barras de configuração que funcione em todas as marcas, e este guia não imprime nenhum.
Métodos habituais:
- Leia um código de barras de configuração do manual desse modelo exacto. A folha está agrupada por definição: sufixo, prefixo, disposição de teclado, simbologia.
- Utilize o programa de configuração do fabricante e escreva depois o resultado no leitor por USB.
- Utilize o utilitário de gestão de dispositivos dessa linha de produto quando actualizar muitas unidades.
Depois de uma alteração, leia um código de barras conhecido e compare o resultado com a descrição da definição escolhida no manual. Uma reposição de fábrica de outra marca pode deixar o leitor inalterado ou colocá-lo num modo inesperado. O Guia de configuração do leitor de códigos de barras resume as definições que habitualmente importam. Não substitui o manual.
O Barcode Scanner Emulator pode escrever um valor à sua escolha e depois enviar ENTER, TAB ou nenhum sufixo. Coloque um prefixo imprimível nesse valor quando precisar de exercitar o tratamento do prefixo sem equipamento. O emulador não emite um par de bytes CR/LF série e não lê uma etiqueta.
Como testar o comportamento do prefixo e do sufixo
Utilize um leitor em modo de teclado, teclado HID USB ou teclado HID Bluetooth.
- Ligue-o e aguarde até indicar que tem alimentação.
- Abra o testador de introdução de códigos de barras.
- Clique em Start Test ou na área de leitura. Fica azul quando está pronto. A página não toma o foco por si.
- Leia um código de barras cuja carga já conhece.
- Leia o valor captado e a contagem de caracteres. Os caracteres imprimíveis do prefixo ou do sufixo estão dentro dessa cadeia. A linha Prefix destina-se a teclas com nome que chegam antes do primeiro carácter, como um modificador. Não retira um prefixo escrito como
]C1do texto do código de barras. - Verifique o sufixo. O testador indica ENTER, TAB ou None. Com Auto capture activo, o resultado aparece depois de Enter, Tab ou uma pausa curta quando as teclas param. Desactive Auto capture para reter a captação até premir Stop. Enter e Tab não fazem parte da cadeia do código de barras.
- Compare esse resultado com a configuração pretendida. Abra depois o testador de eventos de teclado e leia de novo quando precisar de cada
keydownpor ordem, incluindokey,codee a temporização.
O testador de introdução regista os eventos de teclado que o navegador consegue ver. Não consegue ler uma porta série, por isso não mostra CR ou LF como bytes em bruto. Um teste em cunha não prova o que uma definição série irá enviar.
Resolução de problemas
O leitor não envia ENTER. O código de barras aparece e o cursor fica no campo. O testador de introdução indica None. O sufixo está desligado ou está definido para algo diferente de Enter. Consulte Leitor de códigos de barras sem ENTER.
TAB desloca o foco de forma inesperada. O leitor está a enviar a tecla Tab. Esse é o sufixo configurado. Utilize Enter quando o formulário deve ser submetido, ou leia o valor no keydown de Tab quando o fluxo deve avançar. Os pormenores estão no guia Sufixos ENTER e TAB nos leitores de códigos de barras.
O formulário é submetido duas vezes. O navegador submete com Enter, e um ouvinte keydown também aceita a leitura. Mantenha um único caminho de conclusão e chame preventDefault() no outro.
Um prefixo aparece dentro do código de barras. Um prefixo imprimível faz parte da cadeia captada. Desactive-o no leitor ou retire essa sequência exacta na aplicação. Um identificador de simbologia activado é uma origem frequente de um ] inicial e de mais dois caracteres. Um prefixo de controlo que a cunha não consegue escrever faltará em vez de ser visível.
Os caracteres estão errados. A disposição do leitor e a do sistema operativo podem divergir, o que altera caracteres do prefixo e a pontuação enquanto o comprimento se mantém. Consulte Disposição de teclado errada no leitor de códigos de barras.
A aplicação nunca vê o fim da leitura. Não há sufixo, e a página espera Enter. Acrescente um sufixo que corresponda ao formulário, ou conclua o valor numa acção explícita. Uma estimativa de tempo falhará algumas leituras reais e aceitará alguma escrita.
CR/LF difere entre aplicações. O Notepad insere uma linha nova quando recebe Enter. Um campo de texto web conserva o código de barras e dispara um evento de tecla. Um programa série pode receber 0x0D, 0x0A ou ambos. Compare a interface antes de alterar o leitor. Se nenhuma aplicação receber caracteres, comece por O leitor de códigos de barras não funciona.
Uma passagem mais ampla pelo foco, por leituras repetidas e por fluxos de POS está em Como testar a introdução do leitor de códigos de barras.
Matriz de teste
A coluna de configuração é o que define no leitor, ou o que escreve com o emulador quando o caso é um sufixo de teclado. O comportamento esperado é o que a aplicação deve fazer. Um caso CRLF série não é o mesmo teste que uma tecla Enter num navegador.
| Configuração | Comportamento esperado da aplicação |
|---|---|
| Sem prefixo, sem sufixo | O valor do código de barras é recebido e não chega nenhuma tecla de conclusão. O valor permanece disponível até a aplicação o ler. |
| Sem prefixo, sufixo ENTER | A aplicação recebe a tecla de conclusão uma vez e guarda a carga sem um carácter terminador. |
| Sem prefixo, sufixo TAB | O foco pode passar para o controlo seguinte. A aplicação lê o valor antes desse movimento. |
| Prefixo imprimível personalizado | Os caracteres do prefixo aparecem antes dos dados descodificados. A aplicação mantém ou retira esse prefixo exacto de propósito. |
| Sufixo imprimível personalizado | Os caracteres do sufixo aparecem depois dos dados descodificados. Enter e Tab são teclas, por isso não aparecem na cadeia. |
| Sequência CRLF | Um anfitrião série ou de terminal processa os bytes CR e LF configurados. Um campo de texto do navegador não ganha esses bytes a partir de uma premida de Enter. |
Execute as linhas de teclado no leitor em cunha e, na ausência de equipamento, com as definições ENTER, TAB e sem sufixo do emulador. Execute a linha CRLF na interface que deve transportar esses bytes. Os resultados reais continuam a depender dessa interface e da aplicação.