1.1 版本

1.2 应用场景

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

1.3 功能简介

• 文件上传可上传至「服务器」或「FTP」，同时支持「普通报表」和「决策报表」

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

• 各类控件的控件「事件」中同步增加「文件上传」功能。
  

• 不支持单元格扩展

• 不支持多文件上传

• 不支持在集群环境下使用

• 移动端仅支持文件上传，不支持文件下载

2.1 插件安装

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

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

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

2.2 插件功能

2.2.1 上传至服务器

报表填报属性界面，自定义提交中新增了上传类型选择，可选择「上传至服务器」，此方式适用于单机工程，如下图所示：

注：同名文件覆盖，默认不勾选，不勾选时，同名文件重命名，勾选后，实现同名文件直接覆盖。

2.2.2 上传至 FTP

报表填报属性界面，自定义提交中新增上传类型选择，可选择「上传至 FTP」。如下图所示：

注：同名文件覆盖，默认不勾选，不勾选时，同名文件重命名，勾选后实现同名文件直接覆盖。

2.2.3 文件下载

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

注：决策报表不支持「文件下载」功能。

2.3 设置项格式要求

2.3.1 普通报表

2.3.2 决策报表

1）在2020-01-15发布的上传下载插件（App 10.4.49&10.4.55），文件提交至服务器/FTP的使用格式为：

2）2020-02-28及之后发布的插件版本（App 10.4.61）遵循如下规则：

注：上传路径全红为正确，路径必须用双引号括起来。

注：Linux环境下路径地址格式参考Windows路径

3.1 报表设计

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

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

3.2 上传至服务器

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

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

3）保存报表，点击「填报预览」，并上传文件，文件上传成功，保存至设置好的路径下且文件名为 A1 单元格的文件名。如下图所示：

注：请勿一次上传多个文件，否则文件名会叠加，造成使用困扰。

3.3 上传至 FTP

1）菜单栏点击「模板>报表填报属性」，添加「自定义提交」，提交类型选择「上传至 FTP」，点击 FTP 设置，添加一个 FTP 连接。如下图所示：

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

3）设置文件信息，如下图所示：

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

4）保存报表，点击「填报预览」，并上传文件，文件上传成功，FTP 站点下会保存该文件，且文件名为 A1 单元格的文件名。如下图所示：

注：请勿一次上传多个文件！文件名会叠加，造成使用困扰。

3.4 文件下载

以 3.2 中已经设计好的上传到服务器报表为例( FTP 同理设置即可 )。

1）A2 单元格插入公式filename(A1)，表示获取 A1 单元格上传的文件名，A2 单元格如下图设置形态属性，设置自定义类型的数据字典。

实际值=$$$

显示值=LEFT(FILENAME(A1), FIND(".", FILENAME(A1)) - 1)

2）设计器菜单栏点击「模板>报表填报属性」，如下图新增「内置 SQL 提交」，将 A2 单元格的文件名保存到数据库中，为后期数据的下载做准备（数据库中有一张表，里面 filename 字段用来存储上传的文件的文件名）。如下图所示：

3）选中A2单元格，右边属性面板新增一个「文件下载」类型的「超级链接」，文件下载的具体设置如下图所示：

文件服务：只有一个选项「Default」，同时支持从服务器和 FTP 下载，如果是 FTP，需要在右边设置「FTP设置」连接一个 FTP。

文件路径：要下载的文件的路径，如：插入公式"C:/Users/Leo.Tsai/Desktop/Document/Test.xlsx"。

重命名：可以对下载到本地的文件进行重命名，这个是选填项，非必须。

编码类型：匹配自己环境下 FTP 的编码。

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

注：该方法支持移动端。

4.1 报表设计

1）在FineReport设计器中点击「文件>新建决策报表」。

2）在新建决策报表中拖入两个「文件控件」和两个「按钮控件」。

3）选中「multiFileUploader0」控件，选择文件类型为「jpg,png,gif」，如下图所示：

4.2 上传至服务器

1）选中「button0」控件，在「事件」Tab 下添加「点击事件」，如下图所示：

2）选择「文件上传」，类型为「上传至服务器」，根据实际情况填写磁盘路径、文件、文件名。如下图所示：

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

4.3 上传至 FTP

1）选中「button1」控件，在「事件」Tab 下添加「点击事件」，如下图所示：

2）选择「文件上传」，类型为「上传至FTP」，点击「FTP设置」，新增「FTP站点」，根据实际情况配置 FTP 信息。如下图所示：

3）根据实际情况填写磁盘路径、文件、文件名。如下图所示：

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

4.4 效果查看

4.4.1 PC 端

上传文件：

上传文件后效果：

4.4.2 移动端

以 App 效果为例。

上传文件：

上传文件后效果：

1）普通报表

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

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

2）决策报表

已完成模板可参见：%FR_HOME%\webapps\webroot\WEB-INF\reportlets\doc\form\决策报表实现上传文件.frm

点击下载模板：决策报表实现上传文件.frm