附件

1. 控件介绍

附件控件主要用于文件上传、下载、预览等。需要绑定实体字段。

2. 控件特性

2.1 基础

2.1.1 绑定字段

可绑定字段数据类型:附件

绑定的字段如果是多选,那么该附件控件可上传多个文件, 否则只能上传一个。

可在实体的字段列表中确认配置的是否多选。

1719458682845

2.1.2 设置控件样式

附件控件提供4种样式:上传按钮、照片墙式、拖拽区域式、照片列表式。 还可以修改上传按钮的文字、图标、按钮样式。

1719383568033

设计态效果如下:

1719368834053

运行态效果如下:

补图

2.1.3 控件样式适配列表

使用场景:在列表中,希望附件控件只占单行。

配置:开启适配列表

样式效果:

1719395185310

2.2 设置

2.2.1 设置附件表格样式

使用场景:希望上传后的文件展示成表格样式。

在表格样式中会展示上传附件的附件名称、附件大小、上传时间、上传人、上传人部门,最后一列为附件的操作列,比如预览、下载、删除等操作,操作列可配置显示为仅文字、仅图标、文字+图标。

配置如下:

1719385657702

设计态效果:

1719385285774

2.2.2 设置附件个数和大小

当绑定的附件字段是多选时,可以配置上传附件的个数上限,在运行态上传文件时会做校验提示。

可以配置单个附件文件的大小。配置如下:

1729823295601

2.2.3 设置附件文件类型

可以限制可上传文件的类型, 图片、视频、文件,也支持自定义格式。

以下是各种类型支持文件格式。

图片:.jpg,.jpeg,.png,.gif

视频:.mp4,.rmvb,.avi,.wmv,.mov

文件:.docx,.doc,.pptx,.ppt,.pdf,.txt,.xlsx,.ofd

配置如下:

1719384683685

2.2.4 设置附件模板

使用场景: 设计态搭建应用时上传附件文件,终端用户只是下载和查看文件。

配置如下:

1719384420953

小技巧:在属性区上传附件模板文件,选中文件可以拖动调整文件排序。

设计态配合了附件模板后的效果:

1719384449685

运行态效果:

补图

2.2.5 设置隐藏内容

隐藏文件信息课勾选隐藏附件大小、上传时间、上传人、上传部门,勾选后运行态隐藏对应信息。

1729824097843

2.3 附件操作

2.3.1 附件下载支持水印

水印范围可选择跟随系统和无水印。

1729822374855

跟随系统:跟随平台的水印设置,包括场景、水印内容和样式。

img
1729822860880

2.3.2 设置附件批量操作

(1)批量上传:

  • 本地选中多个文件,批量上传
  • 开启上传文件夹,本地选中文件夹,批量上传文件夹中的文件。
  • 1719391920905

(2)批量删除:开启批量删除的开关,可选中多个已上传的文件进行批量删除。

1719391961731

(3)批量下载:开启批量下载的开关,可选中多个已上传的文件进行批量下载。如果文件是多个,会打包下载,可设置打包文件的文件名。

1719391876680

(4)批量设置密级:开启批量设置密级的开关,可选中多个已上传的文件进行批量设置密级。

1723085137519

2.3.3 转PDF下载

附件支持转PDF下载,输入需要转PDF下载的文件格式,多个以英文逗号分隔(如doc,txt,docx),在文档下载时会将指定格式的文档转为PDF下载。

1729823046721

2.3.4 预览时可复制

开启预览时可复制后,运行态文件预览时支持复制内容。

1729824200129

2.3.5 附件重命名

开启后,对于运行态上传的附件文件,上传人可以对已上传的附件进行重命名操作。

1729826752443

1729827073669

2.4 附件操作控制

针对附件文件,可执行扫码上传、本地上传、下载、预览、删除、编辑、设置密级等操作。

可根据实际业务需求,控制这些操作的状态(正常、禁用、隐藏),支持条件表达式。

注意:目前只有WPS(V6)通道可编辑文件。

1729823597375

2.4.1 操作权限控制

开启后,在【角色权限】中可以给角色授权附件“扫码上传、本地上传、下载文件、预览文件、删除文件”等操作权限。

注意:角色权限中授权仍然会遵循控件状态优先级比较。

1729823673054

1719392924531

2.4.2 附件编辑

集成平台提供通道支持,对授予了文档编辑权限的附件,支持在线编辑。

设计态编辑文件默认隐藏,点击改为正常即可在运行态进行附件在线编辑。

1729823923237

运行态:

1724053172764

1724053191168

2.4.3 密级设置

附件开启了密级设置,在运行态上传附件,可以设置密级属性

运行态附件使用时,根据系统三员的总体规则配置,控制那些用户最终权限,如:低密级人员不允许查看高密级附件

1729823987420

运行态:

1724052307505

1724052350590

2.5 设置附件控件状态

1719388965545

附件的控件状态实际控制的是附件操作,对应关系如下表:

附件控件状态 操作状态
附件正常 –操作项正常:预览、下载、删除、设置密级
–操作项隐藏:编辑
附件只读 –操作项正常:预览、下载
–操作项隐藏:删除、上传、编辑、设置密级
附件禁用 所有操作项禁用
附件隐藏 整个控件隐藏

注意:附件的操作状态是可以单独配置状态的,在2.7中已经说明。那么最终运行态的操作究竟是什么状态呢?

前文中我们已经说明过,当控件嵌套控件时,当前控件会受上级控件状态的影响,两种会比较状态的优先级(正常<只读<禁用<隐藏),决定当前控件最终运行时是什么状态。

所以,附件控件状态下对应操作的状态, 会和该操作本身配置的状态做比较,决定该操作最后运行时的状态。

比如:附件控件只读时,预览和下载默认是正常的。 如果设计态单独将预览和下载设置为禁用, 因为禁用优先级高于正常,所以,在运行态看到的效果是预览和下载是禁用的。

特别说明:以上只是为了给大家介绍背后的逻辑, 实际搭建时,只需要调整附件控件的状态,该状态下操作的状态是满足绝大多数场景的,不用单独再去配置某个操作的状态。只有不满足场景需求时,再单独调整操作的状态。

  • 功能权限:开启后,在【角色权限】中可以给角色授权该控件

1719392731100

2.6 附件预览打印

运行态附件支持预览打印。

1723085345543

最后修改 October 25, 2024: 3.8操作文档更新 (31e3c15)