Към съдържанието

Barcode Scanner Emulator

Префикс и наставка при баркод скенери: пълно ръководство

Префиксът е данни или управляваща последователност, която баркод скенерът изпраща преди декодирания баркод. Наставката е това, което изпраща след тази стойност. Един и същ модел може да се настрои с различни префикси и наставки, а серийният скенер не ги доставя по същия начин като скенер в режим на клавиатурен клин.

Префиксът на баркод скенера се изпраща преди декодираната стойност. Наставката се изпраща след нея. Един скенер може да произведе тази последователност:

Префикс: STX

Баркод: 123456789

Наставка: ENTER

STX в ръководството обикновено означава управляващ знак, а не трите букви S, T и X. ENTER при скенер в режим на клавиатурен клин обикновено е клавишът Enter, а не двата знака CR и LF, вмъкнати в текстово поле. Кое от тях получавате, зависи от модела, интерфейса и приложението. Никоя настройка не е универсална.

Ръководството Наставки ENTER и TAB при баркод скенери остава върху избора и проверката на тези два завършващи клавиша. Това ръководство е за рамката около баркода: какво идва преди него, какво идва след него и как уеб приложението трябва да чете и двете.

Какво е префикс на баркод скенер

Префиксът е конфигурирана последователност, която скенерът предава преди полезния товар. Полезният товар е текстът, който символиката е декодирала, например 123456789. Префиксът не е част от това декодиране, освен ако скенерът не е настроен да го добавя.

Обичайни употреби:

  • Отбелязване на началото на съобщение. Серийните и терминалните протоколи понякога изпращат управляващ знак, често наричан STX, за да разбере хостът, че е започнал нов кадър.
  • Наименуване на символиката. При включен идентификатор на символиката AIM скенерът може да изпрати кратък печатаем префикс, например ]C1 за Code 128 или ]E0 за EAN, преди цифрите. Приложението може да се разклони по този идентификатор.
  • Насочване на въвеждането в по-стар софтуер за каса или терминал. Фиксиран код преди данните казваше на хоста към кое поле или устройство принадлежи сканирането.
  • Маркиране на конкретен пост. На два скенера могат да се дадат различни печатаеми префикси, за да покаже дневникът коя линия е изпратила кода.

Печатаемият префикс са обикновени знаци. Те се появяват в текстовото поле в началото на низа. Префикс от управляващ знак, например STX (0x02), не са буквите S, T и X. Скенер в режим на клавиатурен клин може изобщо да не може да въведе този управляващ знак. Сериен скенер може да го изпрати като байт. Прочетете ръководството за вашия модел, преди да пишете код, който очаква едното или другото.

Префиксът не доказва, че въвеждането е дошло от скенер. Човек, макрос или Barcode Scanner Emulator могат да въведат същите знаци. Приемайте префикса като рамка, която сте конфигурирали, и проверявайте полезния товар така, както проверявате всеки друг потребителски вход.

Какво е наставка на баркод скенер

Наставката е конфигурирана последователност, изпратена след полезния товар. Обичайната ѝ работа е да каже на приложението, че сканирането е приключило, или да премести фокуса. Скенерите се различават. Някои предлагат Enter, Tab, CR, LF, CR+LF, собствен низ или нищо. Други предлагат само една или две от тези възможности.

ENTER. Клавишът Enter. В браузъра това е клавиатурно събитие, event.key === "Enter". Не се вмъква в обикновено текстово поле.

TAB. Клавишът Tab, event.key === "Tab". Браузърът премества фокуса към следващия елемент. Клавишът не се вмъква в полето.

CR. Връщане на каретката, ASCII 0x0D. На сериен или терминален интерфейс това може да е истински байт след полезния товар. При клавиатурен клин настройка с етикет CR или връщане на каретката обикновено означава клавиша Enter. Браузърът пак съобщава Enter. Стойността на полето не получава знак CR.

LF. Подаване на ред, ASCII 0x0A. Това е различен управляващ знак от CR. В сериен поток може да е собствен байт. Клавиатурният клин няма стандартен клавиш за подаване на ред по начина, по който има Enter и Tab. Не приемайте, че елемент от менюто с име LF въвежда видим знак или втори Enter.

CRLF. CR, последван от LF: двата байта 0x0D 0x0A. Някои серийни и терминални хостове очакват тази двойка като край на реда. Текстовото поле на браузъра не съхранява тази двойка, когато някой натисне Enter.

Собствени знаци. Печатаема наставка, например # или кратък код, се въвежда след баркода, така че става част от низа, освен ако приложението не я премахне. Собствен управляващ знак следва същото разделяне като STX: байтове на сериен порт, натискания на клин и само натисканията, които клавиатурният интерфейс реално може да изпрати.

ENTER, CR и LF са сродни имена за „край на реда“ в ръководствата. Те не са взаимозаменяеми във всяко приложение. Клинов скенер, сериен скенер, Notepad и уеб формуляр могат да покажат различен резултат за настройка с едно и също име.

Префикс и наставка

Характеристика Префикс Наставка
Позиция Преди данните на баркода След данните на баркода
Предназначение Отбелязва началото или етикетира въвеждането Отбелязва завършването или задейства действие
Пример STX или печатаем идентификатор AIM, например ]C1 ENTER, TAB или печатаем знак, например #
Обичайна употреба Рамкира или разпознава сканирането Изпраща формуляр или премества фокуса
В текстово поле Печатаемите знаци стоят в началото на стойността Печатаемите знаци стоят в края. Enter и Tab не
Същност Конфигуриран маркер, който всеки може да въведе Конфигуриран маркер, който всеки може да въведе

Премахвайте префикс или собствена наставка само когато сте конфигурирали точно тази последователност и записаният запис не трябва да я съдържа. Оставете идентификатора AIM, докато приложението няма правило за него.

ENTER, TAB, CR и LF

Тези имена се появяват върху листовете за конфигурация. Приемащата страна вижда или натискания, или байтове, според интерфейса. Ръководството Клавиатурен клин HID описва пътя на натисканията. Серийният порт е друг път: приложението чете байтове и фокусът не избира къде отиват.

ENTER

При скенер в режим на клавиатурен клин ENTER е клавишът Enter. В едноредово текстово поле текущите браузъри използват този клавиш, за да изпратят ограждащия формуляр. Поле за търсене може да потвърди сканирането при това събитие. Формуляр с няколко полета може да се изпрати, преди да са попълнени следващите полета. Извикайте preventDefault() върху събитието submit или върху keydown на Enter, когато страницата трябва да запази стойността и да остане на място. Обработвайте Enter на едно място. Слушател на keydown и слушател на submit, които и двамата приемат сканирането, ще го запишат два пъти.

Някои скенери изпращат NumPad Enter. event.key пак е "Enter". event.code може да е "NumpadEnter", а не "Enter". Проверявайте event.key, ако и двата клавиша трябва да потвърждават полето.

Ръководството Наставки ENTER и TAB при баркод скенери сравнява тези два избора за POS и уеб формуляри. На баркод скенера липсва ENTER разглежда скенер, който въвежда баркода и после спира.

TAB

TAB е клавишът Tab. Браузърът премества фокуса след keydown. Прочетете полето в този обработчик на keydown, докато още има фокус, и оставете действието по подразбиране, когато курсорът трябва да отиде при следващия елемент. preventDefault() задържа фокуса върху текущото поле.

Shift+Tab е същият клавиш с натиснат Shift. Наставката Tab на скенера е Tab без Shift. Игнорирайте event.shiftKey, ако потребителите с клавиатура трябва да могат да се връщат назад през формуляра.

CR

Връщането на каретката премества курсора в началото на реда в терминал. Байтът е 0x0D. Сериен скенер може да добави този байт към полезния товар. Настройка на клавиатурен клин с име CR обикновено изпраща клавиша Enter, а не вмъква 0x0D в текста. Натискането на Enter в поле на браузъра не записва знак CR в input.value.

Ако хостът е терминал или програма, която слуша COM порт, търсете байта. Ако хостът е уеб страница, търсете event.key === "Enter".

LF

Подаването на ред премества курсора на терминала с един ред надолу. Байтът е 0x0A. Някои хостове приемат само LF като нов ред. Други го игнорират, освен ако преди него не е дошъл CR. Клинов скенер, който посочва LF като наставка, може да изпрати клавиш, който операционната система не превръща в нов ред, или да не изпрати нищо, което текстовото поле ще запази. Захванете клавиша в тестера за клавишни събития, преди да обработвате предполагаем LF в кода на приложението.

CRLF

CRLF е последователност от два управляващи знака: първо CR, после LF. Текстовите файлове в стил Windows и много серийни устройства я използват като един нов ред. Страница за конфигурация, която казва „наставка CRLF“, означава, че скенерът ще се опита да изпрати тази двойка след полезния товар по интерфейса, който използва.

В браузъра натискането на Enter не създава буквална последователност CRLF вътре в текстово поле. Формулярът получава клавиатурно събитие. <textarea> може да вмъкне нов ред, когато потребителят натисне Enter, и този нов ред е собственото поведение за редактиране на браузъра, а не доказателство, че скенерът е излъчил байтовете 0x0D 0x0A. Сериен четец може да получи тези два байта и трябва да ги приема като завършек само ако този скенер е бил конфигуриран да ги изпраща. Не премахвайте CR или LF от средата на полезен товар, на който е позволено да ги съдържа.

Как префиксите и наставките влияят на уеб приложения

Сканирането с клавиатурен клин е поредица от натискания в елемента, който има фокус. Страницата не отваря скенера. Ако фокусът е върху друго поле, префиксът, баркодът и наставката отиват там.

keydown се задейства за всеки клавиш, включително Enter и Tab, преди браузърът да вмъкне знак или да премести фокуса. event.key е знакът или името на клавиша, след като операционната система е приложила подредбата на клавиатурата. Печатаемите знаци на префикса и наставката се появяват в полето чрез събитието input. Enter и Tab не.

Слушателят по-долу потвърждава полето, когато пристигне Enter. Той не добавя наставка, която скенерът е пропуснал. Ако скенерът не изпраща Enter, стойността остава в полето, докато нещо друго я прочете.

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

Дайте фокус на #barcode преди сканирането. preventDefault() спира родителски формуляр да се изпрати втори път. Ако полето не е във формуляр и искате естественото изпращане, пропуснете preventDefault().

Без наставка изчакайте изрично действие: бутон, по-късен Enter от оператора или следващата стъпка в процеса. Таймер при бездействие може да приеме паузата за край на сканирането. Този таймер е евристика. Бавен скенер, забавяне по Bluetooth или бързо писане могат да попаднат от грешната страна на прага. Когато процесът се нуждае от сигурен край, предпочитайте конфигурирана наставка.

Познат печатаем префикс може да се премахне, след като прочетете стойността:

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

Подавайте само префикса, който сте конфигурирали, например ']C1'. Не отрязвайте произволен брой знаци от всяко сканиране.

Пълен формуляр, който обработва и Tab, празно въвеждане и второ сканиране, е в Как да тествате баркод скенери в уеб приложения.

Как да конфигурирате префикси и наставки

Настройките за префикс и наставка са на скенера. Имената на пунктовете и начинът, по който ги променяте, са специфични за производителя. Няма конфигурационен баркод, който работи при всяка марка, и това ръководство не отпечатва такъв.

Типични начини:

  • Сканирайте конфигурационен баркод от ръководството за точния модел. Листът е групиран по настройка: наставка, префикс, подредба на клавиатурата, символика.
  • Използвайте програмата за конфигурация на производителя, после запишете резултата в скенера през USB.
  • Използвайте помощната програма за управление на устройствата от тази линия, когато обновявате много бройки.

След промяна сканирайте известен баркод и сравнете резултата с описанието на избраната настройка в ръководството. Фабрично нулиране от друга марка може да остави скенера непроменен или да го постави в неочакван режим. Ръководството за конфигурация на баркод скенер обобщава настройките, които обикновено имат значение. То не замества ръководството на устройството.

Barcode Scanner Emulator може да въведе избрана от вас стойност и после да изпрати ENTER, TAB или никаква наставка. Поставете печатаем префикс в тази стойност, когато трябва да упражните обработката на префикс без хардуер. Емулаторът не излъчва серийна двойка байтове CR/LF и не чете етикет.

Как да тествате поведението на префикса и наставката

Използвайте скенер в режим на клавиатура: USB HID клавиатура или Bluetooth HID клавиатура.

  1. Свържете го и изчакайте, докато покаже, че има захранване.
  2. Отворете тестера за въвеждане на баркод.
  3. Щракнете върху Старт на теста или щракнете в областта за сканиране. Тя става синя, когато е готова. Страницата не взима фокуса сама.
  4. Сканирайте баркод, чийто полезен товар вече знаете.
  5. Прочетете уловената стойност и броя на знаците. Печатаемите знаци на префикса или наставката са вътре в този низ. Редът Представка е за именувани клавиши, които пристигат преди първия знак, например модификатор. Той не изважда въведен префикс като ]C1 от текста на баркода.
  6. Проверете наставката. Тестерът съобщава ENTER, TAB или Няма. При включено Автоматично прихващане резултатът се появява след Enter, Tab или кратка пауза, щом клавишите спрат. Изключете Автоматично прихващане, за да задържите прихващането, докато не натиснете Стоп. Enter и Tab не са част от низа на баркода.
  7. Сравнете този резултат с конфигурацията, която сте възнамерявали. После отворете тестера за клавишни събития и сканирайте отново, когато ви трябва всяко keydown по ред, включително key, code и времето.

Тестерът за въвеждане записва клавиатурните събития, които браузърът вижда. Той не може да чете сериен порт, затова не може да покаже CR или LF като сурови байтове. Тест с клин не доказва какво ще изпрати серийна настройка.

Отстраняване на проблеми

Скенерът не изпраща ENTER. Баркодът се появява, а курсорът остава в полето. Тестерът за въвеждане съобщава Няма. Наставката е изключена или е зададена на нещо различно от Enter. Вижте На баркод скенера липсва ENTER.

TAB премества фокуса неочаквано. Скенерът изпраща клавиша Tab. Това е конфигурираната наставка. Използвайте Enter, когато формулярът трябва да се изпрати, или прочетете стойността при keydown на Tab, когато процесът трябва да продължи. Подробностите са в ръководството Наставки ENTER и TAB при баркод скенери.

Формулярът се изпраща два пъти. Браузърът го изпраща при Enter, а слушател на keydown също приема сканирането. Оставете един път за завършване и извикайте preventDefault() върху другия.

Префикс се появява вътре в баркода. Печатаемият префикс е част от уловения низ. Или го изключете на скенера, или премахнете точно тази последователност в приложението. Включен идентификатор на символиката е чест източник на водещо ] и още два знака. Управляващ префикс, който клинът не може да въведе, ще липсва, а няма да е видим.

Знаците са грешни. Подредбата на скенера и подредбата на операционната система могат да се разминават, което променя знаците на префикса и пунктуацията, докато дължината остава същата. Вижте Грешна подредба на клавиатурата при баркод скенера.

Приложението никога не вижда края на сканирането. Няма наставка, а страницата чака Enter. Добавете наставка, която отговаря на формуляра, или завършете стойността с изрично действие. Догадка по време ще пропусне някои истински сканирания и ще приеме част от писането.

CR/LF се различава между приложенията. Notepad вмъква нов ред, когато получи Enter. Уеб текстово поле пази баркода и задейства клавишно събитие. Серийна програма може да получи 0x0D, 0x0A или и двете. Сравнете интерфейса, преди да променяте скенера. Ако никое приложение не получава знаци, започнете с Баркод скенерът не работи.

По-широк преглед на фокуса, повторните сканирания и процесите в POS е в Как да тествате въвеждането от баркод скенер.

Тестова матрица

Колоната за конфигурация е това, което задавате на скенера, или това, което въвеждате с емулатора, когато случаят е клавиатурна наставка. Очакваното поведение е това, което приложението трябва да направи. Случай със сериен CRLF не е същият тест като клавиш Enter в браузър.

Конфигурация Очаквано поведение на приложението
Без префикс, без наставка Стойността на баркода е получена и не пристига завършващ клавиш. Стойността остава налична, докато приложението я прочете.
Без префикс, наставка ENTER Приложението получава завършващия клавиш веднъж и записва полезния товар без завършващ знак.
Без префикс, наставка TAB Фокусът може да се премести към следващия елемент. Приложението чете стойността преди това преместване.
Собствен печатаем префикс Знаците на префикса се появяват преди декодираните данни. Приложението умишлено запазва или премахва точно този префикс.
Собствена печатаема наставка Знаците на наставката се появяват след декодираните данни. Enter и Tab са клавиши, затова не се появяват в низа.
Последователност CRLF Сериен или терминален хост обработва конфигурираните байтове CR и LF. Текстово поле на браузъра не получава тези байтове от натискане на Enter.

Клавиатурните редове пускайте на клиновия скенер и, когато няма хардуер, с настройките на емулатора ENTER, TAB и без наставка. Реда CRLF пускайте на интерфейса, който трябва да носи тези байтове. Реалният резултат пак зависи от този интерфейс и от приложението.