跳至內容

Barcode Scanner Emulator

條碼掃描器前綴與後綴:完整說明

前綴是條碼掃描器在解碼後的條碼之前送出的資料或控制序列。後綴則是該值之後送出的內容。同一機型可以分別設定不同的前綴與後綴,序列掃描器也不會用鍵盤楔入掃描器的方式送達。

條碼掃描器會把前綴放在解出的值前面,把後綴放在那個值後面。某一台掃描器送出的順序可能像這樣:

前綴:STX

條碼:123456789

後綴:ENTER

手冊寫的 STX,多半是控制字元,不是 S、T、X 這三個字母。鍵盤楔入掃描器上的 ENTER,通常是 Enter 鍵,不是塞進文字欄的 CR 與 LF 兩個字。你會收到哪一種,要看機型、介面和應用程式。沒有一組設定能套用到所有情況。

條碼掃描器的 ENTER 與 TAB 後綴只處理這兩個結束鍵怎麼選、怎麼查。這份說明談的是條碼外圍的框:前面先來什麼、後面再來什麼,以及網頁應用程式該怎麼把兩邊都讀進來。

條碼掃描器的前綴是什麼?

前綴是你在掃描器上設好、要在承載資料之前送出的一段序列。承載資料是碼制解出來的文字,例如 123456789。掃描器沒有被設成要加上它時,前綴就不屬於這次解碼。

常見的用法:

  • 標出訊息從哪裡開始。 序列與終端機協定有時會先送一個控制字元,常叫 STX,讓主機知道新的一框開始了。
  • 點出碼制名稱。 啟用 AIM 碼制識別碼之後,掃描器可以在數字前面送出一小段可列印前綴,Code 128 是 ]C1,EAN 是 ]E0。應用程式可以依這個識別碼走不同分支。
  • 在較舊的 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 是不同的控制字元。在序列資料流裡,它可以單獨是一個位元組。鍵盤楔入沒有像 Enter 和 Tab 那樣的標準換行鍵。不要以為選單上名叫 LF 的項目會打出一個看得到的字,或再送一次 Enter。

CRLF。 先 CR 再 LF,兩個位元組 0x0D 0x0A。有些序列與終端機主機會把這一對當成一行的結尾。有人按下 Enter 時,瀏覽器的文字欄不會把這一對存起來。

自訂字元。 像 # 或一小段代碼這種可列印後綴,會打在條碼後面,所以除非應用程式把它拿掉,它會變成字串的一部分。自訂控制字元和 STX 的分法一樣:序列埠上是位元組,楔入上是按鍵,而且只有鍵盤介面真的送得出的按鍵。

ENTER、CR、LF 在手冊裡都是在說「一行結束」,名字很近。它們不能在每一個應用程式裡互相替換。楔入掃描器、序列掃描器、記事本和網頁表單,對同一個名稱的設定,可能各自呈現不同結果。

前綴與後綴

項目 前綴 後綴
位置 條碼資料之前 條碼資料之後
目的 標出開頭,或替輸入加上標籤 標出完成,或觸發一個動作
例子 STX,或 ]C1 這類可列印的 AIM 識別碼 ENTER、TAB,或 # 這類可列印字元
常見用法 替掃描加框,或辨認這次掃描 送出表單,或移動焦點
在文字欄裡 可列印字元排在值的開頭 可列印字元排在值的結尾。Enter 與 Tab 不會
身分 任何人都能打出的已設定標記 任何人都能打出的已設定標記

只有當你設的就是那一段確切序列,而且存下來的紀錄不該帶著它時,才拿掉前綴或自訂後綴。應用程式還沒有處理規則之前,AIM 識別碼先留著。

ENTER、TAB、CR 與 LF

這些名稱會出現在設定表上。接收端看到的是按鍵還是位元組,要看介面。HID keyboard wedge 說明講的是按鍵那條路徑。序列埠是另一條:應用程式讀的是位元組,焦點並不會決定它們要去哪裡。

ENTER

在鍵盤楔入掃描器上,ENTER 就是 Enter 鍵。在單行文字欄裡,現在的瀏覽器會用這個鍵送出所在表單。查詢欄可以在這個事件上確認掃描。多欄位表單可能在後面的欄位還沒填完時就送出。頁面應該留下這個值、停在原地時,在 submit 事件上,或在 Enter 的 keydown 上呼叫 preventDefault()。Enter 只在一個地方處理。keydown 監聽器和 submit 監聽器都接受這次掃描時,會記成兩次。

有些掃描器送的是數字鍵盤的 Enter。event.key 仍然是 "Enter"。event.code 可能是 "NumpadEnter",而不是 "Enter"。兩個鍵都應該確認欄位時,檢查 event.key。

條碼掃描器的 ENTER 與 TAB 後綴比較這兩種選擇在 POS 與網頁表單上的差別。條碼掃描器缺少 ENTER說明掃描器打完條碼就停住的情況。

TAB

TAB 是 Tab 鍵。瀏覽器在 keydown 之後才移動焦點。在那個 keydown 處理函式裡、欄位還有焦點時把欄位讀走;下一個控制項應該接到游標時,把預設動作留下。preventDefault() 會把焦點留在目前欄位。

Shift+Tab 是按住 Shift 的同一個鍵。掃描器的 Tab 後綴是沒有 Shift 的 Tab。如果鍵盤使用者必須能在表單裡往回走,就不要看 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、空白輸入和第二次掃描的完整表單,見如何在 Web 應用程式中測試條碼掃描器。

如何設定前綴與後綴

前綴與後綴的設定在掃描器上。按鍵名稱和改法因廠商而異。沒有一條設定條碼能用在所有品牌,這份說明也不印出那樣的條碼。

常見做法:

  • 掃描那一台確切機型手冊裡的設定條碼。設定頁依項目分組:後綴、前綴、鍵盤配置、碼制。
  • 用廠商的設定程式,再經由 USB 把結果寫進掃描器。
  • 一次更新很多台時,用該產品線的裝置管理工具。

改完之後,掃描一組已知條碼,把結果和手冊對你所選設定的說明對一下。用別的品牌的原廠重設,可能讓掃描器完全沒變,也可能把它放進沒想到的模式。條碼掃描器設定指南整理的是通常要緊的設定。它不能取代手冊。

Barcode Scanner Emulator 可以打入你選的值,然後送出 ENTER、TAB,或不送後綴。沒有硬體卻要演練前綴處理時,把可列印前綴放進那個值。模擬器不會送出序列 CR/LF 位元組對,也不會讀取標籤。

如何測試前綴與後綴的行為

使用處於鍵盤模式的掃描器,也就是 USB HID 鍵盤或 Bluetooth HID 鍵盤。

  1. 接上它,等到它顯示已經有電。
  2. 開啟條碼輸入測試器。
  3. 點選開始測試,或點選掃描區域。就緒時它會變成藍色。頁面不會自己拿走焦點。
  4. 掃描一組你已經知道承載資料的條碼。
  5. 讀取擷取到的值和字元數。可列印的前綴或後綴字元就在這個字串裡面。前綴那一列是給第一個字元之前到達的具名按鍵用的,例如修飾鍵。它不會把 ]C1 這種打進去的前綴從條碼文字裡抽出來。
  6. 查看後綴。測試器回報 ENTER、TAB 或無。自動擷取開啟時,結果會在 Enter、Tab,或按鍵停止後的短暫停頓之後出現。關掉自動擷取,就會一直保留這次擷取,直到你按停止。Enter 和 Tab 不屬於條碼字串。
  7. 把這個結果和你打算使用的設定比對。需要依序看到每一次 keydown,包括 key、code 和時間時,再開啟鍵盤事件測試器再掃一次。

輸入測試器記錄的是瀏覽器看得到的鍵盤事件。它讀不了序列埠,所以不能把 CR 或 LF 顯示成原始位元組。楔入測試不能證明序列設定會送出什麼。

排查

掃描器沒有送出 ENTER。 條碼出現了,游標仍留在欄位裡。輸入測試器回報無。後綴被關掉了,或是設成 Enter 以外的東西。參見條碼掃描器缺少 ENTER。

TAB 意外移走了焦點。 掃描器正在送 Tab 鍵。那就是已設定的後綴。表單應該送出時用 Enter;流程應該往前時,在 Tab 的 keydown 上讀取值。細節見條碼掃描器的 ENTER 與 TAB 後綴。

表單送出了兩次。 瀏覽器在 Enter 上送出,同時一個 keydown 監聽器也接受了這次掃描。只留一條完成路徑,並在另一條上呼叫 preventDefault()。

前綴出現在條碼裡面。 可列印前綴是擷取字串的一部分。要嘛在掃描器上關掉它,要嘛在應用程式裡拿掉這一段確切序列。啟用中的碼制識別碼,常常是開頭一個 ] 再加兩個字元的來源。楔入打不出來的控制前綴會缺掉,而不是顯示出來。

字元不對。 掃描器配置和作業系統配置可能不一致,前綴字元和標點會變,長度卻不變。參見條碼掃描器鍵盤配置錯誤。

應用程式始終看不到掃描結束。 沒有後綴,頁面卻在等 Enter。加上和表單相符的後綴,或在一個明確動作上完成這個值。靠時間去猜,會漏掉一些真正的掃描,也會收下一些打字。

CR/LF 在不同應用程式裡不一樣。 記事本收到 Enter 時會插入新的一行。網頁文字輸入會留下條碼並觸發按鍵事件。序列程式可能收到 0x0D、0x0A,或兩者都收到。改掃描器之前先比較介面。如果沒有任何應用程式收到字元,從條碼掃描器無法運作開始。

對焦點、重複掃描和 POS 流程更寬的檢查,見如何測試條碼掃描器輸入。

測試矩陣

設定這一欄是你在掃描器上設的內容;當案例是鍵盤後綴時,也可以是你用模擬器打出來的內容。預期行為是應用程式該做的事。序列 CRLF 案例和瀏覽器裡的 Enter 鍵不是同一項測試。

設定 應用程式的預期行為
沒有前綴,沒有後綴 收到條碼值,沒有完成鍵到達。在應用程式讀取之前,值會一直留著。
沒有前綴,ENTER 後綴 應用程式收到一次完成鍵,儲存承載資料時不含結束字元。
沒有前綴,TAB 後綴 焦點可能移到下一個控制項。應用程式在移動之前讀取值。
自訂可列印前綴 前綴字元出現在解碼資料之前。應用程式有意地保留或拿掉這一段確切前綴。
自訂可列印後綴 後綴字元出現在解碼資料之後。Enter 和 Tab 是鍵,所以不會出現在字串裡。
CRLF 序列 序列或終端機主機處理已設定的 CR 與 LF 位元組。瀏覽器文字欄不會從一次 Enter 按鍵得到這些位元組。

鍵盤那幾列在楔入掃描器上跑;沒有硬體時,用模擬器的 ENTER、TAB 和沒有後綴設定。CRLF 那一列在應該承載這些位元組的介面上跑。實際結果仍然取決於那個介面和應用程式。