Начните с одного простого образца для известной модели принтера и конкретного носителя. Запишите ширину, высоту и плотность печати, затем добавляйте поля по одному. Красивый макет на экране не подтверждает, что этикетка поместится на рулоне и будет одинаково печататься на устройствах с другой плотностью.
ZPL — команды для устройства, поэтому название товара нельзя просто вставлять в поток команд без обработки. Сначала определите допустимые данные и способ их кодирования выбранной библиотекой. Отдельно храните версию макета и параметры принтера: изменение товара не должно менять управляющую структуру задания.
Минимальный образец помогает проверить тракт печати
Учебный пример с латинским текстом:
^XA
^FO30,30^A0N,30,30^FDTEST-42^FS
^XZ
Перед отправкой проверить носитель и поддержку ZPL.
Это один тестовый образец, не производственная партия.В руководстве Zebra ^XA и ^XZ обозначают границы формата, ^FO задаёт положение поля, ^FD — данные, ^FS завершает поле. Руководство проверено 26 октября 2026 года. Пример намеренно использует латиницу: доступность нужных шрифтов и кодировки для кириллицы проверяется отдельно на конкретной модели.
Если этот образец не появляется, сначала разберите путь передачи, язык устройства и состояние печати. Добавление штрихкода, логотипа и десяти переменных полей одновременно сделает причину неясной. Подтвердив простой формат, сохраните его как контрольный файл для сравнения с реальным заданием.
Макет получает паспорт, а поле — пределы
| Часть паспорта | Что зафиксировать |
|---|---|
| Устройство | Модель, язык и плотность |
| Носитель | Размер и рабочая область |
| Макет | ID и версия |
| Поля | Тип, длина и правила переноса |
| Кодирование | Обработка специальных символов и шрифт |
| Проверка | Образец и дата контрольной печати |
Координаты задаются в точках печати. Перед переносом макета на другую плотность пересчитайте физические размеры, а не только внешний вид текста. Уменьшение шрифта ради длинного названия не должно незаметно уменьшать обязательную читаемую информацию или нарушать требования к коду.
Для каждого поля решите, что делать с переполнением: ограничивать ввод, переносить по правилам или использовать согласованный сокращённый текст. Молчаливое обрезание артикула опаснее некрасивой строки: сотрудник может выбрать другой товар. Проверяйте крайние значения заранее, а не только короткое демонстрационное название.
Управляющие символы ZPL и переводы строк в пользовательских данных требуют предусмотренного кодирования или ограничения. Используйте проверенный генератор, который различает команды и содержимое поля. Замена одной кавычки, привычная для SQL, не является защитой для другого языка команд.
Не храните единственный шаблон прямо в пользовательской карточке товара. Тогда правка описания или импорт способны сломать весь формат. Пусть карточка поставляет значения по контракту, а проверенная версия макета определяет их размещение. Перед массовой печатью полезно сохранять точный сформированный образец без лишних персональных данных.
Экранный просмотр завершается физической проверкой
- Проверить короткий контрольный текст на одном устройстве.
- Добавить реальные поля с синтетическими значениями.
- Испытать длинное название, пустое поле и специальные символы.
- Напечатать единичный образец на нужном носителе.
- Проверить чтение добавленного кода сканером и закрепить версию.
Онлайн-просмотрщик удобен для геометрии, но не воспроизводит весь тракт конкретного драйвера и устройства. Не загружайте в сторонний сервис реальные адреса и заказы ради предпросмотра: для макета достаточно вымышленных значений. Размер и читаемость всё равно проверяются по физической этикетке.
Добавленный штрихкод проверяйте отдельно: сравните прочитанное сканером значение с исходным полем, включая ведущие нули. Внешне похожие полосы не гарантируют правильного содержимого. Не добавляйте контрольную цифру дважды, если её формирование уже выполняет выбранный тип кода или библиотека.
Сохранённый комплект для следующей правки должен включать версию макета, профиль устройства и несколько граничных примеров. С ним можно понять, сломалась ли геометрия после изменения шаблона или проблема появилась в новых данных. Массовый запуск разрешайте только для уже проверенной комбинации макета и носителя.