Структура шаблона .jasper для этикетки Честного ЗНАКа: поля и зоны кодов

Опубликовано: 18 июля 2026·Обновлено: 27 сентября 2026·Проверено: 10 сентября 2026·6 мин·Анна Сергеевна
Схема блока .jasper с зонами для наименования, штрихкода и Data Matrix

.jasper является скомпилированным шаблоном. Он отвечает за позицию элементов и типы данных на наклейке. Исходник JRXML предпочтительнее для правок: восстановленная структура из .jasper не равна удобному исходному проекту. Кодовые значения приходят позже из вашей операционной цепочки.

Jasper-шаблон для Честного ЗНАКа стоит разбирать по структуре: сначала размер страницы, затем обязательные поля и кодовые зоны. Эта статья посвящена полям и геометрии. Каталог готовых файлов рассматривается отдельно.

Если вам нужна просто готовая этикетка 58×40 с Data Matrix, возьмите шаблон этикетки Честного ЗНАКа 58×40: там же ответ, какой размер этикетки выбрать, и PDF для термопринтера. Свой .jasper под другой размер удобно собрать в ЗНАКЕТА Студио.

Если упростить цепочку, логика такая:

  • рисуете шаблон в JRXML;
  • компилируете в .jasper;
  • на этапе заполнения в подстановки попадают реальные значения;
  • отдельная система печати заполняет шаблон и формирует этикетку или PDF.

.jasper определяет, где лежит информация. Состав данных формируется вашей системой печати.

Главный практический риск связан с раскладкой кодов и текстов по полям. Декоративная вёрстка вторична.

Почему .jasper нельзя путать с генератором кодов

В документации JasperReports .jasper является скомпилированным шаблоном отчёта. В Честном ЗНАКе он используется как макет этикетки и не создаёт коды за вас.

Фраза «Сделайте шаблон и система сама закодирует всё» вводит в заблуждение. Получение кодов и вёрстка проходят отдельными этапами.

Ключевая геометрия: сначала размер, потом элементы

Смотрите на размер этикетки как на базу для всей логики. Если холст неверный, даже идеальные поля сломаются позже.

В первую очередь проверьте:

  • общие габариты в мм и DPI;
  • соотношение между зонами для кодов, текстом и доп.полями;
  • запас по краям для возможного сдвига печати;
  • читаемость на реальной печати, а не в предпросмотре.

В ЧЗ требования чаще всего касаются качества и читаемости кода. Товарный текст размещайте в доступной свободной зоне.

Что обязательно в структуре этикетки

Независимо от формата этикетки структура обычно та же:

  1. Поле с основным наименованием. Проверьте его на коротких и длинных значениях.
  2. Поле EAN-13 или Code 128. Добавляйте его, если такой товарный или внутренний код нужен в вашем процессе.
  3. Поле Data Matrix. Оно предназначено для Честного ЗНАКа.
  4. Доп.текст и служебная информация. Добавляйте их при наличии свободного места.
  5. Бренд/логотип. Отведите для него отдельную зону при необходимости.

Если начать с этой структуры, шаблон проще адаптировать для разных товаров и проверять после изменений.

Как отделять читаемые коды от текстов

Для 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 в Честный ЗНАК».

Источники

Вопросы и ответы

Что такое .jasper на практике?

.jasper это скомпилированный шаблон JasperReports. В нём лежит структура макета и правила отображения, но не сами коды и не значения полей.

При заполнении карточки данные подставляются сами?

Нет. Значения приходят из вашего источника: карточки товара, выгрузки из CRM, ERP или системы Честного ЗНАКа. Шаблон только определяет, куда их выводить.

Какие блоки обычно нужны для этикетки 58×40?

Обычно это блок наименования, Data Matrix и, если он нужен в вашем процессе, EAN-13 или Code 128. Главное условие состоит в сохранении читаемости кодов.

Чем отличается Data Matrix от EAN-13 в шаблоне?

Это разные сущности: EAN-13 нужен только при наличии 13-значного товарного кода, а Data Matrix уникален для каждой единицы и используется как код Честного ЗНАКа.

Нужна ли тишина вокруг Data Matrix?

Да, код работает лучше, когда вокруг него есть чистая зона и он не упирается в текст или линию. Но на считывание также влияют макет, принтер, материал, контраст, повреждения и сами данные.

Можно ли импортировать чужой .jasper в Студии и доправлять его?

ЗНАКЕТА Студио импортирует .jasper, .jrxml и ZIP с ресурсами. После импорта проверьте предупреждения и доступность правок для конкретных элементов.

Как понять, что шаблон готов к печати?

Если все блоки помещаются внутри холста, коды не пересекаются, логотип и текст не закрывают кодовые зоны и предпросмотр повторяется под ваш размер, можно идти в тестовую печать.

Создайте .jasper-макет в ЗНАКЕТА Студио

Соберите шаблон в браузере, скачайте ZIP с sticker.jasper и проверьте импорт.

Собрать макет в Студии

Инструменты по теме

Читайте также