OSS上传

1 功能简介

在 lczExcel 电子表格表单中，OSS上传 用于实现文件的云端上传与下载。用户可通过该控件将文件直接上传至阿里云 OSS 存储空间（Bucket），并将文件标识（Key）回写至数据库，同时支持在报表中通过函数直接下载 OSS 文件。

2 前提条件

• 乐创者门户配置：已在乐创者智能门户的“第三方平台”中完成阿里云 OSS 存储空间（Bucket）的接入配置。
• 阿里云 OSS 准备：已开通阿里云 OSS 服务，并创建了对应的 Bucket（建议设置为私有读写权限以保证数据安全）。

3 操作流程

3.1 步骤一：设计表单并添加控件

1.在 lczExcel 设计器中创建或打开一个电子表格表单（如“雇员信息录入”）。

2.在目标单元格（如 E23）插入 “ OSS上传”控件。

3.配置控件属性：

• OSS：选择门户配置好的OSS服务。
• 存储空间：从下拉列表中选择已在门户中配置好的 Bucket。
• 前缀（可选）：设置文件存储路径前缀（如 employee_docs/），用于在 OSS 中分类存储文件。注意：前缀不能以“/ ”、“\”开头。

3.2 步骤二：配置回写规则（上传逻辑）

为了实现文件信息自动保存至数据库，需在模板的“回写规则”中进行配置：

• 数据表：选择对应的业务表（如“雇员表”）。
• 字段映射：
  • 文档资料字段：映射到控件所在单元格（如 E23），该字段将存储 OSS 文件的唯一标识（Key）。
  • 文档名称字段：使用公式 filename(E23)获取上传文件的原始名称并回写。
    

3.3 步骤三：配置下载功能（报表展示）

在用于展示文件的报表（如“雇员信息查询”报表）中，使用 loadossfile函数实现文件下载：
1.在报表单元格（如 E23）设置表达式：=loadossfile("dn-wjx", 雇员.文档资料)

• “dn-wjx”：为 OSS 存储空间名称（需与配置一致）。
• 雇员.文档资料：为数据库中存储的文件 Key 字段。
  

2.设置下载文件名：在单元格属性中，设置“下载文件名称”为 雇员.文档名称（或使用 filename(雇员.文档资料)动态获取），确保用户下载时文件名为原始名称。

设置完成后，预览报表，即可点击文件进行下载：

4 核心函数说明

loadossfile(bucket, filekey)

• 功能：获取 OSS 文件对象，并在报表中生成下载链接。
• 参数：
  • bucket：OSS 空间名称（字符串）。
  • filekey：文件在 OSS 中的唯一标识（Key），通常来自数据库字段。
• 返回值：生成可点击下载的文件链接。

5 注意事项

• 权限安全：建议在阿里云 OSS 控制台将 Bucket 权限设置为私有，乐创者控件通过内嵌的 AccessKey 进行签名访问，避免文件被匿名直接访问。
• 路径规范：OSS 中的文件 Key 是唯一的，请确保回写规则正确映射，避免文件上传后无法关联到业务数据。