1. 首页
  2. 文档
  3. 循环相似元素

白皮书下载

实在智能Agent产品白皮书 V.7.3.4.pdf

循环相似元素

发刊日期:
2025/11/26

编辑团队:
实在学院

一、功能说明

组件用于在集合中识别并遍历具有相似特征或属性的元素,以便进行批量处理或优化操作。

二、属性说明

基础属性

目标:首先点击拾取新元素,获取完成后,在元素编辑器中点击“获取相似元素”按钮,如果相似元素获取成功,拾取完会高亮闪烁。

元素操作:对循环项的操作,可选择:获取元素对象、获取元素坐标、获取元素文本内容、获取元素值、获取元素链接地址、获取元素源代码、获取元素属性。

  • 获取元素对象:组件输出的循环项将为一个元素对象。
  • 获取素坐标:组件输出的循环项将为一个元素坐标类型(字典)。
  • 获取元素文本内容:组件输出的循环项将为一个字符串。可以提取如段落、标题、列表项、按钮文本等页面元素的直接可见文本信息,适用于从网页中的相似结构中批量获取文字内容。
  • 获取元素值:获取元素的value属性值,如果没有该属性则返回None,组件输出的循环项将为一个字符串。
  • 获取元素链接地址获取元素的href或src属性值,如果没有该属性则返回None,组件输出的循环项将为一个字符串。
  • 获取元素源代码组件输出的循环项将为一个字符串。用于提取该元素的完整HTML代码,以便进一步分析或处理。例如,在处理一个包含多个产品信息的网页时,可以使用获取元素值来提取每个产品的名称和价格,使用获取元素源代码来分析产品的详细信息布局。
  • 获取元素属性获取指定属性名对应的属性值,如果没有该属性则返回None,组件输出的循环项将为一个字符串。
  • 自动补充完整地址:选择获取元素链接地址时,将会显示该属性。如果链接地址缺少http、https,或地址为相对地址,可勾选该选项补充完整地址。
  • 属性名:选择获取元素属性时,将会显示该属性。需填写元素的一个属性,如果该属性不存在则返回None。

输出当前循环项至:组件用于将当前循环中处理的元素结果动态传输到指定的后续变量和组件,以实现实时的数据流和处理更新。

● 输出当前循环次数:组件用于将当前循环执行的具体次数输出,以便在每次迭代中进行记录、监控或相关处理。

高级属性

 

● 循环方式:支持正序循环和逆序循环 (正序循环组件用于按照元素的自然排列顺序执行循环处理,而逆序循环组件则用于按照元素的逆序排列逐步进行循环处理。)

● 循环开始位置:默认1表示从第一位开始循环,支持负数表示倒数第几位,循环开始位置得大于循环结束位置,否则将返回空列表。例如:一个列表[11,22,33,44,55],循环开始位置为-2,对应第4位。循环结束位置为3,对应第3位,这个时候循环开始位置 > 循环结束位置,循环将会返回一个空列表。

● 循环结束位置:默认-1表示循环至最后一位,支持正数表示正序第几位。

异常处理

异常重试:当流程运行过程中发生异常时,可根据实际需求配置是否启用重试逻辑。

三、使用示例

执行逻辑

获取如图所示相似元素进行循环,输出循环项和循环次数并进行打印。

输出结果

在输出区域打印出如图结果。

四、常见问题

Q:为什么通过该组件找到的相似元素不是我想要的?
A:可能是因为用户选取的两个元素相似性较弱,导致系统判断异常,建议更换选取的元素重新尝试。若仍无法获取所需的相似元素,请反馈给我们的售后伙伴,我们将尽快解决问题。

企业培训
技术支持
加入社群
公众号
实在智能Agent学习群
扫码关注微信公众号