反馈已提交

网络繁忙

上传下载文件插件

  • 文档创建者:lu123
  • 历史版本:90
  • 最近更新:Carly 于 2023-11-21
  • 1. 概述

    1.1 应用场景

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

    1.2 功能限制

    • 请确保您的工程可以支持远程设计,不然插件可能无法正常使用

    • 同一文件控件上传多个文件时,不支持自定义文件名,会重叠显示

    • 上传和下载的路径不支持网络路径

    • 文件下载重命名功能不支持读取扩展单元格值

    • 文件下载路径不支持动态计算公式

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

    • 不支持删除文件

    • 除了FTP外,不支持其他类型的远程服务器上传和下载文件

    • 不支持集群环境

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

    • 容器化环境上传文件给主机,需要做容器和主机之间的上传路径文件映射

    • 于安全考虑,需要登录决策平台账号后才可以下载文件

    • 不支持在模板 Web 属性中设置文件上传事件

    注:如果实际场景受到以上功能限制影响,可以考虑使用悦享版文件上传下载插件解决,其功能和覆盖的场景更多。

    2. 插件介绍

    2.1 插件安装

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

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

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

    2.2 插件功能

    2.2.1 上传至服务器

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

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

    1614847670210710.png

    2.2.2 上传至 FTP

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

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

    1614847752799060.png

    2.2.3 文件下载

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

    4.png

    2.3 设置项格式

    设置项内容示例
    上传路径/文件路径
    公式、固定值
    • A1

    • "D:/photo"(windows)

    • "/data/tomcat/"(linux和ftp)

    文件
    公式
    • A1

    文件名空、公式固定值
    • A1

    • "test2"

    • 空(为空时会自动获取文件名)

    重命名 空、公式固定值
    • A1

    • "test2"

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

    注2:下载重命名功能不支持读取扩展单元格值。文件下载路径不支持动态计算公式。

    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设置页」。

    Snag_72bdc647.png

    2)点击「FTP设置页」左上角新增按钮,新建一个 FTP 连接,用户需根据实际场景填写连接信息。用户名和密码如没有可以不设置,如下图所示:

    注:该配置为服务器级别配置,保存位置为finedb,因此远程环境下直接复制模板无法继承ftp配置,需要使用远程设计功能。

    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. 模板下载

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


    附件列表


    主题: 填报应用
    • 有帮助
    • 没帮助
    • 只是浏览
    中文(简体)

    鼠标选中内容,快速反馈问题

    鼠标选中存在疑惑的内容,即可快速反馈问题,我们将会跟进处理。

    不再提示

    10s后关闭

    联系我们
    在线支持
    获取专业技术支持,快速帮助您解决问题
    工作日9:00-12:00,13:30-17:30在线
    页面反馈
    针对当前网页的建议、问题反馈
    售前咨询
    采购需求/获取报价/预约演示
    或拨打: 400-811-8890 转1
    qr
    热线电话
    咨询/故障救援热线:400-811-8890转2
    总裁办24H投诉:17312781526
    提交页面反馈
    仅适用于当前网页的意见收集,帆软产品问题请在 问答板块提问前往服务平台 获取技术支持