Khắc phục lỗi mã vạch, in tem và quét trong Label Studio
Bắt đầu từ biểu hiện lỗi, rồi kiểm tra dữ liệu, bố cục, thiết lập máy in hoặc quyền trình duyệt. Bảng bên dưới phân biệt lỗi có thể sửa bằng cài đặt với dữ liệu nguồn ứng dụng không khôi phục được. Sao lưu trước khi thay danh mục.
Quyền riêng tư và các giới hạn cần nhớ

File, payload, logo, khung camera và giải mã ảnh đều xử lý trên thiết bị. Ứng dụng không có tài khoản, API tải tài liệu lên máy chủ hoặc analytics ứng dụng. Nhà cung cấp hosting/CDN vẫn có thể giữ nhật ký truy cập tài nguyên thông thường. QR chứa danh bạ hay mật khẩu Wi-Fi để lộ nội dung đó cho người đọc mã.
Dữ liệu trình duyệt có thể mất khi xóa dữ liệu website, kết thúc phiên riêng tư, bị thu hồi dung lượng hoặc do chính sách tổ chức. Quan sát trạng thái lưu; nếu lỗi, tải sao lưu ngay. Không có đồng bộ đám mây hoặc danh mục dùng chung tự động.
| Hạng mục | Giới hạn |
|---|---|
| Bảng tính / danh sách | 20 MiB / 50.000 bản ghi |
| Ánh xạ / chọn tiêu đề | 100 cột đầu / 100 dòng đầu |
| Giá trị mã | 2.000 ký tự, còn phụ thuộc chuẩn; ô nội dung trình tạo QR tối đa 1.500 ký tự trước khi định dạng payload |
| PDF hoặc SVG ZIP | 2.000 tem, tính cả số bản in |
| PNG ZIP | 200 tem; tổng ảnh 100 MiB |
| PNG/SVG đơn | Đúng một tem đầu ra |
| Khôi phục dự án | 100 MiB, schema phiên bản 1 được hỗ trợ |
| Nhật ký quét | 50.000 sự kiện mỗi phiên |
| Bảng kiểm kê | Hiện 100 bản ghi đầu; CSV có toàn bộ |
| Logo | PNG/JPEG, 2 MiB, 16 megapixel |
| Ảnh quét | PNG/JPEG/WebP, 20 MiB, 100 triệu pixel đầu vào |
Xử lý lỗi và checklist cho một lô thực tế
| Vấn đề | Các bước xử lý |
|---|---|
| Mất số 0 đầu hoặc sai serial dài | Kiểm tra file gốc, xuất lại cột định danh dưới dạng Text; không khôi phục được chữ số đã bị Excel làm mất. |
| Code 39/128 không hợp lệ | Đối chiếu quy tắc ký tự; sửa nguồn có chủ đích hoặc đổi chuẩn phù hợp, không trông chờ tự đổi kiểu chữ. |
| EAN/UPC sai số kiểm tra | Xác minh mã đã được cấp từ nguồn; không tự bịa mã bán lẻ để hết cảnh báo. |
| Chữ tràn khung | Tăng khung chữ, giảm cỡ chữ hoặc rút ngắn trường dữ liệu. |
| Mã quá nhỏ | Tăng khung/khổ tem, giảm nội dung và chọn đúng DPI máy in. |
| Không thấy mã hoặc không có gì để xuất | Xóa bộ lọc, kiểm tra trạng thái ẩn/loại khỏi xuất, phạm vi chọn và số tem. |
| In lệch hoặc sai tỷ lệ | In trang hiệu chỉnh ở 100%; sửa tỷ lệ trước rồi mới bù ngang/dọc, lề và khoảng cách. |
| Camera không chạy | Dùng HTTPS, xem quyền website và thiết bị; đóng ứng dụng chiếm camera hoặc quét ảnh. |
| Ảnh không đọc được | Dùng ảnh nét, ánh sáng đều, đủ khoảng trắng; nhập chính xác giá trị bằng tay nếu cần. |
| Phiên quét cũ sau sửa danh mục | Xuất lịch sử cũ và tạo phiên mới. |
| Nhiều kết quả khớp | Xử lý giá trị trùng trong danh mục, không giả định hệ thống đã đếm một hàng bất kỳ. |
| Bị chặn tải hoặc cửa sổ PDF | Cho phép tải/pop-up hoặc tải PDF thay vì mở để in. |
| Lỗi lưu dữ liệu | Tải sao lưu ngay, kiểm tra bộ nhớ trình duyệt và tránh xóa dữ liệu website. |
| Mở tên miền mới thấy dự án trống | Khôi phục sao lưu từ origin cũ; dữ liệu không tự chuyển giữa các địa chỉ. |
Với một lô thực tế: sao lưu → nhập/ánh xạ → kiểm tra giá trị/lỗi/trùng → chọn chuẩn → thiết kế → kiểm tra phạm vi/số bản in → hiệu chỉnh → quét thử tem thật → in → tạo phiên đối chiếu mới → xuất báo cáo → sao lưu lại.
Các ý tưởng đã thảo luận như làm sạch dữ liệu tự động, so hai file danh sách, quy tắc SKU, máy tính check digit riêng, cắt/ghép PDF và ZPL chưa phải chức năng của bản hiện tại. Hướng dẫn này mô tả ứng dụng đã có, không biến kế hoạch thành tính năng đã triển khai.
Câu hỏi thường gặp
Bảng tính có bị tải lên máy chủ ứng dụng không?
Nội dung tài liệu và giải mã camera được xử lý cục bộ. Hosting/CDN vẫn có thể giữ nhật ký truy cập tài nguyên thông thường.
Bộ nhớ trình duyệt có thay sao lưu được không?
Không. Xóa dữ liệu website, phiên riêng tư, thu hồi dung lượng hoặc chính sách tổ chức có thể làm mất dự án. Hãy tải JSON thường xuyên.