.jasper является скомпилированным шаблоном. Он отвечает за позицию элементов и типы данных на наклейке. Исходник JRXML предпочтительнее для правок: восстановленная структура из .jasper не равна удобному исходному проекту. Кодовые значения приходят позже из вашей операционной цепочки.
Jasper-шаблон для Честного ЗНАКа стоит разбирать по структуре: сначала размер страницы, затем обязательные поля и кодовые зоны. Эта статья посвящена полям и геометрии. Каталог готовых файлов рассматривается отдельно.
Если вам нужна просто готовая этикетка 58×40 с Data Matrix, возьмите шаблон этикетки Честного ЗНАКа 58×40: там же ответ, какой размер этикетки выбрать, и PDF для термопринтера. Свой .jasper под другой размер удобно собрать в ЗНАКЕТА Студио.
Если упростить цепочку, логика такая:
- рисуете шаблон в JRXML;
- компилируете в
.jasper; - на этапе заполнения в подстановки попадают реальные значения;
- отдельная система печати заполняет шаблон и формирует этикетку или PDF.
.jasper определяет, где лежит информация. Состав данных формируется вашей системой печати.
Главный практический риск связан с раскладкой кодов и текстов по полям. Декоративная вёрстка вторична.
Почему .jasper нельзя путать с генератором кодов
В документации JasperReports .jasper является скомпилированным шаблоном отчёта. В Честном ЗНАКе он используется как макет этикетки и не создаёт коды за вас.
Фраза «Сделайте шаблон и система сама закодирует всё» вводит в заблуждение. Получение кодов и вёрстка проходят отдельными этапами.
Ключевая геометрия: сначала размер, потом элементы
Смотрите на размер этикетки как на базу для всей логики. Если холст неверный, даже идеальные поля сломаются позже.
В первую очередь проверьте:
- общие габариты в мм и DPI;
- соотношение между зонами для кодов, текстом и доп.полями;
- запас по краям для возможного сдвига печати;
- читаемость на реальной печати, а не в предпросмотре.
В ЧЗ требования чаще всего касаются качества и читаемости кода. Товарный текст размещайте в доступной свободной зоне.
Что обязательно в структуре этикетки
Независимо от формата этикетки структура обычно та же:
- Поле с основным наименованием. Проверьте его на коротких и длинных значениях.
- Поле EAN-13 или Code 128. Добавляйте его, если такой товарный или внутренний код нужен в вашем процессе.
- Поле Data Matrix. Оно предназначено для Честного ЗНАКа.
- Доп.текст и служебная информация. Добавляйте их при наличии свободного места.
- Бренд/логотип. Отведите для него отдельную зону при необходимости.
Если начать с этой структуры, шаблон проще адаптировать для разных товаров и проверять после изменений.
Как отделять читаемые коды от текстов
Для Data Matrix и линейного штрихкода лучше отвести отдельные зоны. Не ставьте их вплотную к тексту и краю.
Поэтому в вёрстке обычно делают:
- один блок для EAN-13 с собственным отступом;
- отдельный блок для Data Matrix на белом фоне;
- самостоятельное пространство под логотип и наименование.
Даже если визуально всё «красиво», при съезде принтера или неидеальном материале сканеры начинают видеть границы по-другому. Это и есть тот случай, когда внешне красивый макет не работает в потоке.
Блоки и блокировки в шаблоне
JasperReports поддерживает поля, изображения и блоки для штрихкодов, и это как раз те элементы, которыми вы оперируете в макете.
Важно:
textFieldиlineзадают, где и как показывать текст;imageнужен для логотипа, но лучше с фиксированным прямоугольником;barcode/dataMatrixдобавляют только элемент размещения, не источник данных.
В редакторе Студии вы настраиваете блоки, проверяете предпросмотр и при доступной квоте экспортируете ZIP с файлом sticker.jasper. Для обычного импорта в СУЗ из ZIP извлекают именно sticker.jasper. Отдельный ZIP-сценарий официальной инструкции с картинкой проверяйте отдельно.
Где поставить логотип, чтобы не мешать считыванию
Логотип не относится к обязательным блокам маркировки. Если его нужно вывести, держите его вне зоны потенциального скана. В маленьком поле бренд и Data Matrix лучше разделять отдельными зонами.
Рабочее правило для каждой партии: сначала кодовая зона, затем логотип и вторичные поля. Если всё не помещается в один формат, упростите дополнительный контент и сохраните размер кода.
В каком порядке собирать макет
Ниже рабочий порядок сборки:
- выбрать итоговый формат этикетки и проверить его в предпросмотре;
- зафиксировать обязательные блоки: текст и Data Matrix, а EAN-13 или Code 128 добавить только при необходимости;
- отвести отдельные зоны под коды;
- добавить вспомогательные тексты только после того, как кодовые блоки стабилизированы;
- вставить изображение только как отдельный элемент в свободной зоне;
- сделать пробную сборку и сохранить шаблон.
Чем меньше вариативных элементов до проверки, тем легче найти реальную причину ошибки на печати и не переписывать весь макет.
Как разделены Студио и Честный ЗНАК
Есть две стадии:
- Стадия макета: вы собираете
.jasper, который хранит структуру этикетки. - Стадия маркировки: коды и статусы обрабатываются в Честном ЗНАКе/ГИС МТ, после чего макет используется для печати.
Поэтому макет не заменяет работу с кодами и настройку печати.
Контрольный чек-лист перед выгрузкой
- Нет ли блоков за пределами холста;
- Нет ли пересечений между Data Matrix и EAN-13;
- Есть ли визуальный и технологический запас вокруг кодов;
- Логотип и текст не «перекрывают» кодовые зоны;
- Предпросмотр подтверждён для целевой партии;
- Формат соответствует вашему процессу печати.
Если эти пункты закрыты, макет можно отправлять дальше в печать.
Что делать, если код периодически не сканируется
Причина может быть в макете, печати, материале или самих данных. Начните с проверки всей цепочки:
- при смене рулона печать смещается из-за подачи, калибровки или несоответствия размера носителя;
- код стоит слишком близко к тексту или к краю;
- в предпросмотре был один формат бумаги, а печать идёт на другом;
- в одной партии менялся набор полей и часть строк «выпадает» из зоны.
Если геометрия верна, проверьте контраст, нагрев и скорость принтера, качество материала, повреждения этикетки и исходное значение кода.
Что важно помнить про проверку шаблона в ЗНАКЕТА Студио
Работа в Студио заканчивается скачиванием ZIP, но это ещё не подтверждает совместимость и качество печати. Окончательная проверка состоит из распаковки sticker.jasper, импорта в целевую систему, пробной печати и считывания рабочим сканером.
Минимальная последовательность сборки
Начните с размера страницы. В редакторе задайте ширину и высоту этикетки, затем проверьте их в предпросмотре. В официальной инструкции Честного ЗНАКа указан лимит 100 Кбайт. Для термотрансферной печати приведены размеры 10–110 × 10–300 мм и допуск более 10%. После этого добавьте Data Matrix, квадратный блок для кода маркировки. Выбор товарного штрихкода зависит от данных и требований получателя. EAN-13 требует подходящего 13-значного номера; Code 128 используйте только для принимаемого получателем значения в этой символике.
Текстовые блоки и поля товара ставьте после кодов. К тексту относятся название, артикул, размер, состав и другие значения рабочего процесса. Изображение добавляйте отдельным блоком и сохраняйте пропорции. Линии и прямоугольники используйте для визуального разделения зон, но не размещайте их поверх кодов.
.jasper хранит правила расположения и отображения этих блоков. Он не хранит реальные коды маркировки конкретной партии. Коды получает и обрабатывает Честный ЗНАК, а шаблон определяет, где они будут напечатаны.
Проверьте три сценария: короткое название, обычное и самое длинное из каталога. Убедитесь, что Data Matrix и выбранный товарный штрихкод остаются внутри рамки, а текст не попадает в свободную зону кода. При нестабильном сканировании проверьте макет, принтер, материал, контраст, повреждения и данные, включая размер блока. Сохраните утверждённый размер, список блоков и дату проверки. О создании макета онлайн читайте в статье «Как создать Jasper-макет этикетки онлайн». Порядок загрузки описан в статье «Как загрузить Jasper в Честный ЗНАК».
