1. 功能说明
将本地的 Word、TXT、Markdown（含.md/.mark/.markdown）或 HTML 文件，一键导入为飞书在线云文档。该指令内部封装了 “上传文件至飞书素材库→创建导入任务” 的完整流程，是【任务 - 创建导入任务】的简化版，同样为异步任务，需配合【任务 - 查询导入任务结果】获取最终导入状态。
2. 配置项说明
| 配置项 | 必填 | 说明 |
|---|---|---|
| 飞书访问凭证 | 是 | 选择已配置的飞书访问凭证，需确保对应应用已开通云文档 “导入” 和 “上传” 相关权限。 |
| 文件路径 | 是 | 填写本地待导入文件的完整路径（如 C:\docs\项目需求.docx），或点击「选择文件」按钮直接选取文件。支持格式：.docx/.doc/.txt/.md/.mark/.markdown/.html。 |
| 上传位置 Token | 是 | 飞书云空间中目标文件夹的 token，导入后的云文档将存放在此文件夹下。 |
| 任务 ID | 是 | 存储内部生成的导入任务唯一标识（ticket），用于后续【查询导入任务结果】的入参。 |
底层逻辑与依赖
该指令是对飞书两个核心 API 的封装：
- 上传素材 API：将本地文件上传至飞书素材库，获取
file_token。 - 创建导入任务 API：使用
file_token创建异步导入任务，返回task_id。指令会自动完成上述两步，无需手动拆分操作。
返回结果说明
指令执行后，主要通过生成的变量返回关键信息：
- 任务 ID：存储导入任务的唯一标识（如
task_1234567890abcdef），用于后续查询任务结果。
3. 示例场景
将本地 Markdown 文档导入飞书云文档：
- 飞书访问凭证：选择已配置的凭证。
- 文件路径：填写
C:\notes\产品说明.md（或点击「选择文件」选取该文件）。 - 上传位置 Token：填写目标文件夹的
token（如fldcn1234567890abcdef）。 - 任务 ID：设置为
import_task_id。 - 执行指令后，
import_task_id存储任务 ID，后续通过【查询导入任务结果】获取最终状态。
4. 注意事项
常见问题
| 错误类型 | 可能原因 | 解决方案 |
|---|---|---|
| 文件不存在或无权限 | 填写的文件路径错误，或 RPA 机器人无文件读取权限 | 核对文件路径准确性，确保机器人对目标文件有读权限。 |
| 文件格式不支持 | 上传的文件不在支持的格式列表中 | 仅上传 Word、TXT、Markdown、HTML 格式的文件。 |
| 上传位置 Token 无效 | 目标文件夹 token 不存在或已被删除 | 重新获取目标文件夹的有效 token。 |
| 权限不足 | 飞书应用未开通云文档上传 / 导入权限 | 参考飞书权限配置文档，为应用添加对应权限。 |
| 网络异常 | 网络波动导致文件上传或任务创建失败 | 检查网络连接，并重试指令。 |