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처럼 표준 Line Feed 키가 없습니다. 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 키보드 웨지 설명은 키 입력 경로를 설명합니다. 시리얼 포트는 다른 경로입니다. 애플리케이션이 바이트를 읽고, 포커스가 갈 곳을 고르지 않습니다.
ENTER
키보드 웨지 스캐너에서 ENTER는 Enter 키입니다. 한 줄 텍스트 필드 안에서 현재 브라우저는 그 키로 감싸는 폼을 제출합니다. 조회 상자는 그 이벤트로 스캔을 확정할 수 있습니다. 여러 필드 폼은 뒤의 필드를 채우기 전에 제출될 수 있습니다. 페이지가 값을 남기고 그 자리에 있어야 하면 submit 이벤트나 Enter의 keydown에서 preventDefault()를 호출하십시오. Enter 처리는 한곳에 두십시오. 스캔을 받아들이는 keydown 리스너와 submit 리스너가 둘 다 있으면 두 번 기록됩니다.
일부 스캐너는 NumPad Enter를 보냅니다. event.key는 여전히 "Enter"입니다. event.code는 "Enter"가 아니라 "NumpadEnter"일 수 있습니다. 두 키 모두 필드를 확정해야 하면 event.key를 검사하십시오.
바코드 스캐너의 ENTER와 TAB 접미사 가이드는 POS와 웹 폼에서 그 두 선택을 비교합니다. 바코드 스캐너에 ENTER가 없음은 바코드를 친 뒤 멈추는 스캐너를 다룹니다.
TAB
TAB은 Tab 키입니다. 브라우저는 keydown 뒤에 포커스를 옮깁니다. 아직 포커스가 있는 그 keydown 핸들러에서 필드를 읽고, 다음 컨트롤이 커서를 받아야 하면 기본 동작을 그대로 두십시오. preventDefault()는 현재 필드에 포커스를 붙잡아 둡니다.
Shift+Tab은 Shift를 누른 같은 키입니다. 스캐너의 Tab 접미사는 Shift가 없는 Tab입니다. 키보드 사용자가 폼을 뒤로 이동할 수 있어야 하면 event.shiftKey는 무시하십시오.
CR
캐리지 리턴은 터미널에서 커서를 줄의 처음으로 옮깁니다. 바이트는 0x0D입니다. 시리얼 스캐너는 그 바이트를 페이로드에 붙일 수 있습니다. CR이라는 이름의 키보드 웨지 설정은 보통 텍스트에 0x0D를 넣는 대신 Enter 키를 보냅니다. 브라우저 입력에서 Enter를 눌러도 input.value에 CR 문자가 쓰이지 않습니다.
호스트가 터미널이나 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 키보드 또는 Bluetooth HID 키보드입니다.
- 연결하고 전원이 들어왔다는 표시가 나올 때까지 기다립니다.
- 바코드 입력 테스터를 엽니다.
- 테스트 시작을 클릭하거나 스캔 영역을 클릭합니다. 준비되면 파란색이 됩니다. 페이지가 스스로 포커스를 가져가지 않습니다.
- 페이로드를 이미 아는 바코드를 스캔합니다.
- 캡처된 값과 문자 수를 읽습니다. 인쇄 가능 접두사나 접미사 문자는 그 문자열 안에 있습니다. 접두사 줄은 첫 문자보다 먼저 도착하는 이름 있는 키, 예를 들어 수정자 키를 위한 것입니다.
]C1처럼 입력된 접두사를 바코드 텍스트에서 빼내지 않습니다. - 접미사를 확인합니다. 테스터는 ENTER, TAB, 또는 없음을 보고합니다. 자동 캡처가 켜져 있으면 결과는 Enter, Tab, 또는 키가 멈춘 뒤의 짧은 멈춤 뒤에 나타납니다. 자동 캡처를 끄면 중지를 누를 때까지 캡처를 붙잡아 둡니다. Enter와 Tab은 바코드 문자열의 일부가 아닙니다.
- 그 결과를 의도한 설정과 비교합니다.
key,code, 타이밍을 포함해 각keydown을 순서대로 봐야 하면 키보드 이벤트 테스터를 열고 다시 스캔합니다.
입력 테스터는 브라우저가 볼 수 있는 키보드 이벤트를 기록합니다. 시리얼 포트를 읽을 수 없으므로 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 행은 그 바이트를 실어야 하는 인터페이스에서 실행하십시오. 실제 결과는 그 인터페이스와 애플리케이션에 따라 달라집니다.