Reports

Дополнение Reports позволяет разработчикам и конечным пользователям создавать и генерировать различные отчеты, форматируя данные из приложения Jmix с помощью шаблонов, созданных в удобных офисных приложениях или HTML.

Дополнение предоставляет следующие возможности:

  • Создание отчетов с использованием аннотированных Java-классов или во время выполнения с помощью комплексного административного интерфейса и пошагового мастера.

  • Генерация отчетов в форматах DOCX, ODT, XLSX, HTML и текстовом формате, а также конвертация вывода отчетов в PDF.

  • Создание отчетов XLSX со сложной структурой, включая многоуровневую организацию, агрегацию данных и кросс-таблицы.

  • Использование диаграмм и формул в отчетах XLSX.

  • Права доступа к отчетам, REST API и история выполнения.

В этой главе представлена справочная информация по созданию и запуску отчетов.

Обратитесь к руководству Report Generation для получения практических примеров, демонстрирующих создание отчетов.

Установка

Для автоматической установки через Jmix Marketplace следуйте инструкциям в разделе Дополнения.

Для ручной установки добавьте следующие зависимости в ваш build.gradle:

implementation 'io.jmix.reports:jmix-reports-starter'
implementation 'io.jmix.reports:jmix-reports-flowui-starter'

Для доступа к отчетам через REST API добавьте также следующие зависимости:

implementation 'io.jmix.reports:jmix-reports-rest-starter'

Дополнение Reports использует пакет LibreOffice для вывода отчетов в форматах PDF и DOC. Установите LibreOffice для поддержки вывода в PDF и DOC.

Важное примечание для приложений в режиме меню Single mode

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

  1. Откройте Дизайнер меню в Jmix Studio.

  2. Перейдите на вкладку Structure.

  3. Доступные пункты меню отображаются на левой панели.

    add menu items

  4. Чтобы добавить пункты:

    • Выберите нужные пункты и нажмите кнопку > кнопка (Add Selected).

    • Или перетащите их с левой панели в текущую структуру меню справа.

Этот шаг необходим, потому что приложения в режиме Single mode не выполняют автоматическое слияние меню дополнений с существующей структурой.