Ошибки шаблона

Шаблон формирует больше одной страницы

Если при формировании PDF появляется сообщение «Шаблон должен формировать ровно одну страницу для одной записи» или «Шаблон должен формировать ровно одну страницу для одной записи; получено 2», значит одна запись в шаблоне этикетки не помещается на одну страницу.

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

Почему это важно

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

Частые причины

• Поле слишком высокое или выходит за границы этикетки.
• Длинный текст не помещается в отведенную область.
• В исходном JRXML поле было настроено как растягивающееся.
• В шаблоне есть элементы ниже рабочей области страницы.
• Размер страницы, отступы или высота band настроены неправильно.

Что сделать

1. Откройте шаблон в редакторе.
2. Проверьте поля с длинным текстом: наименование, состав, адрес, модель, бренд.
3. Уменьшите высоту, размер шрифта или длину текста в таких полях.
4. Если поле продолжает вызывать ошибку, удалите его и создайте заново с теми же данными, например $F{name} или $F{address}.
5. Убедитесь, что все элементы находятся внутри границ этикетки.
6. Снова сформируйте PDF.

Можно ли игнорировать ошибку

Нет. Ошибка означает, что шаблон технически формирует не одну этикетку на запись, а несколько страниц. Такой шаблон лучше исправить до использования в Честном Знаке или печати.

Если шаблон был сделан в другом редакторе

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

Как понять, какое поле вызывает ошибку

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

Если шаблон был сделан в другом редакторе, проблемное поле можно удалить и создать заново с теми же данными, например $F{name} или $F{address}.

При обращении в поддержку укажите код обращения из ошибки. По нему можно найти шаблон и точнее определить причину.