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

用户界面自动化活动

上次更新日期 2026年5月14日

在图像消失时

UiPath.Core.Activities.OnImageVanish

此容器会等待图像消失，并可用于执行其他活动。

属性​

输入​
  • “Image.Image”- 待搜索的现有图像。该字段仅支持“图像”变量。
  • “Image.Accuracy”- 介于 0 到 1 的一种度量单位，表示您正在搜索的图像与要查找的图像之间的最低相似度。当要查找的图像与您正在搜索的图像略有不同时，此方法较为适用。默认值为 0.8。
  • “Image.Profile”- 用于更改要使用的图像检测算法。“基础版”是经典算法，速度和资源成本均适中。“增强版”可提供更精确的结果，但资源成本较高。默认情况下，该字段设为“基础”。
  • “Target.Selector”- 用于在执行活动时查找特定用户界面元素的“文本”属性。它实际上是 XML 片段，用于指定要查找的图形用户界面元素及其一些父元素的属性。
  • “Target.Timeout(毫秒)”- 指定最长等待时间（以毫秒为单位），如果超出该时间后活动并未运行，系统便会抛出“SelectorNotFoundException”错误。默认值为 30000 毫秒（30 秒）。
  • “Target.WaitForReady”- 待目标准备就绪后，再执行操作。可用的选项如下：
    • “无”- 在执行操作之前，系统不会等待显示除目标用户界面元素之外的任何内容。例如，如果希望只从网页检索文本或单击特定按钮，则可以使用此选项，而不必等待用户界面元素全部加载。请注意，如果按钮依赖尚未加载的元素（如脚本），这可能会产生不良后果。
    • “交互/完成” - 待目标应用程序中的所有用户界面元素全部显示之后，再实际执行操作。 为了评估应用程序处于“交互”状态还是“完成”状态，系统将验证以下标签：
    • “桌面应用程序”- 系统会发出一条“wm_null”消息，以检查是否存在“<wnd>”、“<ctrl>”、“<java>”或“<uia>”标签。如存在，则执行活动。
    • 网页应用程序：
    1. Internet Explorer - The <webctrl> tag is used to check if the Ready state of the HTML document is set to Complete. Additionally, the Busy state has to be set to "False".
    2. Others - The <webctrl> tag is used to check if the Ready state of the HTML document is Complete.
    • “SAP 应用程序”- 首先验证是否存在“<wnd>”标签，然后使用 SAP 特定 API 来检测会话是否繁忙。
  • “Target.Element”- 使用另一个活动返回的“用户界面元素”变量。该属性不能与“选取器”属性一起使用。该字段仅支持用户界面元素变量。
  • “Target.ClippingRegion”- 按照左、上、右、下四个方向定义相对于用户界面元素的剪切矩形（以像素为单位）。支持正数和负数。
常见​

  • “显示名称”- 活动的显示名称。

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

    备注：

    如果“Try Catch 异常处理”中包含该活动且“出错时继续”属性的值为“True”，则系统在执行项目时不会捕获任何错误。

选项​
  • 无限重复- 指定活动是否持续监控事件。该字段仅支持“布尔值”（True 和 False）。True
    • 每次出现指定图像时，都执行该块；这是默认值。False - 该活动仅执行一次。
其他​
  • “私有”- 选中后将不再以“Verbose”级别记录变量和参数的值。

使用“在图像消失时”活动的示例​

“在图像消失时”活动会检查网站中的特定图像何时消失。此活动用于验证来自网站的流程，并可用作自动化流程的触发器。

为了举例说明如何使用此活动，我们创建了一个示例，该示例对所选网站执行速度测试，并为其分配特定的性能等级。自动化流程将打开浏览器，并验证图像何时消失。这表示测试已开始。第二个“在图像消失时”活动会检查测试是否完成。

此自动化流程的构建方法如下：

  1. 打开 Studio ，创建一个新“流程”。
  2. 将“序列”活动拖动至“工作流设计器”。

    • 创建以下变量：

      变量名称变量类型默认值
      website字符串
  3. 将“输入对话框”活动拖动到“序列”容器内。
    • 在“属性”面板中，向“标签”字段添加“"Insert Website URL"”表达式。
    • 在“标题”字段中添加表达式“"Website"”。
    • 在“结果”字段中添加 website 变量。
  4. 在“输入对话框”活动下方放置一个“打开浏览器”活动。
    • 在“URL”字段中添加表达式 "https://tools.pingdom.com"。
    • 在“属性”字段中，从“浏览器类型”下拉列表中选择“IE”选项。
    • 选中“新会话”选项的复选框。这会启动所选浏览器的新会话。
  5. 将“输入”活动拖动到“打开浏览器”活动的“执行”容器内。
    • 在“属性”面板中，从“目标”下拉列表中选择“Target”选项。
    • 在“选取器”字段中添加表达式“"<webctrl id='urlInput' tag='INPUT' />"”。
    • 从“等待就绪”下拉列表中选择“INTERACTIVE”选项。
    • 在“文本”字段中添加“website”变量。
    • 选中“激活”选项的复选框。这会将浏览器置于前台，并在写入文本前将其激活。
  6. 在“输入”活动下方放置“单击”活动。
    • 在“属性”面板中，向“在此之后延迟”字段添加“1000”值。
    • 在“单击类型”下拉列表中选择“CLICK_SINGLE”选项。
    • 从“鼠标按键”下拉列表中选择“BTN_LEFT”选项。
    • 在“目标”下拉列表中选择“Target”选项。
    • 在“选取器”字段中添加表达式“"<webctrl tag='INPUT' type='submit' />"”。
    • 从“等待就绪”下拉列表中选择“INTERACTIVE”选项。
    • 在“光标位置”下拉列表中选择“CursorPosition”选项。
    • 在“位置”下拉列表中选择“Center”选项。
    • 从“修饰键”下拉列表中选择“None”选项。
  7. 将“延迟”活动拖动到“单击”活动下方。
    • 在“属性”面板中，向“持续时间”字段添加“00:00:02”值。这会导致活动间出现两秒延迟。
  8. 将“在图像消失时”活动放置在“延迟”活动下方。
    • 在“属性”面板中，从“图像”下拉列表中选择 ImageTarget 选项。
    • 在“准确度”字段中添加值“0.8”。
    • 从“配置文件”下拉列表中选择“Basic”选项。
    • 在“目标”下拉列表中选择“Target”选项。
    • 从“等待就绪”下拉列表中选择“INTERACTIVE”选项。
    • 在“一直重复”字段中添加值“False”。
  9. 将新的“在图像消失时”活动拖动到上一个“在图像消失时”活动的“执行”容器中。

    • 在“属性”面板中，从“图像”下拉列表中选择 ImageTarget 选项。

      • 在“准确度”字段中添加值“0.8”。
      • 从“配置文件”下拉列表中选择“Basic”选项。
      • 在“目标”下拉列表中选择“Target”选项。
      • 在“选取器”字段中添加表达式“"<webctrl id='speedometer' tag='svg' />"”。
      • 从“等待就绪”下拉列表中选择“INTERACTIVE”选项。
      • 在“一直重复”字段中添加值“False”。

    • 选择最后一个“在图像消失时”活动的“执行”容器，并创建以下变量：

      变量名称变量类型默认值
      grade字符串
  10. 将“获取文本”活动拖动至“执行”容器中。
    • 在“属性”面板中，从“目标”下拉列表中选择“Target”选项。
    • 在“选取器”字段中添加表达式“"<html title='Pingdom Tools' /><webctrl parentname='Performance grade' tag='app-grade-badge' />"”。这将从网站检索性能等级，并将其值存储在变量 grade 中。
    • 从“等待就绪”下拉列表中选择“INTERACTIVE”选项。
    • 在“值”字段中添加变量 grade。
  11. 将“消息框”活动放置在“获取文本”活动下方。
    • 在“属性”面板中，从“按钮”下拉列表中选择“Ok”选项。
    • 在“文本”字段中添加表达式 "Performance Grade is " + grade。这将显示您提供的网站收到的分数。
    • 选中“排名最前”选项的复选框。这会将消息框置于前台。
  12. 运行流程。机器人会要求您输入网站地址，打开新的浏览器，访问www.pingdom.com网站，验证您添加的地址的性能，并返回一个包含性能等级的消息框。
  • 属性​
  • 使用“在图像消失时”活动的示例​

此页面有帮助吗？

连接

需要帮助? 支持

想要了解详细内容？ UiPath Academy

有问题? UiPath 论坛

保持更新