极奇策RPA技术教程:判断是否为列表 (NodeIsList) - 自动化开发与配置详细指南

判断是否为列表
📖 节点概述
列表类型检测器,用于判断一个值的数据类型是否为列表(list)。它会严格检查传入的数据是否属于 Python 的列表类型,不会将字符串、元组或其他类似结构误判为列表。支持纯数据模式(输出布尔结果)和执行流模式(直接分支路由)。
💡 使用场景:
- 动态数据处理前的类型确认:在调用列表专属操作(如追加、索引查找)前,确认输入确实是列表,避免运行时错误。
- API 返回值校验:外部接口可能返回列表、字典或单一对象,使用此节点判断返回结果是否为列表,以便选择不同的处理分支。
- 多态变量分流:当一个变量可能存储多种类型(如有时是字符串,有时是列表)时,通过此节点让流程自动走合适的处理路径。
- 数据聚合:判断用户输入是否为列表,如果是则直接遍历,如果不是则先包装成单元素列表再处理。
🎮 实战连线指南:如何正确使用它?
节点的 值 输入接受任意类型,内部使用 isinstance(val, list) 进行精确判断。只有真正的列表才能通过“是列表”分支,字符串、数字、字典等其他类型都会走“不是列表”分支。
场景案例:处理用户传入的标签数据,判断是单个标签还是多个标签的列表
- 获取输入:通过【变量获取】节点读取用户提交的
tags字段。 - 连接判断:将
tags的输出连接到【判断是否为列表】的值输入。 - 选择模式:
- 数据模式(默认):将
结果连接到【条件分支】的条件引脚。True→ 使用for列表遍历逐个处理标签;False→ 将单个标签包装后处理。 - 执行模式:勾选“作为执行节点”,将表单提交的
Exec连入该节点,是列表出口连接列表遍历逻辑,不是列表出口连接单值处理逻辑。
- 数据模式(默认):将
- 执行:当用户提交了多个标签(列表)时,进入批量处理;只提交一个标签时,进入单独处理。
⚙️ 引脚与参数说明
⚙️ 控件参数
| 控件名称 | 类型 | 说明 |
|---|---|---|
| 作为执行节点 | 开关 | 关闭时为数据模式,输出布尔结果;开启后切换为执行模式,出现 Exec 输入和两个执行分支。 |
📥 输入引脚
| 引脚名称 | 数据类型 | 说明 |
|---|---|---|
| Exec | EXEC | (执行模式专有)控制流入口。 |
| 值 | ANY | 待检测的数据,可以是任何类型。 |
📤 输出引脚
| 引脚名称 | 数据类型 | 说明 |
|---|---|---|
| 结果 | BOOL | (数据模式)如果值 是列表类型,返回 True,否则 False。 |
| 是列表 | EXEC | (执行模式)值为列表时触发此分支。 |
| 不是列表 | EXEC | (执行模式)值不为列表时触发此分支。 |
💎 小贴士:
- 该节点严格区分类型,字符串虽然可以像列表一样用索引访问,但仍会被判定为“不是列表”,不会被误判。
- 如果需要同时兼容列表和元组(tuple),可以组合使用【判断类型】节点,或者通过【转为列表】节点预先统一类型。
- 执行模式下,
是列表和不是列表两个分支互斥,每次执行只会触发其中一个。
这篇文档对您有帮助吗?
您的反馈将帮助我们持续优化文档内容

