遍历用户界面元素

UiPath.UIAutomationNext.Activities.NForEachUiElement

描述

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

无法在使用应用程序/浏览器活动内添加此活动。

To use this activity outside a Use Application/Browser activity, you need to provide an Input element.

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

项目兼容性

Windows - 旧版 | 窗口

Windows - 旧版 Windows 配置

设计器面板

• 单击 “在应用程序/浏览器 中指定”，以使用“ 遍历用户界面元素 ”向导指定要用作目标的用户界面元素。 您可以 在此处详细了解如何使用此活动及其向导。

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

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

  要筛选使用选择提取的项目，请选择“ 配置筛选器”。

属性面板

常见

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

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

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

• 显示名称- 设计器面板中活动的显示名称指定目标时，系统会自动生成显示名称。

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

输入

• “目标 ” - 目标元素。 必须设置目标元素。 在屏幕上指定之前，此字段设置为 (null)。 指定目标后，将显示与指定元素相关的所有属性。
  • CV 控件类型 - 指示使用 Computer Vision 识别的控件类型。
  • 计算机视觉文本 - 表示使用 Computer Vision 识别的文本。
  • “模糊选取器 ” - 模糊选取器的参数。
  • 原生文本 - 用于标识用户界面元素的文本。
  • 响应式网站 - 启用响应式网站布局。
  • “严格选取器 ” - 为用户界面元素生成的“严格选取器”。
  • 定位方法 - 要用于标识元素的选取器类型。 可以将此属性设置为下拉菜单中的任意组合：
    • 无
    • 精确选取器
    • 模糊选取器
    • 图像
    • 原生文本
    • Computer Vision
  • 可见性检查 - 检查用户界面元素是否可见。 您可以从下拉菜单中选择以下三个选项之一：
    • “无 ”- 不检查可见性。
    • 交互式（用于模糊选取器） - 默认选项。 检查元素是否可能可见，忽略页面滚动和其他应用程序的阻碍或应用程序已最小化。 当尝试确保您没有以 DOM 中存在但隐藏的不可见元素为目标时，此检查非常有用。
    • 完全可见 - 检查用户界面元素是否可见。
  • 等待页面加载 - 在执行 Actions之前，等待应用程序准备好接受输入。 您可以从下拉菜单中选择以下三个选项之一：
    • 无- 不等待目标变为就绪状态。
    • “交互式”– 等待直到加载了应用程序的一部分。
    • “完整”– 等待整个应用程序被加载。
  • 窗口选取器 (应用程序实例) - 用于应用程序窗口的选取器。 仅在窗口附加模式设置为“应用程序实例”时适用。
• “目标（下一个按钮） ” - 要对其执行 Actions 的下一个用户界面元素。 在屏幕上指示要使用的目标之前，请将此字段设置为 (null)。 指定目标后，将显示与指定元素相关的所有属性。 除了 “ 单击偏移量”外，该字段的子属性与“ 目标 ”属性的特定子属性相同。
  • 单击偏移量 - 指定单击活动的偏移量，可以进一步配置该偏移量。
    • 锚点 - 描述光标相对于“ 偏移 X ”和“ 偏移 Y ”属性的偏移量的起点。 提供以下选项： “左上”、 “右上”、“ 左下”、“ 右下”和“ 居中”。 默认情况下，选择“ 居中 ”。
    • X 轴偏移 - 光标位置根据“ 锚点 ”字段中所选选项而进行的水平位移。 此字段仅支持 Int32 变量。
    • “Y 偏移 ” - 光标位置根据“ 锚点 ” 字段中所选选项而进行的垂直位移。 此字段仅支持 Int32 变量。

输入/输出元素

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

其他

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

选项

• “页面之间的延迟 ” - 如果数据跨越多个页面，则在加载下一页之前等待的时间 (以秒为单位)。

• 输入模式 - 选择机器人与目标应用程序交互时应使用的方法：

  • 与应用程序/浏览器 相同 - 使用与 使用应用程序/浏览器 活动相同的输入模式。

    这是默认选择。

  • “硬件事件 ” - 使用硬件驱动程序执行操作。 这是最慢的方法，无法在后台运行，但与所有桌面应用程序兼容。

    如果您更改以下任何属性的默认设置“ 单击类型”、“ 鼠标按钮”或 “修饰键”，则默认情况下会选择此选项。

  • 模拟 - 使用辅助功能 API 进行模拟。 推荐用于浏览器、基于 Java 的应用程序、SAP。 通常比 硬件事件更可靠。 在单个 Actions中发送所有文本。 即使目标应用程序不在焦点中，也适用。 请测试您的目标应用程序用户界面元素是否支持此功能。

  • Chromium API - 使用调试器 API 执行操作。仅适用于 Chromium 元素。一次性发送所有文本。即使目标应用程序不在焦点中，也适用。有关更多详细信息，请查看此页面。

  • 窗口消息 - 使用 Win32 消息进行模拟。 推荐用于桌面应用程序。 通常比 硬件事件更可靠。 在单个 Actions中发送所有文本。 即使目标应用程序不在焦点中，也适用。 请测试您的目标应用程序用户界面元素是否支持此功能。

• 将提取限制为 - 提取数据时要应用的限制类型。 提供以下选项：
  • 最大用户界面元素 - 指定要提取的用户界面元素的最大数量。 默认值为 1000。
  • 无限制 - 无限制地提取所有可以找到的元素。
  • 最大页数 - 从跨多个页面的表格中提取数据时，指定要从中提取用户界面元素的最大页数。
• “项目数” - 要提取的最大结果数。 如果值为 0，则提取所有已识别的项目。