查看应用程序状态

UiPath.UIAutomationNext.Activities.NCheckState

描述

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

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

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

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

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

项目兼容性

Windows - 旧版 | Windows | 跨平台

Windows - 旧版 Windows 配置

设计器面板

• 单击 “在应用程序/浏览器 中指定”，以指定要用作目标的用户界面元素。

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

  • “在屏幕上指定目标”- 再次指定目标。
  • 编辑目标 - 打开选择模式以配置目标。
  • 在任何应用程序中指明- 在“使用应用程序/浏览器”活动中使用时，您可以选择此选项来检查与当前应用程序实例无关的窗口或元素的应用程序状态，而无需添加新的应用程序卡。
  • 删除信息屏幕截图 - 删除目标应用程序或网页的屏幕截图。
  • 添加到对象存储库 - 将当前用户界面元素添加到库项目中，以便在整个自动化流程中重复使用该元素。

• 等待 - 选择用于确定应用程序或浏览器状态的事件：

  • 要显示 的元素 - 等待元素出现在用户界面中。 如果选择此选项：

    • 添加当元素出现在“ 目标出现” 块中时要执行的活动。
    • 添加“ 目标未出现 ”块中元素未出现时要执行的活动。

  • 要消失的元素 - 等待元素从用户界面中消失。如果选择此选项：

    • 添加目标消失块中元素消失时要执行的活动。
    • 添加目标未消失块中元素未消失时要执行的活动。
• 秒 - 在执行两个活动块之一之前等待元素出现或消失的时间。 您可以从下拉菜单中选择一个预定值。 默认值为 5 秒。
• 单击活动主体中的“ 切换分支 ” 以配置“目标” 的可见性，“ 目标” 不会出现 在容器中，您可以在其中添加要执行的活动，具体取决于状态。 您可以使用两个容器，可以使用其中一个，也可以不使用。 默认情况下，这两个块都可见。

属性面板

常见

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

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

输入

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

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

  • 可见性检查 - 检查用户界面元素是否可见。 您可以从下拉菜单中选择以下三个选项之一：
    • “无 ”- 不检查可见性。
    • 交互式（用于模糊选取器） - 默认选项。 检查元素是否可能可见，忽略页面滚动和其他应用程序的阻碍或应用程序已最小化。 当尝试确保您没有以 DOM 中存在但隐藏的不可见元素为目标时，此检查非常有用。
    • 完全可见 - 检查用户界面元素是否可见。
  • 等待页面加载 - 在执行 Actions之前，等待应用程序准备好接受输入。 您可以从下拉菜单中选择以下三个选项之一：
    • 无- 不等待目标变为就绪状态。
    • “交互式”– 等待直到加载了应用程序的一部分。
    • “完整”– 等待整个应用程序被加载。
  • 窗口选取器 (应用程序实例) - 用于应用程序窗口的选取器。 仅在窗口附加模式设置为“应用程序实例”时适用。

输入/输出元素

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

其他

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

选项

• 超时（秒） - 在“设计器” 面板中查看 秒 。
• 等待（出现/消失） - 请参阅“设计器”面板中的“ 等待” 。

输出

• “结果 ” - 指明元素是否存在。 该字段仅支持 Boolean 变量。 或者，您可以保存此值 (True/False) 以备后用，或将其保存在父级 Excel 文件或“项目笔记本”的单元格中。

跨平台配置

• “在作用域内工作” - 选择呈现要自动化的网页应用程序的浏览器选项卡。

• 在屏幕上指定目标 - 指定要用作目标的用户界面元素。

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

  • “在屏幕上指定目标”- 再次指定目标。
  • 编辑目标 - 打开选择模式以配置目标。

• 等待（显示/消失） - 选择要使用哪个事件来确定应用程序或浏览器的状态：

  • 要显示 的元素 - 等待元素出现在用户界面中。 如果选择此选项：

    • 添加该元素出现在“ IfExists” 块中时要执行的活动。
    • 添加元素未出现在“ IfNotExists” 块中时要执行的活动。

  • 要消失的元素 - 等待元素从用户界面中消失。如果选择此选项：

    • 添加元素在“ IfExists” 块中消失时执行的活动。
    • 添加元素在“ IfNotExists” 块中没有消失时要执行的活动。
• “超时（秒） ”- 执行两个活动块之一之前等待元素出现或消失的时间。 默认值为 5 秒。

其他选项

计时

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

选项

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

输入/输出

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