Windows 키오스크 라벨 Agent

PMS·WMS 웹 화면에서 라벨 출력 버튼을 눌러도 브라우저만으로는 Windows PC에 연결된 프린터를 직접 제어하거나 장비별 명령을 안정적으로 전달하기 어려웠습니다.

라벨 데이터가 만들어지는 방식도 달랐습니다. PMS 상품·팔레트 라벨은 PMS 백엔드에서 템플릿을 조회해 만들지만, WMS 라벨은 WMS 백엔드가 생성해 웹 화면에서 전달한 ZPL을 우선 사용합니다. 따라서 모든 라벨 요청을 하나의 변환 방식으로 처리할 수 없었습니다.

현장에서 다룬 프린터는 Bixolon과 Zebra입니다. Bixolon에는 40×30 mm 상품 라벨과 80×80 mm 팔레트 라벨, Zebra에는 100×100 mm WMS 출고 라벨·팔레트 라벨을 사용했습니다. 웹에서 요청이 들어오면 라벨의 출처·프린터 종류·용지 규격을 구분하고, 현장 PC에서 올바른 출력 경로로 연결할 로컬 프로그램이 필요했습니다.

1. 요청 접수: 웹 화면이 보낸 라벨 요청을 Agent의 ASP.NET Core localhost API에서 받습니다. localhost는 키오스크가 실행 중인 같은 Windows PC를 뜻합니다.
2. 라벨 데이터·템플릿 처리: PMS 상품·팔레트 라벨은 설정된 PMS 백엔드에서 필요한 템플릿을 조회해 라벨 데이터에 적용합니다. WMS 라벨은 웹 화면이 전달한 WMS 생성 ZPL을 우선 사용합니다. 전달된 ZPL이 없을 때만 PMS 템플릿 조회 경로를 적용합니다.
3. 출력 경로 선택: 라벨 유형과 프린터에 맞춰 전송 형식을 정합니다. Zebra 계열에는 ZPL 경로를, Bixolon 계열에는 ZPL을 이미지로 변환한 ESC/POS 경로를 연결했습니다.

제가 맡은 범위는 로컬 API의 라벨 요청 처리, 데이터 출처에 맞는 템플릿·ZPL 적용, 프린터별 출력 경로, 그리고 프린터 설정 복원 정책입니다.

같은 라벨 내용도 프린터가 해석하는 명령이 다릅니다. Zebra 계열은 라벨 배치 정보가 담긴 ZPL을 받습니다. Bixolon 계열의 해당 출력 경로는 ZPL을 그대로 보내는 대신, 라벨을 그림으로 렌더링한 뒤 ESC/POS(이미지를 전송하는 프린터 명령 형식)로 보냅니다. 상품·팔레트·WMS 출고 라벨은 용도와 용지 크기도 서로 달라, 라벨 유형과 프린터에 맞는 출력을 선택해야 했습니다.

따라서 WMS가 준비한 ZPL의 라벨 내용을 우선 보존하되, 출력 직전에 프린터 유형에 맞는 경로로 분기했습니다. Bixolon의 40×30·80×80 mm와 Zebra의 100×100 mm 용지 구분도 이 경계에 포함됩니다.

프린터 목록이 일시적으로 비어도 저장된 선택값을 지우지 않도록 복원 정책을 분리했습니다. 목록이 다시 나타났을 때의 재선택과 대소문자 차이도 포함해 MSTest 7개로 정책을 검증했습니다.