fine-report

FineReport 9.0, основанная на Spring Boot.

Установка зависимостей

Так как FineReport предоставляет только jar-пакеты, нам нужно установить их локально через maven.

Windows

Для пользователей Windows запустите install/installjars.bat.

Unix

Для пользователей Linux, Mac OS запустите install/installjars.sh.

Конфигурация

Система

Порт

По умолчанию 15020. Конфигурационный файл src/main/resources/application.yml.

Логи

Логи по умолчанию (асинхронно) выводятся в директорию logs, конфигурационный файл src/main/resources/logback-spring.xml.

По умолчанию уровень логирования INFO, формат файла finereport.yyyy-MM-dd.log.

FineReport

Датасеты

Обычно требуется настроить серверные датасеты, измените конфигурационный файл env/WEB-INF/resources/datasource.xml.

База данных

Если требуется использовать функции, такие как "сохранение часто используемых параметров", то требуется использовать базу данных. (По умолчанию не включено)

Измените конфигурационный файл env/WEB-INF/resources/config.xml.

Логи

Логи по умолчанию выводятся в директорию logs, конфигурационный файл env/WEB-INF/resources/log4j.properties. (По умолчанию уровень логирования INFO)

Шаблоны CPT

Необходимо загрузить шаблоны CPT в директорию env/WEB-INF/reportlets.

FRDemo.db

Можно использовать базу данных env/FRDemo.db для локальных тестов.

Развертывание

Пакетирование```shell

$ mvn clean $ mvn package

### Запуск

Внимание: **необходимо разместить директорию `env` и собранный `jar` в одной директории**, при запуске программы директория `env` будет использоваться как `docBase`.

```shell
$ nohup java -jar fine-report.{version}.jar > startup.log &

Доступ

• Через браузер: http://127.0.0.1:15020
• Адрес Финерепорта: http://127.0.0.1:15020/ReportServer.
• Доступ к шаблонам Финерепорта: http://127.0.0.1:15020/ReportServer?reportlet=GettingStarted.cpt, где GettingStarted.cpt должен существовать в директории env/WEB-INF/reportlets.

Проблемы

Почему нужно перенести директорию src/main/webapp в env?

Это связано с тем, что после создания директории src/main/webapp, если скопировать ресурсы Финерепорта внутрь, то при сборке проекта будет создан war-пакет (для развертывания через tomcat).

Перенос директории webapp в env позволяет собирать jar-пакет, при этом Финерепорт будет использовать директорию env для чтения конфигураций, анализа шаблонов и резервного копирования.

То есть, директория env эквивалентна docBase для tomcat.