报表

报表扩展组件为 Jmix 应用程序提供了一个生成报表的简单方式。

创建一个报表通常需要三个步骤:定义数据源、创建模板以及运行报表。数据源可以在运行时使用 Jmix 数据模型、SQL、JPQL 或脚本创建。报表模板可以用流行的编辑器,例如,微软 Office 或 LibreOffice 创建,然后导入 Jmix 应用程序中。最后,报表支持在任一应用程序界面中运行。

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

  • 运行时通过向导一步一步可视化地创建报表模板;

  • 报表格式支持 DOC/DOCX、ODT、XLS/XLSX、HTML 或任一纯文本类型;

  • 创建复杂的 XLS(X) 报表:多区域报表、带数据聚合的报表、交叉报表;

  • 在 XLS(X) 报表中使用图表和公式;

  • 将 Office 或 HTML 格式的报表转换成 PDF 格式;

  • 报表访问权限、REST API 以及报表执行历史。

安装

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

手动安装,在 build.gradle 添加下列依赖:

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

如需通过 REST API 访问报表,需要添加下列依赖:

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

注意,REST API 扩展组件也用到了 jmix-security-oauth2-starter,因此,你的 build.gradle 中可能已经包含此依赖。

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