报表

报表扩展组件支持开发者和用户设计报表，并通过对 Jmix 应用程序的数据进行格式化的方式生成各种报表，报表的模板可以用熟悉的 office 软件或 HTML 创建。

该扩展组件提供下列功能：

  • 设计时使用带注解的 Java 类或在运行时使用管理 UI 和分步向导创建报表。

  • 生成 DOCX、XLSX、HTML、CSV、PDF 和文本格式的报表， 或显示为应用程序中的表格。

  • 创建具有复杂结构的 XLSX 报表，包括数据分组、数据聚合和交叉表特性。

  • 在 XLSX 报表中使用图表和公式。

  • 管理报表访问权限、使用 REST API 以及查看报表执行历史。

另请参阅 Report Generation 指南，其中包含具有复杂结构和各种输出类型的报表的实际示例。

安装

按照 扩展组件 章节的说明通过 Jmix 市场进行自动安装。

手动安装，在 build.gradle 添加下列依赖：

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

如需使用 JasperReports 模板，添加以下依赖：

implementation 'net.sf.jasperreports:jasperreports'
implementation 'net.sf.jasperreports:jasperreports-fonts'
implementation 'net.sf.jasperreports:jasperreports-functions'

如需通过 REST API 访问报表，还需要安装以下依赖：

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

报表扩展组件使用 LibreOffice 输出 PDF 和 DOC 格式的报表。因此，请 安装 LibreOffice 支持 PDF 和 DOC 格式。

应用程序使用单一菜单模式

如果你的应用程序使用的是 单一菜单模式，需要在扩展组件安装完成后手动添加菜单项。

  1. 在 Jmix Studio 中打开 菜单设计器。

  2. 切换至 Structure 标签页。

  3. 左侧面板显示可用的菜单项。

    add menu items

  4. 添加菜单项：

    • 左侧选择需要添加的菜单项后，点击 > 按钮添加至右侧。

    • 或者也可以直接从左侧拖拽菜单至右侧结构中。

当应用程序是 单一 菜单模式时，Studio 不会自动合并组件的菜单，因此必须手动执行该步骤。