极奇策RPA技术教程:列表 (NodeList) - 自动化开发与配置详细指南

列表常量 (List)
📖 节点概述
静态列表生成器,用于在工作流中创建一个固定内容的列表。你可以直接在节点内输入文本(每行一个元素),或者粘贴 JSON 格式的数组(如 ["a","b"])。该节点没有执行端口,仅作为数据源供其他节点通过连线读取。
💡 使用场景:
- 提供固定的遍历对象:为
for列表遍历节点提供要循环处理的文件名、用户名等列表。 - 配置项集合:将多个参数(如域名白名单)硬编码为列表,方便统一管理。
- 测试数据源:在调试阶段,用此节点快速提供一组虚拟数据,无需连接外部系统。
- 合并操作:与
列表合并、列表追加等节点配合,作为基础列表参与动态组合。
🎮 实战连线指南:如何正确使用它?
列表常量 节点只有输出端口,没有输入输出 Exec,不能被串联在执行链上。你只需把它放在画布上,然后用数据线将其 列表数据 引脚连接到需要列表的节点输入端口即可。
场景案例:为列表遍历提供一组固定的文件名,批量处理
输入列表内容:在【列表】节点的文本框中逐行输入文件名:
report_jan.csv report_feb.csv report_mar.csv或者直接输入 JSON 字符串:
["report_jan.csv","report_feb.csv","report_mar.csv"]。连线数据:将【列表】节点的
列表数据输出引脚连接到【for列表遍历】节点的列表数据输入引脚。执行遍历:在【for列表遍历】的
Exec输入处连接开始信号,其循环体内放置文件处理节点(如【读取文件】),当前项会依次输出每个文件名。完成处理:循环结束后的
完成输出可接通知或汇总节点。
自动识别:引擎会先尝试将输入内容解析为 JSON 数组,如果失败则视为纯文本并按行分割,因此你无需关心格式切换,只要确保 JSON 格式正确或每行一个元素即可。
⚙️ 引脚与参数说明
📤 输出引脚
| 引脚名称 | 数据类型 | 说明 |
|---|---|---|
| 列表数据 | LIST | 输出文本框中定义的列表。该引脚为只读,不能作为输入端口使用。 |
⚙️ 控件参数
| 控件名称 | 类型 | 说明 |
|---|---|---|
| 列表数据 | 多行文本输入框 | 输入列表内容,支持两种格式:<br>① 每行一个元素,空行自动忽略;<br>② 标准 JSON 数组格式,例如 [1, 2, "text"]。如果是 JSON,会保留元素的数据类型(如数字、布尔值)。 |
💎 小贴士:
- 需要动态生成列表时请使用其他节点(如
Range 生成器、列表追加),本节点仅用于静态固定列表。- 如果 JSON 解析失败,文本会按行分割,每行作为字符串元素。注意,JSON 格式中的字符串必须用双引号。
- 该节点没有执行端口,修改内容后下游节点会在下次被触发时自动拉取新数据,无需手动刷新。
这篇文档对您有帮助吗?
您的反馈将帮助我们持续优化文档内容

