1. 概述
1.1 应用场景
用户有以下需求时：
所有的表都放在一个 Excel 里面，然后分不同的 sheet 。
多个普通报表，通过一个 url ，导出包含多个报表的 Excel 。
十几个不同的模板，每个模板都有不同的参数，然后批量导出 Excel 。
一次导出多个报表。
可参考本文方法实现。
1.2 功能简介
本文提供多个报表同时导出成某种格式的方法。
注：本文方法适用于普通报表。
2. 实现思路
2.1 代码示例
增加一段 JS 代码，实现点击按钮后导出地区参数为「华北」的 Parameter.cpt 和无参数 Cross.cpt 到 Excel 中，代码如下：
http://localhost:8075/webroot/decision/view/report?reportlets=
[{reportlet:"/doc/Primary/Parameter/Parameter.cpt",地区:"华北"},
{reportlet:"/doc/Primary/CrossReport/Cross.cpt"}]
&format=excel&__filename__=export
注：URL 不能直接访问，浏览器可能不支持[] / {} 特殊符号，因此需要进行 编码转换 后才能直接访问使用。上述示例编码后为：
http://localhost:8075/webroot/decision/view/report?reportlets=%5B%7Breportlet%3A%22%2Fdoc%2FPrimary%2FParameter%2FParameter.cpt
%22%2C%E5%9C%B0%E5%8C%BA%3A%22%E5%8D%8E%E5%8C%97%22%7D%2C%7Breportlet
%3A%22%2Fdoc%2FPrimary%2FCrossReport%2FCross.cpt%22%7D%5D
&format=excel&__filename__=export
2.2 代码介绍
利用「window.open」来打开带导出参数 URL 的方式来实现 Excel 导出。相关参数如下所示：
| 参数 | 示例 |
|---|---|
| 1）报表中无参数时： [{reportlet:"/doc/reportname.cpt"},{reportlet:"/doc/reportname.cpt"},{...}] 其中{reportlet:"/doc/reportname.cpt"}，是模板的访问路径 | [{reportlet:"/doc/Primary/CrossReport/Cross.cpt"},{reportlet:"/doc/Primary/DetailReport/Details.cpt"}] |
| 2）报表中有参数时： [{reportlet:"/doc/reportname.cpt",paraname1:"paravalue1",paraname2:"paravalue2",...},{reportlet:"/doc/reportname.cpt",paraname1:"paravalue1",paraname2:"paravalue2",...},{...}]paraname1:"paravalue1"，是指导出各模板内容时，对应的参数名和参数值，多个参数中间用逗号隔开 | [{reportlet:"/doc/Primary/Parameter/Parameter.cpt",地区:"华北"},{reportlet:"/doc/Primary/CrossReport/Cross.cpt"}] |
| &format=XX，format后面的 XX，是指导出文件的格式 | &format=excel 批量导出时导出的是一个文件，多个报表导出后为一个包含多个 sheet 的 excel 文件 |
| &__filename__=name，对导出的文件重命名"name"就是自定义的文件名 | &__filename__=export 重命名为 export |
3. 操作步骤
3.1 模板准备
使用模板：
%FR_HOME%\webapps\webroot\WEB-INF\reportlets\doc\Primary\Parameter\Parameter.cpt
%FR_HOME%\webapps\webroot\WEB-INF\reportlets\doc\Primary\CrossReport\Cross.cpt
3.2 新建 HTML 文件
1）增加一段 JS 代码，实现点击按钮后导出地区参数为「华北」的 Parameter.cpt 和无参数 Cross.cpt 到 Excel 中，代码如下：
var reportlets = "[{reportlet: '/doc/Primary/Parameter/Parameter.cpt',地区: '华北'}, {reportlet: '/doc/Primary/CrossReport/Cross.cpt'}]"
function clickEvent() {
window.open(encodeURI('/webroot/decision/view/report?reportlets=' + reportlets + '&format=excel'));
}
完整代码如下所示：
点击下载文件：export.html
注：自定义批量导出时，如果在导出的同时还在下载多个文件，推荐将浏览器的安全级别降低，避免被浏览器将导出文件判定为不安全文件。
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<title>FineReport自定义导出</title>
</head>
<script type="text/javascript">
var reportlets = "[{reportlet: '/doc/Primary/Parameter/Parameter.cpt',地区: '华北'}, {reportlet: '/doc/Primary/CrossReport/Cross.cpt'}]"
function clickEvent() {
window.open(encodeURI('/webroot/decision/view/report?reportlets=' + reportlets + '&format=excel'));
}
</script>
<body>
<button
type="button"
onclick= clickEvent()>导出[Excel]
</button>
</body>
</html>
2）将export.html放置到%FR_HOME%\webapps\webroot\help\page_demo路径下，如下图所示：
3.3 效果预览
启动 FineReport 工程，在浏览器端输入http://localhost:8075/webroot/help/page_demo/export.html，点击「导出 Excel」，即可导出 Excel，效果如下图所示：
上一篇：自定义提交按钮
