导出用户界面树

UiPath.Core.Activities.ExportUiTree

将在指定元素中找到的所有用户界面元素及其各自的属性和值导出为 XML 或 JSON 文件。此活动通过检查活动的输出并将其与选取器配置进行比较，帮助您了解选取器在执行期间失败的原因。

属性

常见

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

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

输入

• Target.ClippingRegion - 沿以下方向定义相对于用户界面元素的剪切矩形（以像素为单位）：左、上、右、下。 它支持正数和负数。
• “目标.元素” - 使用另一个活动返回的用户界面元素变量。 此属性不能与“选取器”属性一起使用。 此字段仅支持用户界面元素变量。
• “目标选择器” - 执行活动时用于查找特定用户界面元素的文本属性。 它实际上是一个 XML 片段，用于指定您要查找的 GUI 元素及其某些父元素的属性。
• Target.TimeoutMS - 指定在引发 SelectorNotFoundException 错误之前等待活动运行的时间（以毫秒为单位）。 默认值为 30000 毫秒 (30 秒)。

• Target.WaitForReady - 在执行操作之前，请等待目标就绪。 提供以下选项：

  • “无”- 在执行操作之前，系统不会等待显示除目标用户界面元素之外的任何内容。例如，如果希望只从网页检索文本或单击特定按钮，则可以使用此选项，而不必等待用户界面元素全部加载。请注意，如果按钮依赖于尚未加载的元素（例如脚本），则可能会产生不良后果。

  • “交互/完成” - 待目标应用程序中的所有用户界面元素全部显示之后，再实际执行操作。

    为了评估应用程序处于“交互”状态还是“完成”状态，系统将验证以下标签：

  • “桌面应用程序”- 系统会发出一条“wm_null”消息，以检查是否存在“<wnd>”、“<ctrl>”、“<java>”或“<uia>”标签。如存在，则执行活动。
  • 网页应用程序：
  1. Internet Explorer - <webctrl> 标签用于检查 HTML 文档的就绪状态是否设为完成。此外，必须将忙碌状态设置为“False”。
  2. 其他 - <webctrl> 标签用于检查 HTML 文档的“就绪”状态是否为“完成”。
  • “SAP 应用程序”- 首先验证是否存在“<wnd>”标签，然后使用 SAP 特定 API 来检测会话是否繁忙。

其他

• “私有”- 选中后将不再以“Verbose”级别记录变量和参数的值。

选项

• 导出格式 - 此下拉列表用于指定要以何种格式导出用户界面元素。您可以在 XML 和 JSON 之间进行选择。默认情况下，选择 XML。
• 导出路径- 要在其中创建包含提取的用户界面树的文件的路径。如果将此字段留空，则文件将导出为 ExportedString 输出参数。此字段仅支持 String 变量。
• 筛选器 - 此筛选器仅可用于导出特定类型的选取器。导出的用户界面树仅包含用户界面元素，具体取决于此字段中指定的选取器类型。
• 包含屏幕截图 - 如果选中，则将用户界面树的屏幕截图与包含选取器的文件一起保存。默认情况下，该复选框处于未选中状态。
• 操作超时（毫秒）- 指定等待活动生成包含导出的用户界面树的文件的时间（以毫秒为单位）。
• 覆盖- 如果选中，该活动将覆盖导出路径属性字段中指定的路径中存在的所有文件。默认情况下，该复选框处于未选中状态。
• 用户界面框架 - 此下拉菜单用于指定用于检测顶级用户界面元素的用户界面框架。共有三个可能的选项：默认、Active Accessibility 和用户界面自动化。默认情况下，选择默认。此属性字段仅在导出整个桌面的内容时使用。

在活动正文中

您可以通过活动主体配置活动的多个参数，而无需与“属性”面板交互，例如：

“ 在屏幕上指示” 按钮使您可以选择要导出其用户界面树的目标应用程序。

使用导出格式下拉菜单，您可以选择可用于导出文件的 XML 或 JSON 格式。

“目标文件”字段用于指定要保存文件的路径，或指定“浏览”文件夹。

“包含屏幕截图”复选框指定是否将实际用户界面元素的屏幕截图与包含用户界面树的文件一起保存。默认情况下，该复选框处于未选中状态。