Barcode Scanner Emulator
Tiền tố và hậu tố trên máy quét mã vạch: hướng dẫn đầy đủ
Tiền tố là dữ liệu hoặc chuỗi điều khiển mà máy quét mã vạch gửi trước mã vạch đã giải mã. Hậu tố là phần máy quét gửi sau giá trị đó. Cùng một kiểu máy vẫn có thể đặt tiền tố và hậu tố khác nhau, và máy quét nối tiếp không đưa chúng tới theo cách của máy quét keyboard wedge.
Tiền tố của máy quét mã vạch được gửi trước giá trị đã giải mã. Hậu tố được gửi sau giá trị đó. Một máy quét có thể tạo ra chuỗi sau:
Tiền tố: STX
Mã vạch: 123456789
Hậu tố: ENTER
STX trong sách hướng dẫn thường là ký tự điều khiển, không phải ba chữ S, T và X. ENTER trên máy quét keyboard wedge thường là phím Enter, không phải hai ký tự CR và LF được chèn vào ô văn bản. Bạn nhận được cái nào tùy kiểu máy, giao diện và ứng dụng. Không có thiết lập nào dùng được cho mọi trường hợp.
Hướng dẫn Hậu tố ENTER và TAB trên máy quét mã vạch chỉ dừng ở việc chọn và xử lý hai dấu kết thúc đó. Hướng dẫn này nói về khung quanh mã vạch: cái gì đến trước, cái gì đến sau, và ứng dụng web nên đọc cả hai thế nào.
Tiền tố máy quét mã vạch là gì?
Tiền tố là chuỗi đã cấu hình mà máy quét truyền trước phần tải. Phần tải là văn bản mà hệ ký hiệu đã giải mã, ví dụ 123456789. Tiền tố không thuộc lần giải mã đó, trừ khi máy quét được đặt để thêm nó vào.
Công dụng thường gặp:
- Đánh dấu đầu một thông điệp. Giao thức nối tiếp và thiết bị đầu cuối đôi khi gửi một ký tự điều khiển, thường gọi là STX, để máy chủ biết một khung mới đã bắt đầu.
- Gọi tên hệ ký hiệu. Khi bật mã nhận dạng hệ ký hiệu AIM, máy quét có thể gửi một tiền tố in được ngắn, như
]C1cho Code 128 hoặc]E0cho EAN, trước các chữ số. Ứng dụng có thể rẽ nhánh theo mã đó. - Chia hướng đầu vào trong phần mềm POS hoặc thiết bị đầu cuối cũ. Một mã cố định trước dữ liệu báo cho máy chủ biết lần quét thuộc trường hoặc thiết bị nào.
- Gắn nhãn một quầy cụ thể. Hai máy quét có thể được gán tiền tố in được khác nhau, để nhật ký cho thấy làn nào đã gửi mã.
Tiền tố in được là ký tự bình thường. Chúng hiện ở đầu chuỗi trong ô văn bản. Tiền tố là ký tự điều khiển, như STX (0x02), không phải các chữ S, T và X. Máy quét keyboard wedge có thể không gõ được ký tự điều khiển đó. Máy quét nối tiếp có thể gửi nó như một byte. Hãy đọc sách hướng dẫn của đúng kiểu máy trước khi viết mã chờ một trong hai cách.
Tiền tố không chứng minh đầu vào do máy quét tạo ra. Một người, một macro, hoặc Barcode Scanner Emulator đều có thể gõ cùng những ký tự đó. Hãy coi tiền tố là khung bạn đã cấu hình, rồi kiểm tra phần tải như với mọi đầu vào người dùng khác.
Hậu tố máy quét mã vạch là gì?
Hậu tố là chuỗi đã cấu hình, gửi sau phần tải. Việc thường ngày của nó là báo cho ứng dụng biết lần quét đã xong, hoặc chuyển tiêu điểm. Máy quét khác nhau. Có máy cho Enter, Tab, CR, LF, CR+LF, một chuỗi tùy chỉnh, hoặc không có gì. Có máy chỉ cho một hoặc hai lựa chọn trong số đó.
ENTER. Phím Enter. Trong trình duyệt đây là sự kiện bàn phím, event.key === "Enter". Nó không được chèn vào ô văn bản thông thường.
TAB. Phím Tab, event.key === "Tab". Trình duyệt chuyển tiêu điểm sang điều khiển kế tiếp. Phím không được chèn vào trường.
CR. Về đầu dòng, ASCII 0x0D. Trên giao diện nối tiếp hoặc thiết bị đầu cuối, nó có thể là một byte thật sau phần tải. Trên keyboard wedge, mục ghi CR hoặc carriage return thường có nghĩa là phím Enter. Trình duyệt vẫn báo Enter. Giá trị trường không nhận thêm ký tự CR.
LF. Xuống dòng, ASCII 0x0A. Đây là ký tự điều khiển khác với CR. Trên luồng nối tiếp, nó có thể là một byte riêng. Keyboard wedge không có phím Line Feed chuẩn theo cách nó có Enter và Tab. Đừng cho rằng mục menu tên LF sẽ gõ một ký tự nhìn thấy được, hoặc một lần Enter thứ hai.
CRLF. CR rồi đến LF, hai byte 0x0D 0x0A. Một số máy chủ nối tiếp và thiết bị đầu cuối chờ cặp đó như cuối một dòng. Ô văn bản của trình duyệt không lưu cặp đó khi có người nhấn Enter.
Ký tự tùy chỉnh. Hậu tố in được như # hoặc một mã ngắn được gõ sau mã vạch, nên nó trở thành một phần của chuỗi trừ khi ứng dụng gỡ bỏ. Ký tự điều khiển tùy chỉnh đi theo cùng cách chia như STX: byte trên cổng nối tiếp, lần nhấn phím trên wedge, và chỉ những lần nhấn phím mà giao diện bàn phím thực sự gửi được.
ENTER, CR và LF là những tên gần nhau cho “cuối dòng” trong sách hướng dẫn. Chúng không hoán đổi được trong mọi ứng dụng. Máy quét wedge, máy quét nối tiếp, Notepad và biểu mẫu web có thể mỗi bên cho một kết quả khác với cùng một tên thiết lập.
Tiền tố và hậu tố
| Đặc điểm | Tiền tố | Hậu tố |
|---|---|---|
| Vị trí | Trước dữ liệu mã vạch | Sau dữ liệu mã vạch |
| Mục đích | Đánh dấu phần đầu hoặc gắn nhãn đầu vào | Đánh dấu hoàn tất hoặc kích hoạt một hành động |
| Ví dụ | STX, hoặc mã AIM in được như ]C1 |
ENTER, TAB, hoặc một ký tự in được như # |
| Cách dùng thường gặp | Đóng khung hoặc nhận diện lần quét | Gửi biểu mẫu hoặc chuyển tiêu điểm |
| Trong ô văn bản | Ký tự in được đứng ở đầu giá trị | Ký tự in được đứng ở cuối. Enter và Tab thì không |
| Bản chất | Một dấu đã cấu hình, ai cũng gõ được | Một dấu đã cấu hình, ai cũng gõ được |
Chỉ gỡ tiền tố hoặc hậu tố tùy chỉnh khi bạn đã cấu hình đúng chuỗi đó và bản ghi lưu không được chứa nó. Hãy để mã AIM ở nguyên chỗ cho đến khi ứng dụng có quy tắc cho nó.
ENTER, TAB, CR và LF
Những tên này xuất hiện trên tờ cấu hình. Phía nhận thấy lần nhấn phím hoặc byte, tùy giao diện. Hướng dẫn Giải thích HID keyboard wedge mô tả đường lần nhấn phím. Cổng nối tiếp là đường khác: ứng dụng đọc byte, và tiêu điểm không chọn nơi chúng đi.
ENTER
Trên máy quét keyboard wedge, ENTER là phím Enter. Trong ô văn bản một dòng, trình duyệt hiện tại dùng phím đó để gửi biểu mẫu bao quanh. Ô tra cứu có thể chốt lần quét trên sự kiện này. Biểu mẫu nhiều trường có thể gửi trước khi các trường sau được điền. Khi trang phải giữ giá trị và ở lại, hãy gọi preventDefault() trên sự kiện submit, hoặc trên keydown của Enter. Xử lý Enter ở một chỗ. Một bộ lắng nghe keydown và một bộ lắng nghe submit cùng chấp nhận lần quét sẽ ghi nó hai lần.
Một số máy quét gửi NumPad Enter. event.key vẫn là "Enter". event.code có thể là "NumpadEnter" chứ không phải "Enter". Hãy kiểm tra event.key nếu cả hai phím đều phải chốt trường.
Hướng dẫn Hậu tố ENTER và TAB trên máy quét mã vạch so sánh hai lựa chọn đó cho POS và biểu mẫu web. Máy quét mã vạch thiếu ENTER nói về máy quét gõ mã vạch rồi dừng.
TAB
TAB là phím Tab. Trình duyệt chuyển tiêu điểm sau keydown. Hãy đọc trường trong bộ xử lý keydown đó, khi trường vẫn còn tiêu điểm, và để hành động mặc định nguyên vẹn khi điều khiển kế tiếp phải nhận con trỏ. preventDefault() giữ tiêu điểm ở trường hiện tại.
Shift+Tab là cùng phím đó khi giữ Shift. Hậu tố Tab của máy quét là Tab không có Shift. Bỏ qua event.shiftKey nếu người dùng bàn phím phải đi ngược lại được trong biểu mẫu.
CR
Về đầu dòng đưa con trỏ về đầu dòng trên thiết bị đầu cuối. Byte là 0x0D. Máy quét nối tiếp có thể nối byte đó vào phần tải. Thiết lập keyboard wedge mang tên CR thường gửi phím Enter, thay vì chèn 0x0D vào văn bản. Nhấn Enter trong ô nhập của trình duyệt không ghi ký tự CR vào input.value.
Nếu máy chủ là thiết bị đầu cuối hoặc trình lắng nghe cổng COM, hãy tìm byte. Nếu máy chủ là trang web, hãy tìm event.key === "Enter".
LF
Xuống dòng đưa con trỏ thiết bị đầu cuối xuống một dòng. Byte là 0x0A. Một số máy chủ coi riêng LF là ký tự xuống dòng. Số khác bỏ qua nó trừ khi CR đến trước. Máy quét wedge liệt kê LF làm hậu tố có thể gửi một phím mà hệ điều hành không biến thành ngắt dòng, hoặc gửi thứ mà ô văn bản sẽ không giữ. Hãy bắt phím trong trình kiểm thử sự kiện bàn phím trước khi xử lý một LF được cho là như vậy trong mã ứng dụng.
CRLF
CRLF là chuỗi hai điều khiển: CR rồi LF. Tệp văn bản kiểu Windows và nhiều thiết bị nối tiếp dùng nó như một lần xuống dòng. Trang cấu hình ghi hậu tố CRLF có nghĩa là máy quét sẽ cố gửi cặp đó sau phần tải, trên giao diện nó đang dùng.
Trong trình duyệt, nhấn Enter không tạo ra chuỗi CRLF theo nghĩa đen bên trong ô văn bản. Biểu mẫu nhận một sự kiện bàn phím. <textarea> có thể chèn một lần xuống dòng khi người dùng nhấn Enter, và lần xuống dòng đó là hành vi soạn thảo của chính trình duyệt, không phải bằng chứng máy quét đã phát các byte 0x0D 0x0A. Bộ đọc nối tiếp có thể nhận hai byte đó và chỉ nên coi chúng là dấu kết thúc nếu máy quét đó được cấu hình để gửi chúng. Đừng gỡ CR hoặc LF ở giữa một phần tải được phép chứa chúng.
Tiền tố và hậu tố ảnh hưởng đến ứng dụng web thế nào
Một lần quét keyboard wedge là một loạt lần nhấn phím vào điều khiển đang có tiêu điểm. Trang không mở máy quét. Nếu tiêu điểm ở trường khác, tiền tố, mã vạch và hậu tố đều đi vào đó.
keydown bắn cho mọi phím, kể cả Enter và Tab, trước khi trình duyệt chèn một ký tự hoặc chuyển tiêu điểm. event.key là ký tự hoặc tên phím sau khi hệ điều hành áp dụng bố cục bàn phím. Ký tự tiền tố và hậu tố in được hiện trong trường qua sự kiện input. Enter và Tab thì không.
Bộ lắng nghe dưới đây chốt trường khi Enter đến. Nó không thêm hậu tố mà máy quét đã bỏ. Nếu máy quét không gửi Enter, giá trị ở lại trong trường cho đến khi thứ khác đọc nó.
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 = ''
})
Đưa tiêu điểm tới #barcode trước lần quét. preventDefault() ngăn một biểu mẫu tổ tiên gửi lần thứ hai. Nếu ô nhập không nằm trong biểu mẫu và bạn muốn lần gửi gốc của trình duyệt, hãy bỏ preventDefault().
Không có hậu tố thì hãy chờ một hành động rõ ràng: một nút, một Enter sau đó từ người vận hành, hoặc bước kế trong quy trình. Bộ đếm thời gian không hoạt động có thể coi một khoảng dừng là hết lần quét. Bộ đếm đó là phép ước lượng. Máy quét chậm, độ trễ Bluetooth, hoặc người gõ nhanh có thể rơi về phía sai. Hãy ưu tiên hậu tố đã cấu hình khi quy trình cần một điểm kết rõ.
Có thể gỡ một tiền tố in được đã biết sau khi đọc giá trị:
function withoutConfiguredPrefix(value, prefix) {
if (prefix && value.startsWith(prefix)) {
return value.slice(prefix.length)
}
return value
}
Chỉ truyền tiền tố bạn đã cấu hình, ví dụ ']C1'. Đừng cắt một số ký tự tùy ý khỏi mọi lần quét.
Với biểu mẫu đầy đủ còn xử lý Tab, đầu vào rỗng và lần quét thứ hai, xem Cách kiểm thử máy quét mã vạch trong ứng dụng web.
Cách cấu hình tiền tố và hậu tố
Thiết lập tiền tố và hậu tố nằm trên máy quét. Tên phím và cách đổi chúng tùy nhà sản xuất. Không có mã vạch cấu hình nào chạy trên mọi hãng, và hướng dẫn này không in ra mã đó.
Cách làm điển hình:
- Quét mã vạch cấu hình trong sách hướng dẫn của đúng kiểu máy đó. Tờ giấy được nhóm theo thiết lập: hậu tố, tiền tố, bố cục bàn phím, hệ ký hiệu.
- Dùng chương trình cấu hình của nhà cung cấp, rồi ghi kết quả vào máy quét qua USB.
- Dùng tiện ích quản lý thiết bị của dòng sản phẩm đó khi bạn đang cập nhật nhiều máy.
Sau khi đổi, hãy quét một mã vạch đã biết và so kết quả với mô tả trong sách hướng dẫn về thiết lập bạn đã chọn. Đặt lại xuất xưởng từ một hãng khác có thể để máy quét không đổi, hoặc đưa nó vào một chế độ ngoài dự kiến. Hướng dẫn Hướng dẫn cấu hình máy quét mã vạch tóm tắt những thiết lập thường quan trọng. Nó không thay sách hướng dẫn.
Barcode Scanner Emulator có thể gõ một giá trị bạn chọn, rồi gửi ENTER, TAB, hoặc không hậu tố. Hãy đặt một tiền tố in được vào giá trị đó khi cần tập xử lý tiền tố mà không có phần cứng. Trình mô phỏng không phát cặp byte CR/LF nối tiếp, và không đọc nhãn.
Cách kiểm thử hành vi tiền tố và hậu tố
Dùng máy quét đang ở chế độ bàn phím, USB HID keyboard hoặc Bluetooth HID keyboard.
- Nối máy và đợi đến khi nó cho thấy đã có nguồn.
- Mở trình kiểm thử đầu vào mã vạch.
- Bấm Bắt đầu kiểm thử, hoặc bấm vùng quét. Vùng đó chuyển xanh khi sẵn sàng. Trang không tự lấy tiêu điểm.
- Quét một mã vạch mà bạn đã biết phần tải.
- Đọc giá trị đã bắt và số ký tự. Ký tự tiền tố hoặc hậu tố in được nằm trong chuỗi đó. Dòng Tiền tố dành cho các phím có tên đến trước ký tự đầu, ví dụ một phím bổ trợ. Nó không kéo một tiền tố đã gõ như
]C1ra khỏi văn bản mã vạch. - Kiểm tra hậu tố. Trình kiểm thử báo ENTER, TAB, hoặc Không có. Khi Tự động ghi nhận đang bật, kết quả hiện sau Enter, Tab, hoặc một khoảng dừng ngắn khi các phím ngừng. Tắt Tự động ghi nhận để giữ lần bắt cho đến khi bạn nhấn Dừng. Enter và Tab không thuộc chuỗi mã vạch.
- So kết quả đó với cấu hình bạn định dùng. Rồi mở trình kiểm thử sự kiện bàn phím và quét lại khi bạn cần từng
keydowntheo thứ tự, gồmkey,codevà thời điểm.
Trình kiểm thử đầu vào ghi sự kiện bàn phím mà trình duyệt nhìn thấy. Nó không đọc được cổng nối tiếp, nên không thể hiện CR hoặc LF như byte thô. Một lần kiểm thử wedge không chứng minh thiết lập nối tiếp sẽ gửi gì.
Xử lý sự cố
Máy quét không gửi ENTER. Mã vạch hiện ra và con trỏ ở lại trong trường. Trình kiểm thử đầu vào báo Không có. Hậu tố đang tắt, hoặc được đặt thành thứ khác Enter. Xem Máy quét mã vạch thiếu ENTER.
TAB chuyển tiêu điểm ngoài ý muốn. Máy quét đang gửi phím Tab. Đó chính là hậu tố đã cấu hình. Dùng Enter khi biểu mẫu phải gửi, hoặc đọc giá trị trên keydown của Tab khi quy trình phải đi tiếp. Chi tiết nằm trong hướng dẫn Hậu tố ENTER và TAB trên máy quét mã vạch.
Biểu mẫu gửi hai lần. Trình duyệt gửi khi Enter, và một bộ lắng nghe keydown cũng chấp nhận lần quét. Giữ một đường hoàn tất và gọi preventDefault() trên đường kia.
Một tiền tố hiện bên trong mã vạch. Tiền tố in được là một phần của chuỗi đã bắt. Hoặc tắt nó trên máy quét, hoặc gỡ đúng chuỗi đó trong ứng dụng. Mã nhận dạng hệ ký hiệu đang bật là nguồn thường gặp của một ] ở đầu và thêm hai ký tự. Tiền tố điều khiển mà wedge không gõ được sẽ thiếu, thay vì hiện ra.
Ký tự sai. Bố cục máy quét và bố cục hệ điều hành có thể không khớp, làm đổi ký tự tiền tố và dấu câu trong khi độ dài giữ nguyên. Xem Máy quét mã vạch sai bố cục bàn phím.
Ứng dụng không bao giờ thấy hết lần quét. Không có hậu tố, và trang đang chờ Enter. Thêm một hậu tố khớp biểu mẫu, hoặc hoàn tất giá trị bằng một hành động rõ ràng. Đoán theo thời gian sẽ bỏ sót một số lần quét thật và nhận một số lần gõ.
CR/LF khác nhau giữa các ứng dụng. Notepad chèn dòng mới khi nhận Enter. Ô văn bản web giữ mã vạch và bắn một sự kiện phím. Chương trình nối tiếp có thể nhận 0x0D, 0x0A, hoặc cả hai. Hãy so giao diện trước khi đổi máy quét. Nếu không ứng dụng nào nhận được ký tự, hãy bắt đầu với Máy quét mã vạch không hoạt động.
Một lượt rộng hơn về tiêu điểm, lần quét lặp và luồng POS nằm trong Cách kiểm thử đầu vào máy quét mã vạch.
Ma trận kiểm thử
Cột cấu hình là thứ bạn đặt trên máy quét, hoặc thứ bạn gõ bằng trình mô phỏng khi trường hợp là hậu tố bàn phím. Hành vi kỳ vọng là việc ứng dụng phải làm. Trường hợp CRLF nối tiếp không phải cùng một bài kiểm thử với phím Enter trong trình duyệt.
| Cấu hình | Hành vi ứng dụng kỳ vọng |
|---|---|
| Không tiền tố, không hậu tố | Giá trị mã vạch được nhận và không có phím hoàn tất đến. Giá trị còn đó cho đến khi ứng dụng đọc nó. |
| Không tiền tố, hậu tố ENTER | Ứng dụng nhận phím hoàn tất một lần và lưu phần tải mà không có ký tự kết thúc. |
| Không tiền tố, hậu tố TAB | Tiêu điểm có thể chuyển sang điều khiển kế tiếp. Ứng dụng đọc giá trị trước lần chuyển đó. |
| Tiền tố in được tùy chỉnh | Các ký tự tiền tố hiện trước dữ liệu đã giải mã. Ứng dụng cố ý giữ hoặc gỡ đúng tiền tố đó. |
| Hậu tố in được tùy chỉnh | Các ký tự hậu tố hiện sau dữ liệu đã giải mã. Enter và Tab là phím, nên chúng không hiện trong chuỗi. |
| Chuỗi CRLF | Máy chủ nối tiếp hoặc thiết bị đầu cuối xử lý các byte CR và LF đã cấu hình. Ô văn bản trình duyệt không nhận các byte đó từ một lần nhấn Enter. |
Chạy các hàng bàn phím trên máy quét wedge và, khi không có phần cứng, với thiết lập ENTER, TAB và không hậu tố của trình mô phỏng. Chạy hàng CRLF trên giao diện được cho là mang các byte đó. Kết quả thực tế vẫn phụ thuộc vào giao diện đó và vào ứng dụng.