跳到主要内容

文件上传字段

文件上传字段（FileUpload）用于上传与管理附件、图片等文件。

概述​

文件上传字段以文本形式存储文件元信息（JSON 数组），可限制上传数量、单文件大小与文件格式。在列表与详情页中，图片可预览、其他文件可下载；通过附件展示模式可以选择紧凑列表或图片预览的呈现方式。

配置项​

配置项说明可选值
名称字段显示名称，必填—
编码字段唯一编码，必填，创建后不可修改—
描述字段用途说明—
文件数量限制单次可上传的文件数1–10，默认 3
单文件大小限制每个文件的大小上限1 / 5 / 10 / 30 / 50 MB，默认 5
文件格式限制允许的文件格式遵循 HTML input accept 标准
附件展示模式附件的展示方式默认模式 / 预览模式

文件格式限制​

格式限制采用 HTML input 的 accept 语法，多个格式用逗号分隔，常用写法：

.pdf,.doc,.docx,.xls,.xlsx
image/*,video/*
.mp3,.mp4,.avi

附件展示模式​

模式值说明
默认模式0详情页以列表展示文件链接；列表页以图标 + 弹层展示
预览模式1图片直接以缩略图展示并支持点击预览，非图片仍以链接展示

下一步​

属性明细​

以下内容面向技术实现与 AI 检索。

文件上传字段属性表​

属性名类型含义取值/存储值
FieldTypeint字段类型FileUpload = 14
FileCountLimitint文件数量上限1–10
FileSizeLimitint单文件大小上限单位 MB，如 5
FileFormatLimitstring允许的文件格式accept 字符串，如 image/*,.pdf
Properties.AttachmentDisplayModeAttachmentDisplayModeEnum附件展示模式Default=0 / PreviewMode=1

文件上传字段不支持开启索引。上传接口为 POST /api/Biz/Upload。

附件展示模式枚举值​

枚举名值中文含义
Default0默认模式
PreviewMode1预览模式

存储示例​

字段定义：

{
  "Code": "attachments",
  "Name": "相关附件",
  "FieldType": 14,
  "FileCountLimit": 3,
  "FileSizeLimit": 5,
  "FileFormatLimit": "image/*,.pdf",
  "Properties": {
    "AttachmentDisplayMode": 1
  }
}

对象数据中该字段存储为文件信息 JSON 数组的字符串：

{
  "Fields": {
    "attachments": {
      "Code": "attachments",
      "Text": "[{\"id\":\"f8e7d6c5-...\",\"name\":\"合同.pdf\",\"type\":\"application/pdf\",\"time\":1735689600000,\"size\":204800}]",
      "Value": "[{\"id\":\"f8e7d6c5-...\",\"name\":\"合同.pdf\",\"type\":\"application/pdf\",\"time\":1735689600000,\"size\":204800}]"
    }
  }
}