数据获取与存储节点

数据获取节点从页面、浏览器、本地文件或网络请求中读取数据，并把结果保存到流程变量；存储节点把流程数据写入本地文件。本页包含全部 17 个数据获取节点。

数据获取与存储节点

获取数据

获取 URL

读取当前标签页地址，并将结果保存到输出变量。

获取 URL 配置

编号	配置	说明
1	提取类型	选择完整地址、根地址或查询参数
2	参数名	提取类型为查询参数时，填写要读取的参数名
3	保存至	填写合法的输出变量名

例如，当前地址为：

https://example.com/products?page=2&category=books

读取完整地址会得到整个 URL；读取根地址会得到 https://example.com；查询参数填写 page 会得到 2。

获取剪贴板内容

读取当前系统剪贴板中的文本，并保存到变量。

获取剪贴板内容配置

编号	配置	说明
1	保存至	填写合法的输出变量名

读取系统剪贴板依赖桌面客户端及操作系统权限。流程运行前应确认剪贴板内容来源可信，避免把账号、密码等敏感信息写入后续日志或文件。

获取元素数据

定位页面元素并提取指定内容。DOM、iframe 或子元素等元素类结果可以供下游点击、输入、悬停等节点继续使用。

获取元素数据配置

编号	配置	说明
1	元素来源	使用元素选择器，或切换为上游保存的元素对象
2	选择器类型	选择 Selector、XPath 或文本
3	选择器	填写目标元素定位值，支持变量
4	元素顺序	选择固定值或区间随机，并填写对应序号范围
5	提取类型	选择文字、DOM 对象、iframe、源码、属性或子元素；属性和子元素还需填写提取目标
6	保存至	填写合法的输出变量名

提取属性时填写实际属性名，例如 href、src 或 data-id。提取子元素时填写子元素定位规则。

当前焦点元素

获取页面中当前获得焦点的元素，并保存为元素对象变量。

当前焦点元素配置

编号	配置	说明
1	保存至	填写合法的元素对象变量名

例如：

元素聚焦 → 当前焦点元素 → 输入内容

最后一个节点可以选择已保存的焦点元素对象，无需重新填写选择器。

使用存储的焦点元素对象

查询 Excel 数据

按条件查询本地 Excel 工作表，并将结果保存到一个流程变量。第一行为表头，后续每行是一条记录；表头可以使用中文或自定义业务名称，空行不会作为有效记录。

查询 Excel 数据配置

编号	配置	说明
1	Excel 文件路径	选择本地 Excel 文件或填写流程变量路径
2	工作表名称（可选）	填写底部工作表标签名称；留空使用文件保存时选中的工作表
3	查询范围	选择全部、单条或多条；全部返回所有非空行，单条返回一个对象，多条返回数组
4	筛选条件	每行填写查询列、运算和值；条件为空时不筛选，支持变量
5	条件关系	多条条件选择“全部满足”或“任一满足”
6	随机查询	在命中记录中随机排序；“全部”范围不显示此项
7	最多返回数量	仅多条查询生效，0 表示不限制
8	查询结果保存到	填写保存结果的流程变量名
9	查询后标记为占用	开启后给返回行写入占用状态、系统生成的编号和当前时间；关闭时只读取数据

支持的运算包括等于、不等于、包含、不包含、大于、大于等于、小于、小于等于、为空、不为空、属于和不属于。选择“为空”或“不为空”时不需要填写查询值。开启占用后，多个流程必须使用相同文件、工作表、占用列、状态值和有效时长，才会跳过尚未过期的占用行；处理完成后可用 编辑 Excel 数据 清空占用状态。

保存数据到文件

存到文件

把文本模板写入本地文本文件，当前保存目录使用系统默认下载目录。

保存文本配置

编号	配置	说明
1	文件名	填写支持变量的文件名；留空时使用默认名称，执行器自动补充 .txt
2	保存模板	填写固定文字和变量组成的文本内容

任务：${task_name}
环境：${browser_name}
结果：${product_title}

存到 Excel

将选定变量作为列写入本地 Excel 文件，当前保存目录使用系统默认下载目录。

保存 Excel 配置

编号	配置	说明
1	文件名	填写支持变量的文件名；留空时使用默认名称，执行器自动补充 .xlsx
2	选择保存列	从当前可用的系统变量和流程变量中选择要写入的列

存到文件 和 存到 Excel 未填写文件名时，同一次运行会使用统一的基础名称：

taskId_秒级时间戳

本地文件依赖

写入文本和 Excel 依赖中屹浏览器桌面客户端及本地文件权限。任务迁移到其他电脑后，应确认默认下载目录可写。

编辑 Excel 数据

向本地 Excel 工作表写入新行或编辑已有行，只更新配置中指定的列。写入值支持流程变量，写入列不存在时会自动增加，其他列的内容会保留。

编辑 Excel 数据配置

编号	配置	说明
1	Excel 文件路径	选择本地 Excel 文件或填写流程变量路径
2	工作表名称（可选）	填写底部工作表标签名称；留空使用文件保存时选中的工作表
3	写入方式	选择新增一行、修改匹配行或有则修改无则新增
4	匹配条件	修改或有则修改无则新增时必填；多条条件必须全部满足，使用与查询 Excel 相同的条件运算
5	多行匹配处理	选择修改第一条、修改全部命中行或匹配多行时报错
6	写入字段	每行填写写入列名和写入值，可一次写入多个字段
7	处理行数保存到	可选填写变量名，保存本次新增或修改的行数

写入新记录

写入方式选择 新增一行，在“写入字段”中填写新记录的列名和值。节点直接在工作表末尾追加一条记录；没有表头时按写入列创建表头。此模式不显示匹配条件和多行匹配处理，一次可填写多个字段，但只新增一条记录。

编辑已有记录

写入方式选择 修改匹配行，先用“匹配条件”定位记录，再用“写入字段”指定要修改的列和值。只更新指定列，未配置的列保留原值；将某列的写入值留空可以清空该列的内容。

没有命中时不新增记录，处理行数为 0。命中多行时，按“多行匹配处理”选择 修改第一条、修改全部命中行 或 匹配多行时报错。需要批量编辑时选择 修改全部命中行。

有则编辑，无则写入

写入方式选择 有则修改无则新增，同时配置匹配条件和写入字段。命中时按上述编辑规则修改记录；未命中时按写入字段追加一条记录。因此，新记录所需的列和值也应填写在“写入字段”中。

下载文件

根据文件 URL 下载内容到指定的本地保存目录。

下载文件配置

编号	配置	说明
1	文件 URL	填写完整文件地址，支持变量；静态值会在配置时校验 URL 格式
2	保存目录	选择任务执行电脑上存在且可写的本地目录，支持变量

导入本地素材

导入 Excel 素材

读取本地 Excel，根据首行表头生成流程变量，并可把完整表格保存为数组变量。

导入 Excel 素材配置

编号	配置	说明
1	选择 Excel	选择本地文件或填写变量路径；只有静态路径会在设计阶段读取表头
2	缺少环境序号时跳过	找不到 serial_number 对应行时，不随机取值并直接跳过
3	表头变量	显示根据 Excel 首行生成的只读变量；路径有效且解析成功后才显示
4	保存至	填写保存完整表格数组的变量名

Excel 首行的每个表头都必须能转换为合法且不重复的变量名。建议直接使用小写英文和下划线，例如 username、target_url 和 keyword。

节点可以使用系统变量 serial_number，让不同浏览器环境读取 Excel 中对应的数据行。完整表格数组可以配合 For 循环数据 逐行处理。

Excel 素材表头和数据行

导入 txt

读取本地文本文件，并把全部内容保存到变量。

导入 txt 配置

编号	配置	说明
1	选择文件	选择本地文本文件，支持变量路径
2	保存至	填写合法的输出变量名

文件路径只在某一台电脑存在时，流程迁移后需要重新选择文件。

身份验证器码

根据密钥生成身份验证器验证码，并保存到变量。

身份验证器码配置

编号	配置	说明
1	密钥	填写身份验证器密钥，支持变量
2	保存至	填写保存验证码的输出变量名

密钥属于敏感凭据。不要写入节点备注、截图、调试说明或公开分享内容，并限制流程和运行电脑的访问权限。

监听页面请求

监听请求触发

监听与目标 URL 匹配的请求，并提取请求内容。

监听请求触发配置

编号	配置	说明
1	请求 URL	填写要监听的目标 URL，支持变量
2	提取内容	选择完整 URL、请求头、GET 参数或 POST 数据
3	字段名	提取请求头或 GET 参数时，填写具体字段名
4	保存至	填写合法的输出变量名

先配置监听，再执行会触发请求的页面操作。匹配规则应足够稳定且能识别目标接口，避免同时匹配大量无关请求。

监听请求结果

监听与目标 URL 匹配的响应结果，并保存到变量。

监听请求结果配置

编号	配置	说明
1	请求 URL	填写要监听的目标 URL，支持变量
2	保存至	填写合法的响应结果变量名

响应结果可以继续交给转为 JSON 对象或字段提取节点处理。

停止页面监听

结束当前页面的请求监听，不需要业务配置。不再需要监听时及时停止，避免后续页面操作继续产生无关数据。

请求监听流程

Cookie 节点

获取页面 Cookie

读取当前页面 Cookie 并保存到变量。

获取页面 Cookie 配置

编号	配置	说明
1	保存至	填写合法的 Cookie 输出变量名

清除页面 Cookie

清除当前页面 Cookie，不需要业务配置。清除后页面可能退出登录或改变业务状态，建议放在流程末尾，并先在测试环境验证影响。

保护敏感数据

Cookie、身份验证器密钥、账号和请求头可能包含认证信息。不要把真实内容存入公开文件、截图、分享文案或不受控的日志。

常见问题

输出变量在后续节点中找不到

确认已经填写合法的输出变量名，并且使用变量的节点位于数据获取节点的下游可达路径。分支中的变量不会自动出现在另一条不相交的分支中。

Excel 表头校验失败

检查表头是否为空、包含不能转换的字符，或转换后出现重名。建议把首行改为简短、不重复的小写英文变量名。

保存后找不到文件

存到文件和存到 Excel 默认写入系统下载目录。先在运行日志中查看保存路径。

动态文件路径没有显示 Excel 表头

这是设计阶段的正常行为。只有静态本地 Excel 路径会提前读取表头，变量路径会在运行时解析。

相关内容

• 数据处理节点：解析 JSON、正则提取和字段提取。
• 变量与数据：了解输出变量、数组和对象。
• 流程控制节点：按 Excel 全表数组或页面元素循环。
• 运行记录：从正式任务日志定位输出文件。