获取文本

UiPath.UIAutomationNext.Activities.NGetText

描述

从用户界面元素中提取并复制文本。

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

To use this activity outside a Use Application/Browser activity, you need to provide an Input element.

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

项目兼容性

Windows - 旧版 | Windows | 跨平台

Windows - 旧版 Windows 配置

设计器面板

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

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

  • “在屏幕上指定目标”- 再次指定目标。
  • 编辑目标 - 打开选择模式以配置目标。
  • 删除信息屏幕截图 - 删除目标应用程序或网页的屏幕截图。
  • 添加到对象存储库 - 将当前用户界面元素添加到库项目中，以便在整个自动化流程中重复使用该元素。
  • “预览提取 ” - 打开“ 获取文本 - 提取”预览 向导，该向导可用于实时查看从目标中检索到的文本。
• 保存到 - 用于将指定用户界面元素中的文本存储在变量中。 在此字段中创建的变量属于 String 类型。

提取内容预览

“ 获取文本 - 提取”预览 向导使您可以选择要使用的抓取方法，并且还可以实时显示使用所选方法显示的文本。 提取的文本将显示在“ 提取”预览 文本框中，您可以使用“ 复制到剪贴板 ”按钮复制提取的文本。

如果未使用该向导，则默认尝试所有抓取方法，并自动选择最佳方法。 在“ 提取”预览 窗口中选择抓取方法会覆盖此机制，并使该方法成为唯一使用的方法。

可以使用以下方法：

• 默认
• 文本属性
• “全文 ” - 此方法提供“ 忽略隐藏文本” 选项，可以通过选中相应的复选框来激活该选项。

• 本机 - 此方法使您能够通过选中每个功能的复选框来允许格式化和检索单词的屏幕坐标。

  
  

  

  
  

选择要用于抓取的方法后，单击“ 保存并 关闭” 将关闭向导并传播您在活动的“属性面板”中所做的更改。

属性面板

常见

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

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

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

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

• “超时”- 指定最长等待时间（以秒为单位），如果超出该时间后活动并未执行，系统便会抛出错误。 默认值为 30 秒。

  您也可以从下拉菜单中选择一个预定值：10（秒）、20（秒）或 30（秒）。

输入

• 抓取方法 - 描述要使用的抓取方法。 提供以下选项：

  • “默认” - 遍历可能的抓取方法（“文本”属性、“全文”，按此顺序），并在第一个返回数据的方法处停止。更改默认方法的唯一原因是它返回的是文本，但不是正确的文本。 如果默认方法未返回任何内容，则这同样适用于其他抓取方法。
  • 文本属性 - 提取指定用户界面元素的文本属性值。
  • “全文 ” - 提取用户界面元素的全文，包括其子元素。 当您要提取包含多个子元素的容器元素的全文时，此方法非常有用。
  • 原生 - 提取指定用户界面元素的可见文本。
• “目标 ” - 目标元素。 必须设置目标元素。 在屏幕上指定之前，此字段设置为 (null)。 指定目标后，将显示与指定元素相关的所有属性。
  注意： 如果此活动针对选定的复选框，则返回的文本为 checked。 如果此活动定位到图像，则返回图像的 alt 文本。
  • CV 控件类型 - 指示使用 Computer Vision 识别的控件类型。
  • 计算机视觉文本 - 表示使用 Computer Vision 识别的文本。
  • “模糊选取器 ” - 模糊选取器的参数。
  • 原生文本 - 用于标识用户界面元素的文本。
  • 响应式网站 - 启用响应式网站布局。
  • “严格选取器 ” - 为用户界面元素生成的“严格选取器”。
  • 定位方法 - 要用于标识元素的选取器类型。 可以将此属性设置为下拉菜单中的任意组合：
    • 无
    • 精确选取器
    • 模糊选取器
    • 图像
    • 原生文本
    • Computer Vision
  • 可见性检查 - 检查用户界面元素是否可见。 您可以从下拉菜单中选择以下三个选项之一：
    • “无 ”- 不检查可见性。
    • 交互式（用于模糊选取器） - 默认选项。 检查元素是否可能可见，忽略页面滚动和其他应用程序的阻碍或应用程序已最小化。 当尝试确保您没有以 DOM 中存在但隐藏的不可见元素为目标时，此检查非常有用。
    • 完全可见 - 检查用户界面元素是否可见。
  • 等待页面加载 - 在执行 Actions之前，等待应用程序准备好接受输入。 您可以从下拉菜单中选择以下三个选项之一：
    • 无- 不等待目标变为就绪状态。
    • “交互式”– 等待直到加载了应用程序的一部分。
    • “完整”– 等待整个应用程序被加载。
  • 窗口选取器 (应用程序实例) - 用于应用程序窗口的选取器。 仅在窗口附加模式设置为“应用程序实例”时适用。

输入/输出元素

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

其他

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

输出

• “文本 ”- 在“设计器”面板中查看“ 保存到 ”。
• 单词信息 - 检索到的文本的其他信息（例如屏幕坐标）保存在此字段中提供的变量中。 此字段仅支持 NWordInfo 变量。

跨平台配置

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

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

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

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

其他选项

计时

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

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

• “超时”- 指定最长等待时间（以秒为单位），如果超出该时间后活动并未执行，系统便会抛出错误。 默认值为 30 秒。

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

选项

• 抓取方法 - 描述要使用的抓取方法。 提供以下选项：

  • “默认” - 遍历可能的抓取方法（“文本”属性、“全文”，按此顺序），并在第一个返回数据的方法处停止。更改默认方法的唯一原因是它返回的是文本，但不是正确的文本。 如果默认方法未返回任何内容，则这同样适用于其他抓取方法。
  • 文本属性 - 提取指定用户界面元素的文本属性值。
  • “全文 ” - 提取用户界面元素的全文，包括其子元素。 当您要提取包含多个子元素的容器元素的全文时，此方法非常有用。

输入/输出

• “文本值 ” - 用于将指定用户界面元素中的文本存储在变量中。 在此字段中创建的变量属于 String 类型。
• 单词信息 - 检索到的文本的其他信息（例如屏幕坐标）保存在此字段中提供的变量中。 此字段仅支持 NWordInfo 变量。
• 输入元素 - 用于执行活动的用户界面元素，存储在 UIElement 对象中。 此字段仅支持 UIElement 对象。 可以从其他用户界面自动化活动的 输出元素 属性字段获取此对象。
• 输出元素 - 输出目标用户界面元素并将其存储在 UIElement 对象中，该对象可进一步用于通过其他活动定位同一元素。