图片、视频、文件、音频
图片、视频、文件、音频字段用于保存上传资源。这些字段类型共用上传配置，字段类型决定资源类别。
当记录需要附件、凭证、媒体、文档或其他上传文件时，可以使用资源类字段。
基础配置
| 配置项 | 说明 |
|---|---|
| 名称 | 展示给用户的字段标签，必填；名称应清楚表达需要上传的资源 |
| API 名称 | 数据接口、脚本、公式、导入和集成使用的稳定技术名称，必填 |
| 必填 | 保存记录前必须上传资源 |
| 只读 | 展示已上传资源，但不允许用户修改 |
| 停用 | 字段不参与常规使用 |
| 隐藏 | 字段会保存上传资源，但不在常规表单页面展示 |
资源字段配置
| 配置项 | 说明 |
|---|---|
| 存储策略 Key | 上传资源使用的存储策略 |
| 上传按钮文案 | 上传按钮上显示的文字 |
| 允许预览 | 只对系统支持预览的已上传文件显示预览入口；允许上传但不支持预览的文件仍会在列表中展示，并可在允许下载时下载 |
| 允许下载 | 允许用户下载已上传资源 |
| 显示上传列表 | 在字段中展示已上传项目 |
| 列表类型 | 控制上传列表的展示样式 |
| 校验时机 | 控制什么时候执行上传校验：值变更时、失焦时或提交记录时 |
| 最少数量 | 至少需要上传的项目数量 |
| 最多数量 | 最多允许上传的项目数量 |
| 允许扩展名 | 允许上传的文件扩展名 |
| 最大体积（MB） | 单个上传项目的最大体积 |
| 空态文案 | 没有上传资源时显示的文案 |
| 无效类型提示 | 文件类型不符合要求时显示的自定义提示 |
| 最多数量提示 | 上传数量超过限制时显示的自定义提示 |
| 最大体积提示 | 上传项目体积过大时显示的自定义提示 |
| 上传失败提示 | 上传失败时显示的自定义提示 |
| 帮助文案 | 展示在字段附近的辅助说明；可用于说明文件要求 |
| 颜色 | 设置字段展示颜色 |
预览能力
上传规则和预览能力是两件事。允许扩展名 控制用户可以上传什么文件；允许预览 只控制系统是否为当前预览器支持的文件显示预览入口。
开启 允许预览 后：
- 支持预览的文件会在上传列表、紧凑列表和表格单元格中显示预览入口
- 不支持预览的文件不会显示预览入口，用户不会点进弹窗后才看到“不支持预览”
- 不支持预览的文件仍可上传、展示文件名，并在开启
允许下载时下载
Soln 当前支持预览这些简单稳定的文件类型：
| 预览类型 | 扩展名 |
|---|---|
| 图片 | jpg, jpeg, png, gif, bmp, webp, svg, avif, ico |
pdf | |
| 文本和代码 | txt, md, markdown, json, jsonl, xml, csv, tsv, log, sql, js, jsx, ts, tsx, css, scss, less, html, htm, yml, yaml, toml, ini, cfg, conf, env, properties, mjs, cjs, vue, svelte, java, c, h, cc, cpp, cxx, hpp, cs, go, rs, py, rb, php, sh, bash, zsh, ps1, swift, kt, kts, scala |
| 视频 | m3u8, mp4, webm, ogv, mov, m4v, 3gp |
| 音频 | mp3, wav, m4a, aac, ogg, opus, flac |
常见的不支持预览但仍可上传/下载的类型包括：zip, rar, 7z 等压缩包，avi, wmv, mkv, rmvb 等复杂音视频，fig, sketch, psd, dwg, stl, glb 等设计/CAD/模型文件，以及 parquet, avro, orc 等数据列式文件。
字段类型区别
| 字段类型 | 常见用途 |
|---|---|
| 图片 | 照片、截图、视觉凭证 |
| 视频 | 录像、演示、巡检视频 |
| 文件 | 文档、表格、压缩包、通用附件 |
| 音频 | 语音备注、通话、录音 |
配置建议
| 建议 | 说明 |
|---|---|
| 限制扩展名 | 扩展名限制可以减少错误上传，并明确文件要求 |
| 设置最大体积 | 体积限制可以避免上传过大的文件 |
| 使用数量限制 | 最少和最多数量能让上传资源符合业务要求 |
| 支持格式开启预览 | 对系统支持的图片、PDF、文本/代码、常见音视频开启预览更方便查看；如果允许上传压缩包、设计稿、专业数据文件等不支持预览的格式，建议同时保留下载入口 |