Lumaktaw sa nilalaman

Barcode Scanner Emulator

Unlapi laban sa hulapi sa mga barcode scanner: kumpletong gabay

Ang unlapi ay data o control sequence na ipinapadala ng barcode scanner bago ang na-decode na barcode. Ang hulapi ang ipinapadala nito pagkatapos ng halagang iyon. Maaaring itakda ang parehong modelo sa magkaibang unlapi at hulapi, at hindi ipinapadala ng serial scanner ang mga ito sa paraang ginagawa ng keyboard-wedge scanner.

Ipinapadala ang unlapi ng barcode scanner bago ang na-decode na halaga. Ipinapadala ang hulapi pagkatapos ng halagang iyon. Maaaring gumawa ang isang scanner ng ganitong pagkakasunod-sunod:

Unlapi: STX

Barcode: 123456789

Hulapi: ENTER

Ang STX sa manual ay karaniwang control character, hindi ang tatlong letra na S, T, at X. Ang ENTER sa keyboard-wedge scanner ay karaniwang Enter key, hindi ang dalawang character na CR at LF na isiningit sa text field. Alin ang matatanggap mo ay nakasalalay sa modelo, sa interface, at sa application. Walang setting na angkop sa lahat.

Ang gabay na Mga hulaping ENTER laban sa TAB sa mga barcode scanner ay nananatili sa pagpili at pag-troubleshoot ng dalawang terminator na iyon. Tungkol ang gabay na ito sa frame sa paligid ng barcode: ano ang nauuna, ano ang kasunod, at paano dapat basahin ng web application ang pareho.

Ano ang unlapi ng barcode scanner?

Ang unlapi ay naka-configure na sequence na ipinapadala ng scanner bago ang payload. Ang payload ang text na na-decode ng symbology, gaya ng 123456789. Hindi bahagi ng decode na iyon ang unlapi maliban kung itinakda ang scanner na idagdag ito.

Mga karaniwang gamit:

  • Markahan ang simula ng mensahe. Minsan nagpapadala ang serial at terminal protocol ng control character, madalas na tinatawag na STX, para malaman ng host na nagsimula na ang bagong frame.
  • Pangalanan ang symbology. Kapag naka-enable ang AIM symbology identifier, maaaring magpadala ang scanner ng maikling printable na unlapi gaya ng ]C1 para sa Code 128 o ]E0 para sa EAN bago ang mga digit. Maaaring mag-branch ang application sa identifier na iyon.
  • I-route ang input sa mas lumang POS o terminal software. Isang nakapirming code bago ang data ang nagsasabi sa host kung aling field o device ang may-ari ng scan.
  • I-tag ang isang partikular na istasyon. Maaaring bigyan ang dalawang scanner ng magkaibang printable na unlapi para ipakita ng log kung aling lane ang nagpadala ng code.

Ang printable na unlapi ay ordinaryong character. Lumalabas ang mga ito sa harap ng string sa text field. Ang control-character na unlapi, gaya ng STX (0x02), ay hindi ang mga letrang S, T, at X. Maaaring hindi talaga ma-type ng keyboard-wedge scanner ang control character na iyon. Maaari itong ipadala ng serial scanner bilang byte. Basahin ang manual ng modelong hawak mo bago sumulat ng code na umaasa sa isa o sa isa pa.

Hindi patunay ang unlapi na scanner ang gumawa ng input. Maaaring i-type ng tao, ng macro, o ng Barcode Scanner Emulator ang parehong mga character. Ituring ang unlapi bilang framing na ikinonfigura mo, pagkatapos ay i-validate ang payload gaya ng ibang user input.

Ano ang hulapi ng barcode scanner?

Ang hulapi ay naka-configure na sequence na ipinapadala pagkatapos ng payload. Ang karaniwang trabaho nito ay sabihin sa application na tapos na ang scan, o ilipat ang focus. Magkakaiba ang mga scanner. May nag-aalok ng Enter, Tab, CR, LF, CR+LF, custom na string, o wala. May nag-aalok lamang ng isa o dalawa sa mga iyon.

ENTER. Ang Enter key. Sa browser ito ay keyboard event, event.key === "Enter". Hindi ito isiningit sa ordinaryong text input.

TAB. Ang Tab key, event.key === "Tab". Inililipat ng browser ang focus sa susunod na control. Hindi pumapasok ang key sa field.

CR. Carriage return, ASCII 0x0D. Sa serial o terminal interface, maaari itong maging tunay na byte pagkatapos ng payload. Sa keyboard wedge, ang setting na may label na CR o carriage return ay karaniwang nangangahulugang Enter key. Enter pa rin ang iniuulat ng browser. Hindi nakakakuha ng CR character ang value ng field.

LF. Line feed, ASCII 0x0A. Ibang control character ito mula sa CR. Sa serial stream, maaari itong maging sarili nitong byte. Walang standard na Line Feed key ang keyboard wedge sa paraang may Enter at Tab ito. Huwag ipagpalagay na ang menu item na LF ay nagta-type ng nakikitang character, o ng pangalawang Enter.

CRLF. CR na sinusundan ng LF, ang dalawang byte na 0x0D 0x0A. Inaasahan ng ilang serial at terminal host ang pares na iyon bilang dulo ng linya. Hindi iniimbak ng text field ng browser ang pares na iyon kapag may pumindot ng Enter.

Custom na character. Ang printable na hulapi gaya ng # o maikling code ay tina-type pagkatapos ng barcode, kaya nagiging bahagi ito ng string maliban kung aalisin ito ng application. Ang custom na control character ay sumusunod sa parehong hati gaya ng STX: mga byte sa serial port, mga keystroke sa wedge, at ang mga keystroke lamang na kaya talagang ipadala ng keyboard interface.

Magkakalapit na pangalan ang ENTER, CR, at LF para sa dulo ng linya sa mga manual. Hindi sila mapapalitan sa bawat application. Maaaring magpakita ang wedge scanner, ang serial scanner, ang Notepad, at ang web form ng magkaibang resulta para sa setting na may parehong pangalan.

Unlapi laban sa hulapi

Katangian Unlapi Hulapi
Posisyon Bago ang barcode data Pagkatapos ng barcode data
Layunin Markahan ang simula o lagyan ng label ang input Markahan ang pagtatapos o mag-trigger ng aksyon
Halimbawa STX, o printable na AIM identifier gaya ng ]C1 ENTER, TAB, o printable na character gaya ng #
Karaniwang gamit I-frame o tukuyin ang scan Isumite ang form o ilipat ang focus
Sa text field Nasa simula ng value ang mga printable na character Nasa dulo ang mga printable na character. Wala roon ang Enter at Tab
Pagkakakilanlan Naka-configure na marka na kaya i-type ninuman Naka-configure na marka na kaya i-type ninuman

Alisin ang unlapi o custom na hulapi lamang kapag ikinonfigura mo ang eksaktong sequence na iyon at hindi dapat kasama ito sa itinatagong record. Iwan ang AIM identifier hanggang may tuntunin ang application para rito.

ENTER, TAB, CR, at LF

Lumalabas ang mga pangalang ito sa mga configuration sheet. Nakikita ng tumatanggap na panig ang mga keystroke o mga byte, depende sa interface. Inilalarawan ng gabay na HID keyboard wedge ang landas ng keystroke. Ibang landas ang serial port: nagbabasa ng mga byte ang application, at hindi pinipili ng focus kung saan pupunta ang mga ito.

ENTER

Sa keyboard-wedge scanner, ang ENTER ay ang Enter key. Sa loob ng one-line na text field, ginagamit ng kasalukuyang mga browser ang key na iyon para isumite ang nakapalibot na form. Maaaring ikumpirma ng lookup box ang scan sa event na iyon. Maaaring magsumite ang multi-field na form bago mapunan ang mga susunod na field. Tawagin ang preventDefault() sa submit event, o sa Enter keydown, kapag dapat panatilihin ng page ang value at manatili. Hawakan ang Enter sa isang lugar. Itatala nang dalawang beses ang scan ng keydown listener at submit listener na parehong tumatanggap nito.

May mga scanner na nagpapadala ng NumPad Enter. "Enter" pa rin ang event.key. Maaaring "NumpadEnter" ang event.code sa halip na "Enter". Subukan ang event.key kung dapat ikumpirma ng parehong key ang field.

Inihahambing ng gabay na Mga hulaping ENTER laban sa TAB sa mga barcode scanner ang dalawang pagpipiliang iyon para sa POS at web form. Sinasaklaw ng Nawawalang ENTER ng barcode scanner ang scanner na nagta-type ng barcode at pagkatapos ay humihinto.

TAB

Ang TAB ay ang Tab key. Inililipat ng browser ang focus pagkatapos ng keydown. Basahin ang field sa keydown handler na iyon, habang may focus pa ito, at iwan ang default na aksyon kapag dapat tumanggap ng cursor ang susunod na control. Pinapanatili ng preventDefault() ang focus sa kasalukuyang field.

Ang Shift+Tab ay ang parehong key na may hawak na Shift. Ang Tab suffix ng scanner ay Tab na walang Shift. Balewalain ang event.shiftKey kung kailangang makabalik ang mga gumagamit ng keyboard sa form.

CR

Inililipat ng carriage return ang cursor sa simula ng linya sa terminal. Ang byte ay 0x0D. Maaaring idagdag ng serial scanner ang byte na iyon sa payload. Karaniwang nagpapadala ng Enter key ang keyboard-wedge setting na pinangalanang CR, sa halip na isingit ang 0x0D sa text. Ang pagpindot ng Enter sa browser input ay hindi nagsusulat ng CR character sa input.value.

Kung terminal o COM-port listener ang host, hanapin ang byte. Kung web page ang host, hanapin ang event.key === "Enter".

LF

Ibinababa ng line feed ang cursor ng terminal nang isang linya. Ang byte ay 0x0A. Itinuturing ng ilang host ang LF lamang bilang newline. Binabalewala ito ng iba maliban kung nauna ang CR. Ang wedge scanner na naglilista ng LF bilang hulapi ay maaaring magpadala ng key na hindi ginagawang line break ng operating system, o magpadala ng bagay na hindi pananatilihin ng text field. Kunin ang key sa Tester ng keyboard event bago hawakan ang ipinagpalagay na LF sa application code.

CRLF

Ang CRLF ay sequence ng dalawang control: una ang CR, pagkatapos ang LF. Ginagamit ito ng mga text file na istilong Windows at ng maraming serial device bilang isang newline. Ang configuration page na nagsasabing CRLF suffix ay nangangahulugang susubukan ng scanner na ipadala ang pares na iyon pagkatapos ng payload sa interface na ginagamit nito.

Sa browser, ang pagpindot ng Enter ay hindi gumagawa ng literal na CRLF sequence sa loob ng text input. Nakakatanggap ang form ng keyboard event. Maaaring magsingit ng newline ang <textarea> kapag pinindot ng user ang Enter, at ang newline na iyon ay sariling editing behavior ng browser, hindi patunay na naglabas ang scanner ng mga byte na 0x0D 0x0A. Maaaring tumanggap ang serial reader ng dalawang byte na iyon at dapat ituring ang mga ito bilang terminator lamang kung ikinonfigura ang scanner na iyon na ipadala ang mga ito. Huwag alisin ang CR o LF mula sa gitna ng payload na pinapayagang maglaman ng mga ito.

Paano naaapektuhan ng mga unlapi at hulapi ang mga web application

Ang keyboard-wedge scan ay sunod-sunod na keystroke papasok sa control na may focus. Hindi binubuksan ng page ang scanner. Kung nasa ibang field ang focus, doon pupunta ang unlapi, ang barcode, at ang hulapi.

Nagfi-fire ang keydown para sa bawat key, kasama ang Enter at Tab, bago magsingit ng character o maglipat ng focus ang browser. Ang event.key ang character o pangalan ng key pagkatapos ilapat ng operating system ang keyboard layout. Lumalabas sa field ang mga printable na character ng unlapi at hulapi sa pamamagitan ng input event. Hindi lumalabas ang Enter at Tab.

Kinukumpirma ng listener sa ibaba ang field kapag dumating ang Enter. Hindi ito nagdaragdag ng hulaping inalis ng scanner. Kung hindi nagpapadala ng Enter ang scanner, nananatili ang value sa field hanggang may ibang magbasa nito.

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

I-focus ang #barcode bago ang scan. Pinipigilan ng preventDefault() ang ancestor form na magsumite nang pangalawang beses. Kung wala sa loob ng form ang input at gusto mo ang native na submit, alisin ang preventDefault().

Kung walang hulapi, maghintay ng tahasang aksyon: isang button, isang Enter mamaya mula sa operator, o ang susunod na hakbang sa workflow. Maaaring ituring ng inactivity timer ang isang pause bilang wakas ng scan. Heuristic ang timer na iyon. Maaaring mapunta sa maling panig ang mabagal na scanner, ang Bluetooth delay, o ang mabilis na typist. Mas gusto ang naka-configure na hulapi kapag kailangan ng workflow ng tiyak na wakas.

Maaaring alisin ang kilalang printable na unlapi pagkatapos mong basahin ang value:

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

Ipasa lamang ang unlaping ikinonfigura mo, gaya ng ']C1'. Huwag magbawas ng arbitraryong bilang ng character sa bawat scan.

Para sa buong form na humahawak din ng Tab, walang lamang input, at pangalawang scan, tingnan ang Paano subukan ang mga barcode scanner sa mga web application.

Paano i-configure ang mga unlapi at hulapi

Nasa scanner ang mga setting ng unlapi at hulapi. Partikular sa manufacturer ang mga pangalan ng key at ang paraan ng pagbabago. Walang configuration barcode na gumagana sa bawat brand, at hindi nagpi-print ang gabay na ito ng isa.

Mga karaniwang paraan:

  • I-scan ang configuration barcode mula sa manual ng eksaktong modelong iyon. Nakagrupo ang sheet ayon sa setting: hulapi, unlapi, keyboard layout, symbology.
  • Gamitin ang configuration program ng vendor, pagkatapos ay isulat ang resulta sa scanner sa USB.
  • Gamitin ang device management utility ng product line na iyon kapag nag-a-update ka ng maraming unit.

Pagkatapos ng pagbabago, mag-scan ng barcode na alam mo na at ihambing ang resulta sa paglalarawan ng manual sa setting na pinili mo. Maaaring iwan ng factory reset mula sa ibang brand na hindi nagbabago ang scanner, o ilagay ito sa hindi inaasahang mode. Binubuod ng Gabay sa configuration ng barcode scanner ang mga setting na karaniwang mahalaga. Hindi nito pinapalitan ang manual.

Maaaring mag-type ang Barcode Scanner Emulator ng halagang pipiliin mo at pagkatapos ay magpadala ng ENTER, TAB, o walang hulapi. Ilagay ang printable na unlapi sa halagang iyon kapag kailangan mong sanayin ang paghawak ng unlapi nang walang hardware. Hindi naglalabas ang emulator ng serial na pares ng CR/LF byte, at hindi ito nagbabasa ng label.

Paano subukan ang kilos ng unlapi at hulapi

Gumamit ng scanner na nasa keyboard mode, USB HID keyboard o Bluetooth HID keyboard.

  1. Ikonekta ito at hintayin hanggang ipakita nitong may power ito.
  2. Buksan ang Tester ng barcode input.
  3. I-click ang Simulan ang pagsubok, o i-click ang scan area. Nagiging asul ito kapag handa na. Hindi kinukuha ng page ang focus nang kusa.
  4. Mag-scan ng barcode na alam mo na ang payload.
  5. Basahin ang nakuhang value at ang bilang ng character. Nasa loob ng string na iyon ang mga printable na character ng unlapi o hulapi. Para sa mga pinangalanang key na dumarating bago ang unang character, gaya ng modifier, ang linyang Unlapi. Hindi nito hinuhugot ang na-type na unlapi gaya ng ]C1 mula sa barcode text.
  6. Suriin ang hulapi. Iniuulat ng tester ang ENTER, TAB, o Wala. Kapag naka-on ang Awtomatikong pagkuha, lumalabas ang resulta pagkatapos ng Enter, Tab, o maikling pause kapag huminto ang mga key. I-off ang Awtomatikong pagkuha para hawakan ang capture hanggang pindutin mo ang Ihinto. Hindi bahagi ng barcode string ang Enter at Tab.
  7. Ihambing ang resultang iyon sa configuration na nilayon mo. Pagkatapos ay buksan ang Tester ng keyboard event at mag-scan muli kapag kailangan mo ang bawat keydown nang magkakasunod, kasama ang key, code, at timing.

Itinatala ng input tester ang mga keyboard event na nakikita ng browser. Hindi nito mabasa ang serial port, kaya hindi nito maipakita ang CR o LF bilang mga raw byte. Hindi pinatutunayan ng wedge test kung ano ang ipapadala ng serial setting.

Pag-troubleshoot

Hindi nagpapadala ng ENTER ang scanner. Lumalabas ang barcode at nananatili ang cursor sa field. Iniuulat ng input tester ang Wala. Naka-off ang hulapi, o nakatakda ito sa iba pa sa Enter. Tingnan ang Nawawalang ENTER ng barcode scanner.

Inililipat ng TAB ang focus nang hindi inaasahan. Nagpapadala ang scanner ng Tab key. Iyon ang naka-configure na hulapi. Gamitin ang Enter kapag dapat magsumite ang form, o basahin ang value sa Tab keydown kapag dapat umusad ang workflow. Nasa gabay na Mga hulaping ENTER laban sa TAB sa mga barcode scanner ang mga detalye.

Dalawang beses nagsumite ang form. Nagsumite ang browser sa Enter, at tumatanggap din ng scan ang isang keydown listener. Panatilihin ang isang completion path at tawagin ang preventDefault() sa isa pa.

Lumalabas ang unlapi sa loob ng barcode. Bahagi ng nakuhang string ang printable na unlapi. I-disable ito sa scanner, o alisin ang eksaktong sequence na iyon sa application. Karaniwang pinagmulan ng nangungunang ] at dalawa pang character ang naka-enable na symbology identifier. Mawawala, sa halip na makikita, ang control prefix na hindi ma-type ng wedge.

Mali ang mga character. Maaaring hindi magkatugma ang layout ng scanner at ang layout ng operating system, na nagbabago ng mga character ng unlapi at ng bantas habang nananatili ang haba. Tingnan ang Maling keyboard layout ng barcode scanner.

Hindi kailanman nakikita ng application ang wakas ng scan. Walang hulapi, at naghihintay ang page ng Enter. Magdagdag ng hulaping tumutugma sa form, o kumpletuhin ang value sa tahasang aksyon. May mga tunay na scan na mapapalampas ng hula sa timing, at may typing na matatanggap nito.

Nagkakaiba ang CR/LF sa pagitan ng mga application. Nagsisingit ng bagong linya ang Notepad kapag nakatanggap ito ng Enter. Pinapanatili ng web text input ang barcode at nagfi-fire ng key event. Maaaring tumanggap ang serial program ng 0x0D, 0x0A, o pareho. Ihambing ang interface bago baguhin ang scanner. Kung walang application na nakakatanggap ng mga character, magsimula sa Hindi gumagana ang barcode scanner.

Nasa Paano subukan ang input ng barcode scanner ang mas malawak na pagdaan sa focus, mga paulit-ulit na scan, at mga daloy ng POS.

Test matrix

Ang column ng configuration ang itinakda mo sa scanner, o ang tina-type mo gamit ang emulator kapag keyboard suffix ang kaso. Ang inaasahang kilos ang dapat gawin ng application. Hindi parehong test ang serial na kaso ng CRLF at ang Enter key sa browser.

Configuration Inaasahang kilos ng application
Walang unlapi, walang hulapi Natatanggap ang barcode value at walang completion key na dumarating. Nanatiling available ang value hanggang basahin ito ng application.
Walang unlapi, ENTER na hulapi Nakakatanggap ang application ng completion key nang isang beses at iniimbak ang payload nang walang terminator character.
Walang unlapi, TAB na hulapi Maaaring lumipat ang focus sa susunod na control. Binabasa ng application ang value bago ang paglipat na iyon.
Custom na printable na unlapi Lumalabas ang mga character ng unlapi bago ang na-decode na data. Sinasadyang panatilihin o alisin ng application ang eksaktong unlaping iyon.
Custom na printable na hulapi Lumalabas ang mga character ng hulapi pagkatapos ng na-decode na data. Mga key ang Enter at Tab, kaya hindi lumalabas ang mga ito sa string.
CRLF sequence Pinoproseso ng serial o terminal host ang mga naka-configure na byte ng CR at LF. Hindi nakakakuha ang text field ng browser ng mga byte na iyon mula sa pagpindot ng Enter.

Patakbuhin ang mga keyboard row sa wedge scanner at, kapag walang hardware, gamit ang mga setting na ENTER, TAB, at walang hulapi ng emulator. Patakbuhin ang CRLF row sa interface na dapat magdala ng mga byte na iyon. Nakasalalay pa rin ang aktuwal na resulta sa interface na iyon at sa application.