一、指令概述
该 RPA 自定义指令用于通过飞书接口,从指定飞书表格中获取所有工作表(sheet 页)的名称信息,生成名称列表,为后续表格操作(如定位特定 sheet 页、批量处理多 sheet 页 )提供基础数据支持。
二、调用参数配置示意
在 RPA 流程设计中,通过 “调用指令” 配置参数执行获取操作,配置界面如下:
参数名称 | 配置示例 | 说明 |
指令 | 获取 sheet 页名称 | 选择需执行的自定义指令名称 |
飞书访问凭证 | 飞书访问凭证(变量) | 用于验证飞书接口访问权限的凭证,通常由登录或权限获取流程生成 |
飞书表格 URL | 飞书表格 URL(变量) | 网页端飞书表格的 Web 链接,指定目标表格位置 |
生成的变量 - 飞书 sheet 页名称列表 | 变量 | 存储指令执行结果(sheet 页名称列表 )的变量,供后续流程调用 |
三、使用示例
(一)参数配置
• 飞书访问凭证:{飞书访问凭证变量}(权限验证凭证 )
• 飞书表格 URL:{飞书表格 URL 变量}(目标表格 Web 地址 )
• 生成的变量 - 飞书 sheet 页名称列表:变量(存储提取的 sheet 页名称集合 )
(二)执行流程
调用指令后,RPA 工具通过飞书接口,利用输入的访问凭证和表格 URL,获取目标表格中所有工作表的名称,整理为列表格式并存储到指定变量中,支持后续流程调用。
四、运行效果
执行成功后,可在运行日志中查看生成的 sheet 页名称列表,示例日志如下:
五、注意事项
1. 权限要求:飞书访问凭证需具备访问目标表格的权限,否则无法获取 sheet 页名称。
2. 参数准确性:飞书表格 URL 需正确指向目标表格,确保接口能定位到有效表格资源。
3. 异常排查:若运行日志无名称列表生成或报错,检查网络连接、凭证有效性、表格 URL 配置是否正确。
六、延伸应用
该指令可作为飞书表格多 sheet 页自动化处理的基础,拓展应用场景:
• sheet 页筛选操作:结合条件判断指令,从名称列表中筛选出目标 sheet 页(如含特定关键词的 sheet ),执行针对性操作。
• 批量处理流程:循环遍历名称列表,对每个 sheet 页执行数据读写、格式调整等操作,实现多 sheet 页自动化处理。