【限时免费】 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 源码集成

1. 克隆示例项目：jimureport-example
2. 修改数据库配置
3. 执行初始化SQL
4. 启动项目

4.2 Docker方式

docker pull jeecgboot/jimureport
docker run -p 8080:8080 jeecgboot/jimureport

4.3 绿色免安装版

下载官方提供的绿色版压缩包，解压后直接运行启动脚本。

5. 注意事项

1. 商业使用时需保留"Powered by 积木报表"标识
2. 建议生产环境修改默认密码
3. 复杂报表设计时建议先规划数据源结构