dorado 5 ExcelReport 使用手册 v0.9.docVIP

Dorado Excel Report 使用手册 目录 1 简介 2 1.1 数据导出模式 2 1.2 Excel报表模式 2 2 配置 3 2.1 依赖环境 3 2.2 配置web.xml 3 3 定义报表模板 5 3.1 模板属性参数 5 3.1.1 参数说明 5 3.1.2 参数配置 6 3.2 模板报表域 7 3.2.1 报表域创建 7 3.2.2 报表域说明 8 3.3 EL表达式 15 3.4 数据列别名 18 3.5 ExcelProcessorListener 20 4 数据导出模式 21 4.1 自定义导出模板 21 4.2 使用自定义导出模板 22 5 报表模式 22 5.1 分组类报表 24 5.1.1 创建报表模板并属性定义 24 5.1.2 定义数据域及数据显示样式 25 5.1.3 完整报表模板 27 5.2 统计类报表 28 5.2.1 创建报表模板并属性定义 28 5.2.2 定义数据域及数据显示样式 29 5.2.3 完整报表模板 32 5.3 含图表类报表 32 5.3.1 创建报表模板并属性定义 33 5.3.2 定义数据域及数据显示样式 34 5.3.3 设定图表显示 38 5.3.4 完整报表模板 41 6 附录1 - 报表模版路径的描述规则 42 简介 Excel报表功能是目前很多系统中的基本特性之一，在Dorado中对Excel报表提供了很好支持。主要实现为基于Excel 模板的报表功能（Dorado Excel Report），将需要生成报表的数据按Excel模板的定义中的格式输出到Excel文档，形成最终Excel数据报表。 Dorado Excel Report可以将用户页面数据以模板中定义的格式输出到Excel文档中，特别适用于那些需要将页面或数据库数据导出到Excel文档或生成Excel报表。如在页面端填写的合同信息等按照配置好的合同模板格式生成到Excel文档备案、传递或打印。 在dorado中，相关的数据都是通过dataset实现的，数据查询与数据分批下载都需要通过dataset向数据层请求和获得，于是Dorado Excel Report的数据导出是基于dataset实现的，到目前为止，Dorado Excel Report使用方式主要分为： “数据导出模式”和“Excel报表模式”两种。 数据导出模式 数据导出模式是指导出某个正在运行的dorado界面中Dataset的数据。使用方法是利用Export2ExcelCommand控件。因此，在使用此种模式时，用户一定需要首先开启包含要导出数据的页面，然后才能得到最终需要的Excel报表。对于数据导出模式，dorado内部为所有的数据导出功能提供的默认的模版，位于classpath:com/bstek/dorado/report/excel/default-export-template.xls，可以通过dorado的setting.xml中的report.defaultExportTemplate来配置默认的导出模版，也可通过指定templateTable属性来指定导出模板。输出样式中可以利用DataTable的用户格式定制功能，例如动态改变列的顺序，动态改变列的标题，动态设定列是否可见等。 具体实现可以参看“dorado 5 组件详解”中“Export2ExcelCommand控件”的介绍一节。 Excel报表模式 “Excel报表模式”是具有独立的URL的报表，用户可以通过直接访问某个报表的URL在浏览器中得到该报表的展现。对于报表模式而言，报表模版是必须提供的，对某个报表的访问可以看作是对某个报表模版的访问。根据自定义Excel报表模板的方式导出数据，能设计比较灵活的报表样式，形成多种样式报表，如支持数据的分组、汇总等运算，还可以包含支持二维和三维的柱形图、饼图、面积图、折线图等常用的图表样式的报表。 配置 依赖环境 Dorado Excel Report需要依赖Jxl(JAVA EXCEL API)，Jxl为是一开放源码项目，通过它Java开发人员可以读取Excel文件的内容、创建新的Excel文件、更新已经存在的Excel文件。使用该 API非Windows操作系统也可以通过纯Java应用来处理Excel数据表。Dorado Excel Report需要依赖jxl-2.6.4及以上版本。 jxl、poi这一类的excel工具包在运行都会占用大量的内存，因此如果使用Excel报表功能生成大数据量的报表时容易导致JVM内存溢出。目前此问题没有有效的解决方案，因此不建议生成大数据量的报表（此处大数据量一般指3000条记录以上，此指标随报表数据和报表模版的复杂度的不同而不同）。 必威体育精装版Jxl下载地址： /proje