Barcode Scanner Emulator
Префикс и суфикс код скенера бар-кодова: потпуни водич
Префикс су подаци или управљачки низ који скенер бар-кодова пошаље пре декодираног бар-кода. Суфикс је оно што пошаље после те вредности. Исти модел може да се подеси на различите префиксе и суфиксе, а серијски скенер их не испоручује на исти начин као скенер у режиму тастатурног клина.
Префикс скенера бар-кодова шаље се пре декодиране вредности. Суфикс се шаље после ње. Један скенер може да произведе овај низ:
Префикс: STX
Бар-код: 123456789
Суфикс: ENTER
STX у упутству обично значи контролни знак, а не три слова S, T и X. ENTER на скенеру у режиму тастатурног клина обично је тастер Enter, а не два знака CR и LF уметнута у текстуално поље. Шта од тога стигне зависи од модела, интерфејса и апликације. Ниједно подешавање није универзално.
Водич Суфикси ENTER и TAB код скенера бар-кодова остаје на избору и провери та два завршна тастера. Овај водич је о оквиру око бар-кода: шта долази пре, шта долази после и како веб-апликација треба да чита оба дела.
Шта је префикс скенера бар-кодова
Префикс је подешени низ који скенер пренесе пре садржаја. Садржај је текст који је симбологија декодовала, на пример 123456789. Префикс није део тог декодирања осим ако скенер није подешен да га дода.
Уобичајене намене:
- Означити почетак поруке. Серијски и терминалски протоколи понекад пошаљу контролни знак, често зван STX, да би домаћин знао да је почео нови оквир.
- Именовати симбологију. Кад је укључен идентификатор симбологије AIM, скенер може да пошаље кратак исписив префикс, на пример
]C1за Code 128 или]E0за EAN, пре цифара. Апликација може да се грана према том идентификатору. - Усмерити унос у старијем POS или терминалском софтверу. Фиксни код пре података говорио је домаћину ком пољу или уређају скенирање припада.
- Означити одређено место. Два скенера могу да добију различите исписиве префиксе да би дневник показао која је трака послала код.
Исписив префикс су обични знакови. Појављују се у текстуалном пољу на почетку низа. Префикс од контролног знака, као што је 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 покрените на интерфејсу који треба да носи те бајтове. Стварни резултат и даље зависи од тог интерфејса и од апликације.