Разработка шаблона XDocReport#

DCGN использует XDocReport версии 2.0.2. Для работы с XDocReport можно использовать MS Office, LibreOffice или OpenOffice.

Используя движок XDocReport для разработки шаблона, DCGN позволяет генерировать выходной документ в одном из форматов: PDF, HTML, ODT. DCGN поддерживает java.io.InputStream — тип для передачи параметров ресурсов при генерации через библиотеку. XDocReport поддерживает только вставку картинок в качестве ресурсов. Для добавления картинки, которая затем будет заменена, необходимо:

  1. В шаблон формата .ODT добавить картинку-заглушку. Ее нужно добавить в целевое место и с желаемыми размерами.

  2. Установить картинке имя, совпадающее с именем параметра в конфигурационном файле шаблона, через который будет получена картинка. Картинка с таким же именем, полученная через параметр, будет вставлена в то же место с теми же размерами: уменьшена или увеличена до размеров картинки-заглушки.

Инструкция по разработке шаблонов документов с помощью XDocReport приведена в Документации.

Ограничения для шаблона XDocReport#

Разработка шаблона в XDocReport должна производиться с соблюдением следующих ограничений:

  • поддерживается только синтаксис - Freemarker. Например, Hello $\{name\};

  • поддерживается только формат ODT для загружаемых шаблонов;

  • не поддерживается обработка тега <!DOCTYPE>, за исключением <!DOCTYPE html>;

  • не поддерживается обработка тега <#include>;

  • не поддерживается обработка тега <#import>;

  • не поддерживается обработка тега <#stop>;

  • не поддерживаются сноски для PDF;

  • параметры внутри тега <#attempt> обрабатываются как обязательные.