تخطي إلى المحتوى

Barcode Scanner Emulator

البادئة في مقابل اللاحقة في ماسح الباركود: دليل كامل

البادئة بيانات أو تسلسل تحكم يرسله ماسح الباركود قبل الباركود المفكوك. اللاحقة ما يرسله بعد تلك القيمة. يمكن ضبط الطراز نفسه على بادئات ولاحقات مختلفة، والماسح التسلسلي لا يسلّمها بالطريقة نفسها التي يسلّمها ماسح الإسفين.

بادئة ماسح الباركود تُرسل قبل القيمة المفكوكة. اللاحقة تُرسل بعدها. قد ينتج ماسح واحد هذا التسلسل:

بادئة: STX

باركود: 123456789

لاحقة: ENTER

STX في الدليل يعني غالبًا محرف التحكم، لا الأحرف الثلاثة S وT وX. ENTER في ماسح الإسفين هو عادة مفتاح Enter، لا محرفي CR وLF المُدرجين في حقل نص. أيهما يصلك يعتمد على الطراز والواجهة والتطبيق. لا يوجد إعداد عام.

يبقى دليل لاحقات ENTER وTAB عند اختيار هذين المنهيين واستكشاف أخطائهما. هذا الدليل عن الإطار حول الباركود: ما يأتي قبله، وما يأتي بعده، وكيف ينبغي لتطبيق ويب أن يقرأ الاثنين.

ما بادئة ماسح الباركود؟

البادئة تسلسل مُهيأ يبثه الماسح قبل الحمولة. الحمولة هي النص الذي فكّه نظام الترميز، مثل 123456789. البادئة ليست جزءًا من ذلك الفك إلا إذا ضُبط الماسح لإضافتها.

استخدامات شائعة:

  • تعليم بداية الرسالة. ترسل بروتوكولات تسلسلية وطرفية أحيانًا محرف تحكم، يُسمى غالبًا STX، حتى يعرف المضيف أن إطارًا جديدًا قد بدأ.
  • تسمية نظام الترميز. عند تفعيل معرّف نظام الترميز AIM، يستطيع الماسح إرسال بادئة قصيرة قابلة للطباعة مثل ]C1 لـ Code 128 أو ]E0 لـ EAN قبل الأرقام. يستطيع التطبيق التفرع على ذلك المعرّف.
  • توجيه الإدخال في برامج POS أو طرفية أقدم. كان رمز ثابت قبل البيانات يخبر المضيف بأي حقل أو جهاز ينتمي المسح.
  • وسم محطة بعينها. يمكن إعطاء ماسحين بادئات قابلة للطباعة مختلفة حتى يُظهر السجل أي ممر أرسل الرمز.

البادئة القابلة للطباعة محارف عادية. تظهر في حقل النص في مقدمة السلسلة. بادئة محرف التحكم، مثل STX (0x02)، ليست الأحرف S وT وX. قد يعجز ماسح الإسفين عن كتابة محرف التحكم ذاك أصلًا. يستطيع الماسح التسلسلي إرساله كبايت. اقرأ دليل الطراز الذي لديك قبل أن تكتب رمزًا يتوقع أحدهما أو الآخر.

لا تثبت البادئة أن ماسحًا أنتج الإدخال. شخص أو ماكرو أو Barcode Scanner Emulator يستطيع كتابة المحارف نفسها. عامل البادئة كإطار هيأته، ثم تحقق من الحمولة بالطريقة التي تتحقق بها من أي إدخال مستخدم آخر.

ما لاحقة ماسح الباركود؟

اللاحقة تسلسل مُهيأ يُرسل بعد الحمولة. عملها المعتاد أن تخبر التطبيق أن المسح انتهى، أو أن تنقل التركيز. تختلف الماسحات. بعضها يتيح Enter وTab وCR وLF وCR+LF وسلسلة مخصصة أو لا شيء. بعضها يتيح واحدًا أو اثنين فقط من تلك.

ENTER. مفتاح Enter. في المتصفح هذا حدث لوحة مفاتيح، event.key === "Enter". لا يُدرج في حقل نص عادي.

TAB. مفتاح Tab، event.key === "Tab". ينقل المتصفح التركيز إلى عنصر التحكم التالي. لا يُدرج المفتاح في الحقل.

CR. إرجاع الحامل، ASCII 0x0D. على واجهة تسلسلية أو طرفية يمكن أن يكون بايتًا حقيقيًا بعد الحمولة. في الإسفين، إعداد باسم CR أو إرجاع الحامل يعني عادة مفتاح Enter. ما زال المتصفح يبلّغ Enter. قيمة الحقل لا تكتسب محرف CR.

LF. تغذية السطر، ASCII 0x0A. محرف تحكم مختلف عن CR. في تيار تسلسلي يمكن أن يكون بايته الخاص. ليس لإسفين لوحة المفاتيح مفتاح Line Feed قياسي بالطريقة التي يملك بها Enter وTab. لا تفترض أن بند قائمة باسم LF يكتب محرفًا مرئيًا أو Enter ثانيًا.

CRLF. CR يليه LF، البايتان 0x0D 0x0A. تتوقع بعض مضيفات التسلسل والطرفية ذلك الزوج كنهاية سطر. حقل نص في المتصفح لا يخزن ذلك الزوج عندما يضغط أحد Enter.

محارف مخصصة. تُكتب لاحقة قابلة للطباعة مثل # أو رمز قصير بعد الباركود، فتصير جزءًا من السلسلة إلا إذا أزالها التطبيق. يتبع محرف التحكم المخصص الانقسام نفسه الذي يتبعه STX: بايتات على منفذ تسلسلي، وضغطات على الإسفين، وفقط الضغطات التي تستطيع واجهة لوحة المفاتيح إرسالها فعلًا.

ENTER وCR وLF أسماء مترابطة لنهاية السطر في الأدلة. ليست قابلة للتبادل في كل تطبيق. ماسح إسفين وماسح تسلسلي وNotepad ونموذج ويب يمكن أن يُظهر كل منها نتيجة مختلفة لإعداد بالاسم نفسه.

البادئة في مقابل اللاحقة

الميزة البادئة اللاحقة
الموضع قبل بيانات الباركود بعد بيانات الباركود
الغرض تعليم البداية أو وسم الإدخال تعليم الاكتمال أو إطلاق إجراء
مثال STX، أو معرّف AIM قابل للطباعة مثل ]C1 ENTER أو TAB أو محرف قابل للطباعة مثل #
الاستخدام الشائع تأطير المسح أو تعريفه إرسال نموذج أو نقل التركيز
في حقل النص المحارف القابلة للطباعة تجلس في بداية القيمة المحارف القابلة للطباعة تجلس في النهاية. Enter وTab لا يفعلان ذلك
الهوية علامة مُهيأة يستطيع أي شخص كتابتها علامة مُهيأة يستطيع أي شخص كتابتها

أزل بادئة أو لاحقة مخصصة فقط عندما هيأت ذلك التسلسل بعينه ولا ينبغي للسجل المخزن أن يتضمنه. اترك معرّف AIM في مكانه إلى أن يملك التطبيق قاعدة له.

ENTER وTAB وCR وLF

تظهر هذه الأسماء في أوراق التهيئة. يرى الطرف المستلم إما ضغطات أو بايتات، بحسب الواجهة. يصف دليل إسفين لوحة مفاتيح HID مسار الضغطات. المنفذ التسلسلي مسار مختلف: يقرأ التطبيق البايتات، والتركيز لا يختار وجهتها.

ENTER

في ماسح الإسفين، ENTER هو مفتاح Enter. داخل حقل نص من سطر واحد، تستخدم المتصفحات الحالية ذلك المفتاح لإرسال النموذج المحيط. يستطيع مربع بحث تثبيت المسح عند ذلك الحدث. يستطيع نموذج متعدد الحقول أن يُرسل قبل ملء الحقول اللاحقة. استدعِ preventDefault() على حدث submit، أو على keydown لمفتاح Enter، عندما ينبغي للصفحة أن تحتفظ بالقيمة وتبقى مكانها. عالج Enter في موضع واحد. مستمع keydown ومستمع submit يقبلان المسح كلاهما سيسجلانه مرتين.

ترسل بعض الماسحات NumPad Enter. يبقى event.key هو "Enter". قد يكون event.code هو "NumpadEnter" لا "Enter". اختبر event.key إذا كان ينبغي للمفتاحين تثبيت الحقل.

يقارن دليل لاحقات ENTER وTAB هذين الخيارين لـ POS ونماذج الويب. يغطي ماسح الباركود يفتقد ENTER ماسحًا يكتب الباركود ثم يتوقف.

TAB

TAB هو مفتاح Tab. ينقل المتصفح التركيز بعد keydown. اقرأ الحقل في معالج keydown ذاك، بينما ما زال يملك التركيز، واترك الإجراء الافتراضي في مكانه عندما ينبغي لعنصر التحكم التالي أن يستلم المؤشر. يُبقي preventDefault() التركيز على الحقل الحالي.

Shift+Tab هو المفتاح نفسه مع ضغط Shift. لاحقة Tab في الماسح هي Tab بلا Shift. تجاهل event.shiftKey إذا كان ينبغي لمستخدمي لوحة المفاتيح أن يستطيعوا الرجوع عبر النموذج.

CR

ينقل إرجاع الحامل المؤشر إلى بداية السطر في الطرفية. البايت هو 0x0D. يستطيع ماسح تسلسلي إلحاق ذلك البايت بالحمولة. إعداد إسفين باسم CR يرسل عادة مفتاح Enter بدل إدراج 0x0D في النص. الضغط على Enter في حقل متصفح لا يكتب محرف CR في input.value.

إذا كان المضيف طرفية أو مستمع منفذ COM، فابحث عن البايت. إذا كان المضيف صفحة ويب، فابحث عن event.key === "Enter".

LF

تنقل تغذية السطر مؤشر الطرفية سطرًا واحدًا إلى الأسفل. البايت هو 0x0A. تعامل بعض المضيفات LF وحده كسطر جديد. يتجاهله غيرها إلا إذا جاء CR أولًا. ماسح إسفين يسرد LF كلاحقة قد يرسل مفتاحًا لا يحوّله نظام التشغيل إلى فاصل سطر، أو قد لا يرسل شيئًا يحتفظ به حقل النص. التقط المفتاح في فاحص أحداث لوحة المفاتيح قبل أن تعالج LF مفترضًا في رمز التطبيق.

CRLF

CRLF هو تسلسل التحكمين CR ثم LF. تستخدمه ملفات النص بأسلوب Windows وكثير من الأجهزة التسلسلية كسطر جديد واحد. صفحة تهيئة تقول لاحقة CRLF تعني أن الماسح سيحاول إرسال ذلك الزوج بعد الحمولة على الواجهة التي يستخدمها.

في المتصفح، الضغط على Enter لا ينتج تسلسل CRLF حرفيًا داخل حقل نص. يستلم النموذج حدث لوحة مفاتيح. قد يدرج <textarea> سطرًا جديدًا عندما يضغط المستخدم Enter، وذلك السطر الجديد سلوك تحرير خاص بالمتصفح، لا دليل على أن الماسح بعث البايتين 0x0D 0x0A. يستطيع قارئ تسلسلي استلام هذين البايتين وينبغي أن يعاملهما كمنهِ فقط إذا هُيئ ذلك الماسح لإرسالهما. لا تنزع CR أو LF من وسط حمولة يُسمح لها أن تحتويهما.

كيف تؤثر البادئات واللاحقات في تطبيقات الويب

مسح الإسفين دفقة ضغطات في عنصر التحكم المركّز. الصفحة لا تفتح الماسح. إذا كان التركيز على حقل آخر، تذهب البادئة والباركود واللاحقة كلها إلى هناك.

ينطلق keydown لكل مفتاح، بما في ذلك Enter وTab، قبل أن يدرج المتصفح محرفًا أو ينقل التركيز. event.key هو المحرف أو اسم المفتاح بعد أن يطبّق نظام التشغيل تخطيط لوحة المفاتيح. تظهر محارف البادئة واللاحقة القابلة للطباعة في الحقل عبر حدث input. Enter وTab لا يظهران.

يثبّت المستمع أدناه الحقل عندما يصل Enter. لا يضيف لاحقة أغفلها الماسح. إذا لم يرسل الماسح Enter، تبقى القيمة في الحقل إلى أن يقرأها شيء آخر.

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

ركّز #barcode قبل المسح. يوقف preventDefault() نموذجًا سلفًا عن الإرسال مرة ثانية. إذا لم يكن الإدخال داخل نموذج وتريد الإرسال الأصلي، فاحذف preventDefault().

من دون لاحقة، انتظر إجراءً صريحًا: زرًا، أو Enter لاحقًا من المشغّل، أو الخطوة التالية في سير العمل. يستطيع مؤقت خمول أن يعامل التوقف كنهاية المسح. ذلك المؤقت حدس. ماسح بطيء أو تأخير Bluetooth أو كاتب سريع يمكن أن يقع على الجانب الخطأ منه. فضّل لاحقة مُهيأة عندما يحتاج سير العمل إلى نهاية محددة.

يمكن إزالة بادئة معروفة قابلة للطباعة بعد قراءة القيمة:

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

مرّر فقط البادئة التي هيأتها، مثل ']C1'. لا تنزع عددًا اعتباطيًا من المحارف من كل مسح.

لنموذج كامل يعالج أيضًا Tab والإدخال الفارغ ومسحًا ثانيًا، انظر كيفية اختبار ماسحات الباركود في تطبيقات الويب.

كيف تهيئ البادئات واللاحقات

إعدادات البادئة واللاحقة تعيش على الماسح. أسماء المفاتيح وطريقة تغييرها خاصة بالشركة المصنّعة. لا يوجد باركود تهيئة يعمل على كل علامة تجارية، وهذا الدليل لا يطبع واحدًا.

طرق معتادة:

  • امسح باركود تهيئة من دليل ذلك الطراز بعينه. تُجمَّع الورقة حسب الإعداد: لاحقة، بادئة، تخطيط لوحة المفاتيح، نظام الترميز.
  • استخدم برنامج التهيئة لدى البائع، ثم اكتب النتيجة إلى الماسح عبر USB.
  • استخدم أداة إدارة الأجهزة لخط المنتج ذاك عندما تحدّث وحدات كثيرة.

بعد التغيير، امسح باركودًا معروفًا وقارن النتيجة بوصف الدليل للإعداد الذي اخترته. إعادة ضبط المصنع من علامة مختلفة قد تترك الماسح بلا تغيير أو تضعه في وضع غير متوقع. يلخص دليل تهيئة ماسح الباركود الإعدادات التي تهم عادة. لا يغني عن الدليل.

يستطيع Barcode Scanner Emulator كتابة قيمة تختارها ثم إرسال ENTER أو TAB أو بلا لاحقة. ضع بادئة قابلة للطباعة في تلك القيمة عندما تحتاج إلى تمرين معالجة البادئة بلا عتاد. لا يبعث المحاكي زوج بايت CR/LF تسلسليًا، ولا يقرأ ملصقًا.

كيف تختبر سلوك البادئة واللاحقة

استخدم ماسحًا في وضع لوحة المفاتيح، USB HID keyboard أو Bluetooth HID keyboard.

  1. صِله وانتظر حتى يُظهر أن له طاقة.
  2. افتح فاحص إدخال الباركود.
  3. انقر Start Test، أو انقر منطقة المسح. يتحول إلى الأزرق عندما يكون جاهزًا. الصفحة لا تأخذ التركيز من تلقاء نفسها.
  4. امسح باركودًا تعرف حمولته مسبقًا.
  5. اقرأ القيمة الملتقطة وعدد المحارف. محارف البادئة أو اللاحقة القابلة للطباعة داخل تلك السلسلة. سطر Prefix لمفاتيح مسماة تصل قبل المحرف الأول، مثل معدّل. لا يسحب بادئة مكتوبة مثل ]C1 من نص الباركود.
  6. تحقق من اللاحقة. يبلّغ الفاحص عن ENTER أو TAB أو None. مع تشغيل Auto capture، تظهر النتيجة بعد Enter أو Tab أو توقف قصير حالما تتوقف المفاتيح. أوقف Auto capture لتثبيت الالتقاط حتى تضغط Stop. Enter وTab ليسا جزءًا من سلسلة الباركود.
  7. قارن تلك النتيجة بالتهيئة التي قصدتها. ثم افتح فاحص أحداث لوحة المفاتيح وامسح مرة أخرى عندما تحتاج كل keydown بالترتيب، بما في ذلك key وcode والتوقيت.

يسجّل فاحص الإدخال أحداث لوحة المفاتيح التي يستطيع المتصفح رؤيتها. لا يستطيع قراءة منفذ تسلسلي، لذلك لا يستطيع إظهار CR أو LF كبايتات خام. اختبار الإسفين لا يثبت ما سيرسله إعداد تسلسلي.

استكشاف الأخطاء

الماسح لا يرسل ENTER. يظهر الباركود ويبقى المؤشر في الحقل. يبلّغ فاحص الإدخال None. اللاحقة متوقفة، أو مضبوطة على شيء غير Enter. انظر ماسح الباركود يفتقد ENTER.

ينقل TAB التركيز على غير المتوقع. الماسح يرسل مفتاح Tab. تلك هي اللاحقة المُهيأة. استخدم Enter عندما ينبغي للنموذج أن يُرسل، أو اقرأ القيمة عند keydown لـ Tab عندما ينبغي لسير العمل أن يتقدم. التفاصيل في دليل لاحقات ENTER وTAB.

يُرسل النموذج مرتين. يُرسل المتصفح عند Enter، ومستمع keydown يقبل المسح أيضًا. أبقِ مسار اكتمال واحدًا واستدعِ preventDefault() على الآخر.

تظهر بادئة داخل الباركود. البادئة القابلة للطباعة جزء من السلسلة الملتقطة. إما عطّلها على الماسح أو أزل ذلك التسلسل بعينه في التطبيق. معرّف نظام الترميز المفعّل مصدر شائع لـ ] بادئ ومحرفين آخرين. بادئة تحكم لا يستطيع الإسفين كتابتها ستكون غائبة لا مرئية.

المحارف خاطئة. قد يختلف تخطيط الماسح وتخطيط نظام التشغيل، فيغيّر محارف البادئة وعلامات الترقيم بينما يبقى الطول كما هو. انظر تخطيط لوحة مفاتيح خاطئ في ماسح الباركود.

التطبيق لا يرى نهاية المسح أبدًا. لا توجد لاحقة، والصفحة تنتظر Enter. أضف لاحقة تطابق النموذج، أو أكمل القيمة بإجراء صريح. تخمين التوقيت سيفوّت بعض المسوح الحقيقية ويقبل بعض الكتابة.

يختلف CR/LF بين التطبيقات. يدرج Notepad سطرًا جديدًا عندما يستلم Enter. يُبقي حقل نص ويب الباركود ويطلق حدث مفتاح. قد يستلم برنامج تسلسلي 0x0D أو 0x0A أو كليهما. قارن الواجهة قبل أن تغيّر الماسح. إذا لم يستلم أي تطبيق محارف، فابدأ بـماسح الباركود لا يعمل.

مرور أوسع على التركيز والمسوح المتكررة وتدفقات POS في كيفية اختبار إدخال ماسح الباركود.

مصفوفة الاختبار

عمود التهيئة هو ما تضبطه على الماسح، أو ما تكتبه بالمحاكي عندما تكون الحالة لاحقة لوحة مفاتيح. السلوك المتوقع هو ما ينبغي للتطبيق أن يفعله. حالة CRLF تسلسلية ليست الاختبار نفسه كمفتاح Enter في متصفح.

التهيئة سلوك التطبيق المتوقع
بلا بادئة، بلا لاحقة تُستلم قيمة الباركود ولا يصل مفتاح اكتمال. تبقى القيمة متاحة إلى أن يقرأها التطبيق.
بلا بادئة، لاحقة ENTER يستلم التطبيق مفتاح الاكتمال مرة واحدة ويخزن الحمولة بلا محرف منهِ.
بلا بادئة، لاحقة TAB قد ينتقل التركيز إلى عنصر التحكم التالي. يقرأ التطبيق القيمة قبل ذلك الانتقال.
بادئة مخصصة قابلة للطباعة تظهر محارف البادئة قبل البيانات المفكوكة. يُبقي التطبيق تلك البادئة بعينها أو يزيلها عن قصد.
لاحقة مخصصة قابلة للطباعة تظهر محارف اللاحقة بعد البيانات المفكوكة. Enter وTab مفاتيح، لذلك لا تظهر في السلسلة.
تسلسل CRLF يعالج مضيف تسلسلي أو طرفي بايتي CR وLF المُهيأين. حقل نص في المتصفح لا يكتسب هذين البايتين من ضغطة Enter.

شغّل صفوف لوحة المفاتيح على ماسح الإسفين، وعند غياب العتاد، بإعدادات ENTER وTAB وبلا لاحقة في المحاكي. شغّل صف CRLF على الواجهة التي يُفترض أن تحمل تلك البايتات. ما زالت النتائج الفعلية تعتمد على تلك الواجهة وعلى التطبيق.