文件值字段类型

图片、视频、文件、音频字段使用 dataType: 'array'。存储的数组里是文件资产引用。

字段类型	存储值
图片	图片文件引用数组
视频	视频文件引用数组
文件	文件引用数组
音频	音频文件引用数组

脚本需要完整文件资产详情时，使用 context.file.resolve。

const attachmentIds = Array.isArray(record.data.attachments)
  ? record.data.attachments.map((item) => String(item)).filter(Boolean)
  : [];

const files = await context.file.resolve({
  fileIds: attachmentIds,
});

解析后的文件资产会包含原文件地址，并在支持时包含预览地址。预览能力比上传能力更窄：文件可以合法上传和下载，但不一定能被 Soln 预览。

脚本需要文件展示地址时，可以使用 file.previewUrl || file.url。其中 previewUrl 只会在当前预览器支持的文件类型上返回，例如常见图片、PDF、文本/代码文件、常见音视频文件。压缩包、复杂媒体、设计/CAD/模型文件、数据列式文件等不支持预览的格式可能返回 previewUrl: null；这类文件请使用 file.url 下载或交给外部系统处理。