Saltar para o conteúdo

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 ]C1 para Code 128 ou ]E0 para 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.

  1. Ligue-o e aguarde até indicar que tem alimentação.
  2. Abra o testador de introdução de códigos de barras.
  3. Clique em Start Test ou na área de leitura. Fica azul quando está pronto. A página não toma o foco por si.
  4. Leia um código de barras cuja carga já conhece.
  5. 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 ]C1 do texto do código de barras.
  6. 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.
  7. Compare esse resultado com a configuração pretendida. Abra depois o testador de eventos de teclado e leia de novo quando precisar de cada keydown por ordem, incluindo key, code e 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.