菜单

上传文件

一、指令概述

该 RPA 指令用于将本地文件上传至飞书云盘指定文件夹,执行后返回上传文件的唯一标识(file_token),适用于本地文件的飞书云盘备份、自动化上云等场景。

飞书官方开发文档参考:https://open.feishu.cn/document/server-docs/docs/drive-v1/upload/upload_all

二、调用参数配置示意

参数名称示例 / 默认值说明
指令上传文件固定选择 “上传文件”,执行本地文件飞书云盘上传操作。
飞书访问凭证飞书访问凭证配置飞书开放平台的访问凭证(需具备文件上传权限,可通过 “获取飞书访问凭证” 指令生成),支持变量(界面显示 “{x}” 标识)。
文件夹 Tokenfldbc****************输入目标文件夹的唯一标识 Token(需为飞书云盘合法文件夹 Token),关键字符已打码,支持变量。
文件路径(如 “C:\Reports\ 报表.xlsx”)选择本地待上传文件的路径,可点击 “选择文件” 按钮选取,支持变量。
生成的变量 - 运行结果变量(自定义变量名)存储文件上传操作的执行结果(包含上传后文件的file_token),需配置为自定义变量,后续流程可调用,支持变量。

三、使用示例(本地文件上传至飞书云盘场景)

场景:将本地文件 “报表.xlsx” 上传至飞书云盘目标文件夹(Token:fldbc****************)。

参数配置:

指令:上传文件

飞书访问凭证:feishuAuthToken(通过 “获取飞书访问凭证” 指令生成的变量)

文件夹 Token:fldbc****************(目标文件夹唯一标识,关键字符已打码)

文件路径:C:\Reports\报表.xlsx(本地待上传文件路径)

运行结果:uploadResult(自定义变量,存储上传结果)

执行流程:

调用该 RPA 指令后,RPA 会通过 feishuAuthToken 完成飞书 API 认证,根据打码后的文件夹 Token 和本地文件路径,将文件上传至飞书云盘指定文件夹;上传完成后,将包含file_token的结果存入 uploadResult 变量,便于后续文件管理(如移动、分享)等操作引用该文件标识。

四、返回结果说明

飞书 API 标准返回示例(成功场景):

指令执行后,“运行结果” 变量(如uploadResult)会存储包含上传文件标识的 JSON 结果,格式如下:

{ "code": 0, "msg": "success", "data": { "file_token": "boxcnrHpsg1QDqXAAAyachabcef" }}

响应字段含义:

code:状态码,0 表示文件上传成功,非 0 为失败(具体错误码含义参考飞书官方文档)。

msg:提示信息,success 表示上传成功。

data.file_token:上传后文件的唯一标识 Token,是飞书云盘操作该文件的核心身份标识(如后续移动、删除文件需引用此 Token)。

五、注意事项

1. 访问凭证权限:“飞书访问凭证” 需具备文件上传权限(如 “Upload file” 权限)且未过期,否则会返回 code=403(权限不足)错误。

2. 文件夹 Token 有效性文件夹Token 需为飞书云盘合法存在的文件夹 Token(打码不影响实际值校验),否则会返回 code=404(目标文件夹不存在)错误。

3. 文件路径合法性:本地 “文件路径” 需指向真实存在的文件(避免选择快捷方式或不存在的路径),否则会返回文件读取失败错误。

4. 上传限制:飞书 API 对上传文件的大小、格式有一定限制(具体参考飞书官方文档),超出限制会导致上传失败,需提前确认文件符合要求。

六、延伸应用

可结合 RPA 的 “新建文件夹”“移动文件” 指令,实现本地文件自动化云盘管理:例如本地生成日报表后,自动调用 “上传文件” 指令将其上传至飞书临时文件夹,再调用 “移动文件” 指令将其移动到 “日报表归档” 文件夹,替代人工手动上传和整理的重复工作,提升文件上云效率。


上一个
新建文件夹
下一个
下载文件
最近修改: 1970-01-01