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

判断是否为字典
📖 节点概述
字典类型检测器,用于判断一个值的数据类型是否为字典(dict)。它严格检查传入数据是否属于键值对结构,帮助流程在操作字典前确认数据类型,避免因类型不符导致运行错误。支持纯数据模式和执行流分支模式。
💡 使用场景:
- API 响应结构验证:判断接口返回的是单个对象(字典)还是对象列表,从而决定走解析还是遍历流程。
- 配置数据读取:从外部文件或数据库加载数据后,先确认是否为字典格式,再提取具体键值。
- 变量类型检查:当一个变量可能在字符串和字典之间切换时,提前判断类型,适配不同的处理逻辑。
- 数据合并保护:在使用【字典合并】或【设置字典键值】等节点前,确保目标确实为字典。
🎮 实战连线指南:如何正确使用它?
节点的 值 输入接受任意类型,内部使用 isinstance(val, dict) 进行精确判断。只有真正的字典才能通过“是字典”分支。
场景案例:处理 API 返回的用户信息,判断是单个用户还是用户列表
- 获取数据:使用【HTTP 请求】节点获取用户数据,返回结果存入变量
response。 - 连接判断:将
response的输出连接到【判断是否为字典】的值输入。 - 选择模式:
- 数据模式(默认):将
结果连接到【条件分支】的条件引脚。True→ 作为单个用户对象解析;False→ 作为列表遍历。 - 执行模式:勾选“作为执行节点”,将请求完成的
Exec连入该节点,是字典出口连接【获取字典键值】节点提取字段,不是字典出口连接【for列表遍历】节点批量处理。
- 数据模式(默认):将
- 执行:根据实际返回的数据类型,自动走上合适的处理路径。
⚙️ 引脚与参数说明
⚙️ 控件参数
| 控件名称 | 类型 | 说明 |
|---|---|---|
| 作为执行节点 | 开关 | 关闭时为数据模式,输出布尔结果;开启后切换为执行模式,出现 Exec 输入和两个执行分支。 |
📥 输入引脚
| 引脚名称 | 数据类型 | 说明 |
|---|---|---|
| Exec | EXEC | (执行模式专有)控制流入口。 |
| 值 | ANY | 待检测的数据,可以是任何类型。 |
📤 输出引脚
| 引脚名称 | 数据类型 | 说明 |
|---|---|---|
| 结果 | BOOL | (数据模式)如果值 是字典类型,返回 True,否则 False。 |
| 是字典 | EXEC | (执行模式)值为字典时触发此分支。 |
| 不是字典 | EXEC | (执行模式)值不为字典时触发此分支。 |
💎 小贴士:
- 该节点使用类型严格匹配,即便数据是类似字典的 JSON 字符串(如
"{\"key\":\"value\"}"),也会被判定为“不是字典”。如需先解析 JSON,可结合【字符串转字典】节点。- 与【判断是否为列表】类似,该节点只检测
dict类型,不会将其他映射类型误判为字典。- 执行模式下,
是字典和不是字典两个分支互斥,每次执行只会触发其中一个。
这篇文档对您有帮助吗?
您的反馈将帮助我们持续优化文档内容

