查找元素

UiPath.UIAutomationNext.Activities.NFindElements

描述

根据指定的作用域和筛选条件，检索用户界面元素集合，可以是子元素、后代元素或顶层元素。

此活动可与对象存储库兼容。

项目兼容性

Windows | 跨平台

配置

• 模式- 用于设置集合中用户界面元素的查找模式。可选择以下选项：
  • 查找子元素- 从指定的目标/元素/作用域中查找与筛选条件匹配的第一级元素。
  • 查找后代- 从指定的目标/元素/作用域中查找与筛选条件匹配的所有元素。
  • 查找顶层- 从所有打开的应用程序中查找与筛选条件匹配的所有元素。

• 筛选- XML 字符串，指定集合中的所有元素应符合的条件。筛选器是选取器。该活动搜索目标元素与选取器匹配的所有子元素。

  例如，使用<webctrl tag='UL' />将启动对特定网页中未排序列表元素的搜索。
  注意： 如果您使用的筛选条件遗漏了所有可能的元素，则返回一个空的元素列表。

属性面板

选项

• Healing Agent 模式- 根据流程或作业级别的监管或 Orchestrator 设置，配置此活动的 Healing Agent 行为。
  • 已禁用- 关闭此活动的 Healing Agent。
  • 继承作业设置- 在流程或作业级别应用在监管或 Orchestrator 中定义的设置。
  • “仅建议” - 允许 Healing Agent 提供有关如何修复正在运行的作业中的用户界面自动化问题的建议，但前提是监管或 Orchestrator 设置允许。
  • 与应用程序/浏览器相同- 从父级“使用应用程序/浏览器”活动继承配置。

• “出错时继续” - 指定在活动引发错误时是否应继续自动化操作。 此字段仅支持 Boolean 值（True、 False）。 默认值为 False。 因此，如果该字段为空且活动引发错误，系统将停止执行项目。 如果该值设置为 True，则无论出现何种错误，系统都将继续执行项目。

计时

• “在此之前延迟”- 上一个活动完成与此活动开始执行任何操作之间的延迟（以秒为单位）。默认值为 0.2 秒。在活动之间添加延迟可确保一个活动有足够的时间完成，然后再开始下一个活动。

• “超时”- 指定最长等待时间（以秒为单位），如果超出该时间后活动并未执行，系统便会抛出错误。 默认值为 30 秒。

输入/输出

• 输入元素 - 用于执行活动的用户界面元素，存储在 UIElement 对象中。 此字段仅支持 UIElement 对象。 可以从其他用户界面自动化活动的 输出元素 属性字段获取此对象。
• 输出元素 - 输出目标用户界面元素并将其存储在 UIElement 对象中，该对象可进一步用于通过其他活动定位同一元素。

输出

子项- 根据筛选器和作用域设置找到的所有用户界面子项。该字段仅支持IEnumerable<UiElement>变量。