推荐一个开源报表工具UReport2

UReport2，主要针对企业在数据管理和报表生成方面的痛点需求，提供了有效的解决方案。以下是uReport能够解决的一些企业常见痛点：

自动化报表生成： uReport可以自动从数据库或其他数据源提取数据，并根据预设的模板生成报表，减少人工操作，提高效率和准确性。
复杂报表设计：支持中国式复杂报表的设计，包括但不限于交叉表、分组、排序、汇总、条件格式等，使得报表设计更加灵活多样。
数据可视化：通过图表、图形和其他视觉元素展示数据，使数据分析更加直观，有助于快速理解数据趋势和模式。
实时数据报告：实时或定时更新报表数据，确保决策者能够基于最新的信息做出决策。
跨平台兼容性： uReport支持多种输出格式，如PDF、Excel、HTML等，满足不同场景下的需求。
成本效益：开源且免费的特性降低了企业的IT成本，尤其是对于中小企业而言，无需购买昂贵的商业报表软件。
易于集成：作为纯Java的报表引擎，uReport易于集成到现有的Java应用中，特别是那些基于Spring框架的应用。
用户友好界面：提供网页端报表设计器，使得报表设计和维护变得更加简单，不需要深入的编程知识。
性能优化：特别是在处理大量数据时，uReport的性能优化技术可以确保报表的快速加载和响应。
安全性和权限控制：企业可以设置不同的访问权限，确保敏感数据的安全，同时允许不同层级的用户访问他们需要的信息。
维护和扩展性：由于其开源性质，uReport具有良好的社区支持，便于企业进行定制化开发和长期维护。

综上所述，uReport通过提供自动化、灵活性和成本效益高的报表解决方案，帮助企业解决了数据管理和分析中的许多挑战。

[UReport2](gitee.com/youseries_a...) 是一款用于设计和生成复杂报表的开源报表引擎，它支持在Web浏览器中直接设计报表模板，特别适合中国式报表的需求。下面是UReport2的基本使用流程：

1.项目集成环境

对于微服务架构，通常作为一个独立的报表服务调用。

依赖添加 ：在Maven项目的pom.xml中添加UReport2的依赖。目前最新版本为2.2.9

xml 复制代码

<!-- ureport2报表 -->
 <dependency>
            <groupId>com.bstek.ureport</groupId>
            <artifactId>ureport2-console</artifactId>
            <version>2.3.0-SNAPSHOT</version>
        </dependency>

环境配置 ：配置数据源、报表引擎参数等，通常在bootstrap.yml中完成。

yaml 复制代码

#ureport配置
ureport:
  disableHttpSessionReportCache: false
  disableFileProvider: false
  #设计报表源文件存储位置
  fileStoreDir: /ureport/template
  debug: true

项目中配置新建MyUReportPropertyConfigurer.java、UreportConfig.java

scala 复制代码

package com.budaos.tool.ureport.config;

import org.springframework.beans.factory.config.YamlPropertiesFactoryBean;
import org.springframework.core.io.ClassPathResource;

import com.bstek.ureport.UReportPropertyPlaceholderConfigurer;

/**
 * 继承UReportPropertyPlaceholderConfigurer, 装载application.yml
 * @author kool.zhao
 * 2024年5月24日
 */
public class MyUReportPropertyConfigurer extends UReportPropertyPlaceholderConfigurer {

	public MyUReportPropertyConfigurer(String path) {
		YamlPropertiesFactoryBean yaml = new YamlPropertiesFactoryBean();
		yaml.setResources(new ClassPathResource(path));
		this.setProperties(yaml.getObject());
	}

}

typescript 复制代码

package com.budaos.tool.ureport.config;

import org.apache.commons.lang.StringUtils;
import org.springframework.boot.web.servlet.ServletRegistrationBean;
import org.springframework.context.EnvironmentAware;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.context.annotation.ImportResource;
import org.springframework.core.env.Environment;
import com.bstek.ureport.console.UReportServlet;

/**
 * UReport 配置
 * 2024年5月24日
 */
@Configuration
@ImportResource("classpath:ureport-console-context.xml")
public class UreportConfig implements EnvironmentAware {
	private Environment environment;
	@Override
	public void setEnvironment(Environment environment) {
		this.environment = environment;
	}
	@Bean
	public MyUReportPropertyConfigurer propertyrConfigurer(){
		String activeProfile = environment.getProperty("spring.profiles.active");
		if(StringUtils.isNotBlank(activeProfile)){
			activeProfile = "-" + activeProfile;
		}
		return new MyUReportPropertyConfigurer("bootstrap.yml");
	}

    @Bean
    public ServletRegistrationBean<UReportServlet> buildUreportServlet(){
        return new ServletRegistrationBean<UReportServlet>(new UReportServlet(), "/ureport/*");
    }

}

服务端service示例。

ini 复制代码

package com.budaos.tool.ureport.service;

import com.budaos.standard.api.RemoteTaskService;
import com.budaos.standard.api.domain.vo.AttentionItemModel;
import com.budaos.standard.api.domain.vo.TTaskTicketItemModel;
import com.budaos.standard.api.domain.vo.TTaskTicketModel;
import lombok.RequiredArgsConstructor;
import org.springframework.stereotype.Service;

import java.util.List;
import java.util.Map;

@RequiredArgsConstructor
@Service("taskReport")
public class TaskReportService {


    private final RemoteTaskService remoteTaskService;

    /**
     * 获取任务单打印基础数据源
     */
    public List<TTaskTicketModel> getTaskInfo(String dsName, String datasetName, Map<String, String> parameters) {
        String id = parameters.get("id");
        String templateName = parameters.get("templateName");
        List<TTaskTicketModel> opticketVoList = remoteTaskService.getTaskInfo(Long.parseLong(id));
        TTaskTicketModel taskTicketModel = opticketVoList.get(0);
        taskTicketModel.setTemplateName(templateName);
        String deptMemberName = taskTicketModel.getDeptMemberName();
        if (deptMemberName != null) {
            int length = 27;
            if (deptMemberName.length() > length) {
                taskTicketModel.setDeptMemberName(deptMemberName.substring(0, length));
                taskTicketModel.setDeptMemberNameTwoLine(deptMemberName.substring(length));
            }
        }
        String workTask = taskTicketModel.getWorkTask();
        if (workTask != null) {
            int length = 38;
            if (workTask.length() > length) {
                taskTicketModel.setWorkTask(workTask.substring(0, length));
                taskTicketModel.setOtherWorkTask(workTask.substring(length));
            }
        }

        return opticketVoList;
    }

    public List<TTaskTicketItemModel> getTaskItemInfo(String dsName, String datasetName, Map<String, String> parameters) {
        String id = parameters.get("id");
        List<TTaskTicketItemModel> opticketVoList = remoteTaskService.getTaskItemInfo(Long.parseLong(id));
        return opticketVoList;
    }

    public List<AttentionItemModel> getAttentionItemInfo(String dsName, String datasetName, Map<String, String> parameters) {
        String id = parameters.get("id");
        List<AttentionItemModel> opticketVoList = remoteTaskService.getAttentionItemInfo(Long.parseLong(id));
        return opticketVoList;
    }

}

前后端整合可以参照开源框架：renren-security-ureport2

2. 设计报表模板

启动设计器 ：在Web浏览器中访问UReport2的设计器页面。
创建报表：在设计器中创建新的报表模板，可以选择预定义的布局或自定义。
编辑单元格：添加单元格，设定样式，编写数据绑定表达式。
添加数据集：从数据库或其他数据源导入数据，创建数据集。
函数和表达式：利用内置函数和表达式处理数据，如求和、平均值等。
预览和调整：在设计器中预览报表，根据需要调整模板。

3. 配置报表

参数设置：如果报表需要参数输入，配置参数并定义默认值。
图表和图形：插入图表和图形，选择数据源和图表类型，如饼图、条形图等。

4. 报表输出

生成报表：在应用中调用UReport2 API生成报表，可以指定输出格式（如PDF、Excel、HTML）。
动态数据填充：传入数据集和参数，报表引擎会填充模板中的数据。

5.报表设计时小技巧

字体：微软雅黑，标题13号字体，正文10号字体即可
设计单元格是关键，先要计算以最多单元格为基准，进行合理布局
页面类型：A4,页面宽210，页面高297
左边距22 左边距22
上边距15 下边距15
实现WPS分页符：通过设置表达式达到要求
日期设置年格式：yyyy ; 月格式：MM 日格式：dd 小时格式：HH 分钟格式：mm 秒格式