用户界面自动化活动

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

提取表格数据

UiPath.UIAutomationNext.Activities.NExtractData

描述

提取可以跨越多个页面的结构化信息，例如表格数据或网页搜索结果。

按照“ 表格数据提取 ”向导指示要提取的信息。要了解有关该向导使用方法的更多信息，请查看 “ 表格数据提取 ”页面。

无法在使用应用程序/浏览器活动内添加此活动。

如要在“使用应用程序/浏览器”活动之外使用此活动，您需要提供一个 “输入”元素。

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

项目兼容性

Windows - 旧版 | Windows | 跨平台

Windows - 旧版 Windows 配置

设计器面板

单击 “在屏幕上指定目标” ，按照“ 表格数据提取 ”向导指定要提取的数据。

指定目标后，选择“ 菜单” 按钮以访问以下选项：
- 编辑提取数据 - 打开“ 表格提取 ”向导以配置提取的数据。
- “测试提取 ” - 使用当前配置运行数据提取测试。结果将显示在预览数据窗口中。
- 提取数据向导 - 再次打开“ 表格提取 ”向导以提取数据。
- 删除信息屏幕截图 - 删除目标应用程序或网页的屏幕截图。
- 添加到对象存储库 - 将当前用户界面元素添加到库项目中，以便在整个自动化流程中重复使用该元素。
“提取位置” - 提取数据的保存位置。

属性面板

常见

“出错时继续” - 指定在活动引发错误时是否应继续自动化操作。此字段仅支持 Boolean 值（True、 False）。默认值为 False。因此，如果该字段为空且活动引发错误，系统将停止执行项目。如果该值设置为 True，则无论出现何种错误，系统都将继续执行项目。
“延迟时间” - 此活动完成与下一个活动开始执行任何操作之间的延迟时间（以秒为单位）。默认值为 0.3 秒。在活动之间添加延迟可确保一个活动有足够的时间完成，然后再开始下一个活动。
“在此之前延迟”- 上一个活动完成与此活动开始执行任何操作之间的延迟（以秒为单位）。默认值为 0.2 秒。在活动之间添加延迟可确保一个活动有足够的时间完成，然后再开始下一个活动。
显示名称- 设计器面板中活动的显示名称指定目标时，系统会自动生成显示名称。
“超时”- 指定最长等待时间（以秒为单位），如果超出该时间后活动并未执行，系统便会抛出错误。默认值为 30 秒。

输入

“提取元数据” - 一个 XML 字符串，用于定义要从指定网页提取的数据。
“表格设置 ” - 提取数据时使用的表格设置。
“目标 ” - 目标元素。必须设置目标元素。在屏幕上指定之前，此字段设置为 (null)。指定目标后，将显示与指定元素相关的所有属性。
- CV 控件类型 - 指示使用 Computer Vision 识别的控件类型。
- 计算机视觉文本 - 表示使用 Computer Vision 识别的文本。
- “模糊选取器 ” - 模糊选取器的参数。
- 原生文本 - 用于标识用户界面元素的文本。
- 响应式网站 - 启用响应式网站布局。
- “严格选取器 ” - 为用户界面元素生成的“严格选取器”。
- 定位方法 - 要用于标识元素的选取器类型。可以将此属性设置为下拉菜单中的任意组合：
  - 无
  - 精确选取器
  - 模糊选取器
  - 图像
  - 原生文本
  - Computer Vision - 要将 Computer Vision 用作定位方法，您需要转到“项目设置”>“Computer Vision”，并确保设置正确的服务器端点。您可以原样保留此字段，并使用 UiPath Cloud（默认情况下已填写），也可以通过选择特定于服务器区域的任何其他公共端点或您自己的本地部署服务器来输入其他值。
    将 Computer Vision 用作定位方法的另一种方法是将“使用本地服务器”设置为 True。这意味着 UiPath.ComputerVision.LocalServer 包已安装在项目中。启用“本地服务器”后，服务器值将被覆盖。但是，“本地服务器”在跨平台项目中不可用。
- 可见性检查 - 检查用户界面元素是否可见。您可以从下拉菜单中选择以下三个选项之一：
  - “无 ”- 不检查可见性。
  - 交互式（用于模糊选取器） - 默认选项。检查元素是否可能可见，忽略页面滚动和其他应用程序的阻碍或应用程序已最小化。当尝试确保您没有以 DOM 中存在但隐藏的不可见元素为目标时，此检查非常有用。
  - 完全可见 - 检查用户界面元素是否可见。
- 等待页面加载 - 在执行 Actions之前，等待应用程序准备好接受输入。您可以从下拉菜单中选择以下三个选项之一：
  - 无- 不等待目标变为就绪状态。
  - “交互式”– 等待直到加载了应用程序的一部分。
  - “完整”– 等待整个应用程序被加载。
- 窗口选取器 (应用程序实例) - 用于应用程序窗口的选取器。仅在窗口附加模式设置为“应用程序实例”时适用。
“目标”（“下一步”按钮） - 指定的第二个按钮的目标，提取表格时将依据该目标。有关可在此属性下展开的属性字段的更多信息，请参阅上面的目标属性，因为属性的功能是相同的。

其他

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

选项

“附加结果 ” - 指定是在现有值之后附加结果（如果适用），还是覆盖整个信息。
“数据表 ” - 从指定网页中提取的信息。此字段仅支持 DataTable 变量。
“页面之间的延迟 ”- 加载下一页之前的等待时间（以秒为单位）。默认值为 1.5 秒。如果页面的加载时间较长，则该值较高。
“输入模式 ”- 选择在数据跨越多个页面时如何执行“单击下一页”链接。仅当指示了“下一个链接”按钮时，此属性才有效。
- 与应用程序/浏览器 相同 - 使用与 使用应用程序/浏览器 活动相同的输入模式。
  
  这是默认选项。
- “硬件事件 ” - 使用硬件驱动程序执行操作。这是最慢的方法，无法在后台运行，但与所有桌面应用程序兼容。
- 模拟 - 使用辅助功能 API 进行模拟。推荐用于浏览器、基于 Java 的应用程序、SAP。通常比 硬件事件更可靠。在单个 Actions中发送所有文本。即使目标应用程序不在焦点中，也适用。请测试您的目标应用程序用户界面元素是否支持此功能。
- Chromium API - 使用调试器 API 执行操作。仅适用于 Chromium 元素。一次性发送所有文本。即使目标应用程序不在焦点中，也适用。有关更多详细信息，请查看此页面。
- 窗口消息 - 使用 Win32 消息进行模拟。推荐用于桌面应用程序。通常比 硬件事件更可靠。在单个 Actions中发送所有文本。即使目标应用程序不在焦点中，也适用。请测试您的目标应用程序用户界面元素是否支持此功能。
提取限制为 - 指定提取数据时要使用的限制类型。此属性与 项目数 属性一起使用。提供以下选项： 最大用户界面元素数、 无限制 （默认选项）和 最大页数。
项目数 - 要提取的最大结果数。如果值为 0，则所有已识别的元素都将添加到输出中。此属性与“ 限制提取 范围”属性一起使用。

跨平台配置

“在作用域内工作” - 选择呈现要自动化的网页应用程序的浏览器选项卡。
在屏幕上指定目标 - 按照“ 表格提取 ”向导指定要提取的数据。

指定目标后，选择加号按钮以访问以下选项：
- 提取数据向导 - 再次打开“ 表格提取 ”向导以提取数据。
- 编辑提取数据 - 打开“ 表格提取 ”向导以配置提取的数据。

其他选项

计时

“在此之前延迟”- 上一个活动完成与此活动开始执行任何操作之间的延迟（以秒为单位）。默认值为 0.2 秒。在活动之间添加延迟可确保一个活动有足够的时间完成，然后再开始下一个活动。
“延迟时间” - 此活动完成与下一个活动开始执行任何操作之间的延迟时间（以秒为单位）。默认值为 0.3 秒。在活动之间添加延迟可确保一个活动有足够的时间完成，然后再开始下一个活动。
“超时”- 指定最长等待时间（以秒为单位），如果超出该时间后活动并未执行，系统便会抛出错误。默认值为 30 秒。
“出错时继续” - 指定在活动引发错误时是否应继续自动化操作。此字段仅支持 Boolean 值（True、 False）。默认值为 False。因此，如果该字段为空且活动引发错误，系统将停止执行项目。如果该值设置为 True，则无论出现何种错误，系统都将继续执行项目。

选项

将提取内容限制为 - 指定提取数据时要使用的限制类型。该属性与“项目数量”属性一起使用。提供以下选项：“最大行数”（默认选项）、“无限制”和“最大页数”。
项目数 - 要提取的最大结果数。如果值为 0，则所有已识别的元素都将添加到输出中。
“页面之间的延迟 ”- 加载下一页之前的等待时间（以秒为单位）。默认值为 1.5 秒。如果页面的加载时间较长，则该值较高。
输入模式 - 选择机器人与目标应用程序交互时应使用的方法：
- 与浏览器相同 - 用户使用父级 使用浏览器 活动中的 输入模式设置。
- Chromium API - 使用调试器 API 执行操作。仅适用于 Chrome 和 Edge 元素。一次性发送所有文本。即使目标应用程序不在焦点中，也适用。
- 模拟 - 使用辅助功能 API 模拟单击。适用于浏览器。一次性发送所有文本。此输入方法在后台工作 (即使目标应用程序不在焦点中)。