4.2. Шаблон отчёта

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

Рассмотрим форму добавления шаблона:

report template
Рисунок 31. Редактор шаблона
  • Template code – код шаблона для его идентификации.

  • Template file – файл шаблона, который загружается из файловой системы и сохраняется в базе данных вместе с описанием структуры отчёта.

  • Output type – тип вывода отчёта. Должен быть согласован с типом файла шаблона по правилам, описанным в секции Соответствие типа шаблона типу вывода.

  • Output name pattern – необязательное имя файла, которое будет использоваться для выгрузки готового отчёта. Паттерн имени файла может быть как постоянной строкой, так и содержать параметры отчёта в качестве переменных, например, ${header.authorName}.xlsx. Более сложные паттерны с несколькими параметрами и конкатенацией строк можно также создать скриптом в любой полосе в структуре отчёта, например, ${Root.title}.xlsx, где title является результатом следующего скрипта:

    [['title' : ('Report for '+params['author'].firstName+' '+params['author'].lastName)]]
  • Is custom – признак использования шаблона, определяемого собственной логикой, не предусмотренной стандартным форматтером.

  • Defined by – способ создания собственного шаблона: определяемый классом, скриптом или URL.

  • Custom definition – имя Java-класса с полным именем пакета, либо путь к скрипту Groovy, расположенному в модуле core, либо URL, используемый для создания собственного шаблона.

  • Is alterable output – признак, позволяющий выбирать тип вывода отчёта во время его выполнения.

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

    report template alterable
    Рисунок 32. Окно ввода параметров отчёта