变量与数据

本页承接基础术语与变量类型，用于查阅变量的详细规则和进阶用法。

常用系统变量

系统变量由 RPA Plus 在每次运行时自动提供，不需要手动创建：

变量	内容	示例
task_id	当前任务 ID。	task_10001
task_name	当前任务名称。	每日商品检查
serial_number	当前浏览器环境编号。	1001
browser_name	当前浏览器环境名称。	店铺 A
env_id	当前浏览器环境 ID。	env_abc123
env_remark	当前浏览器环境备注。	华东区测试账号
account_name	环境中主要账号的用户名。	demo@example.com
account_password	环境中主要账号的密码。	******
cookies	当前环境的 Cookie 内容。	一段较长的 Cookie 文本

密码和 Cookie 可能包含登录凭据，不要把它们写入调试日志、截图、公开文件或分享给无关人员。

类型详解

字符串

字符串适合保存网址、关键词、用户名、文件名等较短的单行内容。即使内容全部是数字，只要不参与计算，也可以使用字符串。

例如，环境编号 0012 应使用字符串。如果使用数字，开头的两个 0 可能失去原本的含义。

数字

数字适合保存循环次数、数量、页码、金额或等待时长等需要计算、比较大小的值。填写数字时不要加引号或单位。

正确：3
错误："3"
错误：3次

布尔

布尔类型只有两个值：

• true：是、开启、满足条件。
• false：否、关闭、不满足条件。

创建布尔变量时，界面会显示开关，不需要手动输入英文。

数组

数组用于保存一组按顺序排列的数据，例如多个网址、账号或关键词。可以配合 For 循环数据节点逐个处理。

一个网址数组可以这样填写：

["https://example.com/a", "https://example.com/b"]

填写时请注意：

• 整组内容使用英文方括号 [] 包住。
• 每段文字使用英文双引号 "" 包住。
• 多项内容之间使用英文逗号 , 分隔。
• 最后一项后面不要再加逗号。

数字数组中的数字不需要双引号，例如：

[1, 2, 3]

对象

对象用于把同一条数据的多个字段放在一起。可以把它理解为一张只有一行的表格，每个字段都有名称和对应的值。

例如，一个账号对象可以这样填写：

{"username":"demo@example.com","retry_count":3,"enabled":true}

填写时请注意：

• 整组内容使用英文花括号 {} 包住。
• 字段名和文字值使用英文双引号 "" 包住。
• 字段名和值之间使用英文冒号 :。
• 多个字段之间使用英文逗号 , 分隔。
• 不要使用中文引号、中文逗号或中文冒号。

数组和对象的这种书写方式叫作 JSON 格式。格式不正确时，配置面板会提示错误，流程无法按预期读取数据。

文本、文件和文件夹

• 文本：保存较长内容或多行内容，例如消息模板、文章正文和 Cookie。
• 文件：保存一个本地文件的完整路径，使用文件按钮选择文件。
• 文件夹：保存一个本地目录的完整路径，使用文件夹按钮选择目录。

文件和文件夹变量只保存路径，不会复制文件内容。换到另一台电脑运行流程时，要确认目标路径存在且有权限。

元素对象和未知类型

• 元素对象：由获取焦点元素、获取元素数据等节点产生，代表网页中的某个元素，不是普通文字。
• 未知：节点运行前无法确定结果的具体类型，实际内容会在节点执行后产生。

遇到这两种类型时，确认变量来自哪个节点，并在它的下游节点中选择使用即可，不需要手动修改类型。

变量命名规则

变量名必须满足以下规则：

• 不能为空。
• 只使用英文字母、数字和下划线 _。
• 不能以数字开头。
• 同一个变量列表中不能出现重复名称。
• 区分大小写，建议统一使用小写字母和下划线。

推荐	不推荐	原因
target_url	目标网址	包含中文
account_1	1_account	以数字开头
product_title	product-title	包含短横线
retry_count	retry count	包含空格

建议让名字直接说明用途，例如使用 product_title，不要只写 data1。

变量的作用范围

• 系统变量和开始节点变量：整条流程都可以使用。
• 中间节点产生的变量：只能在该节点之后、与它连接的下游节点中使用。
• 不同分支之间：只有执行路径能够到达当前节点的变量才会出现在选择器中。

流程后面再次创建同名变量时，新值会覆盖前面的旧值。为避免看错数据，建议为不同用途使用不同的变量名。

组合使用变量

变量可以和固定文字组合。例如，keyword 的值为 蓝牙耳机 时，下面的内容会生成完整的搜索网址：

https://example.com/search?keyword=${keyword}

同一个输入框中也可以插入多个变量，例如：

${serial_number}_${task_id}

运行时可能得到 1001_task_10001，便于区分不同环境和任务生成的文件。

完整示例

逐个访问多个网址

1. 在开始流程中创建数组变量 product_urls。
2. 默认值填写：

["https://example.com/product/1", "https://example.com/product/2"]

3. 添加 For 循环数据节点，数据选择 product_urls。
4. 将循环对象保存到变量 current_url。
5. 在循环内的访问网站节点中填写 ${current_url}。

从对象中取出字段

1. 创建对象变量 account_info，默认值填写：

{"username":"demo@example.com","retry_count":3}

2. 添加提取字段节点，数据选择 account_info。
3. 提取键填写 username，结果保存到 current_username。
4. 后续输入账号的节点引用 ${current_username}。

需要读取重试次数时，将提取键改为 retry_count 即可。

常见问题

变量出现在列表中，但当前节点选不到

检查产生变量的节点是否位于当前节点之前，并且两者是否通过连线处于同一条可执行路径上。下游节点产生的变量不能提前使用。

数组或对象提示格式错误

检查括号、双引号、逗号和冒号是否为英文符号，并确认最后一项后面没有多余逗号。可以先复制本页示例，再替换其中的内容。

引用变量后仍显示 ${变量名}

编辑流程时显示 ${变量名} 是正常现象。它是占位标记，只有流程运行到该节点时才会替换为变量的实际值。

变量的值是数字，应该选字符串还是数字

需要计算、循环或比较大小时选数字；只是作为编号、手机号或文本显示时选字符串。例如循环次数 3 选数字，环境编号 0012 选字符串。