1. 概述
FineReport,既可在设计器端导出模板,也可以在浏览器端导出,还可以通过 API 接口导出。
注:通过添加 JS 实现的报表效果,导出后不会体现,即导出后的效果和未添加 JS 前的报表效果一致,如通过 JS 隐藏了单元格行,导出后隐藏的单元格行依旧存在,因为 JS 是纯前端修改,对于后台执行导出没有任何影响。
2. 普通报表导出
注:普通报表导出不支持 自适应。
注2:jdk1.8.0_262,jdk-8u231,jdk1.8.0_192 三个版本不建议使用导出功能将普通报表导出为 PDF 或图片。
2.1 导出方式
导出方式 | 简介 | 参考文档 |
---|---|---|
设计器端导出 | 无需预览模板,直接在设计器里面通过可视化操作导出模板 | 设计器端导出 |
浏览器端导出 | 简介:在 Web 端预览模板后,导出模板为各种格式 原理:先选择导出的文件格式;然后根据报表内容,在服务器的内存中将页面中的内容生成;最后由 serverlet 直接推送给客户端 注:报表的导出,遵循所见即所得原则,即导出的页面与浏览器预览的页面完全一致,仅导出显示值而不是实际值 | 浏览器端导出 |
API 导出 | 通过导出 API ,在程序中导出 | 导出 API |
URL 直接导出 | 在预览报表的 URL 后增加 format 参数,赋一个导出格式来实现 URL 直接导出 注:post 方式导出请参见:URL直接导出(post方式) | URL 直接导出 |
自定义导出按钮 | 通过 Web 页面集成,自定义 Web 页面的按钮,实现导出功能 | 自定义按钮导出 |
2.2 导出 Excel
分类 | 简介 | 参考文档 |
---|---|---|
内置导出方案 | 分页导出 原样导出 分页分 Sheet 导出 | Excel导出 |
导出格式 | 导出 2007 版本 Excel | 导出 Excel2007 |
自行选择导出 2007/2003 版本 Excel | 导出 Excel 方式选择控件插件 | |
导出样式 | 导出 Excel 时保留超链接 | Excel超链接导出插件 |
导出 Excel 时保留公式 | 导出 Excel 时保留公式 | |
导出 Excel 时保留隐藏的行列 导出 Excel 时设置密码 | Excel导出隐藏行列与导出密码 |
2.3 导出其他格式
导出格式 | 简介 | 参考文档 |
---|---|---|
导出 Word | Word 导出页眉页脚 | Word 导出页眉页脚 |
Word 导出自动调整行高 | Word 导出自动调整行高 | |
导出 PDF | 合并多个模板导出到一个 PDF | 多CPT导出PDF插件 |
导出 PDF 时设置密码 | PDF导出密码属性 | |
导出 PPT | 导出 PPT | CPT报表导出PPT插件 |
导出 CSV | 导出 CSV 文件 | 导出 CSV 插件 |
自定义导出的 CSV文件的编码格式 | CSV导出编码插件 | |
导出图片 | 导出图片 | 图片导出设置插件 |
导出 HWP | 导出 HWP 文件 | HWP 导出插件 |
导出 HTML 内容 | 用户导出包含 HTML 语句的模板 | HTML 解析插件 |
导出文本文件 | 用户导出文件类型为文本文件 | URL直接导出报表内容 |
3. 决策报表导出
3.1 支持场景
场景 | 细化场景 | URL添加导出参数导出 | 使用sessionID导出(导出后的纸张会小于URL导出的纸张) | 使用控件值导出 | |
---|---|---|---|---|---|
自适应 | 存在隐藏报表块情况下的自适应模板导出 | 默认自适应 | 不支持 | 无自适应效果 | 不支持 |
其他 | 导出后会预留出隐藏报表块的位置 | 支持 | |||
存在自定义报表&图表标题下的自适应模板导出 | 默认自适应 | 不支持 | 无自适应效果 | ||
其他 | 支持 | 支持 | |||
其他自适应场景下的模板导出 | 默认自适应 | 不支持 | 无自适应效果 | ||
其他 | 支持 | 支持 | |||
参数传递 | 根据参数面板控件值进行导出,不查询直接导出 | 不支持 | 不支持 | ||
根据参数面板控件值进行导出,查询后导出 | 不支持 | 支持 |
3.2 参考文档
简介 | 参考文档 |
---|---|
决策报表导出为 Excel、PDF 、Word、图片(png、jpg、gif、bmp) | 决策报表导出插件 |
决策报表导出为 PPT 合并多个模板导出到一个 PPT | 合并演示报告插件 |
决策报表导出为 Excel、PDF 、Word、PPT、Image 合并多个模板导出到一个 Excel、PDF 、Word、PPT、Image | 决策报表导出 Plus 插件 |
决策报表多 Sheet 导出 | 决策报表多标签页导出插件 |
在决策报表中实现导出单个报表块 | JS实现决策报表导出单个报表块 |
4. 大数据集导出
详情请参见:大数据集导出
5. 批量导出
简介 | 参考文档 |
---|---|
批量导出指定子表 | JS实现批量导出多个模板 |
从当前表筛选数据并分别导出为多个文件 | 根据参数批量导出多个文件 |
多个普通报表同时导出成某种格式的方法 | 自定义批量导出按钮 |
将多个 CPT 模板合并导出至一个 Excel 文件 | 多CPT导出Excel插件 |
6. 自定义导出
简介 | 参考文档 |
---|---|
普通报表自定义导出文件名 | |
普通报表实现:导出文件的名称跟随筛选框的值动态变化 | JS实现导出文件名随筛选值变化 |
普通报表实现:Excel 导出时,用户希望实现分组分 Sheet 导出,即每个 Sheet 页中报表格式相同,内容不同 | JS实现分Sheet导出Excel |
普通报表中:需要在指定的报表中选择下载报表,且需自定义导出的名称 | 根据参数选择导出不同报表 |
通过自定义按钮实现只导出一种文件格式 | JS实现工具栏按钮只导出单一格式文件 |
7. HTML 内容导出
导出支持的 HTML 标签及 HTML 标签的使用范围请参见:HTML 解析插件(必看)
注意事项如下所示:
1)若单元格内容是 HTML ,HTML 中设置的字体要与「单元格属性>样式>字体」中一致,否则导出为 Word 后,可能文字的上半截不显示。
2)若单元格内容是 HTML ,导出时,后台不会单独为删除线和下划线额外处理颜色属性,会显示和字体一样的颜色。
3)若在使用性能优化插件的情况下使用导出功能,导出文件为PDF,模板中不支持的 HTML 语句将在 PDF 中显示为字符串的 HTML 语句。
8. 注意事项
模板导出需要注意以下几点:
1)模板导出为 Word 格式,表格列数最大不超过 63 ,否则超过 63 列的模板内容丢失。
2)模板的表格字体加粗后,导出为图片,加粗后导出的图片文件大小是未加粗前的 2 倍,若用户网络限制图片大小,可能会导致图片无法下载。
3)若导出模板中设置的有条形码,需保证条形码所在的单元格的高度大于等于 6mm ,否则导出后可能会出现条形码下面一行的文字被遮挡。
4)sheet 名称导出 Excel 时,需注意以下两个问题:
sheet 的名称长度有限制,不能多于 31 个。若多于 31 个,导出时会被自动截取,可能会导致两个 sheet 名称相同,导出报错。
sheet 名称支持包含英文、汉字、| 、()等,但是不能包含: 、/、?、*、[]等。
注:导出常见问题及解决方案请参见:导出问题及解决方案