Hoppa till innehållet

Barcode Scanner Emulator

Prefix och suffix i streckkodsläsare: komplett guide

Ett prefix är data eller en styrsekvens som en streckkodsläsare skickar före den avkodade streckkoden. Ett suffix är det läsaren skickar efter det värdet. Samma modell kan ställas in med olika prefix och suffix, och en seriell läsare levererar dem på ett annat sätt än en läsare med keyboard wedge.

Prefixet från en streckkodsläsare går ut före det avkodade värdet. Suffixet går ut efteråt. En och samma läsare kan ge den här följden:

Prefix: STX

Streckkod: 123456789

Suffix: ENTER

STX i en handbok syftar oftast på styrtecknet, inte bokstäverna S, T och X. ENTER på en läsare med keyboard wedge är vanligen tangenten Enter, inte tecknen CR och LF inklistrade i ett textfält. Vilket av dem du får beror på modell, gränssnitt och program. Ingen inställning gäller överallt.

Guiden Suffixen ENTER och TAB håller sig till att välja och felsöka de två avslutningarna. Den här guiden handlar om ramen runt streckkoden: vad som kommer före, vad som kommer efter och hur ett webbprogram ska läsa båda.

Vad är ett prefix i en streckkodsläsare?

Ett prefix är en inställd sekvens som läsaren sänder före nyttolasten. Nyttolasten är texten som symbologin avkodade, till exempel 123456789. Prefixet ingår inte i den avkodningen om inte läsaren har ställts in att lägga till det.

Vanliga användningar:

  • Markera början av ett meddelande. Seriella protokoll och terminalprotokoll skickar ibland ett styrtecken, ofta kallat STX, så att värden vet att en ny ram har börjat.
  • Namnge symbologin. Med AIM-symbologiidentifieraren påslagen kan en läsare skicka ett kort utskrivbart prefix som ]C1 för Code 128 eller ]E0 för EAN före siffrorna. Programmet kan grena på den identifieraren.
  • Styra inmatning i äldre POS- eller terminalprogram. En fast kod före datat talade om för värden vilket fält eller vilken enhet avläsningen hörde till.
  • Märka en viss station. Två läsare kan få olika utskrivbara prefix så att en logg kan visa vilket spår som skickade koden.

Ett utskrivbart prefix är vanliga tecken. De syns i ett textfält längst fram i strängen. Ett styrteckensprefix, till exempel STX (0x02), är inte bokstäverna S, T och X. En läsare med keyboard wedge kan vara oförmögen att skriva det styrtecknet över huvud taget. En seriell läsare kan skicka det som en byte. Läs handboken för den modell du har innan du skriver kod som förväntar sig det ena eller det andra.

Ett prefix bevisar inte att en läsare skapade inmatningen. En person, ett makro eller Barcode Scanner Emulator kan skriva samma tecken. Behandla prefixet som en ram du har ställt in, och validera sedan nyttolasten på samma sätt som du validerar annan användarinmatning.

Vad är ett suffix i en streckkodsläsare?

Ett suffix är en inställd sekvens som skickas efter nyttolasten. Den vanliga uppgiften är att tala om för programmet att avläsningen är klar, eller att flytta fokus. Läsare skiljer sig åt. Vissa erbjuder Enter, Tab, CR, LF, CR+LF, en egen sträng eller ingenting. Vissa erbjuder bara en eller två av dem.

ENTER. Tangenten Enter. I en webbläsare är det en tangentbordshändelse, event.key === "Enter". Den sätts inte in i ett vanligt textfält.

TAB. Tangenten Tab, event.key === "Tab". Webbläsaren flyttar fokus till nästa kontroll. Tangenten sätts inte in i fältet.

CR. Vagnretur, ASCII 0x0D. På ett seriellt eller terminalgränssnitt kan det vara en verklig byte efter nyttolasten. På en keyboard wedge betyder en inställning märkt CR eller vagnretur vanligen tangenten Enter. Webbläsaren rapporterar fortfarande Enter. Fältvärdet får inget CR-tecken.

LF. Radmatning, ASCII 0x0A. Det är ett annat styrtecken än CR. I en seriell ström kan det vara en egen byte. En keyboard wedge har ingen standardtangent för Line Feed på det sätt den har Enter och Tab. Utgå inte från att ett menyval som heter LF skriver ett synligt tecken eller ett andra Enter.

CRLF. CR följt av LF, de två byten 0x0D 0x0A. Vissa seriella värdar och terminalvärdar förväntar sig det paret som radslut. Ett textfält i webbläsaren lagrar inte det paret när någon trycker på Enter.

Egna tecken. Ett utskrivbart suffix som # eller en kort kod skrivs efter streckkoden, så det blir en del av strängen om inte programmet tar bort det. Ett eget styrtecken följer samma delning som STX: byte på en serieport, tangenttryckningar på en wedge, och bara de tangenttryckningar som tangentbordsgränssnittet faktiskt kan skicka.

ENTER, CR och LF är besläktade namn för radslut i handböcker. De är inte utbytbara i varje program. En wedgeläsare, en seriell läsare, Notepad och ett webbformulär kan var och en visa ett annat resultat för en inställning med samma namn.

Prefix jämfört med suffix

Egenskap Prefix Suffix
Position Före streckkodsdatat Efter streckkodsdatat
Syfte Markera början eller etikettera inmatningen Markera att det är klart eller utlösa en åtgärd
Exempel STX, eller en utskrivbar AIM-identifierare som ]C1 ENTER, TAB eller ett utskrivbart tecken som #
Vanlig användning Rama in eller identifiera avläsningen Skicka ett formulär eller flytta fokus
I ett textfält Utskrivbara tecken ligger i början av värdet Utskrivbara tecken ligger i slutet. Enter och Tab gör det inte
Identitet En inställd markör som vem som helst kan skriva En inställd markör som vem som helst kan skriva

Ta bort ett prefix eller ett eget suffix bara när du har ställt in exakt den sekvensen och den lagrade posten inte ska innehålla den. Lämna en AIM-identifierare kvar tills programmet har en regel för den.

ENTER, TAB, CR och LF

De här namnen står på konfigurationsblad. Mottagarsidan ser antingen tangenttryckningar eller byte, beroende på gränssnittet. Guiden HID keyboard wedge beskriver tangenttryckningsvägen. En serieport är en annan väg: programmet läser byte, och fokus väljer inte vart de tar vägen.

ENTER

På en läsare med keyboard wedge är ENTER tangenten Enter. I ett textfält på en rad använder aktuella webbläsare den tangenten för att skicka det omgivande formuläret. En sökruta kan bekräfta avläsningen på den händelsen. Ett formulär med flera fält kan skickas innan senare fält är ifyllda. Anropa preventDefault() på händelsen submit, eller på Enter-keydown, när sidan ska behålla värdet och stanna kvar. Hantera Enter på ett ställe. En keydown-lyssnare och en submit-lyssnare som båda tar emot avläsningen registrerar den två gånger.

Vissa läsare skickar NumPad Enter. event.key är fortfarande "Enter". event.code kan vara "NumpadEnter" i stället för "Enter". Testa event.key om båda tangenterna ska bekräfta fältet.

Guiden Suffixen ENTER och TAB jämför de två valen för POS och webbformulär. Streckkodsläsaren saknar ENTER tar upp en läsare som skriver streckkoden och sedan stannar.

TAB

TAB är tangenten Tab. Webbläsaren flyttar fokus efter keydown. Läs fältet i den keydown-hanteraren, medan det fortfarande har fokus, och lämna standardåtgärden kvar när nästa kontroll ska få markören. preventDefault() håller fokus på det aktuella fältet.

Shift+Tab är samma tangent med Shift nedtryckt. Ett Tab-suffix från läsaren är Tab utan Shift. Ignorera event.shiftKey om tangentbordsanvändare ska kunna gå bakåt genom formuläret.

CR

Vagnretur flyttar en markör till radens början i en terminal. Byten är 0x0D. En seriell läsare kan lägga till den byten efter nyttolasten. En inställning för keyboard wedge som heter CR skickar typiskt tangenten Enter i stället för att infoga 0x0D i texten. Att trycka på Enter i ett webbläsarfält skriver inte ett CR-tecken i input.value.

Om värden är en terminal eller en lyssnare på en COM-port, leta efter byten. Om värden är en webbsida, leta efter event.key === "Enter".

LF

Radmatning flyttar en terminalmarkör en rad nedåt. Byten är 0x0A. Vissa värdar behandlar enbart LF som nyrad. Andra ignorerar det om inte CR kom först. En wedgeläsare som listar LF som suffix kan skicka en tangent som operativsystemet inte gör till ett radbryt, eller så skickar den ingenting som ett textfält behåller. Fånga tangenten i tangentbordshändelsetestaren innan du hanterar ett förmodat LF i programkod.

CRLF

CRLF är tvåstyrsekvensen CR och sedan LF. Textfiler i Windows-stil och många seriella enheter använder den som en nyrad. En konfigurationssida som säger CRLF-suffix betyder att läsaren kommer att försöka skicka det paret efter nyttolasten på det gränssnitt den använder.

I en webbläsare ger ett tryck på Enter inte en bokstavlig CRLF-sekvens inuti ett textfält. Formuläret tar emot en tangentbordshändelse. En <textarea> kan infoga en nyrad när användaren trycker på Enter, och den nyraden är webbläsarens egen redigeringsbeteende, inte ett bevis på att läsaren sände byten 0x0D 0x0A. En seriell läsare kan ta emot de två byten och ska behandla dem som avslutning bara om just den läsaren var inställd att skicka dem. Ta inte bort CR eller LF ur mitten av en nyttolast som får innehålla dem.

Hur prefix och suffix påverkar webbprogram

En avläsning med keyboard wedge är en skur av tangenttryckningar in i kontrollen som har fokus. Sidan öppnar inte läsaren. Om fokus ligger på ett annat fält hamnar prefixet, streckkoden och suffixet där.

keydown utlöses för varje tangent, inklusive Enter och Tab, innan webbläsaren infogar ett tecken eller flyttar fokus. event.key är tecknet eller tangentnamnet efter att operativsystemet har tillämpat tangentbordslayouten. Utskrivbara prefix- och suffixtecken syns i fältet via händelsen input. Enter och Tab gör det inte.

Lyssnaren nedan bekräftar fältet när Enter kommer. Den lägger inte till ett suffix som läsaren utelämnade. Om läsaren inte skickar Enter ligger värdet kvar i fältet tills något annat läser det.

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

Fokusera #barcode före avläsningen. preventDefault() hindrar ett överordnat formulär från att skickas en andra gång. Om inmatningen inte ligger i ett formulär och du vill ha den inbyggda sändningen, utelämna preventDefault().

Utan suffix väntar du på en uttrycklig åtgärd: en knapp, ett senare Enter från operatören eller nästa steg i flödet. En inaktivitetstimer kan behandla en paus som slutet på avläsningen. Den timern är en gissning. En långsam läsare, en Bluetooth-fördröjning eller en snabb skrivare kan hamna på fel sida av den. Föredra ett inställt suffix när flödet behöver ett bestämt slut.

Ett känt utskrivbart prefix kan tas bort efter att du har läst värdet:

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

Skicka bara det prefix du har ställt in, till exempel ']C1'. Ta inte bort ett godtyckligt antal tecken från varje avläsning.

För ett helt formulär som också hanterar Tab, tom inmatning och en andra avläsning, se Så testar du streckkodsläsare i webbprogram.

Så konfigurerar du prefix och suffix

Inställningarna för prefix och suffix finns på läsaren. Tangentnamnen och sättet du ändrar dem på är tillverkarspecifika. Det finns ingen konfigurationsstreckkod som fungerar på varje märke, och den här guiden skriver inte ut någon.

Vanliga metoder:

  • Läs av en konfigurationsstreckkod ur handboken för just den modellen. Bladet är grupperat efter inställning: suffix, prefix, tangentbordslayout, symbologi.
  • Använd leverantörens konfigurationsprogram och skriv sedan resultatet till läsaren över USB.
  • Använd enhetshanteringsverktyget för den produktlinjen när du uppdaterar många enheter.

Efter en ändring läser du av en känd streckkod och jämför resultatet med handbokens beskrivning av inställningen du valde. En fabriksåterställning från ett annat märke kan lämna läsaren oförändrad eller sätta den i ett oväntat läge. Guiden Guide för konfiguration av streckkodsläsare sammanfattar inställningarna som vanligen spelar roll. Den ersätter inte handboken.

Barcode Scanner Emulator kan skriva ett värde du väljer och sedan skicka ENTER, TAB eller inget suffix. Lägg ett utskrivbart prefix i det värdet när du behöver öva prefixhantering utan hårdvara. Emulatorn sänder inte ett seriellt bytepar för CR/LF, och den läser inte en etikett.

Så testar du prefix- och suffixbeteende

Använd en läsare som är i tangentbordsläge, USB HID keyboard eller Bluetooth HID keyboard.

  1. Anslut den och vänta tills den visar att den har ström.
  2. Öppna streckkodsinmatningstestaren.
  3. Klicka på Start Test, eller klicka i avläsningsytan. Den blir blå när den är redo. Sidan tar inte fokus av sig själv.
  4. Läs av en streckkod vars nyttolast du redan känner till.
  5. Läs det infångade värdet och antalet tecken. Utskrivbara prefix- eller suffixtecken ligger inuti den strängen. Raden Prefix är till för namngivna tangenter som kommer före det första tecknet, till exempel en modifierare. Den plockar inte ut ett skrivet prefix som ]C1 ur streckkodstexten.
  6. Kontrollera suffixet. Testaren rapporterar ENTER, TAB eller None. Med Auto capture på syns resultatet efter Enter, Tab eller en kort paus när tangenterna slutar. Stäng av Auto capture för att hålla infångningen tills du trycker på Stop. Enter och Tab ingår inte i streckkodssträngen.
  7. Jämför det resultatet med konfigurationen du avsåg. Öppna sedan tangentbordshändelsetestaren och läs av igen när du behöver varje keydown i ordning, inklusive key, code och timing.

Inmatningstestaren registrerar tangentbordshändelser som webbläsaren kan se. Den kan inte läsa en serieport, så den kan inte visa CR eller LF som råa byte. Ett wedgetest bevisar inte vad en seriell inställning kommer att skicka.

Felsökning

Läsaren skickar inte ENTER. Streckkoden syns och markören stannar i fältet. Inmatningstestaren rapporterar None. Suffixet är avstängt, eller inställt på något annat än Enter. Se Streckkodsläsaren saknar ENTER.

TAB flyttar fokus oväntat. Läsaren skickar tangenten Tab. Det är det inställda suffixet. Använd Enter när formuläret ska skickas, eller läs värdet på Tab-keydown när flödet ska gå vidare. Detaljerna finns i guiden Suffixen ENTER och TAB.

Formuläret skickas två gånger. Webbläsaren skickar på Enter, och en keydown-lyssnare tar också emot avläsningen. Behåll en avslutningsväg och anropa preventDefault() på den andra.

Ett prefix syns inuti streckkoden. Ett utskrivbart prefix är en del av den infångade strängen. Antingen stäng av det på läsaren eller ta bort just den sekvensen i programmet. En påslagen symbologiidentifierare är en vanlig källa till ett inledande ] och två tecken till. Ett styrprefix som wedgen inte kan skriva saknas i stället för att synas.

Tecknen är fel. Läsarens layout och operativsystemets layout kan vara oense, vilket ändrar prefixtecken och skiljetecken medan längden förblir densamma. Se Fel tangentbordslayout på streckkodsläsaren.

Programmet ser aldrig slutet på avläsningen. Det finns inget suffix, och sidan väntar på Enter. Lägg till ett suffix som passar formuläret, eller slutför värdet med en uttrycklig åtgärd. En tidsgissning missar vissa riktiga avläsningar och godtar viss skrivning.

CR/LF skiljer sig mellan program. Notepad infogar en ny rad när den tar emot Enter. Ett webbtextfält behåller streckkoden och utlöser en tangenthändelse. Ett seriellt program kan ta emot 0x0D, 0x0A eller båda. Jämför gränssnittet innan du ändrar läsaren. Om inget program tar emot tecken, börja med Streckkodsläsaren fungerar inte.

En bredare genomgång av fokus, upprepade avläsningar och POS-flöden finns i Så testar du inmatning från streckkodsläsare.

Testmatris

Konfigurationskolumnen är det du ställer in på läsaren, eller det du skriver med emulatorn när fallet är ett tangentbordssuffix. Det förväntade beteendet är det programmet ska göra. Ett seriellt CRLF-fall är inte samma test som tangenten Enter i en webbläsare.

Konfiguration Förväntat programbeteende
Inget prefix, inget suffix Streckkodsvärdet tas emot och ingen avslutningstangent kommer. Värdet ligger kvar tills programmet läser det.
Inget prefix, ENTER-suffix Programmet tar emot avslutningstangenten en gång och lagrar nyttolasten utan ett avslutningstecken.
Inget prefix, TAB-suffix Fokus kan flyttas till nästa kontroll. Programmet läser värdet före den flytten.
Eget utskrivbart prefix Prefixtecknen syns före det avkodade datat. Programmet behåller eller tar bort just det prefixet med avsikt.
Eget utskrivbart suffix Suffixtecknen syns efter det avkodade datat. Enter och Tab är tangenter, så de syns inte i strängen.
CRLF-sekvens En seriell värd eller en terminalvärd bearbetar de inställda CR- och LF-byten. Ett textfält i webbläsaren får inte de byten från ett tryck på Enter.

Kör tangentbordsraderna på wedgeläsaren och, när hårdvara saknas, med emulatorns inställningar för ENTER, TAB och inget suffix. Kör CRLF-raden på det gränssnitt som ska bära de byten. De faktiska resultaten beror fortfarande på det gränssnittet och på programmet.