历史版本68 :上传下载文件插件 返回文档
编辑时间: 内容长度:图片数:目录数: 修改原因:

目录:

1. 概述编辑

1.1 版本

设计器版本  JAR 包
插件版本  
10.02019-06-11V8.1.4

1.2 应用场景

有时候用户需要将文件上传到服务器或者FTP进行保存,并且可以提供文件下载。以前 FineReport 实现此功能需要自定义函数实现,但代码实现会比较麻烦。该插件将此功能封装,安装后可以通过可视化界面操作,方便快捷。

1.3 功能限制

  • 文件下载不支持「决策报表」

  • 不支持单元格扩展场景

  • 不支持多文件上传

  • 不支持集群环境

  • 移动端只支持上传图片类型的文件,不支持上传其他文件和下载功能

2. 插件介绍编辑

2.1 插件安装

插件下载请点击:上传下载文件插件

设计器插件安装方法参照 设计器插件管理

服务器安装插件方法参照 服务器插件管理

2.2 插件功能

2.2.1 上传至服务器

报表填报属性界面,自定义提交中新增了上传类型选择,可选择「上传至服务器」。

同名文件覆盖:默认不勾选。不勾选时,同名文件会自动重命名;勾选后,同名文件会直接覆盖。

1614847670210710.png

2.2.2 上传至 FTP

报表填报属性界面,自定义提交中新增上传类型选择,可选择「上传至 FTP」。

同名文件覆盖:默认不勾选。不勾选时,同名文件会自动重命名;勾选后,同名文件会直接覆盖。

1614847752799060.png

2.2.3 文件下载

超级链接新增一个选项「文件下载」,可以通过设置超级链接,实现从服务器端下载文件,如下图所示:

4.png

2.3 设置项格式

设置项内容示例
磁盘路径
控件名称、单元格、自定义
  • $a

  • A1

  • "D:/photo"(windows)

  • "/data/tomcat/"(linux)

文件
控件名称、单元格
  • $a

  • A1

文件名空,控件名称、单元格、自定义
  • $a

  • A1

  • "test2"

注:文件名如果为空,会默认获取上传的文件名,支持多文件上传。如果不为空,则不支持多文件上传,文件名会重叠。


3. 示例编辑

3.1 报表设计

1)在FineReport设计器中点击「文件>新建普通报表」。

2)选中A1单元格,为 A1 单元格添加「文件控件」,文件类型选择「全部文件」。如下图所示:

3.png

3.2 上传至服务器

1)菜单栏点击「模板>报表填报属性」,添加「自定义提交」,提交类型选择「上传至服务器」,根据实际情况输入磁盘路径、文件、文件名。如下图所示:

具体设置项说明如下表所示:

设置项本次示例说明
磁盘路径"C:/Users/Leo.Tsai/Desktop/Document/"文件保存位置
文件A1文件控件所在单元格编号
文件名

选填

  • 如果为空,会默认获取上传的文件名,支持多文件上传。

  • 如果不为空,可以自定义或者使用公式生成文件名,但不支持多文件上传,文件名会重叠

3)保存报表,点击「填报预览」,上传文件点击提交,查看文件保存位置即可看到刚上传的文件。如下图所示:

1574826271507574.png

3.3 上传至 FTP

1)菜单栏点击「模板>报表填报属性」,添加「自定义提交」,提交类型选择「上传至 FTP」,点击 FTP 设置,添加一个 FTP 连接。

1574835673588206.png

2)新建一个 FTP 连接,用户需根据实际场景填写连接信息。如下图所示:

1589252675257339.png

3)设置文件信息,如下图所示:

各设置项说明如下表所示:

设置项本次示例说明
上传路径"/FineReport Document"文件保存位置
文件A1文件控件所在单元格编号
文件名

选填

  • 如果为空,会默认获取上传的文件名,支持多文件上传。

  • 如果不为空,可以自定义或者使用公式生成文件名,但不支持多文件上传,文件名会重叠

FTP 站点Test本文 3.3 节第二步骤中的 FTP 连接名称

4)保存报表,点击「填报预览」,上传文件并提交,查看文件保存位置即可看到刚上传的文件。如下图所示:

1574834747508971.png

3.4 下载文件

1)A2 单元格插入公式=filename(A1),表示获取 A1 单元格上传的文件名。除了使用公式外,也可以使用数据集字段,手写文件名等方式来设置。

2)选中A2单元格,右边属性面板新增一个「文件下载」类型的「超级链接」,具体设置如下:

设置项
本次示例说明
文件服务Default支持从服务器或者FTP 下载,如果是FTP的话需要选择对应的FTP连接名
文件路径"C:/Users/Leo.Tsai/Desktop/Document/Test.xlsx"文件所在磁盘或者FTP位置
重命名空 选填,可以对下载的文件进行重命名
编码类型UTF-8可以设置编码,以匹配不同编码的环境

Snag_663251b.png

4)保存报表,点击「填报预览」,点击下载超链,即可下载文件,如下图所示:

39FCB2ED-9599-4D14-A4A1-74840E36CC2A.GIF


4. 模板下载编辑

已完成模板可参见:%FR_HOME%\webapps\webroot\WEB-INF\reportlets\doc\form\上传下载文件.cpt

点击下载模板:上传下载文件 .cpt