1. 概述编辑
1.1 版本
设计器版本 | JAR 包 | 插件版本 |
---|---|---|
10.0 | 2019-06-11 | V6.1.1 |
9.0 | 2019-06-11 | V6.0.8 |
8.0 | 2019-06-11 | V6.0.8 |
1.2 应用场景
有时候用户需要将文件上传到服务器保存,并且可以提供文件下载。以前 FineReport 实现此功能需要自定义函数实现,但代码实现会比较麻烦。该插件将此功能封装,安装后可以通过可视化界面操作,方便快捷。
注:此插件暂不支持决策报表。
1.3 功能介绍
报表填报属性界面,自定义提交中新增上传类型选择,可选择上传至服务器或上传至FTP
超级链接新增一个选项文件下载
2. 插件介绍编辑
2.1 插件安装
插件下载请点击:上传下载文件插件
设计器插件安装方法参照 设计器插件管理
服务器安装插件方法参照 服务器插件管理
2.2 插件功能
1)上传至服务器
报表填报属性界面,自定义提交中新增了上传类型选择,可选择上传至服务器,此方式适用于单机工程,如下图所示:
注1:参数面板中、CPT 单元格控件中的控件事件都同步加了上传至服务器功能。
注2:同名文件覆盖,默认不勾选,不勾选时,同名文件重命名,勾选后实现同名文件直接覆盖。
2)上传至 FTP
报表填报属性界面,自定义提交中新增上传类型选择,可选择上传至 FTP,此方式适用于单机和集群工程,如下图所示:
注1:参数面板中、CPT 单元格控件中的控件事件都同步加了上传至服务器功能。
注2:同名文件覆盖,默认不勾选,不勾选时,同名文件重命名,勾选后实现同名文件直接覆盖。
3)文件下载
超级链接新增一个选项文件下载,可以通过设置超级链接,实现从服务器端下载文件,如下图所示:
2.3 注意事项
1)上传路径全红为正确,路径用双引号括起,举例:"C:/Users/WCT/Desktop/"。
2)上传页面点击上传后需要点击提交按钮。
3)在填报属性界面可定义文件上传后的名称。
4)文件上传和下载为不同单元格。
5)移动端只支持上传,不支持下载。
6)请勿一次上传多个文件,文件名会默认叠加修改,如下图所示:
3. 示例编辑
下面通过制作一张报表,演示一下如何使用该插件的功能。
3.1 报表设计
选中 A1 单元格,如下图给 A1 单元格添加文件控件。
3.2 上传文件到服务器
1)菜单栏点击模板>报表填报属性,添加自定义提交,提交类型选择上传至服务器。
磁盘路径:填写服务器磁盘路径,例如插入公式"C:/Users/Leo.Tsai/Desktop/Document/"
文件:填写文件的填报单元格,插入公式A1
文件名:填写文件名,插入公式LEFT(FILENAME(A1), FIND(".", FILENAME(A1)) - 1)
注:公式LEFT(FILENAME(A1), FIND(".", FILENAME(A1)) - 1),表示 find 函数找到后进行定位,再使用 left 函数提取前面的位数,防止出现多后缀名。
注:这里文件名可以直接输入内容,或者使用单元格内容或者函数。
3)保存报表,点击填报预览,并上传文件,文件上传成功,保存至设置好的路径下且文件名为 A1 单元格的文件名。
注:请勿一次上传多个文件,否则文件名会叠加,造成使用困扰。
3.3 上传文件到FTP
1)菜单栏点击模板>报表填报属性,添加自定义提交,提交类型选择上传至FTP,点击 FTP 设置,添加一个 FTP 连接。
2)如下图新建一个 FTP 连接,用户需根据实际场景填写连接信息。
3)设置文件信息。
上传路径:填写FTP上传路径,例如插入公式"/FineReport Document"
文件:文件填报的单元格,插入公式A1
文件名:填写文件名,插入公式LEFT(FILENAME(A1), FIND(".", FILENAME(A1)) - 1)
FTP站点:选择连接好的 FTP 站点,例如Test
4)保存报表,点击填报预览,并上传文件,文件上传成功,FTP 站点下会保存该文件,且文件名为 A1 单元格的文件名。
注:请勿一次上传多个文件!文件名会叠加,造成使用困扰。
3.4 下载功能
以4.2中已经设计好的上传到服务器报表为例( FTP同理设置即可 )。
1)A2 单元格插入公式filename(A1),表示获取 A1 单元格上传的文件名,A2 单元格如下图设置形态属性,设置自定义类型的数据字典。
实际值=$$$
显示值=LEFT(FILENAME(A1), FIND(".", FILENAME(A1)) - 1)
2)设计器菜单栏点击模板>报表填报属性,如下图新增内置SQL提交,将 A2 单元格的文件名保存到数据库中,为后期数据的下载做准备(数据库中有一张表,里面 filename 字段用来存储上传的文件的文件名)。
3)选中 A2 单元格,右边属性面板新增一个文件下载类型的超级链接,文件下载的具体设置如下图步骤5所示:
文件服务:只有一个选项Default,同时支持从服务器和 FTP 下载,如果是 FTP,需要在右边设置FTP设置连接一个 FTP。
文件路径:要下载的文件的路径,如:插入公式"C:/Users/Leo.Tsai/Desktop/Document/Test.xlsx"。
重命名:可以对下载到本地的文件进行重命名,这个是选填项,非必须。
编码类型:匹配自己环境下 FTP 的编码。
4)保存报表,点击填报预览,点击下载超链,即可下载文件,如下图所示: