用户界面自动化活动

上次更新日期 2024年12月20日

展开树

UiPath.Core.Activities.SAP.ExpandTree

描述

将父级树展开到活动节点或活动项目。指明 SAP GUI 窗口中的 SAP 树元素后，活动中会显示包含所有可用节点和项目的树列表。

项目兼容性

Windows - 旧版 | 窗口

配置

设计器面板

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

指定目标后，选择“菜单”按钮访问以下选项：
- 在屏幕上指定 - 再次指定目标。
- 编辑选取器 - 打开“选取器编辑器”向导，您可以在其中配置选取器。
- 在 UI Explorer 中打开 - 打开“UI Explorer”，并显示在可视化树中选择的用户界面元素。
- 更改信息性屏幕截图 - 更改目标应用程序或网页的屏幕截图。
- 删除信息性屏幕截图 - 删除目标应用程序或网页的屏幕截图。
- 显示信息截图（双击） - 显示目标应用程序或网页的完整屏幕截图。
- 添加到对象存储库 - 将当前用户界面元素添加到库项目中，以便在整个自动化流程中重复使用该元素。
树项目 - 指定父树中的“树项目”或“树节点”。系统会选中活动节点或项目。指明 SAP GUI 窗口中的 SAP 树元素后，活动中会显示包含所有可用节点和项目的树列表。

属性面板

常见

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

注意：如果 Try Catch 异常处理中包含该活动且“出错时继续”属性的值设置为 True，则系统在执行项目时不会捕获任何错误。
在此之后延迟 - 执行活动之后的延迟时间（以毫秒为单位）。默认时长为 300 毫秒。
“延迟 之前” - 活动开始执行任何操作之前的延迟时间（以毫秒为单位）。默认时间为 200 毫秒。
“显示名称”- 活动的显示名称。

输入

项目 - 指定父树中的“树项目”或“树节点”。系统会选中活动节点或项目。指明 SAP GUI 窗口中的 SAP 树元素后，活动中会显示包含所有可用节点和项目的树列表。
“目标 ” - 目标元素。必须设置目标元素。在屏幕上指定之前，此字段设置为 (null)。指定目标后，将显示与指定元素相关的所有属性。
- 剪切区域 - 按照左、上、右、下四个方向定义相对于用户界面元素的剪切矩形（以像素为单位）。支持正数和负数。
- 元素 - 使用另一个活动返回的 UiElement 变量。该属性不能与选取器属性一起使用。此字段仅支持 UiElement 变量。
- 选取器- 此为“文本”属性，用于在执行活动时查找特定用户界面元素。它实际上是 XML 片段，用于指定要查找的图形用户界面元素及其一些父元素的属性。
- 超时（毫秒）- 指定最长等待时间（以毫秒为单位），如果超出该时间后活动并未运行，系统便会引发 SelectorNotFoundException 错误。默认值为 30000 毫秒（30 秒）。
- “等待准备就绪”- 执行操作之前，等待目标准备就绪。可选择以下选项：
  - “无”- 在执行操作之前，系统不会等待显示除目标用户界面元素之外的任何内容。例如，如果希望只从网页检索文本或单击特定按钮，则可以使用此选项，而不必等待用户界面元素全部加载。请注意，如果按钮依赖于尚未加载的元素（例如脚本），则可能会产生不良后果。
  - “交互/完成” - 待目标应用程序中的所有用户界面元素全部显示之后，再实际执行操作。
    为了评估应用程序处于“交互”状态还是“完成”状态，系统将验证以下标签：
    - “桌面应用程序”- 系统会发出一条“wm_null”消息，以检查是否存在“<wnd>”、“<ctrl>”、“<java>”或“<uia>”标签。如存在，则执行活动。
    - 网页应用程序：
      
      Internet Explorer - <webctrl> 标签用于检查 HTML 文档的“就绪”状态是否设为“完成”。此外，必须将“忙碌”状态设为“False”。
      
      其他 - <webctrl> 标签用于检查 HTML 文档的“就绪”状态是否为“完成”。
    - “SAP 应用程序”- 首先验证是否存在“<wnd>”标签，然后使用 SAP 特定 API 来检测会话是否繁忙。