דילוג לתוכן

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 על הממשק שאמור לשאת את הבתים האלה. התוצאות בפועל עדיין תלויות בממשק הזה וביישום.