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

用户界面自动化活动

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

获取文本

UiPath.UIAutomationNext.Activities.NGetText

描述

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

此活动必须添加到“使用应用程序/浏览器”活动中。

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

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

项目兼容性

Windows - 旧版 | Windows | 跨平台

Windows 和跨平台配置

  • 在作用域内工作 - 选择呈现要自动化的网页应用程序的浏览器选项卡。
  • 在屏幕上指明目标
    • 指定要用作目标的用户界面元素。指定目标后,选择加号按钮以访问以下选项:
    • Indicate target on screen - Indicate the target again.
    • “编辑目标” - 打开选择模式以配置目标。

属性面板

输入/输出

  • 文本值- 用于将指定用户界面元素中的文本存储在变量中。在此字段中创建的变量属于String类型。
  • Words info - The additional information of the retrieved text, such as screen coordinates, are saved in the variable supplied in this field. This field supports only NWordInfo variables.
  • “输入元素” - 要在其上执行活动的用户界面元素,存储在UIElement对象中。此字段仅支持UIElement对象。可以从其他用户界面自动化活动的“输出元素”属性字段中获取该对象。
  • “输出元素” - 输出目标用户界面元素,并将其存储在UIElement对象中,该对象可进一步用于与其他活动针对同一元素。

选项

  • 抓取方法- 描述要使用的抓取方法。可选择以下选项:
    • 默认- 遍历可能的抓取方法(按顺序为文本属性、全文),并在第一个返回数据的方法处停止。更改默认方法的唯一原因是它是否返回文本,而不是错误的文本。如果默认方法未返回任何内容,则上述情况适用于其他抓取方法。
    • 文本属性- 提取指定用户界面元素的文本属性值。
    • 全文- 提取用户界面元素的全文,包括其子元素。当您要提取包含多个子元素的容器元素全文时,此方法非常实用。
    • OCR - 使用 OCR 引擎提取文本。
  • 抓取选项
    • 文本格式设置
    • 忽略隐藏文本
    • 词坐标
  • Healing Agent 模式- 根据流程或作业级别的监管或 Orchestrator 设置,配置此活动的 Healing Agent 行为。
    • 已禁用 - 关闭此活动的 Healing Agent。
    • 继承作业设置- 在流程或作业级别应用在监管或 Orchestrator 中定义的设置。
    • “仅建议” - 允许 Healing Agent 提供有关如何修复正在运行的作业中的用户界面自动化问题的建议,但前提是监管或 Orchestrator 设置允许。
    • 与应用程序/浏览器相同- 从父级“使用应用程序/浏览器”活动继承配置。
  • “出错时继续”- 指定在活动抛出错误时是否应继续自动化操作。该字段仅支持“布尔值”(TrueFalse)。默认值为 FALSE。因此,如果该字段为空且活动引发错误,系统将停止执行项目。如果该值设为 True,则无论出现何种错误,系统都将继续执行项目。

目标

  • 展开目标属性- 显示目标和锚点属性。这将隐藏其他活动属性,仅显示与目标相关的属性。

  • “折叠目标属性” - 隐藏“目标” 和锚点属性。这将隐藏目标相关属性并显示活动属性。

  • 定位方式- 要用于识别元素的选取器类型。从下拉菜单中选择此属性后,可将其设置为任意组合:

    • 精确选取器- 为目标用户界面元素生成的精确选取器。
    • 模糊选取器- 模糊选取器参数。
    • Computer Vision - 要将 Computer Vision 用作定位方法,您需要转到“项目设置” > “Computer Vision” ,并确保设置正确的服务器端点。您可以原样保留此字段,并使用 UiPath Cloud(默认情况下已填写),也可以通过选择特定于服务器区域的任何其他公共端点或您自己的本地部署服务器来输入其他值。将 Computer Vision 用作定位方法的另一种方法是将“使用本地服务器”设置为True 。这意味着UiPath.ComputerVision.LocalServer包已安装在项目中。启用“本地服务器”后,服务器值将被覆盖。但是,“本地服务器”在跨平台项目中不可用。
      • CV 控件类型- 表示使用 Computer Vision 识别的控件的类型。
      • CV 文本- 表示使用 Computer Vision 识别的文本。
      • 计算机视觉文本出现次数- 当找到多个匹配项时,指示要使用的特定出现次数。
      • 计算机视觉文本准确性- 指示 OCR 文本匹配的准确性级别。
    • 语义选取器- 利用大型语言模型 (LLM) 为用户界面元素生成功能性、拟人化的描述。这些描述可靠性极高,既能适应用户界面的变更,又能在传统选取器失效时显着增强自动化弹性。
    • 图像(仅限 Windows)
      • 图像准确性- 指示图像匹配的准确性级别。
      • 图像出现次数- 当找到多个匹配项时,指示要使用的特定出现次数。
    • 原生文本(仅限 Windows)
      • 原生文本- 要查找来识别用户界面元素的文本。
      • 原生文本出现次数- 当找到多个匹配项时,指示要使用的特定出现次数。
  • 窗口选取器(应用程序实例) - 应用程序窗口的选取器。仅在窗口附加模式设置为应用程序实例时可用。

  • 等待页面加载- 在执行操作之前,等待应用程序做好接受输入的准备。选项包括:

    • “无”- 不等待目标变为就绪状态。
    • “交互式”– 等待直到加载了应用程序的一部分。
    • “完整”– 等待整个应用程序被加载。
  • 可见性检查- 启用后,该活动还会检查用户界面元素是否可见。您可以从下拉菜单中选择以下三个选项之一:

    • - 不检查可见性。
    • 交互式(用于模糊选取器)- 默认选项。检查元素是否可能可见,忽略页面滚动和其他应用程序的阻碍或者应用程序已最小化的情况。当尝试确保您没有以 DOM 中存在但隐藏的不可见元素为目标时,此检查非常有用。
    • 完全可见- 检查用户界面元素是否可见。
  • 响应式网站- 启用响应式网站布局。

目标 - 剪切区域

  • “锚点” - 描述光标从“偏移 X”“偏移 Y”属性添加的偏移量的起点。提供以下选项:左上右上左下右下中间。默认情况下,选择“中心”
  • 偏移 X - 根据“锚点”字段中选择的选项对光标位置进行的水平位移。此字段仅支持 Int32 变量。
  • 偏移 Y - 光标位置根据“锚点”字段中选择的选项而进行的垂直位移。此字段仅支持 Int32 变量。
  • 偏移宽度- 偏移区域的宽度。
  • 偏移高度- 偏移区域的高度。

计时

  • Delay before - Delay (in seconds) between the time the previous activity is completed and the time this activity begins performing any operations. The default value is 0.2 seconds. Adding a delay between activities ensures that one activity has enough time to complete before the next activity begins.
  • Delay after - Delay (in seconds) between the time this activity is completed and the time the next activity begins any operations. The default value is 0.3 seconds. Adding a delay between activities ensures that one activity has enough time to complete before the next activity begins.
  • “超时” - 指定在引发错误之前等待执行活动的时间(以秒为单位)。默认值为 30 秒。

Windows - 旧版配置

  • 选择“在应用程序/浏览器中指明” ,以指定用作目标的用户界面元素。

指定目标后,选择“菜单”docs image按钮访问以下选项:

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

提取内容预览

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

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

可以使用以下方法:

  • 默认
  • 文本属性
  • Fulltext - This method offers the option to Ignore hidden text, which can be activated by selecting its respective check box.
  • Native - This method enables you to Allow formatting and retrieve the screen coordinates of the words by selecting the check boxes for each of these features.

docs image

After selecting the method you want to use for scraping, hitting Save & close closes the wizard and propagates the changes you have made in the Properties Panel of the activity.

属性面板

常见

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

  • Delay after - Delay (in seconds) between the time this activity is completed and the time the next activity begins any operations. The default value is 0.3 seconds. Adding a delay between activities ensures that one activity has enough time to complete before the next activity begins.

  • Delay before - Delay (in seconds) between the time the previous activity is completed and the time this activity begins performing any operations. The default value is 0.2 seconds. Adding a delay between activities ensures that one activity has enough time to complete before the next activity begins.

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

  • “超时” - 指定在引发错误之前等待执行活动的时间(以秒为单位)。默认值为 30 秒。您也可以从下拉菜单中选择一个预定值:10(秒)、20(秒)或 30(秒)。

  • “默认” - 遍历可能的抓取方法(按“文本”属性、“全文”的顺序),在第一个返回数据的方法处停止。更改默认方法的唯一原因是它是否返回文本,而不是正确的文本。如果默认方法未返回任何内容,则上述情况适用于其他抓取方法。

  • 文本属性- 提取指定用户界面元素的文本属性值。

  • 全文- 提取用户界面元素的全文,包括其子元素。当您要提取包含多个子元素的容器元素全文时,此方法非常实用。

  • 原生- 提取指定用户界面元素的可见文本。

备注:

If a selected check box is targeted by this activity, the returned text is checked. If an image is targeted by this activity, the alt text of the image is returned.

  • CV 控件类型- 表示使用 Computer Vision 识别的控件的类型。
  • CV 文本- 表示使用 Computer Vision 识别的文本。
  • Fuzzy selector - The parameters for the fuzzy selector.
  • 原生文本- 用于标识用户界面元素的文本。
  • 响应式网站- 启用响应式网站布局。
  • 精确选取器- 为用户界面元素生成的精确选取器。
  • 定位方式- 要用于识别元素的选取器类型。从下拉菜单中选择此属性后,可将其设置为任意组合:
    • 精确选取器
    • 模糊选取器
    • 图像
    • 原生文本
    • Computer Vision - 要将 Computer Vision 用作定位方法,您需要转到“项目设置” > “Computer Vision” ,并确保设置正确的服务器端点。您可以原样保留此字段,并使用 UiPath Cloud(默认情况下已填写),也可以通过选择特定于服务器区域的任何其他公共端点或您自己的本地部署服务器来输入其他值。将 Computer Vision 用作定位方法的另一种方法是将“使用本地服务器”设置为True 。这意味着 UiPath.ComputerVision.LocalServer 包已安装在项目中。启用“本地服务器”后,服务器值将被覆盖。但是,“本地服务器”在跨平台项目中不可用。
  • 语义选取器- 利用大型语言模型 (LLM) 生成功能性、拟人化的用户界面元素描述。这些描述可靠性极高,既能适应用户界面的变更,又能在传统选取器失效时显着增强自动化弹性。
  • 可见性检查- 检查用户界面元素是否可见。您可以从下拉菜单中选择以下三个选项之一:
    • - 不检查可见性。
    • 交互式(用于模糊选取器)- 默认选项。检查元素是否可能可见,忽略页面滚动和其他应用程序的阻碍或者应用程序已最小化的情况。当尝试确保您没有以 DOM 中存在但隐藏的不可见元素为目标时,此检查非常有用。
    • 完全可见
      • 检查用户界面元素是否可见。
  • 等待页面加载- 在执行操作之前,等待应用程序做好接受输入的准备。您可以从下拉菜单中选择以下三个选项之一:
    • “无”- 不等待目标变为就绪状态。
    • “交互式”– 等待直到加载了应用程序的一部分。
    • “完整”– 等待整个应用程序被加载。
  • 窗口选取器(应用程序实例) - 用于应用程序窗口的选取器。仅在窗口附加模式设置为“应用程序实例”时可用。
  • “输入元素” - 要在其上执行活动的用户界面元素,存储在UIElement对象中。此字段仅支持UIElement对象。可以从其他用户界面自动化活动的“输出元素”属性字段中获取该对象。

  • “输出元素” - 输出目标用户界面元素,并将其存储在UIElement对象中,该对象可进一步用于与其他活动针对同一元素。

  • “私有” - 选中后将不再以“Verbose”级别记录变量和参数的值。此字段仅支持BooleanTrueFalse )值。默认值为False

  • “文本” - 查看“设计器” 面板中的“保存到”

  • Words info - The additional information of the retrieved text, such as screen coordinates, are saved in the variable supplied in this field. This field supports only NWordInfo variables.

  • 描述
  • 项目兼容性
  • Windows 和跨平台配置
  • Windows - 旧版配置

此页面有帮助吗?

获取您需要的帮助
了解 RPA - 自动化课程
UiPath Community 论坛
Uipath Logo
信任与安全
© 2005-2026 UiPath。保留所有权利。