Блог

Как подготовить шаблон этикетки Jasper для Честного знака

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

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

Какой результат вам нужен

Для работы с Честным знаком обычно нужны два файла:

• файл .jasper — загружается в СУЗ и используется при создании этикеток;
• изображение .png — помогает увидеть и выбрать нужный шаблон в списке.

Главный файл — .jasper. Именно он определяет, где на этикетке будут расположены Data Matrix, название товара, артикул, размер, цвет, состав, штрихкод и другие сведения.

В СУЗ пользовательские шаблоны добавляются в разделе «Этикетки». При загрузке указываются размеры этикетки и вариант печати.

Зачем нужен собственный шаблон

Стандартные шаблоны Честного знака подходят не для всех задач. Например, вам может потребоваться:

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

В личном кабинете Честного знака доступны стандартные варианты, но для собственного расположения информации нужен пользовательский шаблон. Официальная инструкция предлагает скачать один из шаблонов СУЗ, изменить его и загрузить обратно.

Как создать шаблон без сложных программ

Традиционно шаблоны Jasper редактируют в программе Jaspersoft Studio. Это профессиональный инструмент с большим количеством настроек, поэтому он может оказаться сложным для пользователя, которому нужно просто подготовить этикетку.

В EasyJasper работа происходит в визуальном редакторе:

1. Выберите готовый шаблон или загрузите свой файл.
2. Укажите размер этикетки.
3. Разместите необходимые поля.
4. Добавьте текст, изображения и штрихкоды.
5. Проверьте, как будет выглядеть этикетка.
6. Скачайте готовый файл .jasper.
7. Загрузите его в СУЗ.

Вам не нужно самостоятельно писать код или разбираться во внутреннем устройстве JasperReports.

Что такое .jasper и .jrxml простыми словами

При работе с шаблонами вы можете встретить два расширения.

Файл .jasper

Это готовый шаблон для Честного знака.

Его необходимо загрузить в СУЗ. Открывать и вручную изменять содержимое такого файла не требуется.

Файл .jrxml

Это редактируемая версия шаблона.

Она нужна, если вы хотите сохранить макет и позднее снова его изменить. После редактирования из неё создаётся новый файл .jasper.

Можно представить это так:

JRXML — рабочий макет → JASPER — готовый файл для загрузки

Для обычной работы достаточно запомнить:

• хотите продолжить редактирование — сохраняйте .jrxml;
• хотите загрузить шаблон в Честный знак — скачивайте .jasper.

Можно ли изменить готовый файл .jasper

Да, если редактор поддерживает загрузку таких файлов.

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

Не пытайтесь получить рабочий шаблон простым переименованием файла .jrxml в .jasper. Расширение изменится, но файл не станет готовым шаблоном: его необходимо правильно скомпилировать. Подобная ошибка упоминается и в обсуждениях загрузки шаблонов на официальном сайте сообщества Честного знака.

Как загрузить готовый шаблон в СУЗ

После скачивания файла .jasper:

1. Войдите в личный кабинет Честного знака.
2. Откройте Станцию управления заказами.
3. Перейдите в раздел «Этикетки».
4. Выберите добавление пользовательского шаблона.
5. Загрузите файл .jasper.
6. Укажите ширину и высоту этикетки.
7. При необходимости добавьте изображение для предварительного просмотра.
8. Сохраните шаблон.
9. Проверьте его на небольшом количестве кодов перед массовой печатью.

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

Почему шаблон может не загрузиться

Наиболее распространённые причины:

• вместо .jasper загружается переименованный файл .jrxml;
• шаблон собран в несовместимой версии JasperReports;
• неправильно добавлено изображение;
• файл повреждён;
• указанные в СУЗ размеры отличаются от размеров макета;
• внутри шаблона используются неподдерживаемые шрифты или элементы.

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

Какие файлы лучше сохранить

После завершения работы рекомендуется сохранить:

• .jasper — для загрузки в СУЗ;
• .jrxml — для будущего редактирования;
• .png — для предварительного просмотра;
• пробный .pdf — чтобы проверить расположение элементов до печати.

Так вам не придётся создавать этикетку заново, если позже понадобится изменить размер, текст или добавить новое поле.

Главное

Для печати собственной этикетки через Честный знак вам нужен готовый файл .jasper.

В EasyJasper можно визуально подготовить макет, проверить его и скачать нужный файл без ручного редактирования XML и изучения Jaspersoft Studio.

Создайте этикетку → проверьте результат → скачайте .jasper → загрузите его в СУЗ.