JimuReport积木报表技术文档
1. 安装指南
1.1 环境要求
- JDK版本:支持JDK8、JDK17、JDK21+
- 数据库:支持MySQL、Oracle、SQL Server等30多种数据库(详见兼容列表)
- 框架支持:SpringBoot2.x/3.x
1.2 依赖引入
根据项目使用的SpringBoot版本选择对应依赖:
SpringBoot2项目
<!-- 核心报表依赖 -->
<dependency>
<groupId>org.jeecgframework.jimureport</groupId>
<artifactId>jimureport-spring-boot-starter</artifactId>
<version>2.1.1</version>
</dependency>
<!-- 大屏设计依赖(可选) -->
<dependency>
<groupId>org.jeecgframework.jimureport</groupId>
<artifactId>jimubi-spring-boot-starter</artifactId>
<version>2.1.0</version>
</dependency>
SpringBoot3项目
<!-- 核心报表依赖 -->
<dependency>
<groupId>org.jeecgframework.jimureport</groupId>
<artifactId>jimureport-spring-boot3-starter-fastjson2</artifactId>
<version>2.1.1</version>
</dependency>
<!-- 大屏设计依赖(可选) -->
<dependency>
<groupId>org.jeecgframework.jimureport</groupId>
<artifactId>jimubi-spring-boot3-starter</artifactId>
<version>2.1.0</version>
</dependency>
1.3 初始化SQL
执行官方提供的SQL脚本初始化数据库表结构。
2. 项目使用说明
2.1 登录系统
默认管理员账号:
- 用户名:admin
- 密码:123456
2.2 核心功能模块
报表设计器
- 类Excel操作界面,支持拖拽设计
- 支持复杂报表、分组报表、交叉报表等
- 提供28种图表类型
打印设计
- 支持套打、背景打印
- 可设置打印边距、方向等参数
大屏设计器
- 类Word操作风格,自由拖动组件
- 支持动态数据刷新
- 提供多种预设模板
3. API使用文档
3.1 报表API
获取报表数据
GET /api/report/{reportId}
参数:
- reportId: 报表ID
- params: 查询参数(JSON格式)
导出报表
POST /api/report/export/{reportId}
参数:
- exportType: 导出类型(excel/pdf/word)
- params: 查询参数
3.2 大屏API
获取大屏配置
GET /api/screen/{screenId}
更新大屏数据
POST /api/screen/update
参数:
- screenData: 大屏配置数据(JSON格式)
4. 项目安装方式
4.1 源码集成
- 克隆示例项目:
jimureport-example - 修改数据库配置
- 执行初始化SQL
- 启动项目
4.2 Docker方式
docker pull jeecgboot/jimureport
docker run -p 8080:8080 jeecgboot/jimureport
4.3 绿色免安装版
下载官方提供的绿色版压缩包,解压后直接运行启动脚本。
5. 注意事项
- 商业使用时需保留"Powered by 积木报表"标识
- 建议生产环境修改默认密码
- 复杂报表设计时建议先规划数据源结构
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考



