极奇策RPA技术教程:字典大小 (NodeDictSize) - 自动化开发与配置详细指南

字典大小
📖 节点概述
计算字典中键值对的数量(即字典的长度)。输入支持字典对象、JSON 字符串、Python 字典字面量、URL Query 字符串或简易键值对格式(多行/逗号分隔)。输出为整数。该节点为纯数据节点,无执行端口。
💡 使用场景:
- 数据完整性检查:验证字典是否包含预期的字段数量。
- 空字典判断:判断字典是否为空(长度为 0)。
- 日志/统计:记录字典中配置项的数量,用于审计或调试。
- 条件分支:根据字典大小决定后续处理逻辑(如小字典直接处理,大字典分批处理)。
- 循环控制:在遍历前获取字典大小,用于进度计算或循环次数。
🎮 实战连线指南:如何正确使用它?
节点有一个输入端口 字典 和一个输出端口 键数量。
场景案例:获取用户信息字典的键数量
准备字典:在“字典”文本框中输入 JSON:
{"name": "李四", "age": 30, "email": "lisi@example.com"}或从上游连线传入字典对象。
获取结果:
键数量输出3。后续使用:将数值用于条件判断(如是否为空,或是否达到预期数量)。
多行简易格式示例:
- 输入:
name: 王五 age: 25 - 输出:
2
空字典示例:
- 输入:
{}或空字符串 → 输出0
⚙️ 引脚与参数说明
📥 输入引脚
| 引脚名称 | 数据类型 | 说明 |
|---|---|---|
| 字典 | STRING / DICT | 待计算大小的字典。支持字典对象、JSON 字符串、Python 字典字面量、URL Query 字符串或简易键值对格式。 |
⚙️ 控件参数
| 控件名称 | 类型 | 说明 |
|---|---|---|
| 字典 | 多行文本框 | 手动输入字典内容(支持多种格式)。连线时优先使用连线值。 |
📤 输出引脚
| 引脚名称 | 数据类型 | 说明 |
|---|---|---|
| 键数量 | INT | 字典中键值对的总数(非负整数)。如果输入无法解析为字典,返回0。 |
🔧 行为说明
- 节点内部使用与【创建字典】相同的智能解析器,支持:
- 字典对象(直接透传)
- JSON 字符串(如
{"a":1}) - Python 字典字面量(如
{'a':1}) - URL Query 字符串(如
a=1&b=2) - 多行或逗号分隔的
key:value/key=value
- 解析得到的字典,返回其键的数量(
len(dict))。 - 如果解析失败(例如输入无效字符串),返回
0。
⚠️ 注意事项
- 只计算顶层键:嵌套字典中的子字典内部的键不会计入总数。
- 空字符串或无效输入:返回
0,不会抛出错误。 - 大小写敏感:键名不经过归一化,每个不同的键名都独立计数。
- 性能:
len(dict)操作时间复杂度 O(1)。
💎 小贴士:
- 若要判断字典是否为空,可以直接检查
键数量 == 0。- 结合【条件判断】节点,可以根据字典大小自动选择不同的处理路径。
- 该节点是纯数据节点,无需执行信号,可在数据流中随时使用。
这篇文档对您有帮助吗?
您的反馈将帮助我们持续优化文档内容

