Reports

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

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

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

  • Генерация отчетов в форматах DOCX, XLSX, HTML, CSV, 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 не выполняют автоматическое слияние меню дополнений с существующей структурой.