Руководство пользователя

Инструкция по эксплуатации EasyJasper

EasyJasper — веб-редактор шаблонов этикеток JasperReports для маркировки Честного Знака. В нем можно открыть готовый шаблон или свой файл .jrxml/.jasper, изменить расположение и значения полей, проверить шаблон и скачать результат для использования в учетной системе.

1. Что нужно для работы

Для работы нужен современный браузер и доступ к сайту EasyJasper. Устанавливать программу на компьютер не требуется.

Редактор работает с файлами:

Открывать и редактировать .jrxml можно прямо в браузере. Для открытия .jasper, проверки, скачивания .jrxml, .png и сборки нового .jasper нужен вход по e-mail.

2. Вход в аккаунт

  1. Нажмите Профиль.
  2. Выберите Войти.
  3. Введите e-mail.
  4. Нажмите кнопку отправки кода.
  5. Откройте письмо с одноразовым кодом.
  6. Введите код в окне входа.

После входа в верхней панели появится ваш e-mail. Если код не пришел, проверьте папку со спамом и правильность адреса.

3. Как начать редактирование

Есть два способа начать работу: выбрать готовый шаблон или открыть свой файл.

3.1. Выбрать готовый шаблон

  1. В поле Категория выберите товарную группу: Одежда, Обувь или Универсальный.
  2. В поле Шаблон выберите подходящий вариант.
  3. Дождитесь сообщения, что шаблон открыт.

После этого на холсте появится этикетка, слева — список элементов, справа — предпросмотр и свойства выбранного элемента.

3.2. Открыть свой файл

  1. Нажмите Открыть файл.
  2. Выберите файл .jrxml или .jasper.
  3. Дождитесь загрузки шаблона.

Если вы открываете .jasper, редактор отправит файл на сервер для декомпиляции. Для этой операции требуется вход в аккаунт.

4. Основные зоны редактора

Верхняя панель содержит основные действия:

Левая панель Элементы показывает объекты шаблона: текстовые поля, штрихкоды, картинки, линии и прямоугольники.

Центральная область — холст этикетки. На нем можно выбирать элементы, перетаскивать их и менять размер.

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

5. Изменение размера этикетки

  1. Откройте шаблон.
  2. В поле Размер выберите готовый размер или оставьте Пользовательский.
  3. При необходимости измените Ширина, мм и Высота, мм.
  4. Проверьте, что все элементы остались внутри границ этикетки.

После изменения размера шаблона элементы не всегда автоматически перестраиваются под новый формат. Если что-то вышло за пределы этикетки, переместите элементы вручную.

6. Работа с элементами

6.1. Выбор элемента

Выберите элемент одним из способов:

После выбора справа появятся свойства элемента.

6.2. Перемещение

  1. Выберите элемент на холсте.
  2. Перетащите его мышью в нужное место.

Точные координаты можно задать в блоке Геометрия на правой панели:

6.3. Изменение размера

  1. Выберите элемент.
  2. Потяните за маркеры по краям элемента на холсте.
  3. Или введите точные размеры в блоке Геометрия.

6.4. Блокировка элемента

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

7. Работа с текстом и полями

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

Чтобы изменить тестовое значение в предпросмотре:

  1. Выберите текстовое поле на холсте или в списке элементов.
  2. В правой панели измените поле Значение.
  3. Посмотрите результат в блоке Предпросмотр.

Чтобы изменить формулу поля:

  1. Выберите текстовое поле.
  2. Измените поле Формула.
  3. Нажмите Проверить шаблон.

Меняйте формулы осторожно. Некорректная формула может помешать сборке .jasper.

7.1. Поворот текста

Редактор поддерживает обычные и вертикальные надписи JasperReports. Если в открытом .jrxml или .jasper текст был повернут, редактор сохранит это направление на холсте, в предпросмотре, PNG и при скачивании результата.

Чтобы изменить направление надписи:

  1. Выберите Текст или текстовое поле на холсте.
  2. В правой панели найдите поле Поворот.
  3. Выберите нужный вариант.

Поворот меняет только направление текста внутри рамки элемента. Положение и размер рамки задаются отдельно в блоке Геометрия.

8. Добавление новых элементов

  1. Откройте шаблон.
  2. В поле Добавить поле выберите нужный вариант.

Доступные варианты:

После добавления новый элемент появится на холсте и станет выбранным. Переместите его в нужное место и настройте размеры.

9. Работа со штрихкодом EAN-13

Штрихкод EAN-13 строится из значения GTIN.

Корректные варианты:

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

10. Работа с картинками

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

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

Редактор не загружает картинки из внешних URL, локальных путей и classpath-ресурсов.

11. Удаление и отмена удаления

Чтобы удалить элемент:

  1. Выберите элемент.
  2. Нажмите Delete на клавиатуре.

Чтобы отменить последнее удаление, нажмите Ctrl+Z или Cmd+Z на macOS.

Критический элемент Data Matrix нельзя удалить в редакторе.

12. Предпросмотр

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

Чтобы открыть предпросмотр крупнее, нажмите на изображение предпросмотра.

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

В поле Режим можно выбрать:

13. Проверка шаблона

Перед выгрузкой нажмите Проверить шаблон.

Редактор проверяет структуру шаблона и собирает .jasper для контроля размера. Если ошибок нет, появится сообщение об успешной проверке и размере .jasper.

Если есть ошибки:

  1. Прочитайте сообщение в правой панели или в верхней части редактора.
  2. Исправьте проблемное поле, размер или формулу.
  3. Запустите проверку повторно.

Если размер .jasper превышает лимит, уменьшите шаблон или удалите лишние тяжелые элементы.

14. Скачивание результата

Чтобы скачать результат, нажмите Скачать Jasper.

Редактор скачает ZIP-архив. В архив входят:

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

15. Что передать в учетную систему

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

Рекомендуемый порядок хранения:

  1. .jrxml — хранить как рабочую версию шаблона.
  2. .jasper — загружать в учетную систему.
  3. .png — использовать для визуальной проверки или согласования.

16. Типовые проблемы

Не открывается файл

Проверьте, что файл имеет расширение .jrxml или .jasper. Файлы .xml без расширения .jrxml не поддерживаются.

Также проверьте размер файла. Слишком большие файлы редактор не принимает.

При открытии .jasper просит войти

Это нормально. Для открытия .jasper нужна серверная декомпиляция, поэтому требуется вход по e-mail.

Не скачивается .jasper

Проверьте:

В предпросмотре не те значения

Предпросмотр использует тестовые значения. Выберите нужное поле и измените Значение в правой панели. Это не обязательно меняет реальные данные в учетной системе, а только помогает проверить внешний вид этикетки.

Вертикальная надпись отображается не так, как нужно

Выберите текстовый элемент и проверьте поле Поворот в правой панели. Для вертикальных надписей обычно используется Влево или Вправо.

Если после поворота текст обрезается, увеличьте Ширина, мм или Высота, мм в блоке Геометрия. Рамка элемента не поворачивается: меняется только направление текста внутри нее.

Штрихкод EAN-13 не отображается корректно

Проверьте GTIN. Для EAN-13 нужно 13 цифр или 14 цифр с ведущим нулем.

Картинка отображается как заглушка

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

17. Рекомендации перед внедрением шаблона

Перед загрузкой .jasper в учетную систему:

  1. Проверьте размер этикетки.
  2. Проверьте положение Data Matrix и штрихкодов.
  3. Проверьте читаемость текста.
  4. Проверьте шаблон кнопкой Проверить шаблон.
  5. Скачайте архив через Скачать Jasper.
  6. Сохраните .jrxml как исходник на случай будущих правок.
  7. Загрузите .jasper в учетную систему и сделайте тестовую печать.

18. Обратная связь

Если возникла проблема или нужен новый шаблон:

  1. Нажмите Профиль.
  2. Выберите Обратная связь.
  3. Укажите тип обращения, тему и описание.
  4. Отправьте сообщение.

В описании полезно указать:

Готовы попробовать?

Откройте редактор и соберите первый .jasper-шаблон для СУЗ.

Открыть редактор Посмотреть инструкции