Barcode Scanner Emulator
Vonalkódolvasó előtagja és utótagja: teljes útmutató
Az előtag adat vagy vezérlősorozat, amelyet a vonalkódolvasó a dekódolt vonalkód előtt küld. Az utótag az, amit az érték után küld. Ugyanaz a modell különböző előtagokra és utótagokra állítható, és a soros olvasó másképp adja át őket, mint a billentyűzet-ékeléses olvasó.
A vonalkódolvasó előtagja a dekódolt érték előtt megy ki. Az utótag utána. Egy olvasó ezt a sorozatot adhatja:
Előtag: STX
Vonalkód: 123456789
Utótag: ENTER
A kézikönyvben az STX általában a vezérlőkarakter, nem az S, T és X betűk. Billentyűzet-ékeléses olvasón az ENTER rendszerint az Enter billentyű, nem a szövegmezőbe illesztett CR és LF karakter. Hogy melyiket kapja, a modelltől, a csatolótól és az alkalmazástól függ. Nincs egyetemes beállítás.
Az ENTER és TAB utótagok útmutató a két lezáró kiválasztásánál és hibaelhárításánál marad. Ez az útmutató a vonalkód körüli keretről szól: mi jön előtte, mi jön utána, és a webes alkalmazás hogyan olvassa mindkettőt.
Mi a vonalkódolvasó előtagja?
Az előtag beállított sorozat, amelyet az olvasó a tartalom előtt küld. A tartalom a szöveg, amelyet a szimbólumrendszer dekódolt, például 123456789. Az előtag nem része ennek a dekódolásnak, hacsak az olvasót nem úgy állították, hogy hozzáfűzze.
Gyakori felhasználás:
- Az üzenet elejének jelölése. A soros és a terminálprotokollok néha vezérlőkaraktert küldenek, gyakran STX néven, hogy a gazda tudja, új keret kezdődött.
- A szimbólumrendszer megnevezése. Bekapcsolt AIM-szimbólumazonosítóval az olvasó rövid, nyomtatható előtagot küldhet, például
]C1a Code 128-hoz vagy]E0az EAN-hoz a számjegyek előtt. Az alkalmazás elágazhat ezen az azonosítón. - A bemenet irányítása régebbi POS- vagy terminálprogramban. Egy rögzített kód az adatok előtt megmondta a gazdának, melyik mezőhöz vagy eszközhöz tartozik a beolvasás.
- Egy adott állomás megjelölése. Két olvasó különböző nyomtatható előtagot kaphat, hogy a napló mutassa, melyik sáv küldte a kódot.
A nyomtatható előtag közönséges karakter. A szövegmezőben a karakterlánc elején jelenik meg. A vezérlőkarakteres előtag, például az STX (0x02), nem az S, T és X betű. A billentyűzet-ékeléses olvasó lehet, hogy egyáltalán nem tudja begépelni azt a vezérlőkaraktert. A soros olvasó bájtként elküldheti. Olvassa el a meglévő modell kézikönyvét, mielőtt olyan kódot ír, amely az egyiket vagy a másikat várja.
Az előtag nem bizonyítja, hogy olvasó hozta létre a bemenetet. Egy személy, egy makró vagy a Barcode Scanner Emulator ugyanazokat a karaktereket begépelheti. Kezelje az előtagot Ön által beállított keretként, majd ellenőrizze a tartalmat úgy, ahogy bármely más felhasználói bemenetet.
Mi a vonalkódolvasó utótagja?
Az utótag beállított sorozat, amelyet a tartalom után küldenek. Szokásos feladata, hogy jelezze az alkalmazásnak a beolvasás végét, vagy hogy áthelyezze a fókuszt. Az olvasók különböznek. Némelyik Entert, Tabot, CR-t, LF-et, CR+LF-et, egyedi karakterláncot vagy semmit kínál. Némelyik csak egyet vagy kettőt ezek közül.
ENTER. Az Enter billentyű. Böngészőben ez billentyűzetesemény, event.key === "Enter". Közönséges szövegmezőbe nem kerül be.
TAB. A Tab billentyű, event.key === "Tab". A böngésző a fókuszt a következő vezérlőre viszi. A billentyű nem kerül a mezőbe.
CR. Kocsivissza, ASCII 0x0D. Soros vagy terminálcsatolón ez valódi bájt lehet a tartalom után. Ékelésen a CR vagy kocsivissza feliratú beállítás rendszerint az Enter billentyűt jelenti. A böngésző továbbra is Entert jelent. A mező értéke nem kap CR karaktert.
LF. Soremelés, ASCII 0x0A. Ez a CR-től különböző vezérlőkarakter. Soros folyamban saját bájtja lehet. A billentyűzet-ékelésnek nincs szabványos Line Feed billentyűje úgy, ahogy Enter és Tab van. Ne feltételezze, hogy egy LF nevű menüpont látható karaktert vagy második Entert gépel.
CRLF. CR, majd LF, a két bájt 0x0D 0x0A. Egyes soros és terminálgazdák ezt a párt várják sorszakadásként. A böngésző szövegmezője nem tárolja a párt, amikor valaki Entert nyom.
Egyedi karakterek. A nyomtatható utótag, például a # vagy egy rövid kód, a vonalkód után gépelődik, így a karakterlánc része lesz, hacsak az alkalmazás el nem távolítja. Az egyedi vezérlőkarakter ugyanazt a szétválasztást követi, mint az STX: bájtok a soros porton, leütések az ékelésen, és csak azok a leütések, amelyeket a billentyűzetcsatoló ténylegesen el tud küldeni.
Az ENTER, a CR és az LF a kézikönyvekben a sorvég rokon nevei. Nem cserélhetők fel minden alkalmazásban. Az ékeléses olvasó, a soros olvasó, a Notepad és a webes űrlap ugyanannak a beállításnak más eredményét mutathatja.
Előtag és utótag
| Jellemző | Előtag | Utótag |
|---|---|---|
| Hely | A vonalkódadatok előtt | A vonalkódadatok után |
| Cél | A kezdet jelölése vagy a bemenet címkézése | A befejezés jelölése vagy művelet indítása |
| Példa | STX, vagy nyomtatható AIM-azonosító, például ]C1 |
ENTER, TAB vagy nyomtatható karakter, például # |
| Gyakori használat | A beolvasás keretezése vagy azonosítása | Űrlap elküldése vagy a fókusz áthelyezése |
| Szövegmezőben | A nyomtatható karakterek az érték elején állnak | A nyomtatható karakterek a végén állnak. Az Enter és a Tab nem |
| Azonosság | Beállított jel, amelyet bárki begépelhet | Beállított jel, amelyet bárki begépelhet |
Csak akkor távolítson el előtagot vagy egyedi utótagot, ha pontosan azt a sorozatot állította be, és a tárolt rekordnak nem szabad tartalmaznia. Hagyja a helyén az AIM-azonosítót, amíg az alkalmazásnak nincs szabálya rá.
ENTER, TAB, CR és LF
Ezek a nevek a beállítólapokon szerepelnek. A fogadó oldal a csatolótól függően leütéseket vagy bájtokat lát. A HID billentyűzet-ékelés útmutató a leütési utat írja le. A soros port más út: az alkalmazás bájtokat olvas, és a fókusz nem választja meg, hová mennek.
ENTER
Billentyűzet-ékeléses olvasón az ENTER az Enter billentyű. Egysoros szövegmezőben a mai böngészők ezzel a billentyűvel küldik el a befoglaló űrlapot. Egy keresőmező ezen az eseményen rögzítheti a beolvasást. A többmezős űrlap elküldődhet, mielőtt a későbbi mezők kitöltődnének. Hívja a preventDefault() függvényt a submit eseményen, vagy az Enter keydown eseményén, amikor az oldalnak meg kell tartania az értéket és a helyén kell maradnia. Az Entert egy helyen kezelje. A keydown figyelő és a submit figyelő, ha mindkettő elfogadja a beolvasást, kétszer rögzíti.
Egyes olvasók NumPad Entert küldenek. Az event.key továbbra is "Enter". Az event.code lehet "NumpadEnter" az "Enter" helyett. Tesztelje az event.key értékét, ha mindkét billentyűnek rögzítenie kell a mezőt.
Az ENTER és TAB utótagok útmutató összeveti ezt a két választást a POS és a webes űrlapok számára. A vonalkódolvasóról hiányzik az ENTER azt az olvasót tárgyalja, amely begépeli a vonalkódot, majd megáll.
TAB
A TAB a Tab billentyű. A böngésző a keydown után helyezi át a fókuszt. Olvassa a mezőt abban a keydown kezelőben, amíg még van fókusza, és hagyja a helyén az alapértelmezett műveletet, amikor a következő vezérlőnek kell megkapnia a kurzort. A preventDefault() a fókuszt az aktuális mezőn tartja.
A Shift+Tab ugyanaz a billentyű lenyomott Shifttel. Az olvasó Tab utótagja Tab Shift nélkül. Hagyja figyelmen kívül az event.shiftKey értékét, ha a billentyűzetes felhasználóknak visszafelé kell tudniuk haladni az űrlapon.
CR
A kocsivissza a kurzort a sor elejére viszi a terminálon. A bájt 0x0D. A soros olvasó hozzáfűzheti ezt a bájtot a tartalomhoz. A CR nevű ékelésbeállítás tipikusan az Enter billentyűt küldi, nem pedig a 0x0D beszúrását a szövegbe. Az Enter lenyomása egy böngészőmezőben nem ír CR karaktert az input.value értékébe.
Ha a gazda terminál vagy COM-port figyelő, keresse a bájtot. Ha a gazda weblap, keresse az event.key === "Enter" feltételt.
LF
A soremelés a terminálkurzor egy sorral lejjebb viszi. A bájt 0x0A. Egyes gazdák az LF-et önmagában sortörésnek tekintik. Mások figyelmen kívül hagyják, hacsak a CR nem jött előbb. Az ékeléses olvasó, amely az LF-et utótagként sorolja, küldhet olyan billentyűt, amelyet az operációs rendszer nem alakít sortöréssé, vagy küldhet olyat, amit a szövegmező nem tart meg. Fogja el a billentyűt a billentyűzetesemény-tesztelővel, mielőtt egy feltételezett LF-et kezelne az alkalmazáskódban.
CRLF
A CRLF a két vezérlőből álló sorozat: előbb CR, majd LF. A Windows-stílusú szövegfájlok és sok soros eszköz egyetlen sortörésként használja. A beállítóoldal, amely CRLF utótagot mond, azt jelenti, hogy az olvasó megpróbálja elküldeni a párt a tartalom után azon a csatolón, amelyet használ.
Böngészőben az Enter lenyomása nem hoz létre szó szerinti CRLF-sorozatot a szövegmezőben. Az űrlap billentyűzeteseményt kap. A <textarea> sortörést illeszthet be, amikor a felhasználó Entert nyom, és ez a sortörés a böngésző saját szerkesztési viselkedése, nem bizonyíték arra, hogy az olvasó a 0x0D 0x0A bájtokat bocsátotta ki. A soros olvasó megkaphatja ezt a két bájtot, és csak akkor kezelje őket lezáróként, ha az adott olvasót úgy állították be, hogy elküldje őket. Ne távolítsa el a CR-t vagy az LF-et egy olyan tartalom közepéről, amely tartalmazhatja őket.
Hogyan hatnak az előtagok és az utótagok a webes alkalmazásokra
A billentyűzet-ékeléses beolvasás leütések sorozata a fókuszban lévő vezérlőbe. Az oldal nem nyitja meg az olvasót. Ha a fókusz másik mezőn van, az előtag, a vonalkód és az utótag mind oda kerül.
A keydown minden billentyűre elsül, az Enterre és a Tabra is, mielőtt a böngésző karaktert illesztene be vagy áthelyezné a fókuszt. Az event.key a karakter vagy a billentyű neve azután, hogy az operációs rendszer alkalmazta a billentyűzetkiosztást. A nyomtatható előtag- és utótagkarakterek az input eseményen keresztül jelennek meg a mezőben. Az Enter és a Tab nem.
Az alábbi figyelő rögzíti a mezőt, amikor az Enter megérkezik. Nem ad hozzá utótagot, amelyet az olvasó kihagyott. Ha az olvasó nem küld Entert, az érték a mezőben marad, amíg valami más el nem olvassa.
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 = ''
})
Adjon fókuszt a #barcode elemnek a beolvasás előtt. A preventDefault() megakadályozza, hogy egy ősűrlap másodszor is elküldődjön. Ha a bemenet nincs űrlapban, és a natív küldést szeretné, hagyja ki a preventDefault() hívást.
Utótag nélkül várjon kifejezett műveletre: egy gombra, egy későbbi Enterre a kezelőtől, vagy a munkafolyamat következő lépésére. Egy inaktivitási időzítő a szünetet a beolvasás végének tekintheti. Az időzítő becslés. A lassú olvasó, a Bluetooth-késleltetés vagy a gyors gépíró a rossz oldalára eshet. Részesítse előnyben a beállított utótagot, amikor a munkafolyamatnak határozott végre van szüksége.
Egy ismert nyomtatható előtag az érték elolvasása után eltávolítható:
function withoutConfiguredPrefix(value, prefix) {
if (prefix && value.startsWith(prefix)) {
return value.slice(prefix.length)
}
return value
}
Csak az Ön által beállított előtagot adja át, például ']C1'. Ne vágjon le tetszőleges számú karaktert minden beolvasásból.
A teljes űrlaphoz, amely a Tabot, az üres bemenetet és a második beolvasást is kezeli, lásd a Hogyan tesztelhetők a vonalkódolvasók webes alkalmazásokban útmutatót.
Az előtagok és az utótagok beállítása
Az előtag és az utótag beállításai az olvasón vannak. A billentyűnevek és a módosítás módja gyártófüggő. Nincs olyan konfigurációs vonalkód, amely minden márkán működik, és ez az útmutató nem nyomtat ki ilyet.
Szokásos módszerek:
- Olvasson be egy konfigurációs vonalkódot pontosan annak a modellnek a kézikönyvéből. A lap beállítás szerint csoportosít: utótag, előtag, billentyűzetkiosztás, szimbólumrendszer.
- Használja a gyártó konfigurációs programját, majd írja az eredményt az olvasóra USB-n keresztül.
- Használja az adott termékcsalád eszközkezelő segédprogramját, amikor sok egységet frissít.
A változtatás után olvasson be egy ismert vonalkódot, és vesse össze az eredményt a kézikönyv leírásával a választott beállításról. Más márka gyári visszaállítása hagyhatja az olvasót változatlanul, vagy váratlan módba teheti. A Vonalkódolvasó beállítási útmutatója összefoglalja a beállításokat, amelyek általában számítanak. Nem helyettesíti a kézikönyvet.
A Barcode Scanner Emulator begépelhet egy Ön által választott értéket, majd küldhet ENTER-t, TAB-ot vagy utótag nélkül. Tegyen nyomtatható előtagot abba az értékbe, amikor az előtagkezelést hardver nélkül kell gyakorolnia. Az emulátor nem bocsát ki soros CR/LF bájtpárt, és nem olvas címkét.
Az előtag és az utótag viselkedésének tesztelése
Használjon billentyűzetmódban lévő olvasót, USB HID keyboard vagy Bluetooth HID keyboard.
- Csatlakoztassa, és várjon, amíg jelzi, hogy van tápellátása.
- Nyissa meg a vonalkódbevitel-tesztelőt.
- Kattintson a Start Test elemre, vagy kattintson a beolvasási területre. Kékre vált, amikor kész. Az oldal magától nem veszi el a fókuszt.
- Olvasson be egy vonalkódot, amelynek a tartalmát már ismeri.
- Olvassa el a rögzített értéket és a karakterszámot. A nyomtatható előtag- vagy utótagkarakterek a karakterláncban vannak. A Prefix sor a nevesített billentyűknek szól, amelyek az első karakter előtt érkeznek, például egy módosítónak. Nem húz ki begépelt előtagot, például
]C1-et, a vonalkódszövegből. - Ellenőrizze az utótagot. A tesztelő ENTER, TAB vagy None értéket jelent. Bekapcsolt Auto capture mellett az eredmény az Enter, a Tab vagy egy rövid szünet után jelenik meg, amint a billentyűk megállnak. Kapcsolja ki az Auto capture funkciót, hogy a rögzítés megmaradjon, amíg a Stop gombot meg nem nyomja. Az Enter és a Tab nem része a vonalkód karakterláncának.
- Vesse össze az eredményt a tervezett beállítással. Ezután nyissa meg a billentyűzetesemény-tesztelőt, és olvasson be újra, amikor minden
keydowneseményre sorrendben szüksége van, akey, acodeés az időzítés mellett.
A beviteltesztelő azokat a billentyűzeteseményeket rögzíti, amelyeket a böngésző lát. Soros portot nem tud olvasni, ezért a CR-t és az LF-et nem tudja nyers bájtként megjeleníteni. Az ékelésteszt nem bizonyítja, hogy egy soros beállítás mit fog küldeni.
Hibaelhárítás
Az olvasó nem küld ENTER-t. A vonalkód megjelenik, és a kurzor a mezőben marad. A beviteltesztelő None értéket jelent. Az utótag ki van kapcsolva, vagy nem Enterre van állítva. Lásd: A vonalkódolvasóról hiányzik az ENTER.
A TAB váratlanul áthelyezi a fókuszt. Az olvasó a Tab billentyűt küldi. Ez a beállított utótag. Használjon Entert, amikor az űrlapnak el kell mennie, vagy olvassa az értéket a Tab keydown eseményén, amikor a munkafolyamatnak tovább kell lépnie. A részletek az ENTER és TAB utótagok útmutatóban vannak.
Az űrlap kétszer küldődik el. A böngésző Enterre küld, és egy keydown figyelő is elfogadja a beolvasást. Tartson meg egy befejezési utat, és a másikon hívja a preventDefault() függvényt.
Előtag jelenik meg a vonalkódban. A nyomtatható előtag a rögzített karakterlánc része. Vagy kapcsolja ki az olvasón, vagy távolítsa el pontosan azt a sorozatot az alkalmazásban. A bekapcsolt szimbólumazonosító gyakori forrása a kezdő ] jelnek és még két karakternek. A vezérlőelőtag, amelyet az ékelés nem tud begépelni, hiányzik, nem pedig látható.
A karakterek hibásak. Az olvasó kiosztása és az operációs rendszer kiosztása eltérhet, ami megváltoztatja az előtagkaraktereket és az írásjeleket, miközben a hossz ugyanaz marad. Lásd: A vonalkódolvasó billentyűzetkiosztása hibás.
Az alkalmazás soha nem látja a beolvasás végét. Nincs utótag, és az oldal Enterre vár. Adjon hozzá az űrlaphoz illő utótagot, vagy fejezze be az értéket kifejezett művelettel. Az időzítésre tett tipp kihagy néhány valódi beolvasást, és elfogad némi gépelést.
A CR/LF alkalmazásonként eltér. A Notepad új sort illeszt be, amikor Entert kap. A webes szövegmező megtartja a vonalkódot, és billentyűeseményt indít. A soros program kaphat 0x0D-t, 0x0A-t vagy mindkettőt. Vesse össze a csatolót, mielőtt megváltoztatná az olvasót. Ha egyetlen alkalmazás sem kap karaktert, kezdje itt: A vonalkódolvasó nem működik.
A fókusz, az ismételt beolvasások és a POS-folyamatok szélesebb áttekintése a A vonalkódolvasó bemenetének tesztelése útmutatóban van.
Tesztmátrix
A beállítás oszlopa az, amit az olvasón beállít, vagy amit az emulátorral begépel, amikor az eset billentyűzetes utótag. A várt viselkedés az, amit az alkalmazásnak tennie kell. A soros CRLF eset nem ugyanaz a teszt, mint az Enter billentyű a böngészőben.
| Beállítás | Várt alkalmazásviselkedés |
|---|---|
| Nincs előtag, nincs utótag | A vonalkódérték megérkezik, és nem jön befejező billentyű. Az érték elérhető marad, amíg az alkalmazás el nem olvassa. |
| Nincs előtag, ENTER utótag | Az alkalmazás egyszer megkapja a befejező billentyűt, és lezáró karakter nélkül tárolja a tartalmat. |
| Nincs előtag, TAB utótag | A fókusz a következő vezérlőre kerülhet. Az alkalmazás a mozgatás előtt olvassa az értéket. |
| Egyedi nyomtatható előtag | Az előtag karakterei a dekódolt adatok előtt jelennek meg. Az alkalmazás szándékosan megtartja vagy eltávolítja pontosan azt az előtagot. |
| Egyedi nyomtatható utótag | Az utótag karakterei a dekódolt adatok után jelennek meg. Az Enter és a Tab billentyű, ezért nem jelennek meg a karakterláncban. |
| CRLF-sorozat | A soros vagy a terminálgazda feldolgozza a beállított CR és LF bájtokat. A böngésző szövegmezője Enter-lenyomásból nem kapja meg ezeket a bájtokat. |
Futtassa a billentyűzetsorokat az ékeléses olvasón, és ha nincs hardver, az emulátor ENTER, TAB és utótag nélküli beállításaival. A CRLF sort azon a csatolón futtassa, amelynek ezeket a bájtokat kell vinnie. A tényleges eredmények továbbra is ettől a csatolótól és az alkalmazástól függenek.