1. 概述
1.1 版本说明
报表服务器版本 | 功能变动 |
---|---|
10.0.19 | 普通报表中多了一种事件类型「导出事件」,用户可以通过该事件将模板导出为文件并支持自定义导出文件名 |
1.2 应用场景
注1:目前只支持 .cpt 报表。
注2:不支持新计算引擎。
模板导出为文件时,文件名默认为模板的名称,用户想要自定义导出文件名,一般都要借助 JavaScript 代码实现。
但是一方面 JavaScript 有一定的门槛,另一方面维护起来也比较复杂。
针对上述问题,10.0.19 版本新增导出事件,可以在选择导出文件类型的同时,自定义文件名称,无需再借助 JavaScript 代码。
1.3 功能入口
目前只支持 .cpt 报表,在 .cpt 报表中控件事件新增一种类型:「导出事件」,如下图所示:
该事件可以同时实现:文件导出+自定义文件名。
2. 功能介绍
2.1 导出设置
导出模板:默认是导出当前模板,也可以选择导出其他模板,选择其他模板时,需要在报表工程目录下选择,且只能选择普通报表。
导出方式:可以选择 PDF 导出、Excel 导出、Word 导出、图片导出。
导出文件名:选择默认,文件名就是模板名称,选择自定义,支持使用公式和字符串来定义文件名,公式就是编辑框前面有等于号,字符串把前面等于号去掉即可。
注:自定义导出文件名时,不支持一些特殊符号、单元格、层次坐标函数,详情参见下图界面里的红色提示文字。
2.2 参数
默认勾选「继承报表的参数」,此时将按照当前 session 参数导出,也就是在未点击查询的情况下,将使用当前参数面板选择的参数进行导出。
取消勾选「继承报表的参数」,用户可以自定义参数。
3. 示例
3.1 设计模板
打开设计器内置模板:%FR_HOME%\webapps\webroot\WEB-INF\reportlets\GettingStarted.cpt
3.2 添加事件
参数面板拖个按钮控件进来,重命名为「导出模板」,给按钮添加一个「点击」事件,类型选择「导出事件」。
导出方式选择「Excel输出(原样导出)」,导出文件用公式来自定义:=$地区+"地区销售概况",如下图所示:
3.3 效果预览
保存报表,分页预览后,导出文件的效果如 1.2应用场景 中所示。
不支持 App 端和 HTML5 端预览。
注:本文方法不支持 新填报预览
4. 模板下载
已完成模板参见:%FR_HOME%\webapps\webroot\WEB-INF\reportlets\doc\SpecialSubject\ExcelImport\自定义导出文件名.cpt
点击下载模板:自定义导出文件名.cpt