一、功能描述

将本地文件上传至当前多维表格可用的存储，得到 file_token，用于写入附件类型字段。单文件建议不超过 20MB（以飞书接口说明为准）。

二、属性说明

组件输入

• 凭证：组件中通过添加凭证配置的飞书应用凭证。

• 多维表ID：目标多维表格的唯一标识，可从多维表格 URL 中获取。

• 文件：选择需要上传的文件。

组件输出

• 执行结果：字典；通常含 file_token，请保存后写入附件字段。

高级属性

• 错误继续执行：组件运行异常时，流程是否继续运行。
• 执行前延时(秒)：运行组件前的延时时间。
• 执行后延时(秒)：运行组件后的延时时间。
• 超时时间(秒)：运行组件的超时时间限制。

三、使用实例

前置环境

1. 飞书开放平台 → 应用 → 权限管理：一般勾选 bitable:app 即可；若报无权限，再按飞书「上传素材」接口补勾 docs:document.media:upload 等（文档所列多项为任选其一）。保存后 发版。

2. 把应用加进目标多维表格的 协作者（多维表格右上角「…」→「更多」→「添加文档应用」，建议可编辑或可管理）；只开通权限、不加协作者会调用失败。若表格开了 高级权限，还要在高级权限里给应用对应能力。详见 如何为应用开通云文档权限。

流程编辑

在流程中拖入本组件，按「组件输入」填写参数。

运行结果

根据「组件输出」将返回值赋给变量，用于后续步骤或打印到日志查看。

四、常见问题

Q1、1254303 附件权限

说明：须先上传到当前多维表格关联空间，再写入记录。

Q2、文件超过大小限制

说明：组件仅支持小于20MB的文件上传。