Barcode Scanner Emulator
Viivakoodinlukijan etuliite ja pääte: täydellinen opas
Etuliite on data tai ohjausjono, jonka viivakoodinlukija lähettää ennen purettua viivakoodia. Pääte on se, minkä lukija lähettää arvon jälkeen. Sama malli voidaan asettaa eri etuliitteille ja päätteille, eikä sarjalukija toimita niitä samalla tavalla kuin näppäimistökiilaa käyttävä lukija.
Viivakoodinlukijan etuliite lähtee ennen purettua arvoa. Pääte lähtee sen jälkeen. Yksi lukija voi tuottaa tämän jonon:
Etuliite: STX
Viivakoodi: 123456789
Pääte: ENTER
Käsikirjassa STX tarkoittaa yleensä ohjausmerkkiä, ei kirjaimia S, T ja X. Näppäimistökiilalukijassa ENTER on tavallisesti Enter-näppäin, ei tekstikenttään lisättyjä merkkejä CR ja LF. Kumman vastaanotat, riippuu mallista, liitännästä ja sovelluksesta. Mikään asetus ei ole yleinen.
Opas ENTER- ja TAB-päätteet pysyy noiden kahden päättimen valinnassa ja vianmäärityksessä. Tämä opas käsittelee kehystä viivakoodin ympärillä: mitä tulee ennen, mitä tulee jälkeen ja miten verkkosovelluksen tulisi lukea molemmat.
Mikä on viivakoodinlukijan etuliite?
Etuliite on määritetty jono, jonka lukija lähettää ennen sisältöä. Sisältö on teksti, jonka symbologia purki, esimerkiksi 123456789. Etuliite ei kuulu siihen purkuun, ellei lukijaa ole asetettu lisäämään sitä.
Tavallisia käyttötapoja:
- Viestin alun merkitseminen. Sarja- ja pääteprotokollat lähettävät joskus ohjausmerkin, jota kutsutaan usein STX:ksi, jotta isäntä tietää uuden kehyksen alkaneen.
- Symbologian nimeäminen. Kun AIM-symbologiatunniste on käytössä, lukija voi lähettää lyhyen tulostettavan etuliitteen, kuten
]C1Code 128:lle tai]E0EAN:lle, ennen numeroita. Sovellus voi haarautua tunnisteen mukaan. - Syötteen reititys vanhassa POS- tai pääteohjelmistossa. Kiinteä koodi ennen dataa kertoi isännälle, mihin kenttään tai laitteeseen luku kuului.
- Tietyn aseman merkitseminen. Kahdelle lukijalle voidaan antaa eri tulostettavat etuliitteet, jotta loki näyttää, mikä kaista lähetti koodin.
Tulostettava etuliite on tavallisia merkkejä. Ne näkyvät tekstikentässä merkkijonon alussa. Ohjausmerkkietuliite, kuten STX (0x02), ei ole kirjaimet S, T ja X. Näppäimistökiilalukija ei ehkä pysty kirjoittamaan sitä ohjausmerkkiä lainkaan. Sarjalukija voi lähettää sen tavuna. Lue käytössäsi olevan mallin käsikirja ennen kuin kirjoitat koodia, joka odottaa jompaakumpaa.
Etuliite ei todista, että lukija tuotti syötteen. Henkilö, makro tai Barcode Scanner Emulator voi kirjoittaa samat merkit. Käsittele etuliitettä kehyksenä, jonka määritit, ja validoi sisältö samalla tavalla kuin muun käyttäjän syötteen.
Mikä on viivakoodinlukijan pääte?
Pääte on määritetty jono, joka lähetetään sisällön jälkeen. Sen tavallinen tehtävä on kertoa sovellukselle, että luku on valmis, tai siirtää kohdistus. Lukijat eroavat toisistaan. Jotkin tarjoavat Enterin, Tabin, CR:n, LF:n, CR+LF:n, oman merkkijonon tai ei mitään. Jotkin tarjoavat vain yhden tai kaksi näistä.
ENTER. Enter-näppäin. Selaimessa tämä on näppäimistötapahtuma, event.key === "Enter". Sitä ei lisätä tavalliseen tekstikenttään.
TAB. Sarkainnäppäin, event.key === "Tab". Selain siirtää kohdistuksen seuraavaan ohjausobjektiin. Näppäintä ei lisätä kenttään.
CR. Vaununpalautus, ASCII 0x0D. Sarja- tai pääte liitännässä tämä voi olla todellinen tavu sisällön jälkeen. Näppäimistökiilassa asetus nimeltä CR tai vaununpalautus tarkoittaa yleensä Enter-näppäintä. Selain raportoi silti Enterin. Kentän arvo ei saa CR-merkkiä.
LF. Rivinsyöttö, ASCII 0x0A. Se on eri ohjausmerkki kuin CR. Sarjavirrassa se voi olla oma tavunsa. Näppäimistökiilalla ei ole vakiomuotoista Line Feed -näppäintä samalla tavalla kuin Enter ja Tab. Älä oleta, että LF-niminen valikkokohta kirjoittaa näkyvän merkin tai toisen Enterin.
CRLF. CR ja sen jälkeen LF, kaksi tavua 0x0D 0x0A. Jotkin sarja- ja pääteisännät odottavat tätä paria rivin lopuksi. Selaimen tekstikenttä ei tallenna paria, kun joku painaa Enteriä.
Omat merkit. Tulostettava pääte, kuten # tai lyhyt koodi, kirjoitetaan viivakoodin jälkeen, joten siitä tulee osa merkkijonoa, ellei sovellus poista sitä. Oma ohjausmerkki noudattaa samaa jakoa kuin STX: tavuja sarjaportissa, näppäilyjä kiilassa ja vain ne näppäilyt, jotka näppäimistöliitäntä todella voi lähettää.
ENTER, CR ja LF ovat käsikirjoissa sukulaisnimiä rivin lopulle. Ne eivät ole keskenään vaihdettavissa jokaisessa sovelluksessa. Kiilalukija, sarjalukija, Notepad ja verkkolomake voivat kukin näyttää eri tuloksen samannimiselle asetukselle.
Etuliite ja pääte rinnakkain
| Ominaisuus | Etuliite | Pääte |
|---|---|---|
| Sijainti | Ennen viivakoodidataa | Viivakoodidatan jälkeen |
| Tarkoitus | Merkitä alku tai nimetä syöte | Merkitä valmistuminen tai laukaista toiminto |
| Esimerkki | STX tai tulostettava AIM-tunniste, kuten ]C1 |
ENTER, TAB tai tulostettava merkki, kuten # |
| Tavallinen käyttö | Kehystää tai tunnistaa luku | Lähettää lomake tai siirtää kohdistus |
| Tekstikentässä | Tulostettavat merkit ovat arvon alussa | Tulostettavat merkit ovat lopussa. Enter ja Tab eivät ole |
| Identiteetti | Määritetty merkki, jonka kuka tahansa voi kirjoittaa | Määritetty merkki, jonka kuka tahansa voi kirjoittaa |
Poista etuliite tai oma pääte vain, kun määritit juuri sen jonon eikä tallennetun tietueen tule sisältää sitä. Jätä AIM-tunniste paikalleen, kunnes sovelluksella on sille sääntö.
ENTER, TAB, CR ja LF
Nämä nimet näkyvät määritysarkeilla. Vastaanottava puoli näkee joko näppäilyjä tai tavuja liitännän mukaan. Opas HID-näppäimistökiila kuvaa näppäilyreitin. Sarjaportti on eri reitti: sovellus lukee tavuja, eikä kohdistus valitse niiden kohdetta.
ENTER
Näppäimistökiilalukijassa ENTER on Enter-näppäin. Yksirivisessä tekstikentässä nykyiset selaimet käyttävät näppäintä ympäröivän lomakkeen lähettämiseen. Haku voi vahvistaa luvun sillä tapahtumalla. Monikenttäinen lomake voi lähteä ennen myöhempien kenttien täyttöä. Kutsu preventDefault() tapahtumassa submit tai Enterin keydown-tapahtumassa, kun sivun tulee säilyttää arvo ja pysyä paikallaan. Käsittele Enter yhdessä paikassa. keydown-kuuntelija ja submit-kuuntelija, jotka molemmat hyväksyvät luvun, kirjaavat sen kahdesti.
Jotkin lukijat lähettävät NumPad Enterin. event.key on yhä "Enter". event.code voi olla "NumpadEnter" eikä "Enter". Testaa event.key, jos molempien näppäinten tulee vahvistaa kenttä.
Opas ENTER- ja TAB-päätteet vertaa näitä kahta valintaa POS-järjestelmille ja verkkolomakkeille. Viivakoodinlukijalta puuttuu ENTER käsittelee lukijaa, joka kirjoittaa viivakoodin ja pysähtyy.
TAB
TAB on sarkainnäppäin. Selain siirtää kohdistuksen keydown-tapahtuman jälkeen. Lue kenttä siinä keydown-käsittelijässä, kun sillä on yhä kohdistus, ja jätä oletustoiminto voimaan, kun seuraavan ohjausobjektin tulee saada kohdistin. preventDefault() pitää kohdistuksen nykyisessä kentässä.
Shift+Tab on sama näppäin Shift painettuna. Lukijan Tab-pääte on Tab ilman Shiftiä. Ohita event.shiftKey, jos näppäimistön käyttäjien on voitava liikkua lomakkeessa taaksepäin.
CR
Vaununpalautus siirtää kohdistimen rivin alkuun päätteessä. Tavu on 0x0D. Sarjalukija voi liittää tavun sisältöön. Näppäimistökiilan asetus nimeltä CR lähettää tyypillisesti Enter-näppäimen sen sijaan, että se lisäisi 0x0D:n tekstiin. Enterin painaminen selaimen kentässä ei kirjoita CR-merkkiä kenttään input.value.
Jos isäntä on pääte tai COM-portin kuuntelija, etsi tavu. Jos isäntä on verkkosivu, etsi event.key === "Enter".
LF
Rivinsyöttö siirtää päätteen kohdistinta yhden rivin alaspäin. Tavu on 0x0A. Jotkin isännät käsittelevät pelkkää LF:ää rivinvaihtona. Toiset sivuuttavat sen, ellei CR tullut ensin. Kiilalukija, joka luettelee LF:n päätteeksi, voi lähettää näppäimen, jota käyttöjärjestelmä ei muuta rivinvaihdoksi, tai se voi lähettää jotain, mitä tekstikenttä ei säilytä. Kaappaa näppäin näppäimistötapahtumien testaajalla ennen kuin käsittelet oletettua LF:ää sovelluskoodissa.
CRLF
CRLF on kahden ohjauksen jono CR ja sitten LF. Windows-tyyliset tekstitiedostot ja monet sarjalaitteet käyttävät sitä yhtenä rivinvaihtona. Määrityssivu, joka sanoo CRLF-päätteen, tarkoittaa, että lukija yrittää lähettää parin sisällön jälkeen käyttämällään liitännällä.
Selaimessa Enterin painaminen ei tuota kirjaimellista CRLF-jonoa tekstikentän sisään. Lomake vastaanottaa näppäimistötapahtuman. <textarea> voi lisätä rivinvaihdon, kun käyttäjä painaa Enteriä, ja se rivinvaihto on selaimen oma muokkauskäyttäytyminen, ei todiste siitä, että lukija lähetti tavut 0x0D 0x0A. Sarjalukija voi vastaanottaa nämä kaksi tavua, ja niiden tulee olla pääte vain, jos juuri se lukija määritettiin lähettämään ne. Älä poista CR:ää tai LF:ää sisällön keskeltä, jos sisältö saa sisältää ne.
Miten etuliitteet ja päätteet vaikuttavat verkkosovelluksiin
Näppäimistökiilaluku on näppäilyjen purske kohdistettuun ohjausobjektiin. Sivu ei avaa lukijaa. Jos kohdistus on toisessa kentässä, etuliite, viivakoodi ja pääte menevät sinne.
keydown laukeaa jokaisesta näppäimestä, myös Enteristä ja Tabista, ennen kuin selain lisää merkin tai siirtää kohdistuksen. event.key on merkki tai näppäimen nimi sen jälkeen, kun käyttöjärjestelmä on soveltanut näppäimistöasettelun. Tulostettavat etuliite- ja päätteen merkit näkyvät kentässä input-tapahtuman kautta. Enter ja Tab eivät näy.
Alla oleva kuuntelija vahvistaa kentän, kun Enter saapuu. Se ei lisää päätettä, jonka lukija jätti pois. Jos lukija ei lähetä Enteriä, arvo pysyy kentässä, kunnes jokin muu lukee sen.
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 = ''
})
Kohdista #barcode ennen lukua. preventDefault() estää ylempää lomaketta lähtemästä toisen kerran. Jos syöte ei ole lomakkeen sisällä ja haluat natiivin lähetyksen, jätä preventDefault() pois.
Ilman päätettä odota selvää toimintoa: painiketta, myöhempää Enteriä operaattorilta tai työnkulun seuraavaa vaihetta. Käyttämättömyysajastin voi käsitellä tauon luvun loppuna. Ajastin on arvaus. Hidas lukija, Bluetooth-viive tai nopea kirjoittaja voi osua sen väärälle puolelle. Suosi määritettyä päätettä, kun työnkulku tarvitsee varman lopun.
Tunnetun tulostettavan etuliitteen voi poistaa arvon lukemisen jälkeen:
function withoutConfiguredPrefix(value, prefix) {
if (prefix && value.startsWith(prefix)) {
return value.slice(prefix.length)
}
return value
}
Anna vain määrittämäsi etuliite, esimerkiksi ']C1'. Älä poista mielivaltaista merkkimäärää jokaisesta luvusta.
Kokonaiselle lomakkeelle, joka käsittelee myös Tabin, tyhjän syötteen ja toisen luvun, katso Miten viivakoodinlukijoita testataan verkkosovelluksissa.
Miten etuliitteet ja päätteet määritetään
Etuliitteen ja päätteen asetukset ovat lukijassa. Näppäinten nimet ja muutostapa ovat valmistajakohtaisia. Ei ole määritysviivakoodia, joka toimisi jokaisella merkillä, eikä tämä opas tulosta sellaista.
Tavallisia tapoja:
- Lue määritysviivakoodi juuri sen mallin käsikirjasta. Arkki on ryhmitelty asetuksen mukaan: pääte, etuliite, näppäimistöasettelu, symbologia.
- Käytä toimittajan määritysohjelmaa ja kirjoita tulos lukijaan USB:n kautta.
- Käytä tuotesarjan laitehallintaohjelmaa, kun päivität monia laitteita.
Muutoksen jälkeen lue tunnettu viivakoodi ja vertaa tulosta käsikirjan kuvaukseen valitsemastasi asetuksesta. Toisen merkin tehdaspalautus voi jättää lukijan ennalleen tai asettaa sen odottamattomaan tilaan. Opas Viivakoodinlukijan määritysopas tiivistää asetukset, joilla yleensä on merkitystä. Se ei korvaa käsikirjaa.
Barcode Scanner Emulator voi kirjoittaa valitsemasi arvon ja lähettää sitten ENTER, TAB tai ei päätettä. Laita tulostettava etuliite siihen arvoon, kun etuliitteen käsittelyä pitää harjoitella ilman laitteistoa. Emulaattori ei lähetä sarjaista CR/LF-tavuparia, eikä se lue etikettiä.
Miten etuliitteen ja päätteen toiminta testataan
Käytä lukijaa, joka on näppäimistötilassa, USB HID keyboard tai Bluetooth HID keyboard.
- Kytke se ja odota, kunnes se näyttää saaneensa virtaa.
- Avaa viivakoodisyötteen testaaja.
- Napsauta Start Test tai napsauta skannausaluetta. Se muuttuu siniseksi, kun se on valmis. Sivu ei ota kohdistusta itse.
- Lue viivakoodi, jonka sisällön jo tiedät.
- Lue kaapattu arvo ja merkkimäärä. Tulostettavat etuliitteen tai päätteen merkit ovat merkkijonon sisällä. Prefix-rivi on nimetyille näppäimille, jotka saapuvat ennen ensimmäistä merkkiä, kuten muuntonäppäimelle. Se ei vedä kirjoitettua etuliitettä kuten
]C1ulos viivakooditekstistä. - Tarkista pääte. Testaaja ilmoittaa ENTER, TAB tai None. Kun Auto capture on päällä, tulos ilmestyy Enterin, Tabin tai lyhyen tauon jälkeen, kun näppäimet loppuvat. Kytke Auto capture pois, jotta kaappaus pysyy, kunnes painat Stop. Enter ja Tab eivät ole osa viivakoodimerkkijonoa.
- Vertaa tulosta määritykseen, jonka tarkoitit. Avaa sitten näppäimistötapahtumien testaaja ja lue uudelleen, kun tarvitset jokaisen
keydown-tapahtuman järjestyksessä, mukaan lukienkey,codeja ajoitus.
Syötetestaaja kirjaa näppäimistötapahtumat, jotka selain näkee. Se ei voi lukea sarjaporttia, joten se ei voi näyttää CR:ää tai LF:ää raakoina tavuina. Kiilatesti ei todista, mitä sarja-asetus lähettää.
Vianmääritys
Lukija ei lähetä ENTER-näppäintä. Viivakoodi ilmestyy ja kohdistin jää kenttään. Syötetestaaja ilmoittaa None. Pääte on pois päältä, tai se on asetettu joksikin muuksi kuin Enteriksi. Katso Viivakoodinlukijalta puuttuu ENTER.
TAB siirtää kohdistuksen odottamatta. Lukija lähettää sarkainnäppäimen. Se on määritetty pääte. Käytä Enteriä, kun lomakkeen tulee lähteä, tai lue arvo Tabin keydown-tapahtumassa, kun työnkulun tulee edetä. Yksityiskohdat ovat oppaassa ENTER- ja TAB-päätteet.
Lomake lähtee kahdesti. Selain lähettää Enterillä, ja keydown-kuuntelija myös hyväksyy luvun. Pidä yksi valmistumisreitti ja kutsu preventDefault() toisessa.
Etuliite näkyy viivakoodin sisällä. Tulostettava etuliite on osa kaapattua merkkijonoa. Joko poista se käytöstä lukijassa tai poista juuri se jono sovelluksessa. Käytössä oleva symbologiatunniste on yleinen lähde alkavalle ]-merkille ja kahdelle muulle merkille. Ohjausetuliite, jota kiila ei voi kirjoittaa, puuttuu sen sijaan, että se näkyisi.
Merkit ovat väärin. Lukijan asettelu ja käyttöjärjestelmän asettelu voivat olla ristiriidassa, mikä muuttaa etuliitteen merkkejä ja välimerkkejä, vaikka pituus pysyy samana. Katso Viivakoodinlukijan väärä näppäimistöasettelu.
Sovellus ei koskaan näe luvun loppua. Päätettä ei ole, ja sivu odottaa Enteriä. Lisää lomakkeeseen sopiva pääte tai täydennä arvo selvällä toiminnolla. Ajoitusarvaus ohittaa joitakin oikeita lukuja ja hyväksyy kirjoitusta.
CR/LF eroaa sovellusten välillä. Notepad lisää uuden rivin, kun se vastaanottaa Enterin. Verkon tekstikenttä säilyttää viivakoodin ja laukaisee näppäintapahtuman. Sarjaohjelma voi vastaanottaa 0x0D:n, 0x0A:n tai molemmat. Vertaa liitäntää ennen lukijan muuttamista. Jos mikään sovellus ei vastaanota merkkejä, aloita oppaasta Viivakoodinlukija ei toimi.
Laajempi katsaus kohdistukseen, toistuviin lukuihin ja POS-kulkuihin on oppaassa Miten viivakoodinlukijan syöte testataan.
Testimatriisi
Määrityssarake on se, minkä asetat lukijaan, tai se, minkä kirjoitat emulaattorilla, kun tapaus on näppäimistöpääte. Odotettu toiminta on se, mitä sovelluksen tulee tehdä. Sarjainen CRLF-tapaus ei ole sama testi kuin Enter-näppäin selaimessa.
| Määritys | Odotettu sovelluksen toiminta |
|---|---|
| Ei etuliitettä, ei päätettä | Viivakoodiarvo vastaanotetaan, eikä valmistusnäppäintä tule. Arvo pysyy saatavilla, kunnes sovellus lukee sen. |
| Ei etuliitettä, ENTER-pääte | Sovellus vastaanottaa valmistusnäppäimen kerran ja tallentaa sisällön ilman päättävää merkkiä. |
| Ei etuliitettä, TAB-pääte | Kohdistus voi siirtyä seuraavaan ohjausobjektiin. Sovellus lukee arvon ennen siirtoa. |
| Oma tulostettava etuliite | Etuliitteen merkit näkyvät ennen purettua dataa. Sovellus säilyttää tai poistaa juuri sen etuliitteen tarkoituksella. |
| Oma tulostettava pääte | Päätteen merkit näkyvät puretun datan jälkeen. Enter ja Tab ovat näppäimiä, joten ne eivät näy merkkijonossa. |
| CRLF-jono | Sarja- tai pääteisäntä käsittelee määritetyt CR- ja LF-tavut. Selaimen tekstikenttä ei saa näitä tavuja Enter-painalluksesta. |
Aja näppäimistörivit kiilalukijalla ja, kun laitteisto puuttuu, emulaattorin ENTER-, TAB- ja ei päätettä -asetuksilla. Aja CRLF-rivi liitännällä, jonka kuuluu kuljettaa nämä tavut. Todelliset tulokset riippuvat yhä siitä liitännästä ja sovelluksesta.