极奇策RPA技术教程:变量设置 (NodeSetter) - 自动化开发与配置详细指南

变量设置 (Setter)
📖 节点概述
变量声明与赋值节点。在工作流中创建或覆盖一个变量,并指定它的作用域(局部/全局)和数据类型。你可以直接在控件中输入初始值,也可以通过连线动态传入。一次执行即可完成变量的设定,后续可通过【变量获取】节点读取该变量。
💡 使用场景:
- 初始化计数器:在循环开始前将变量置为 0。
- 存储用户输入:将用户填写的表单内容保存为变量,供后续节点使用。
- 保存中间计算结果:将数学运算或字符串拼接的结果暂存起来。
- 状态标记:设置一个布尔变量表示“是否已登录”,控制整个流程的分支走向。
- 配置参数集中管理:在流程起始处一次性声明多个全局变量,作为后续操作的配置项。
🎮 实战连线指南:如何正确使用它?
该节点串联在执行流中,触发后立即完成变量赋值。它同时提供动态输入端口,你可以选择连线传入数据,或直接在控件中填入固定值。
场景案例:开始时初始化一个分数变量 Score = 0,并随后进入循环累加
- 放置节点:在流程起始位置拖入【变量设置】节点。
- 配置基本信息:
VarName:输入Score。VarScope:保持局部 (Local)(仅在当前工作流内可用)。VarType:选择整数 (Integer),节点下方会自动出现一个整数输入框。
- 提供初始值:在整数输入框中填入
0,或通过连线从其他节点获取初值。 - 串联执行:将起始事件(如“开始按钮”)的
Exec连接到【变量设置】的Exec,其Exec输出再连向后续循环或处理节点。
类型切换:当你改变
VarType时,下方的输入控件和动态端口会自动切换为对应类型(字符串、整数、浮点数、JSON列表/字典等),已填入的值不会丢失。
⚙️ 引脚与参数说明
📥 输入引脚
| 引脚名称 | 数据类型 | 说明 |
|---|---|---|
| Exec | EXEC | 控制流入口,激活后执行变量赋值。 |
| (动态端口) | 根据 VarType 变化 | 与当前选择的类型同名,例如整数 (Integer)、字符串 (String)、列表 (List) 等。连线传入的数据优先于控件输入值。 |
⚙️ 控件参数
| 控件名称 | 类型 | 说明 |
|---|---|---|
| VarName | 文本输入 | 变量名称,支持中文、英文、数字和下划线。建议使用有意义的名字,如user_count。 |
| VarScope | 下拉选择 | 局部 (Local):仅在当前工作流中可用,运行结束后销毁。<br>全局 (Global):跨工作流共享,需谨慎使用以避免命名冲突。 |
| VarType | 下拉选择 | 变量数据类型,可选自动推断或手动指定。选择后下方的输入控件和动态端口会相应变化。 |
| (类型同名控件) | 文本/数值/JSON | 对应 VarType 的输入控件,用于填写初始值或静态值。若对应动态端口有连线,则控件值被覆盖。 |
📤 输出引脚
| 引脚名称 | 数据类型 | 说明 |
|---|---|---|
| Exec | EXEC | 赋值完成后触发,用于串联后续节点。 |
💎 小贴士:
- 变量名在当前作用域内必须唯一,重复设置相同名称的变量会覆盖旧值。
- 若选择
自动推断 (Auto),引擎会根据你传入的数据自动判断类型,适合快速原型开发;正式流程建议明确指定类型以避免意外。- 对于
列表和字典类型,需在控件中输入合法的 JSON 格式,如[1, 2, 3]或{"key": "value"}。- 通过连线传入数据时,请确保数据类型与
VarType匹配,否则可能导致类型转换异常或运行时错误。
这篇文档对您有帮助吗?
您的反馈将帮助我们持续优化文档内容

