Barcode Scanner Emulator
Barkod Okuyucuda Önek ve Sonek: Tam Kılavuz
Önek, barkod okuyucunun çözümlenen barkoddan önce gönderdiği veri veya denetim dizisidir. Sonek, okuyucunun bu değerden sonra gönderdiğidir. Aynı model farklı önek ve soneklere ayarlanabilir; seri bir okuyucu bunları bir keyboard wedge okuyucuyla aynı biçimde iletmez.
Barkod okuyucu öneki, çözümlenen değerden önce gönderilir. Sonek ondan sonra gönderilir. Bir okuyucu şu diziyi üretebilir:
Önek: STX
Barkod: 123456789
Sonek: ENTER
Kılavuzdaki STX çoğu zaman denetim karakteridir; S, T ve X harfleri değildir. Keyboard wedge okuyucuda ENTER genellikle Enter tuşudur; metin alanına eklenen CR ve LF karakterleri değildir. Hangisini alacağınız modele, arayüze ve uygulamaya bağlıdır. Hiçbir ayar her aygıt için geçerli değildir.
Barkod Okuyucularda ENTER ve TAB Sonekleri kılavuzu bu iki sonlandırıcıyı seçmeye ve sorun gidermeye odaklanır. Bu kılavuz barkodun çerçevesi hakkındadır: önce ne gelir, sonra ne gelir ve bir web uygulaması ikisini de nasıl okumalıdır.
Barkod Okuyucu Öneki Nedir?
Önek, okuyucunun yükten önce ilettiği yapılandırılmış bir dizidir. Yük, sembolojinin çözümlediği metindir; örneğin 123456789. Okuyucu eklemek üzere ayarlanmadıysa önek bu çözümlemenin parçası değildir.
Yaygın kullanımlar:
- İletinin başlangıcını işaretlemek. Seri ve terminal protokolleri bazen, çoğu zaman STX denen bir denetim karakteri gönderir; böylece ana bilgisayar yeni bir çerçevenin başladığını bilir.
- Sembolojiyi adlandırmak. AIM semboloji tanımlayıcısı açıksa okuyucu, rakamlardan önce Code 128 için
]C1veya EAN için]E0gibi kısa, yazdırılabilir bir önek gönderebilir. Uygulama bu tanımlayıcıya göre dallanabilir. - Eski POS veya terminal yazılımında girişi yönlendirmek. Veriden önceki sabit bir kod, ana bilgisayara taramanın hangi alana veya aygıta ait olduğunu söylerdi.
- Belirli bir istasyonu etiketlemek. İki okuyucuya farklı yazdırılabilir önekler verilebilir; böylece bir günlük hangi şeridin kodu gönderdiğini gösterebilir.
Yazdırılabilir önek sıradan karakterlerdir. Metin alanında dizinin başında görünürler. STX (0x02) gibi bir denetim karakteri öneki, S, T ve X harfleri değildir. Keyboard wedge okuyucu bu denetim karakterini hiç yazamayabilir. Seri okuyucu onu bayt olarak gönderebilir. Birini veya diğerini bekleyen kod yazmadan önce elinizdeki modelin kılavuzunu okuyun.
Önek, girişi bir okuyucunun ürettiğini kanıtlamaz. Bir kişi, bir makro veya Barcode Scanner Emulator aynı karakterleri yazabilir. Öneki yapılandırdığınız bir çerçeve olarak ele alın, sonra yükü başka herhangi bir kullanıcı girişi gibi doğrulayın.
Barkod Okuyucu Soneki Nedir?
Sonek, yükten sonra gönderilen yapılandırılmış bir dizidir. Alışılmış işi, uygulamaya taramanın bittiğini söylemek veya odağı taşımaktır. Okuyucular farklıdır. Kimisi Enter, Tab, CR, LF, CR+LF, özel bir dize veya hiçbir şey sunar. Kimisi bunlardan yalnızca birini veya ikisini sunar.
ENTER. Enter tuşu. Tarayıcıda bu bir klavye olayıdır, event.key === "Enter". Normal bir metin girişine eklenmez.
TAB. Tab tuşu, event.key === "Tab". Tarayıcı odağı sonraki denetime taşır. Tuş alana eklenmez.
CR. Satır başı, ASCII 0x0D. Seri veya terminal arayüzünde bu, yükten sonra gerçek bir bayt olabilir. Keyboard wedge üzerinde CR veya satır başı etiketli bir ayar genellikle Enter tuşu demektir. Tarayıcı yine Enter bildirir. Alan değeri bir CR karakteri kazanmaz.
LF. Satır besleme, ASCII 0x0A. CR’den farklı bir denetim karakteridir. Seri akışta kendi baytı olabilir. Keyboard wedge okuyucunun Enter ve Tab gibi standart bir Satır Besleme tuşu yoktur. LF adlı bir menü öğesinin görünür bir karakter veya ikinci bir Enter yazdığını varsaymayın.
CRLF. CR ve ardından LF, iki bayt 0x0D 0x0A. Bazı seri ve terminal ana bilgisayarları satır sonu olarak bu çifti bekler. Birisi Enter’a bastığında tarayıcı metin alanı bu çifti saklamaz.
Özel karakterler. # veya kısa bir kod gibi yazdırılabilir bir sonek barkoddan sonra yazılır; uygulama kaldırmazsa dizinin parçası olur. Özel bir denetim karakteri STX ile aynı ayrımı izler: seri bağlantı noktasında baytlar, wedge üzerinde tuş vuruşları ve yalnızca klavye arayüzünün gerçekten gönderebildiği tuş vuruşları.
ENTER, CR ve LF kılavuzlarda satır sonu için birbiriyle ilişkili adlardır. Her uygulamada birbirinin yerine geçmez. Wedge okuyucu, seri okuyucu, Notepad ve bir web formu, aynı adlı bir ayar için farklı sonuç gösterebilir.
Önek ve Sonek
| Özellik | Önek | Sonek |
|---|---|---|
| Konum | Barkod verisinden önce | Barkod verisinden sonra |
| Amaç | Başlangıcı işaretlemek veya girişi etiketlemek | Tamamlanmayı işaretlemek veya bir eylem tetiklemek |
| Örnek | STX veya ]C1 gibi yazdırılabilir bir AIM tanımlayıcısı |
ENTER, TAB veya # gibi yazdırılabilir bir karakter |
| Yaygın kullanım | Taramayı çerçevelemek veya tanımak | Form göndermek veya odağı taşımak |
| Metin alanında | Yazdırılabilir karakterler değerin başında durur | Yazdırılabilir karakterler değerin sonunda durur. Enter ve Tab durmaz |
| Kimlik | Herkesin yazabileceği yapılandırılmış bir işaret | Herkesin yazabileceği yapılandırılmış bir işaret |
Bir öneki veya özel soneki yalnızca tam olarak o diziyi yapılandırdıysanız ve saklanan kayıt onu içermemeliyse çıkarın. Uygulamanın bunun için bir kuralı olana kadar AIM tanımlayıcısını yerinde bırakın.
ENTER, TAB, CR ve LF
Bu adlar yapılandırma sayfalarında görünür. Alan taraf, arayüze göre ya tuş vuruşları ya da baytlar görür. HID Keyboard Wedge kılavuzu tuş vuruşu yolunu anlatır. Seri bağlantı noktası farklı bir yoldur: uygulama baytları okur ve odak onların nereye gideceğini seçmez.
ENTER
Keyboard wedge okuyucuda ENTER, Enter tuşudur. Tek satırlık bir metin alanında güncel tarayıcılar bu tuşu çevreleyen formu göndermek için kullanır. Bir arama kutusu taramayı bu olayda kesinleştirebilir. Çok alanlı bir form, sonraki alanlar dolmadan gönderilebilir. Sayfa değeri tutup yerinde kalmalıysa submit olayında veya Enter keydown olayında preventDefault() çağırın. Enter’ı tek yerde işleyin. Taramayı ikisi de kabul eden bir keydown dinleyicisi ve bir submit dinleyicisi onu iki kez kaydeder.
Bazı okuyucular NumPad Enter gönderir. event.key yine "Enter" olur. event.code, "Enter" yerine "NumpadEnter" olabilir. Her iki tuş da alanı kesinleştirmeliyse event.key sınayın.
Barkod Okuyucularda ENTER ve TAB Sonekleri kılavuzu bu iki seçeneği POS ve web formları için karşılaştırır. Barkod Okuyucuda ENTER Eksik, barkodu yazıp sonra duran bir okuyucuyu ele alır.
TAB
TAB, Tab tuşudur. Tarayıcı odağı keydown sonrasında taşır. Alan hâlâ odaktayken değeri bu keydown işleyicisinde okuyun ve sonraki denetim imleci almalıysa varsayılan eylemi yerinde bırakın. preventDefault() odağı geçerli alanda tutar.
Shift+Tab, Shift basılıyken aynı tuştur. Okuyucunun Tab soneki, Shift olmadan Tab’dır. Klavye kullanıcıları formda geriye gidebilmeliyse event.shiftKey yok sayın.
CR
Satır başı, terminalde imleci satırın başına taşır. Bayt 0x0D değeridir. Seri okuyucu bu baytı yüke ekleyebilir. CR adlı bir keyboard wedge ayarı, metne 0x0D eklemek yerine tipik olarak Enter tuşunu gönderir. Tarayıcı girişinde Enter’a basmak input.value içine bir CR karakteri yazmaz.
Ana bilgisayar bir terminal veya COM bağlantı noktası dinleyicisiyse baytı arayın. Ana bilgisayar bir web sayfasıysa event.key === "Enter" arayın.
LF
Satır besleme, terminal imlecini bir satır aşağı taşır. Bayt 0x0A değeridir. Bazı ana bilgisayarlar tek başına LF’yi yeni satır sayar. Diğerleri, önce CR gelmedikçe yok sayar. Sonek olarak LF listeleyen bir wedge okuyucu, işletim sisteminin satır sonuna çevirmediği bir tuş gönderebilir veya metin alanının tutacağı hiçbir şey göndermeyebilir. Sözde bir LF’yi uygulama kodunda işlemeden önce tuşu Klavye Olayı Test Aracı içinde yakalayın.
CRLF
CRLF, önce CR sonra LF olan iki denetim dizisidir. Windows tarzı metin dosyaları ve birçok seri aygıt bunu tek bir yeni satır olarak kullanır. CRLF soneki diyen bir yapılandırma sayfası, okuyucunun kullandığı arayüzde yükten sonra bu çifti göndermeye çalışacağı anlamına gelir.
Tarayıcıda Enter’a basmak, bir metin girişinin içinde gerçek bir CRLF dizisi üretmez. Form bir klavye olayı alır. Bir <textarea>, kullanıcı Enter’a bastığında yeni satır ekleyebilir; bu yeni satır tarayıcının kendi düzenleme davranışıdır, okuyucunun 0x0D 0x0A baytlarını çıkardığının kanıtı değildir. Seri okuyucu bu iki baytı alabilir ve onları yalnızca o okuyucu göndermek üzere yapılandırıldıysa sonlandırıcı saymalıdır. İçermesine izin verilen bir yükün ortasından CR veya LF çıkarmayın.
Önekler ve Sonekler Web Uygulamalarını Nasıl Etkiler
Keyboard wedge taraması, odaktaki denetime bir tuş vuruşu patlamasıdır. Sayfa okuyucuyu açmaz. Odak başka bir alandaysa önek, barkod ve sonek oraya gider.
keydown, tarayıcı bir karakter eklemeden veya odağı taşımadan önce Enter ve Tab dahil her tuş için tetiklenir. event.key, işletim sistemi klavye düzenini uyguladıktan sonraki karakter veya tuş adıdır. Yazdırılabilir önek ve sonek karakterleri alanda input olayıyla görünür. Enter ve Tab görünmez.
Aşağıdaki dinleyici, Enter geldiğinde alanı kesinleştirir. Okuyucunun atladığı bir soneki eklemez. Okuyucu Enter göndermezse değer, başka bir şey onu okuyana kadar alanda kalır.
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 = ''
})
Taramadan önce #barcode alanına odaklanın. preventDefault(), üst bir formun ikinci kez gönderilmesini durdurur. Giriş bir formun içinde değilse ve yerel gönderimi istiyorsanız preventDefault() çağrısını çıkarın.
Sonek yoksa açık bir eylem bekleyin: bir düğme, operatörden sonraki bir Enter veya iş akışındaki sonraki adım. Bir hareketsizlik zamanlayıcısı duraklamayı taramanın sonu sayabilir. Bu zamanlayıcı bir sezgiseldir. Yavaş bir okuyucu, bir Bluetooth gecikmesi veya hızlı yazan biri onun yanlış tarafında kalabilir. İş akışı kesin bir son istiyorsa yapılandırılmış bir soneki yeğleyin.
Bilinen yazdırılabilir bir önek, değeri okuduktan sonra kaldırılabilir:
function withoutConfiguredPrefix(value, prefix) {
if (prefix && value.startsWith(prefix)) {
return value.slice(prefix.length)
}
return value
}
Yalnızca yapılandırdığınız öneki geçirin, örneğin ']C1'. Her taramadan keyfi sayıda karakter çıkarmayın.
Tab, boş giriş ve ikinci bir taramayı da işleyen tam bir form için Web Uygulamalarında Barkod Okuyucular Nasıl Test Edilir kılavuzuna bakın.
Önekler ve Sonekler Nasıl Yapılandırılır
Önek ve sonek ayarları okuyucudadır. Tuş adları ve bunları değiştirme yolu üreticiye özeldir. Her markada çalışan bir yapılandırma barkodu yoktur ve bu kılavuz bir tane basmaz.
Tipik yöntemler:
- Tam olarak o modelin kılavuzundan bir yapılandırma barkodu tarayın. Sayfa ayara göre gruplanır: sonek, önek, klavye düzeni, semboloji.
- Üreticinin yapılandırma programını kullanın, sonra sonucu USB üzerinden okuyucuya yazın.
- Çok sayıda birimi güncellerken o ürün hattının aygıt yönetim yardımcı programını kullanın.
Bir değişiklikten sonra bilinen bir barkod tarayın ve sonucu, seçtiğiniz ayarın kılavuzdaki açıklamasıyla karşılaştırın. Başka bir markanın fabrika sıfırlaması okuyucuyu değiştirmeden bırakabilir veya beklenmedik bir kipe sokabilir. Barkod Okuyucu Yapılandırma Kılavuzu genellikle önemli olan ayarları özetler. Kılavuzun yerini tutmaz.
Barcode Scanner Emulator seçtiğiniz bir değeri yazabilir, sonra ENTER, TAB veya sonek yok gönderebilir. Donanım olmadan önek işlemeyi denemeniz gerektiğinde bu değere yazdırılabilir bir önek koyun. Emülatör seri bir CR/LF bayt çifti çıkarmaz ve bir etiket okumaz.
Önek ve Sonek Davranışı Nasıl Test Edilir
Klavye kipindeki bir okuyucu kullanın: USB HID klavye veya Bluetooth HID klavye.
- Bağlayın ve gücünün olduğunu gösterene kadar bekleyin.
- Barkod Giriş Test Aracı sayfasını açın.
- Start Test düğmesine tıklayın veya tarama alanına tıklayın. Hazır olduğunda maviye döner. Sayfa odağı kendiliğinden almaz.
- Yükünü zaten bildiğiniz bir barkod tarayın.
- Yakalanan değeri ve karakter sayısını okuyun. Yazdırılabilir önek veya sonek karakterleri bu dizinin içindedir. Prefix satırı, bir değiştirici gibi ilk karakterden önce gelen adlandırılmış tuşlar içindir.
]C1gibi yazılmış bir öneki barkod metninden ayırmaz. - Soneki denetleyin. Test aracı ENTER, TAB veya None bildirir. Auto capture açıkken sonuç, tuşlar durduktan sonra Enter, Tab veya kısa bir duraklamanın ardından görünür. Yakalamayı Stop düğmesine basana kadar tutmak için Auto capture kapatın. Enter ve Tab barkod dizisinin parçası değildir.
- Bu sonucu amaçladığınız yapılandırmayla karşılaştırın. Sonra her
keydownolayını sırayla,key,codeve zamanlama dahil görmeniz gerektiğinde Klavye Olayı Test Aracı sayfasını açın ve yeniden tarayın.
Giriş test aracı, tarayıcının görebildiği klavye olaylarını kaydeder. Seri bağlantı noktası okuyamaz, bu yüzden CR veya LF’yi ham bayt olarak gösteremez. Bir wedge testi, seri bir ayarın ne göndereceğini kanıtlamaz.
Sorun Giderme
Okuyucu ENTER göndermiyor. Barkod görünür ve imleç alanda kalır. Giriş test aracı None bildirir. Sonek kapalıdır veya Enter dışında bir şeye ayarlıdır. Bkz. Barkod Okuyucuda ENTER Eksik.
TAB odağı beklenmedik biçimde taşıyor. Okuyucu Tab tuşunu gönderiyor. Bu, yapılandırılmış sonektir. Form gönderilmeliyse Enter kullanın veya iş akışı ilerlemeliyse değeri Tab keydown olayında okuyun. Ayrıntılar Barkod Okuyucularda ENTER ve TAB Sonekleri kılavuzundadır.
Form iki kez gönderiliyor. Tarayıcı Enter’da gönderir ve bir keydown dinleyicisi de taramayı kabul eder. Tek bir tamamlanma yolu tutun ve diğerinde preventDefault() çağırın.
Barkodun içinde bir önek görünüyor. Yazdırılabilir bir önek, yakalanan dizinin parçasıdır. Okuyucuda kapatın veya uygulamada tam olarak o diziyi kaldırın. Açık bir semboloji tanımlayıcısı, başta ] ve iki karakter daha görmenin yaygın kaynağıdır. Wedge’in yazamadığı bir denetim öneki görünmez; eksik kalır.
Karakterler yanlış. Okuyucu düzeni ile işletim sistemi düzeni uyuşmayabilir; bu, uzunluk aynı kalırken önek karakterlerini ve noktalama işaretlerini değiştirir. Bkz. Barkod Okuyucuda Yanlış Klavye Düzeni.
Uygulama taramanın sonunu hiç görmüyor. Sonek yok ve sayfa Enter bekliyor. Forma uyan bir sonek ekleyin veya değeri açık bir eylemle tamamlayın. Zaman tahmini bazı gerçek taramaları kaçırır ve bazı yazmaları kabul eder.
CR/LF uygulamalar arasında farklı. Notepad, Enter aldığında yeni satır ekler. Bir web metin girişi barkodu tutar ve bir tuş olayı tetikler. Seri bir program 0x0D, 0x0A veya ikisini birden alabilir. Okuyucuyu değiştirmeden önce arayüzü karşılaştırın. Hiçbir uygulama karakter almıyorsa Barkod Okuyucu Çalışmıyor ile başlayın.
Odak, yinelenen taramalar ve POS akışlarına daha geniş bir geçiş Barkod Okuyucu Girişi Nasıl Test Edilir kılavuzundadır.
Test Matrisi
Yapılandırma sütunu, okuyucuda ayarladığınız veya durum bir klavye sonekiyken emülatörle yazdığınız şeydir. Beklenen davranış, uygulamanın yapması gerekendir. Seri bir CRLF durumu, tarayıcıdaki bir Enter tuşuyla aynı test değildir.
| Yapılandırma | Beklenen uygulama davranışı |
|---|---|
| Önek yok, sonek yok | Barkod değeri alınır ve tamamlanma tuşu gelmez. Değer, uygulama okuyana kadar kullanılabilir kalır. |
| Önek yok, ENTER soneki | Uygulama tamamlanma tuşunu bir kez alır ve yükü sonlandırıcı karakter olmadan saklar. |
| Önek yok, TAB soneki | Odak sonraki denetime geçebilir. Uygulama değeri bu geçişten önce okur. |
| Özel yazdırılabilir önek | Önek karakterleri çözümlenen veriden önce görünür. Uygulama tam olarak bu öneki bilerek tutar veya kaldırır. |
| Özel yazdırılabilir sonek | Sonek karakterleri çözümlenen veriden sonra görünür. Enter ve Tab tuştur, bu yüzden dizide görünmez. |
| CRLF dizisi | Seri veya terminal ana bilgisayar, yapılandırılmış CR ve LF baytlarını işler. Tarayıcı metin alanı bu baytları bir Enter tuş basışından kazanmaz. |
Klavye satırlarını wedge okuyucuda ve donanım yokken emülatörün ENTER, TAB ve sonek yok ayarlarıyla çalıştırın. CRLF satırını bu baytları taşıması gereken arayüzde çalıştırın. Gerçek sonuçlar yine o arayüze ve uygulamaya bağlıdır.