قارئ الباركود في نقطة بيع تعمل بالمتصفح: التركيز وEnter والعربية
باختصار: معظم قارئات الباركود التي تُوصل بمنفذ USB في المحلات تعمل كأنها لوحة مفاتيح: تكتب أرقام الباركود في الحقل المركّز عليه بسرعة كبيرة ثم ترسل غالباً ضغطة Enter. لذلك يمكن لنقطة بيع تعمل في المتصفح أن تستقبل القراءة دون أي برنامج إضافي. لكن ثلاث مشكلات تتكرر: الحقل غير مركّز فتضيع القراءة، أو Enter يرسل النموذج كله، أو لوحة المفاتيح العربية مفعّلة فتتحول الرموز التي فيها حروف لاتينية إلى حروف عربية. الحل: حقل مخصص للمسح يبقى مركّزاً، والتقاط Enter بنفسك، وقراءة KeyboardEvent.code حين يلزم، والتحقق من الرمز قبل إضافته للفاتورة.
الموقف في محل حقيقي
محل مواد غذائية في الزرقاء انتقل من برنامج نقطة بيع قديم إلى نظام يعمل في المتصفح على حاسوب الكاشير. اشترى قارئ باركود يوصل بـ USB، وجرّبه في المفكرة فكتب الأرقام بنجاح. لكن في شاشة البيع حدثت أمور غريبة:
- أحياناً تُمسح السلعة فلا يحدث شيء، لأن مؤشر الكتابة كان في حقل آخر أو خارج الصفحة.
- أحياناً تُضاف السلعة ثم تُرسل الفاتورة فوراً قبل أن يكمل الكاشير.
- بعض أصناف المورّد التي يحتوي رمزها حروفاً، مثل SKU داخلي، تظهر بحروف عربية غريبة ولا يجدها البحث.
كل هذه المشكلات من طبيعة القارئ كلوحة مفاتيح، لا من عطل فيه.
كيف يعمل القارئ «كلوحة مفاتيح»
القارئ في هذا الوضع يرسل إلى الحاسوب ضغطات مفاتيح، تماماً كما لو كتب شخص الأرقام بسرعة عالية جداً. المتصفح لا يعرف أنها قادمة من قارئ. لهذا:
- القراءة تذهب إلى العنصر المركّز عليه الآن، أياً كان.
- كثير من القارئات تضيف بعد الرمز لاحقة، غالباً Enter، ويمكن تغييرها من إعدادات القارئ عادة بمسح باركود إعداد من دليله.
- ما يظهر من «أحرف» يعتمد على تخطيط لوحة المفاتيح المفعّل في النظام.
المشكلة الأولى: الحقل غير مركّز
اجعل في شاشة البيع حقلاً واحداً واضحاً للمسح، كبيراً في أعلى الشاشة، بعنوان مثل «امسح الباركود أو اكتبه». ثم:
- ضع عليه التركيز عند فتح الشاشة.
- أعد التركيز إليه بعد كل إضافة صنف، وبعد إغلاق أي نافذة منبثقة.
- اعرض مؤشراً بصرياً واضحاً، كإطار أخضر، حين يكون الحقل جاهزاً للمسح، ورمادياً حين لا يكون.
هذا يحل معظم حالات «مسحت ولم يحدث شيء».
المشكلة الثانية: Enter يرسل الفاتورة
إن كان حقل المسح داخل نموذج HTML، فضغطة Enter من القارئ قد ترسل النموذج. التقط Enter بنفسك في حقل المسح. توثيق MDN لخاصية KeyboardEvent.key يعرض مثالاً لمعالجة المفاتيح بالاسم، ومنها "Enter". ويعرض توثيق حدث keydown في MDN طريقة لتجاهل الأحداث التي تكون جزءاً من تركيب نص عبر محرر الإدخال IME، بفحص isComposing.
مثال توضيحي:
const scan = document.querySelector('#scan');
scan.addEventListener('keydown', (e) => {
if (e.isComposing) return;
if (e.key === 'Enter') {
e.preventDefault();
const code = normalizeCode(scan.value);
scan.value = '';
if (code) addItemByBarcode(code);
}
});
بهذا تصبح Enter «أضف هذا الصنف»، لا «أرسل الفاتورة». واجعل زر إتمام البيع زراً منفصلاً يضغطه الكاشير بيده.
المشكلة الثالثة: لوحة المفاتيح العربية
حين يكون التخطيط العربي مفعّلاً، فالقارئ يرسل ضغطات المفاتيح نفسها، لكن النظام يحولها إلى الحروف المقابلة في التخطيط العربي. الأرقام غالباً تبقى سليمة، أما الرموز التي فيها حروف لاتينية فتظهر حروفاً عربية.
هنا تفيد خاصية KeyboardEvent.code. توضح MDN أنها تمثل المفتاح الفعلي على لوحة المفاتيح، لا الحرف الناتج عن الضغط، وأن قيمتها لا تتغير بتخطيط لوحة المفاتيح ولا بحالة مفاتيح التعديل. ومثالها أن القيمة KeyQ تخص مفتاح Q في تخطيط QWERTY. وتنبه MDN في المقابل إلى أن key هي الخاصية الصحيحة لمعرفة الحرف الذي يقصده المستخدم، وأن code ليست مدعومة بالكامل في كل المتصفحات.
لذلك، في حقل المسح تحديداً، يمكن بناء الرمز من قيم code، مثل تحويل KeyA إلى A وDigit5 إلى 5، بدل الاعتماد على الحرف الظاهر. وهذا مقبول لأن القارئ يكتب دائماً بالتخطيط الإنجليزي المفترض. لكن لا تستخدم هذه الطريقة في حقول يكتب فيها البشر بالعربية.
حل أبسط إن لم يرد المطور ذلك: تأكد أن حاسوب الكاشير يبدأ بالتخطيط الإنجليزي، أو اجعل رموز الأصناف رقمية فقط.
الكتابة اليدوية بجانب المسح
ليس كل صنف يحمل باركوداً سليماً. الخضار والفواكه بالوزن، والملصقات الممزقة، والأصناف المحلية بلا رمز، كلها تحتاج طريقة أخرى. اجعل حقل المسح نفسه يقبل كتابة الرمز يدوياً أو جزءاً من اسم الصنف، واعرض نتائج البحث تحته فوراً. وأضف أزراراً سريعة للأصناف الأكثر بيعاً دون باركود، مثل الخبز أو الكيس، حتى لا يبحث الكاشير عنها في كل مرة.
ومن المفيد أن يسجل النظام إن كان الصنف أُضيف بالمسح أم بالكتابة. إن تكررت الكتابة اليدوية لصنف معين، فربما ملصقه تالف أو رمزه غير مسجل في القائمة، وهذا شيء يُصلح مرة واحدة بدل أن يُعاد كل يوم.
تحقق من الرمز قبل إضافته
القراءة الخاطئة نادرة لكنها تحدث، وقد يكتب الكاشير بيده أيضاً. قبل إضافة الصنف:
- نظّف الرمز من المسافات.
- حوّل الأرقام العربية الهندية إلى غربية إن وُجدت.
- ابحث عنه في قائمة الأصناف.
- إن لم يوجد، اعرض رسالة واضحة بصوت تنبيه مميز، ولا تضف شيئاً.
- إن مُسح الصنف نفسه مرتين متتاليتين بسرعة غير طبيعية، فاسأل: هل هي قطعتان أم قراءة مكررة؟
مثال توضيحي لإعداد القارئ
مثال توضيحي لما تتفق عليه مع المورد أو تضبطه من دليل القارئ:
- الوضع: محاكاة لوحة مفاتيح عبر USB.
- اللاحقة: Enter.
- بلا بادئة، أو بادئة مميزة إن أردت أن يميز النظام القراءة الآلية عن الكتابة اليدوية.
- التخطيط المفترض: إنجليزي أمريكي.
احتفظ بورقة باركودات الإعداد في درج الكاشير، لأن القارئ قد يُعاد ضبطه بالخطأ إذا مُسح باركود إعداد مطبوع على علبة أو دليل. واكتب عليها تاريخ آخر ضبط واسم من قام به.
أسئلة شائعة
هل أحتاج إلى برنامج تشغيل للقارئ؟
في وضع محاكاة لوحة المفاتيح، لا يحتاج المتصفح إلى شيء خاص؛ يرى القراءة كضغطات مفاتيح. راجع دليل جهازك للتأكد من الوضع.
لماذا تظهر بعض الرموز بحروف عربية؟
لأن تخطيط لوحة المفاتيح العربي مفعّل. استخدم KeyboardEvent.code في حقل المسح، أو اجعل التخطيط الإنجليزي هو الافتراضي على جهاز الكاشير.
لماذا تُرسل الفاتورة بعد كل مسح؟
لأن القارئ يرسل Enter بعد الرمز، والحقل داخل نموذج. التقط Enter وامنع السلوك الافتراضي.
هل يعمل هذا على جهاز لوحي؟
قارئات البلوتوث في وضع لوحة المفاتيح تعمل بالفكرة نفسها، لكن لوحة المفاتيح على الشاشة قد تختفي أو تظهر بشكل مزعج. اختبر على جهازك قبل الاعتماد.
إذا كانت نقطة البيع في متجرك تضيّع قراءات الباركود أو تخلط الرموز، تواصل معنا لنضبط شاشة البيع مع القارئ.