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.
- Підключіть його і зачекайте, доки він покаже, що має живлення.
- Відкрийте тестер введення штрихкодів.
- Клацніть Почати тест або клацніть область сканування. Вона стає синьою, коли готова. Сторінка сама фокус не забирає.
- Зчитайте штрихкод, корисне навантаження якого ви вже знаєте.
- Прочитайте захоплене значення і кількість символів. Друковані символи префікса або суфікса перебувають усередині цього рядка. Рядок Префікс призначений для іменованих клавіш, які надходять до першого символу, наприклад модифікатора. Він не витягує набраний префікс на кшталт
]C1з тексту штрихкоду. - Перевірте суфікс. Тестер повідомляє ENTER, TAB або Немає. Коли Автозахоплення увімкнено, результат з’являється після Enter, Tab або короткої паузи, щойно клавіші припинилися. Вимкніть Автозахоплення, щоб утримувати захоплення, доки ви не натиснете Зупинити. Enter і Tab не входять у рядок штрихкоду.
- Порівняйте цей результат із налаштуванням, яке ви задавали. Потім відкрийте тестер подій клавіатури і зчитайте код знову, коли потрібен кожен
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 проганяйте на тому інтерфейсі, який має нести ці байти. Фактичний результат усе одно залежить від цього інтерфейсу і від застосунку.