Блог

Что такое файлы .jasper и .jrxml

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

Что такое .jrxml

JRXML — это редактируемый исходный файл шаблона JasperReports в формате XML.

В нём хранится описание макета этикетки:

размер и ориентация этикетки;
расположение текста, изображений и линий;
поля и параметры шаблона;
выражения и переменные;
штрихкоды и коды маркировки;
настройки шрифтов, выравнивания и оформления.

Файл .jrxml можно изменять в JasperSoft Studio или в совместимом визуальном редакторе, например EasyJasper.

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

Что такое .jasper

JASPER — это скомпилированная версия шаблона JasperReports.

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

Упрощённо процесс выглядит так:

JRXML → компиляция → JASPER

Как эти форматы используются в EasyJasper

Работа с шаблоном проходит в несколько этапов:

Пользователь открывает готовый шаблон или загружает собственный файл.
Редактор преобразует шаблон во внутреннее JRXML-представление.
Пользователь визуально изменяет макет этикетки: добавляет поля, текст, изображения и штрихкоды.
Перед выгрузкой можно проверить внешний вид этикетки на примере PDF или изображения.
После проверки сервис компилирует шаблон.
Готовый файл .jasper можно загрузить в СУЗ.

Чем отличается .jrxml от .jasper

Формат	Назначение	Можно редактировать
`.jrxml`	Исходный код и структура шаблона	Да
`.jasper`	Скомпилированный шаблон для загрузки и печати	Напрямую — нет

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

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

Файл .jasper является результатом компиляции. Он предназначен для выполнения JasperReports, а не для ручного или визуального редактирования.

Это похоже на различие между исходным кодом программы и готовым исполняемым файлом: готовый файл можно запустить, но изменять его намного сложнее, чем исходник.

Поэтому наиболее надёжный процесс выглядит так:

открыть или создать JRXML-шаблон;
внести необходимые изменения;
проверить результат;
скомпилировать новый файл .jasper.

Если у вас сохранился только файл .jasper, EasyJasper может попытаться открыть его для дальнейшего редактирования. Однако при сложных шаблонах отдельные настройки могут потребовать дополнительной проверки.

Какой файл нужно сохранять

Рекомендуется сохранять оба файла:

.jrxml — для последующего редактирования;
.jasper — для загрузки в СУЗ и использования при печати этикеток.

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

Краткий итог

JRXML — редактируемый исходник шаблона.

JASPER — скомпилированный файл, готовый для загрузки в СУЗ.

Создавать и изменять этикетку удобнее в формате JRXML, а после завершения работы экспортировать её в .jasper.