快速集成

第一步：引入JimuReport依赖

快速集成到自己项目中，支持 SpringBoot3 和 SpringBoot2 脚手架项目

积木报表依赖

• springboot3

 <dependency>
    <groupId>org.jeecgframework.jimureport</groupId>
    <artifactId>jimureport-spring-boot3-starter</artifactId>
    <version>2.5.0</version>
 </dependency>

• SpringBoot4

<dependency>
  <groupId>org.jeecgframework.jimureport</groupId>
  <artifactId>jimureport-spring-boot4-starter</artifactId>
  <version>2.5.0</version>
</dependency>

• springboot2

 <dependency>
    <groupId>org.jeecgframework.jimureport</groupId>
    <artifactId>jimureport-spring-boot-starter</artifactId>
    <version>2.3.4</version>
 </dependency>

• 功能增量依赖(不区分springboot版本)

<!-- mongo、redis和文件数据集支持包，按需引入 -->
 <dependency>
    <groupId>org.jeecgframework.jimureport</groupId>
    <artifactId>jimureport-nosql-starter</artifactId>
    <version>2.1.0</version>
 </dependency>
 <!-- 后台导出接口Echart图表支持包，按需引入 -->
 <dependency>
    <groupId>org.jeecgframework.jimureport</groupId>
    <artifactId>jimureport-echarts-starter</artifactId>
    <version>2.3.0</version>
 </dependency>

积木BI依赖

• springboot3

<dependency>
  <groupId>org.jeecgframework.jimureport</groupId>
  <artifactId>jimubi-spring-boot3-starter</artifactId>
  <version>2.5.0.1</version>
</dependency>

• springboot4

<dependency>
  <groupId>org.jeecgframework.jimureport</groupId>
  <artifactId>jimubi-spring-boot4-starter</artifactId>
  <version>2.5.0</version>
</dependency>

• springboot2

 <dependency>
   <groupId>org.jeecgframework.jimureport</groupId>
   <artifactId>jimubi-spring-boot-starter</artifactId>
   <version>2.3.2.1</version>
 </dependency>

Chat2BI依赖

• SpringBoot4

<dependency>
  <groupId>org.jeecgframework.jimureport</groupId>
  <artifactId>jimuchatbi-spring-boot4-starter</artifactId>
  <version>1.0.0</version>
</dependency>

第二步：执行初始化Sql脚本

jimureport.mysql5.7.create.sql

第三步：接入 AI 模型

修改配置文件 application.yml，在 jeecg.jmreport 下增加 ai 节点：

jeecg:
  jmreport:
    ai:
      base-url: https://api.deepseek.com
      # 厂商控制台申请的 API Key（请替换为自己的）
      api-key: sk-xxxxxxxx
      model: deepseek-v4-pro
      temperature: 0
      max-tokens: 16384
      # AI自动建表（安全警告: 此功能会直接操作数据库DDL/DML，生产环境请勿启用）
      autoTableEnabled: false

autoTableEnabled: true 会让 AI 直接执行 DDL/DML 语句操作数据库，生产环境请保持关闭（false），仅在开发/测试环境按需开启。

第四步：排除权限拦截

JimuReport自带权限控制，所以需要放开自己框架对JimuReport请求的权限拦截 ;

JeecgBoot修改org.jeecg.config.shiro.ShiroConfig加入以下代码，其他项目参考修改 ;

//积木报表排除
filterChainDefinitionMap.put("/jmreport/**", "anon");
//积木仪表盘排除
filterChainDefinitionMap.put("/drag/**", "anon");
filterChainDefinitionMap.put("/jimubi/**", "anon");

第五步：实现扩展接口

这步很重要，通过实现扩展接口，来实现与集成系统对接登录token、操作权限、角色权限、字典。

// 1.积木报表实现这个接口
org.jeecg.modules.jmreport.api.JmReportTokenServiceI

// 2.积木BI实现这个接口
org.jeecg.modules.drag.service.IOnlDragExternalService

可以参考JeecgBoot集成实现类 JmReportTokenServiceI实现类 、IOnlDragExternalService实现类

第六步：集成积木权限（操作角色、操作权限）

为了安全积木针对敏感接口，加了角色注解和权限注解，你需要显示的配置角色和权限，才能访问某些功能。

具体对接请仔细阅读文档 集成积木权限

第七步：访问积木报表

1. 访问报表工作台： {项目前缀}/jmreport/list

2. 访问BI工作台： {项目前缀}/drag/list

第八步：更多配置

• 更多参考配置