菜单

移动文件

一、指令概述

该 RPA 指令用于将飞书云盘指定类型的文件移动到目标文件夹,需配置飞书访问凭证、待移动文件的唯一标识(文件 Token)、目标文件夹的唯一标识(文件夹 Token)及文件类型(如bitabledocx等),执行后返回移动任务 ID,适用于飞书文件的精准分类整理场景。

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

二、调用参数配置示意

参数名称示例 / 默认值说明
指令移动文件固定选择 “移动文件”,执行飞书文件移动操作。
飞书访问凭证飞书访问凭证配置飞书开放平台的访问凭证(需具备文件移动权限,可通过 “获取飞书访问凭证” 指令生成),支持变量(界面显示 “{x}” 标识)。
要移动的文件 TokenGrTwb****************输入待移动文件的唯一标识 Token(需为飞书云盘合法文件的有效 Token),关键字符已打码,支持变量。
目标文件夹 TokenTKRkf****************输入目标文件夹的唯一标识 Token(需为飞书云盘合法文件夹的有效 Token),关键字符已打码,支持变量。
文件类型bitable / docx / file选择待移动文件的类型(需与文件实际类型匹配,否则接口返回失败),下拉可选:- file:普通文件类型;- docx:新版文档类型;- bitable:多维表格类型;- doc:文档类型;- sheet:电子表格类型等,支持变量。
生成的变量 - 运行结果变量1(自定义变量名)存储文件移动操作的执行结果(包含任务 ID),需配置为自定义变量,后续流程可调用,支持变量。

三、使用示例(移动多维表格场景)

场景:将飞书云盘类型为bitable的文件(Token 为GrTwb****************)移动到目标文件夹(Token 为TKRkf****************)。

参数配置:

指令:移动文件

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

要移动的文件 Token:GrTwb****************(文件唯一标识,关键字符已打码)

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

文件类型:bitable

运行结果:moveResult(自定义变量,存储移动结果)

执行流程:

调用该 RPA 指令后,RPA 会通过 feishuAuthToken 完成飞书 API 认证,根据打码后的文件 Token、目标文件夹 Token 及匹配的文件类型bitable,执行文件移动操作;操作完成后,将包含任务 ID 的结果存入 moveResult 变量,便于后续确认移动状态或记录操作日志。

四、返回结果说明

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

指令执行后,“运行结果” 变量(如moveResult)会存储包含移动任务 ID 的 JSON 结果,格式如下:

{ "code": 0, "msg": "success", "data": { "task_id": "7360595374803812356" }}

响应字段含义:

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

msg:提示信息,success 表示移动成功。

data.task_id:移动任务的唯一标识 ID,可用于追踪移动任务的执行状态(若需确认移动结果,可结合飞书任务查询接口使用)。

五、注意事项

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

2. 文件类型匹配性文件类型需与待移动文件的实际类型完全一致(如文件是多维表格则选bitable,普通文件选file),否则接口会返回失败(如code=400 参数不匹配错误)。

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

4. 操作影响:文件移动后,原路径将不再保留该文件,仅存于目标文件夹中,请确保目标文件夹正确且操作前确认文件移动的必要性。

六、延伸应用

可结合 RPA 的 “获取文件夹中的文件清单” 指令,实现飞书云盘文件批量精准移动:例如先调用 “获取文件夹中的文件清单” 指令,筛选出类型为bitable且满足移动条件的文件 Token 列表,再循环调用本 “移动文件” 指令,将这些文件自动移动到指定目标文件夹,替代人工手动逐个判断类型并移动的重复工作,提升文件整理效率。


上一个
下载文件
下一个
获取空间元数据
最近修改: 1970-01-01