Pāriet uz saturu

Barcode Scanner Emulator

Svītrkodu skenera priedēklis un piedēklis: pilnīgs ceļvedis

Priedēklis ir dati vai vadības secība, ko svītrkodu skeneris nosūta pirms atkodētā svītrkoda. Piedēklis ir tas, ko tas nosūta pēc šīs vērtības. To pašu modeli var iestatīt dažādiem priedēkļiem un piedēkļiem, un seriālais skeneris tos nepiegādā tāpat kā tastatūras ķīļa skeneris.

Svītrkodu skenera priedēklis tiek nosūtīts pirms atkodētās vērtības. Piedēklis tiek nosūtīts pēc tās. Viens skeneris var dot šādu secību:

Priedēklis: STX

Svītrkods: 123456789

Piedēklis: ENTER

STX rokasgrāmatā bieži nozīmē vadības rakstzīmi, nevis trīs burtus S, T un X. ENTER tastatūras ķīļa skenerī parasti ir Enter taustiņš, nevis divas rakstzīmes CR un LF, kas tiek ievietotas teksta laukā. Kuru no tām saņemat, ir atkarīgs no modeļa, saskarnes un lietojumprogrammas. Neviens iestatījums nav universāls.

Ceļvedis ENTER un TAB piedēkļi svītrkodu skeneros paliek pie šo divu noslēdzēju izvēles un problēmu novēršanas. Šis ceļvedis ir par rāmi ap svītrkodu: kas nāk pirms, kas nāk pēc un kā tīmekļa lietojumprogrammai jālasa abi.

Kas ir svītrkodu skenera priedēklis?

Priedēklis ir konfigurēta secība, ko skeneris pārraida pirms kravas. Krava ir teksts, ko atkodēja simboloģija, piemēram 123456789. Priedēklis nav šīs atkodēšanas daļa, ja vien skeneris netika iestatīts to pievienot.

Ierasti lietojumi:

  • Atzīmējiet ziņojuma sākumu. Seriālie un termināļa protokoli dažreiz sūta vadības rakstzīmi, ko bieži sauc par STX, lai resursdators zinātu, ka sācies jauns kadrs.
  • Nosauciet simboloģiju. Ja AIM simboloģijas identifikators ir ieslēgts, skeneris var pirms cipariem nosūtīt īsu drukājamu priedēkli, piemēram ]C1 Code 128 vai ]E0 EAN. Lietojumprogramma var zaroties pēc šī identifikatora.
  • Novirziet ievadi vecākā POS vai termināļa programmatūrā. Fiksēts kods pirms datiem resursdatoram pateica, kuram laukam vai ierīcei skenējums pieder.
  • Atzīmējiet konkrētu staciju. Diviem skeneriem var dot dažādus drukājamus priedēkļus, lai žurnāls rādītu, kura josla nosūtīja kodu.

Drukājams priedēklis ir parastas rakstzīmes. Tās parādās teksta laukā virknes sākumā. Vadības rakstzīmes priedēklis, piemēram STX (0x02), nav burti S, T un X. Tastatūras ķīļa skeneris var nespēt šo vadības rakstzīmi ierakstīt vispār. Seriālais skeneris var to nosūtīt kā baitu. Izlasiet sava modeļa rokasgrāmatu, pirms rakstāt kodu, kas gaida vienu vai otru.

Priedēklis nepierāda, ka ievadi radīja skeneris. Cilvēks, makro vai Barcode Scanner Emulator var ierakstīt tās pašas rakstzīmes. Uztveriet priedēkli kā rāmi, ko konfigurējāt, un pēc tam pārbaudiet kravu tā, kā pārbaudāt jebkuru citu lietotāja ievadi.

Kas ir svītrkodu skenera piedēklis?

Piedēklis ir konfigurēta secība, kas tiek nosūtīta pēc kravas. Tā parastais uzdevums ir pateikt lietojumprogrammai, ka skenējums ir pabeigts, vai pārvietot fokusu. Skeneri atšķiras. Daži piedāvā Enter, Tab, CR, LF, CR+LF, pielāgotu virkni vai neko. Daži piedāvā tikai vienu vai divus no tiem.

ENTER. Enter taustiņš. Pārlūkā tas ir tastatūras notikums, event.key === "Enter". Tas netiek ievietots parastā teksta ievadē.

TAB. Tab taustiņš, event.key === "Tab". Pārlūks pārvieto fokusu uz nākamo vadīklu. Taustiņš netiek ievietots laukā.

CR. Rakstatgriezes atgrieze, ASCII 0x0D. Seriālā vai termināļa saskarnē tas var būt īsts baits pēc kravas. Tastatūras ķīlī iestatījums ar nosaukumu CR vai rakstatgriezes atgrieze parasti nozīmē Enter taustiņu. Pārlūks joprojām ziņo Enter. Lauka vērtība neiegūst CR rakstzīmi.

LF. Rindas padeve, ASCII 0x0A. Tā ir cita vadības rakstzīme nekā CR. Seriālā plūsmā tā var būt savs baits. Tastatūras ķīlim nav standarta rindas padeves taustiņa tā, kā tam ir Enter un Tab. Nepieņemiet, ka izvēlnes vienums ar nosaukumu LF ieraksta redzamu rakstzīmi vai otru Enter.

CRLF. CR, kam seko LF, divi baiti 0x0D 0x0A. Daži seriālie un termināļa resursdatori šo pāri sagaida kā rindas beigas. Pārlūka teksta lauks šo pāri neuzglabā, kad kāds nospiež Enter.

Pielāgotas rakstzīmes. Drukājams piedēklis, piemēram # vai īss kods, tiek ierakstīts pēc svītrkoda, tāpēc tas kļūst par virknes daļu, ja lietojumprogramma to nenoņem. Pielāgota vadības rakstzīme seko tam pašam dalījumam kā STX: baiti seriālajā portā, taustiņu spiedieni ķīlī un tikai tie taustiņu spiedieni, ko tastatūras saskarne patiešām var nosūtīt.

ENTER, CR un LF rokasgrāmatās ir saistīti nosaukumi nozīmei "rindas beigas". Tie nav aizstājami katrā lietojumprogrammā. Ķīļa skeneris, seriālais skeneris, Notepad un tīmekļa veidlapa katrs var rādīt citu rezultātu iestatījumam ar to pašu nosaukumu.

Priedēklis un piedēklis

Īpašība Priedēklis Piedēklis
Vieta Pirms svītrkoda datiem Pēc svītrkoda datiem
Mērķis Atzīmēt sākumu vai apzīmēt ievadi Atzīmēt pabeigšanu vai izraisīt darbību
Piemērs STX vai drukājams AIM identifikators, piemēram ]C1 ENTER, TAB vai drukājama rakstzīme, piemēram #
Ierasts lietojums Ierāmēt vai atpazīt skenējumu Iesniegt veidlapu vai pārvietot fokusu
Teksta laukā Drukājamas rakstzīmes ir vērtības sākumā Drukājamas rakstzīmes ir beigās. Enter un Tab nav
Identitāte Konfigurēta atzīme, ko var ierakstīt ikviens Konfigurēta atzīme, ko var ierakstīt ikviens

Noņemiet priedēkli vai pielāgotu piedēkli tikai tad, kad konfigurējāt tieši šo secību un saglabātajam ierakstam to nevajag ietvert. Atstājiet AIM identifikatoru vietā, līdz lietojumprogrammai ir tam noteikums.

ENTER, TAB, CR un LF

Šie nosaukumi parādās konfigurācijas lapās. Saņemošā puse redz vai nu taustiņu spiedienus, vai baitus, atkarībā no saskarnes. Ceļvedis HID tastatūras ķīlis apraksta taustiņu spiedienu ceļu. Seriālais ports ir cits ceļš: lietojumprogramma lasa baitus, un fokuss neizvēlas, kur tie nonāk.

ENTER

Tastatūras ķīļa skenerī ENTER ir Enter taustiņš. Vienas rindas teksta laukā pašreizējie pārlūki šo taustiņu izmanto, lai iesniegtu aptverošo veidlapu. Meklēšanas lodziņš var apstiprināt skenējumu šajā notikumā. Vairāku lauku veidlapa var tikt iesniegta, pirms vēlākie lauki ir aizpildīti. Izsauciet preventDefault() notikumā submit vai Enter keydown, kad lapai jāpatur vērtība un jāpaliek vietā. Apstrādājiet Enter vienā vietā. keydown klausītājs un submit klausītājs, kas abi pieņem skenējumu, to ierakstīs divreiz.

Daži skeneri sūta NumPad Enter. event.key joprojām ir "Enter". event.code var būt "NumpadEnter", nevis "Enter". Pārbaudiet event.key, ja abiem taustiņiem jāapstiprina lauks.

Ceļvedis ENTER un TAB piedēkļi svītrkodu skeneros salīdzina šīs divas izvēles POS un tīmekļa veidlapām. Svītrkodu skenerim trūkst ENTER aptver skeneri, kas ieraksta svītrkodu un tad apstājas.

TAB

TAB ir Tab taustiņš. Pārlūks pārvieto fokusu pēc keydown. Nolasiet lauku šajā keydown apstrādē, kamēr tam vēl ir fokuss, un atstājiet noklusējuma darbību, kad nākamajai vadīklai jāsaņem kursors. preventDefault() patur fokusu pašreizējā laukā.

Shift+Tab ir tas pats taustiņš, turot Shift. Skenera Tab piedēklis ir Tab bez Shift. Ignorējiet event.shiftKey, ja tastatūras lietotājiem jāspēj virzīties atpakaļ pa veidlapu.

CR

Rakstatgriezes atgrieze pārvieto kursoru uz rindas sākumu terminālī. Baits ir 0x0D. Seriālais skeneris var šo baitu pievienot kravai. Tastatūras ķīļa iestatījums ar nosaukumu CR parasti sūta Enter taustiņu, nevis ievieto 0x0D tekstā. Enter nospiešana pārlūka ievadē neieraksta CR rakstzīmi laukā input.value.

Ja resursdators ir terminālis vai COM porta klausītājs, meklējiet baitu. Ja resursdators ir tīmekļa lapa, meklējiet event.key === "Enter".

LF

Rindas padeve pārvieto termināļa kursoru par vienu rindu uz leju. Baits ir 0x0A. Daži resursdatori tikai LF uzskata par jaunu rindu. Citi to ignorē, ja CR nenāca pirmais. Ķīļa skeneris, kas LF norāda kā piedēkli, var nosūtīt taustiņu, ko operētājsistēma nepārvērš rindas pārtraukumā, vai var nenosūtīt neko, ko teksta lauks paturētu. Tveriet taustiņu tastatūras notikumu testētājā, pirms apstrādājat it kā LF lietojumprogrammas kodā.

CRLF

CRLF ir divu vadības rakstzīmju secība CR, tad LF. Windows stila teksta faili un daudzas seriālās ierīces to izmanto kā vienu jaunu rindu. Konfigurācijas lapa, kas saka "CRLF piedēklis", nozīmē, ka skeneris mēģinās nosūtīt šo pāri pēc kravas saskarnē, ko tas izmanto.

Pārlūkā Enter nospiešana nerada burtisku CRLF secību teksta ievadē. Veidlapa saņem tastatūras notikumu. <textarea> var ievietot jaunu rindu, kad lietotājs nospiež Enter, un šī jaunā rinda ir paša pārlūka rediģēšanas uzvedība, nevis pierādījums, ka skeneris izdeva baitus 0x0D 0x0A. Seriālais lasītājs var saņemt šos divus baitus un tos kā noslēdzēju būtu jāuzskata tikai tad, ja šis skeneris bija konfigurēts tos sūtīt. Nenoņemiet CR vai LF no kravas vidus, kurai ir atļauts tos saturēt.

Kā priedēkļi un piedēkļi ietekmē tīmekļa lietojumprogrammas

Tastatūras ķīļa skenējums ir taustiņu spiedienu uzliesmojums fokusētajā vadīklā. Lapa neatver skeneri. Ja fokuss ir citā laukā, priedēklis, svītrkods un piedēklis visi nonāk tur.

keydown nostrādā katram taustiņam, ieskaitot Enter un Tab, pirms pārlūks ievieto rakstzīmi vai pārvieto fokusu. event.key ir rakstzīme vai taustiņa nosaukums pēc tam, kad operētājsistēma ir piemērojusi tastatūras izkārtojumu. Drukājamas priedēkļa un piedēkļa rakstzīmes laukā parādās caur notikumu input. Enter un Tab neparādās.

Klausītājs zemāk apstiprina lauku, kad pienāk Enter. Tas nepievieno piedēkli, ko skeneris izlaida. Ja skeneris nenosūta Enter, vērtība paliek laukā, līdz kaut kas cits to nolasa.

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

Fokusējiet #barcode pirms skenēšanas. preventDefault() aptur priekšteča veidlapas otro iesniegšanu. Ja ievade nav veidlapā un vēlaties vietējo iesniegšanu, izlaidiet preventDefault().

Bez piedēkļa gaidiet skaidru darbību: pogu, vēlāku operatora Enter vai nākamo darbplūsmas soli. Bezdarbības taimeris var pauzi uzskatīt par skenējuma beigām. Šis taimeris ir heiristika. Lēns skeneris, Bluetooth aizture vai cilvēks, kas raksta ātri, var nonākt tā nepareizajā pusē. Dodiet priekšroku konfigurētam piedēklim, kad darbplūsmai vajag noteiktas beigas.

Zināmu drukājamu priedēkli var noņemt pēc vērtības nolasīšanas:

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

Padodiet tikai konfigurēto priedēkli, piemēram ']C1'. Nenoņemiet patvaļīgu rakstzīmju skaitu no katra skenējuma.

Pilnu veidlapu, kas apstrādā arī Tab, tukšu ievadi un otru skenējumu, skatiet ceļvedī Kā testēt svītrkodu skenerus tīmekļa lietojumprogrammās.

Kā konfigurēt priedēkļus un piedēkļus

Priedēkļa un piedēkļa iestatījumi ir skenerī. Taustiņu nosaukumi un veids, kā tos maināt, ir atkarīgi no ražotāja. Nav konfigurācijas svītrkoda, kas darbotos katrā zīmolā, un šis ceļvedis tādu nedrukā.

Ierastie veidi:

  • Noskenējiet konfigurācijas svītrkodu no tieši šī modeļa rokasgrāmatas. Lapa ir sagrupēta pēc iestatījuma: piedēklis, priedēklis, tastatūras izkārtojums, simboloģija.
  • Izmantojiet ražotāja konfigurācijas programmu un tad ierakstiet rezultātu skenerī pa USB.
  • Izmantojiet šīs produktu līnijas ierīču pārvaldības utilītu, kad atjaunināt daudzas vienības.

Pēc izmaiņas noskenējiet zināmu svītrkodu un salīdziniet rezultātu ar rokasgrāmatas aprakstu iestatījumam, ko izvēlējāties. Cita zīmola rūpnīcas atiestatīšana var atstāt skeneri nemainītu vai ievietot to negaidītā režīmā. Ceļvedis svītrkodu skenera konfigurēšana apkopo iestatījumus, kas parasti ir svarīgi. Tas neaizstāj rokasgrāmatu.

Barcode Scanner Emulator var ierakstīt jūsu izvēlēto vērtību un tad nosūtīt ENTER, TAB vai nevienu piedēkli. Ielieciet drukājamu priedēkli šajā vērtībā, kad jāizmēģina priedēkļa apstrāde bez aparatūras. Emulators neizdod seriālu CR/LF baitu pāri un nelasa etiķeti.

Kā testēt priedēkļa un piedēkļa uzvedību

Izmantojiet skeneri, kas ir tastatūras režīmā, USB HID tastatūra vai Bluetooth HID tastatūra.

  1. Pievienojiet to un pagaidiet, līdz tas parāda, ka tam ir barošana.
  2. Atveriet svītrkoda ievades testētāju.
  3. Noklikšķiniet uz Sākt testu vai noklikšķiniet skenēšanas apgabalā. Tas kļūst zils, kad ir gatavs. Lapa pati nepaņem fokusu.
  4. Noskenējiet svītrkodu, kura kravu jau zināt.
  5. Izlasiet tverto vērtību un rakstzīmju skaitu. Drukājamas priedēkļa vai piedēkļa rakstzīmes ir šīs virknes iekšpusē. Rinda Priedēklis ir nosauktiem taustiņiem, kas pienāk pirms pirmās rakstzīmes, piemēram modifikatoram. Tā neizvelk ierakstītu priedēkli, piemēram ]C1, no svītrkoda teksta.
  6. Pārbaudiet piedēkli. Testētājs ziņo ENTER, TAB vai Nav. Kad Automātiska tveršana ir ieslēgta, rezultāts parādās pēc Enter, Tab vai īsas pauzes, kad taustiņi apstājas. Izslēdziet Automātiska tveršana, lai tveršanu paturētu, līdz nospiežat Apturēt. Enter un Tab nav svītrkoda virknes daļa.
  7. Salīdziniet šo rezultātu ar konfigurāciju, ko bijāt iecerējis. Tad atveriet tastatūras notikumu testētāju un skenējiet vēlreiz, kad vajag katru keydown secībā, ieskaitot key, code un laiku.

Ievades testētājs reģistrē tastatūras notikumus, ko pārlūks var redzēt. Tas nevar lasīt seriālo portu, tāpēc nevar parādīt CR vai LF kā neapstrādātus baitus. Ķīļa tests nepierāda, ko nosūtīs seriālais iestatījums.

Problēmu novēršana

Skeneris nenosūta ENTER. Svītrkods parādās un kursors paliek laukā. Ievades testētājs ziņo Nav. Piedēklis ir izslēgts vai iestatīts uz kaut ko citu, nevis Enter. Skatiet Svītrkodu skenerim trūkst ENTER.

TAB negaidīti pārvieto fokusu. Skeneris sūta Tab taustiņu. Tas ir konfigurētais piedēklis. Izmantojiet Enter, kad veidlapai jāiesniedz, vai nolasiet vērtību Tab keydown, kad darbplūsmai jāvirzās uz priekšu. Sīkāk ceļvedī ENTER un TAB piedēkļi svītrkodu skeneros.

Veidlapa iesniedz divreiz. Pārlūks iesniedz uz Enter, un keydown klausītājs arī pieņem skenējumu. Paturiet vienu pabeigšanas ceļu un otrā izsauciet preventDefault().

Priedēklis parādās svītrkoda iekšpusē. Drukājams priedēklis ir tvertās virknes daļa. Atspējojiet to skenerī vai noņemiet tieši šo secību lietojumprogrammā. Ieslēgts simboloģijas identifikators ir ierasts avots sākuma ] un vēl divām rakstzīmēm. Vadības priedēklis, ko ķīlis nevar ierakstīt, trūks, nevis būs redzams.

Rakstzīmes ir nepareizas. Skenera izkārtojums un operētājsistēmas izkārtojums var nesakrist, kas maina priedēkļa rakstzīmes un pieturzīmes, kamēr garums paliek tāds pats. Skatiet Nepareizs svītrkodu skenera tastatūras izkārtojums.

Lietojumprogramma nekad neredz skenējuma beigas. Piedēkļa nav, un lapa gaida Enter. Pievienojiet piedēkli, kas atbilst veidlapai, vai pabeidziet vērtību ar skaidru darbību. Laika minējums palaidīs garām dažus īstus skenējumus un pieņems daļu rakstīšanas.

CR/LF atšķiras starp lietojumprogrammām. Notepad ievieto jaunu rindu, kad saņem Enter. Tīmekļa teksta ievade patur svītrkodu un izraisa taustiņa notikumu. Seriālā programma var saņemt 0x0D, 0x0A vai abus. Salīdziniet saskarni, pirms maināt skeneri. Ja neviena lietojumprogramma nesaņem rakstzīmes, sāciet ar Svītrkodu skeneris nedarbojas.

Plašāks skatījums uz fokusu, atkārtotiem skenējumiem un POS plūsmām ir ceļvedī Kā testēt svītrkodu skenera ievadi.

Testu matrica

Konfigurācijas kolonna ir tas, ko iestatāt skenerī, vai tas, ko ierakstāt ar emulatoru, kad gadījums ir tastatūras piedēklis. Gaidāmā uzvedība ir tas, kas lietojumprogrammai jādara. Seriāls CRLF gadījums nav tas pats tests kā Enter taustiņš pārlūkā.

Konfigurācija Gaidāmā lietojumprogrammas uzvedība
Nav priedēkļa, nav piedēkļa Svītrkoda vērtība tiek saņemta, un neviens pabeigšanas taustiņš nepienāk. Vērtība paliek pieejama, līdz lietojumprogramma to nolasa.
Nav priedēkļa, ENTER piedēklis Lietojumprogramma saņem pabeigšanas taustiņu vienreiz un saglabā kravu bez noslēdzēja rakstzīmes.
Nav priedēkļa, TAB piedēklis Fokuss var pāriet uz nākamo vadīklu. Lietojumprogramma nolasa vērtību pirms šīs pārvietošanas.
Pielāgots drukājams priedēklis Priedēkļa rakstzīmes parādās pirms atkodētajiem datiem. Lietojumprogramma apzināti patur vai noņem tieši šo priedēkli.
Pielāgots drukājams piedēklis Piedēkļa rakstzīmes parādās pēc atkodētajiem datiem. Enter un Tab ir taustiņi, tāpēc virknē neparādās.
CRLF secība Seriālais vai termināļa resursdators apstrādā konfigurētos CR un LF baitus. Pārlūka teksta lauks šos baitus negūst no Enter taustiņa spiediena.

Izpildiet tastatūras rindas ķīļa skenerī un, kad aparatūras nav, ar emulatora iestatījumiem ENTER, TAB un bez piedēkļa. Izpildiet CRLF rindu saskarnē, kurai jānes šie baiti. Faktiskie rezultāti joprojām ir atkarīgi no šīs saskarnes un no lietojumprogrammas.