文件操作

Zion 平台支持多种文件相关行为，适用于微信小程序和 Web 端，涵盖文件上传、查看、下载及位图下载等常见场景。

文件相关行为包括：

1. 上传文件
2. 查看文件
3. 下载文件
4. 下载位图

上传文件

作用

• 小程序端：可选择微信聊天文件，暂不支持直接上传手机本地文件。
• Web 端：可选择系统文件夹中的文件，支持 PDF、Word、Excel、音频等常见格式。

场景

如招聘类项目，页面按钮配置上传文件行为，用于上传应聘者简历。上传成功后可通过“修改表数据”行为将文件写入数据库（需提前创建对应表及文件字段）。

行为配置

添加页面数据

上传文件需先在页面添加类型为“文件”的页面数据。若页面有多个页面数据，建议重命名以便区分。

添加行为

上传文件通过为组件添加“上传文件”行为实现，将上传的文件赋值给页面数据。上传成功时可配置提示行为，或用条件式容器切换上传与上传成功的不同样式。

上传文件行为配置界面	上传成功提示配置界面

特殊说明

1. 仅支持上传单个文件，重复上传会覆盖前一个文件。
2. PC 端打开微信小程序暂不支持此行为。
3. 暂不支持文件预览。

查看文件

作用

在小程序端打开并查看文件。

场景

如远程数据请求到文件后，点击“查看文件”按钮即可查看内容，并可通过微信右上角按钮分享或保存。

行为配置

请求文件的远程数据

需先在页面配置远程数据，查询保存文件的数据表，限额为 1，过滤条件按需设置。

添加行为

为组件添加“查看文件”行为，绑定远程数据中的文件字段。

• 查看本地文件：文件来源选“本地上传”，数据绑定为页面数据。
• 查看数据库文件：文件来源选“文件”，数据绑定为远程数据字段。

查看本地文件行为配置	查看数据库文件行为配置

特殊说明

1. 仅支持查看单个文件。
2. 小程序端无法直接保存文件到手机，需通过“查看文件”行为后点击右上角保存，iOS 需先转发至微信聊天再保存。
3. 文件大小上限 20MB。
4. 仅支持小程序端配置。

下载文件

作用

将数据库中的文件下载到本地电脑。

行为配置

请求文件的远程数据

页面需配置数据源，查询保存文件的数据表，限额为 1，过滤条件按需设置。

添加行为

为组件添加“文件操作-文件-下载文件”行为，绑定远程数据中的文件字段。

下载文件行为配置界面	下载文件行为执行界面

特殊说明

仅支持网页端配置。

下载位图

作用

将目标视图内容下载为位图图片。

行为配置

1. 在组件交互中添加“组件操作-视图-视图转位图”行为，填写目标视图组件 ID，成功后内容转为位图。
2. 在成功时添加“文件操作-图片-下载位图”行为，绑定结果数据进行下载。

特殊说明

仅支持网页端配置。