遍历用户界面元素

UiPath.UIAutomationNext.Activities.NForEachUiElement

描述

遍历用户界面元素列表，并对每个元素执行一个或多个 Actions 。

此活动必须添加到“使用应用程序/浏览器”活动中。

如要在“使用应用程序/浏览器”活动之外使用该活动，您需要提供一个“输入”元素。

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

项目兼容性

Windows - Legacy | Windows

Windows - 旧版 Windows 配置

设计器面板

• 单击“在应用程序/浏览器中指明” ，使用 “遍历用户界面元素”向导指定用作目标的用户界面元素。您可以在此处找到有关如何使用此活动及其向导的更多信息。

指定目标后，选择“菜单”按钮访问以下选项：

• “编辑配置” - 打开“遍历用户界面元素”向导以配置目标。
• 配置新目标- 再次指定目标。
• 删除信息性屏幕截图 - 删除目标应用程序或网页的屏幕截图。
• 添加到对象存储库- 将当前用户界面元素添加到库项目中，这样就可以在整个自动化流程中重用该元素。要筛选使用选择提取的项目，请选择“配置筛选器” 。

属性面板

常见

• “出错时继续” - 指定在活动抛出错误时是否应继续自动化操作。此字段仅支持Boolean值（ True ， False ）。默认值为False 。因此，如果该字段为空且活动引发错误，系统将停止执行项目。如果该值设为True ，则无论出现何种错误，系统都将继续执行项目。
• Delay after - Delay (in seconds) between the time this activity is completed and the time the next activity begins any operations. The default value is 0.3 seconds. Adding a delay between activities ensures that one activity has enough time to complete before the next activity begins.
• Delay before - Delay (in seconds) between the time the previous activity is completed and the time this activity begins performing any operations. The default value is 0.2 seconds. Adding a delay between activities ensures that one activity has enough time to complete before the next activity begins.
• 显示名称 -“设计器”面板中活动的显示名称。 指定目标时，系统会自动生成显示名称。
• “超时” - 指定在引发错误之前等待执行活动的时间（以秒为单位）。默认值为 30 秒。

输入

• “目标” - 目标元素。必须设置目标元素。在屏幕上指示之前，此字段设置为(null) 。指定目标后，将显示与指定元素相关的所有属性。

  • CV 控件类型- 表示使用 Computer Vision 识别的控件的类型。
  • CV 文本- 表示使用 Computer Vision 识别的文本。
  • Fuzzy selector - The parameters for the fuzzy selector.
  • 原生文本- 用于标识用户界面元素的文本。
  • 响应式网站- 启用响应式网站布局。
  • 精确选取器- 为用户界面元素生成的精确选取器。
  • 定位方式- 要用于识别元素的选取器类型。从下拉菜单中选择此属性后，可将其设置为任意组合：
    • 无
    • 精确选取器
    • 模糊选取器
    • 图像
    • 原生文本
    • Computer Vision - 要将 Computer Vision 用作定位方法，您需要转到“项目设置” > “Computer Vision” ，并确保设置正确的服务器端点。您可以原样保留此字段，并使用 UiPath Cloud（默认情况下已填写），也可以通过选择特定于服务器区域的任何其他公共端点或您自己的本地部署服务器来输入其他值。将 Computer Vision 用作定位方法的另一种方法是将“使用本地服务器”设置为True 。这意味着 UiPath.ComputerVision.LocalServer 包已安装在项目中。启用“本地服务器”后，服务器值将被覆盖。但是，“本地服务器”在跨平台项目中不可用。
    • 语义选取器- 利用大型语言模型 (LLM) 生成功能性、拟人化的用户界面元素描述。这些描述可靠性极高，既能适应用户界面的变更，又能在传统选取器失效时显着增强自动化弹性。
  • 可见性检查- 检查用户界面元素是否可见。您可以从下拉菜单中选择以下三个选项之一：
    • 无- 不检查可见性。
    • 交互式（用于模糊选取器）- 默认选项。检查元素是否可能可见，忽略页面滚动和其他应用程序的阻碍或者应用程序已最小化的情况。当尝试确保您没有以 DOM 中存在但隐藏的不可见元素为目标时，此检查非常有用。
    • 完全可见
      • 检查用户界面元素是否可见。
  • 等待页面加载- 在执行操作之前，等待应用程序做好接受输入的准备。您可以从下拉菜单中选择以下三个选项之一：
    • “无”- 不等待目标变为就绪状态。
    • “交互式”– 等待直到加载了应用程序的一部分。
    • “完整”– 等待整个应用程序被加载。
  • 窗口选取器（应用程序实例） - 用于应用程序窗口的选取器。仅在窗口附加模式设置为“应用程序实例”时可用。

• 目标（“下一步”按钮） - 要对其执行操作的下一个用户界面元素。在屏幕上指明要使用的目标之前，此字段会设置为(null) 。指定目标后，将显示与指定元素相关的所有属性。除“单击偏移量”外，该字段的子属性与特定于“目标”属性的子属性相同。

  • 单击偏移量- 指定单击活动的偏移量，您可以进一步配置该偏移量。
    • “锚点” - 描述光标从“偏移 X”和“偏移 Y”属性添加的偏移量的起点。提供以下选项：左上、右上、左下、右下和中间。默认情况下，选择“中心” 。
    • 偏移 X - 根据“锚点”字段中选择的选项对光标位置进行的水平位移。此字段仅支持Int32变量。
    • 偏移 Y - 光标位置根据“锚点”字段中选择的选项而进行的垂直位移。此字段仅支持Int32变量。

输入/输出元素

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

其他

• “私有” - 选中后将不再以“Verbose”级别记录变量和参数的值。此字段仅支持Boolean （ True ， False ）值。默认值为False 。

选项

• Delay between pages - The amount of time (in seconds) to wait until the next page is loaded if the data spans multiple pages.
• Input mode - Select which method the Robot should use to interact with the target application:
  • 与应用程序/浏览器相同- 使用与使用应用程序/浏览器活动相同的输入模式。这是默认选择。
  • 硬件事件- 使用硬件驱动程序执行操作。该方法速度最慢，且不能在后台工作，但可兼容所有桌面应用程序。如果您更改以下任何属性的默认设置“点击类型” 、 “鼠标键”或“修饰键”，系统默认会选择此选项。
  • 模拟- 使用辅助功能 API 进行模拟。建议用于浏览器、基于 Java 的应用程序、SAP。通常比“硬件事件”更可靠。在单个操作中发送所有文本。即使目标应用程序不在焦点中，也适用。请测试您的目标应用程序用户界面元素是否支持此方法。
  • Chromium API - 使用调试器 API 执行操作。仅适用于 Chromium 元素。一次性发送所有文本。即使目标应用程序不在焦点中，也适用。有关更多详细信息，请查看此页面。
  • Window 消息- 使用 Win32 消息进行模拟。推荐用于桌面应用程序。通常比“硬件事件”更可靠。在单个操作中发送所有文本。即使目标应用程序不在焦点中，也适用。请测试您的目标应用程序用户界面元素是否支持此方法。
• Limit extraction to - The type of limit you want to apply when extracting data. The following options are available:
  • 最大用户界面元素数- 指定要提取的用户界面元素的最大数量。默认值为 1000。
  • No limit - Extracts all elements that can be found, without any limit.
  • 最大页数- 从跨越多个页面的表格提取数据时，指定要从中提取用户界面元素的最大页数。
• Number of items - The maximum number of results that you want to extract. If the value is 0, all of the identified items are extracted.