activities
latest
false
重要 :
请注意,此内容已使用机器翻译进行了部分本地化。 新发布内容的本地化可能需要 1-2 周的时间才能完成。
UiPath logo, featuring letters U and I in white

用户界面自动化活动

上次更新日期 2025年11月18日

查看应用程序状态

UiPath.UIAutomationNext.Activities.NCheckState

描述

通过验证元素是否出现在用户界面中,检查应用程序或网页浏览器的状态,如果找到该元素,则可以执行一组活动,如果找不到该元素,则执行另一组活动。

它可以监控整个应用程序的更改,而不仅仅是监控单个用户界面元素。

该活动可在“使用应用程序/浏览器”活动内部和外部使用。

它也可用作“重试作用域”活动的条件。

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

项目兼容性

Windows - 旧版 | Windows | 跨平台

Windows and Cross-platform configuration

  • “在作用域内工作” - 选择呈现要自动化的网页应用程序的浏览器选项卡。
  • 在屏幕上指定目标 - 指定要用作目标的用户界面元素。

    指定目标后,选择加号按钮以访问以下选项:

    • “在屏幕上指定目标”- 再次指定目标。
    • 编辑目标 - 打开选择模式以配置目标。
  • 等待(显示/消失) - 选择要使用哪个事件来确定应用程序或浏览器的状态:
    • 要显示 的元素 - 等待元素出现在用户界面中。 如果选择此选项:
      • 添加该元素出现在“ IfExists” 块中时要执行的活动。
      • 添加元素未出现在“ IfNotExists” 块中时要执行的活动。
    • 要消失的元素 - 等待元素从用户界面中消失。如果选择此选项:
      • 添加元素在“ IfExists” 块中消失时执行的活动。
      • 添加元素在“ IfNotExists” 块中没有消失时要执行的活动。
  • 超时(秒) ”- 执行两个活动块之一之前等待元素出现或消失的时间。 默认值为 5 秒。

属性面板

输入/输出

  • 状态 ” - 此为 True 或 False 值,指明检测到的目标状态。
  • 输入元素 - 用于执行活动的用户界面元素,存储在 UIElement 对象中。 此字段仅支持 UIElement 对象。 可以从其他用户界面自动化活动的 输出元素 属性字段获取此对象。
  • 输出元素 - 输出目标用户界面元素并将其存储在 UIElement 对象中,该对象可进一步用于通过其他活动定位同一元素。

选项

  • Healing Agent 模式- 根据流程或作业级别的监管或 Orchestrator 设置,配置此活动的 Healing Agent 行为。
    • 已禁用- 关闭此活动的 Healing Agent。
    • 继承作业设置- 在流程或作业级别应用在监管或 Orchestrator 中定义的设置。
    • “仅建议” - 允许 Healing Agent 提供有关如何修复正在运行的作业中的用户界面自动化问题的建议,但前提是监管或 Orchestrator 设置允许。
    • 与应用程序/浏览器相同- 从父级“使用应用程序/浏览器”活动继承配置。
目标
  • Expand target properties - Display target and anchor properties. This will hide the other activity properties and display only those related to the target.
  • Collapse target properties - Hide target and anchor properties. This will hide target related properties and display the activity properties.
  • 定位方法 - 要用于标识元素的选取器类型。 可以将此属性设置为下拉菜单中的任意组合:
    • Strict selector - The strict selector generated for the target UI element.
    • Fuzzy selector - The fuzzy selector parameters.
    • Computer Vision - 要将 Computer Vision 用作定位方法,您需要转到“项目设置”>“Computer Vision”,并确保设置正确的服务器端点。您可以原样保留此字段,并使用 UiPath Cloud(默认情况下已填写),也可以通过选择特定于服务器区域的任何其他公共端点或您自己的本地部署服务器来输入其他值。

      Another way of using Computer Vision as a targeting method is to set Use Local Server to True. This implies that the UiPath.ComputerVision.LocalServer package is installed in your project. When Local Server is enabled, the server value is over-written. However, the Local Server is not available in cross-platform projects.

      • CV 控件类型 - 指示使用 Computer Vision 识别的控件类型。
      • 计算机视觉文本 - 表示使用 Computer Vision 识别的文本。
      • CV Text occurrence - Indicates a specific occurrence to be used, when multiple matches are found.
      • CV Text accuracy - Indicates the accuracy level for OCR text matching.
    • Semantic selector - Leverages large language models (LLMs) to generate functional, human-like descriptions of UI elements. These descriptions are highly reliable making them adaptable to UI changes and significantly improving automation resilience when traditional selectors fail.
    • Image (Windows only)
      • Image accuracy - Indicates the accuracy level for image matching.
      • Image occurrence - Indicates a specific occurrence to be used, when multiple matches are found.
    • Native text (Windows only)
      • Native text - The text to find to identify the UI element.
      • Native text occurrence - Indicates a specific occurrence to be used, when multiple matches are found.
  • Window selector (Application instance) - Selector for the application window. Only applicable when window attach mode is set to application instance.
  • Wait for page load - Before performing the action, wait for the application to becaome ready to accept input. The options are:
    • - 不等待目标变为就绪状态。
    • “交互式”– 等待直到加载了应用程序的一部分。
    • “完整”– 等待整个应用程序被加载。
  • Visibility check - When enabled, the activity also checks whether the UI element is visible or not. You can choose one of three options from the drop-down menu:
    • ”- 不检查可见性。
    • 交互式(用于模糊选取器) - 默认选项。 检查元素是否可能可见,忽略页面滚动和其他应用程序的阻碍或应用程序已最小化。 当尝试确保您没有以 DOM 中存在但隐藏的不可见元素为目标时,此检查非常有用。
    • 完全可见 - 检查用户界面元素是否可见。
  • 响应式网站 - 启用响应式网站布局。

计时

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

  • “检查可见性 ” - 启用后,该活动还将检查用户界面元素是否可见。

Windows - 旧版配置

  • 选择“在应用程序/浏览器中指明” ,以指定用作目标的用户界面元素。

    指定目标后,选择“ 菜单 按钮以访问以下选项:

    • “在屏幕上指定目标”- 再次指定目标。
    • 编辑目标 - 打开选择模式以配置目标。
    • 在任何应用程序中指明- 在“使用应用程序/浏览器”活动中使用时,您可以选择此选项来检查与当前应用程序实例无关的窗口或元素的应用程序状态,而无需添加新的应用程序卡。
    • 删除信息屏幕截图 - 删除目标应用程序或网页的屏幕截图。
    • 添加到对象存储库 - 将当前用户界面元素添加到库项目中,以便在整个自动化流程中重复使用该元素。
  • 等待 - 选择用于确定应用程序或浏览器状态的事件:
    • 要显示 的元素 - 等待元素出现在用户界面中。 如果选择此选项:
      • 添加当元素出现在“ 目标出现” 块中时要执行的活动。
      • 添加“ 目标未出现 ”块中元素未出现时要执行的活动。
    • 要消失的元素 - 等待元素从用户界面中消失。如果选择此选项:
      • 添加目标消失块中元素消失时要执行的活动。
      • 添加目标未消失块中元素未消失时要执行的活动。
  • - 在执行两个活动块之一之前等待元素出现或消失的时间。 您可以从下拉菜单中选择一个预定值。 默认值为 5 秒。
  • 单击活动主体中的“ 切换分支 ” 以配置“目标” 的可见性,“ 目标” 不会出现 在容器中,您可以在其中添加要执行的活动,具体取决于状态。 您可以使用两个容器,可以使用其中一个,也可以不使用。 默认情况下,这两个块都可见。
属性面板

常见

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

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

    • CV 控件类型 - 指示使用 Computer Vision 识别的控件类型。
    • 计算机视觉文本 - 表示使用 Computer Vision 识别的文本。
    • 模糊选取器 ” - 模糊选取器的参数。
    • 原生文本 - 用于标识用户界面元素的文本。
    • 响应式网站 - 启用响应式网站布局。
    • 严格选取器 ” - 为用户界面元素生成的“严格选取器”。
    • 定位方法 - 要用于标识元素的选取器类型。 可以将此属性设置为下拉菜单中的任意组合:
      • 精确选取器
      • 模糊选取器
      • 图像
      • 原生文本
      • Computer Vision - 要将 Computer Vision 用作定位方法,您需要转到“项目设置”>“Computer Vision”,并确保设置正确的服务器端点。您可以原样保留此字段,并使用 UiPath Cloud(默认情况下已填写),也可以通过选择特定于服务器区域的任何其他公共端点或您自己的本地部署服务器来输入其他值。

        将 Computer Vision 用作定位方法的另一种方法是将“使用本地服务器”设置为 True。这意味着 UiPath.ComputerVision.LocalServer 包已安装在项目中。启用“本地服务器”后,服务器值将被覆盖。但是,“本地服务器”在跨平台项目中不可用。

      • 语义选取器- 利用大型语言模型 (LLM) 生成功能性、拟人化的用户界面元素描述。这些描述可靠性极高,既能适应用户界面的变更,又能在传统选取器失效时显着增强自动化弹性。
    • 可见性检查 - 检查用户界面元素是否可见。 您可以从下拉菜单中选择以下三个选项之一:
      • ”- 不检查可见性。
      • 交互式(用于模糊选取器) - 默认选项。 检查元素是否可能可见,忽略页面滚动和其他应用程序的阻碍或应用程序已最小化。 当尝试确保您没有以 DOM 中存在但隐藏的不可见元素为目标时,此检查非常有用。
      • 完全可见 - 检查用户界面元素是否可见。
    • 等待页面加载 - 在执行 Actions之前,等待应用程序准备好接受输入。 您可以从下拉菜单中选择以下三个选项之一:
      • - 不等待目标变为就绪状态。
      • “交互式”– 等待直到加载了应用程序的一部分。
      • “完整”– 等待整个应用程序被加载。
    • 窗口选取器 (应用程序实例) - 用于应用程序窗口的选取器。 仅在窗口附加模式设置为“应用程序实例”时适用。
  • 输入元素 - 用于执行活动的用户界面元素,存储在 UIElement 对象中。 此字段仅支持 UIElement 对象。 可以从其他用户界面自动化活动的 输出元素 属性字段获取此对象。
  • 输出元素 - 输出目标用户界面元素并将其存储在 UIElement 对象中,该对象可进一步用于通过其他活动定位同一元素。
  • “私有” - 如果选中,则不再以“Verbose”级别记录变量和参数的值。 此字段仅支持 Boolean (TrueFalse) 值。 默认值为 False
  • 超时(秒) - 在“设计器” 面板中查看
  • 等待(出现/消失) - 请参阅“设计器”面板中的“ 等待”
  • 结果 ” - 指明元素是否存在。 该字段仅支持 Boolean 变量。 或者,您可以保存此值 (True/False) 以备后用,或将其保存在父级 Excel 文件或“项目笔记本”的单元格中。
  • 描述
  • 项目兼容性
  • Windows and Cross-platform configuration
  • Windows - 旧版配置

此页面有帮助吗?

获取您需要的帮助
了解 RPA - 自动化课程
UiPath Community 论坛
Uipath Logo
信任与安全
© 2005-2025 UiPath。保留所有权利。