获取属性 (通用)

UiPath.UIAutomationNext.Activities.NGetAttributeGeneric<System.String>

描述

检索指定用户界面元素的指定属性的值，以特定字符串形式返回。

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

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

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

有关指定和配置目标的更多信息，请参阅 选择屏幕。

项目兼容性

Windows - 旧版 | Windows | 跨平台

Windows 和跨平台配置

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

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

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

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

• “属性 ” - 要检索的属性的名称。

  指定目标后，可以使用下拉菜单从可检索的属性列表中进行选择。但是，计算机视觉 AI 模型用于定位单选按钮的 checked 属性需要手动添加。

  要刷新属性列表，可以使用刷新按钮或 Ctrl + R 热键。

  注意： 活动中显示的指定属性的预览值是设计时确定的值；该值可能会在运行时更改。

属性面板

输入/输出

• “属性值” - 当前属性值的保存位置。
• “输入元素” - 要在其上执行活动的用户界面元素，存储在“用户界面元素”对象中。该字段仅支持用户界面元素对象。可以从其他用户界面自动化活动的“输出元素”属性字段中获取该对象。
• 输出元素- 输出目标用户界面元素，并将其存储在用户界面元素对象中，该对象可进一步用于使其他活动定位同一元素。

选项

• Healing Agent 模式- 根据流程或作业级别的监管或 Orchestrator 设置，配置此活动的 Healing Agent 行为。
  • 已禁用- 关闭此活动的 Healing Agent。
  • 继承作业设置- 在流程或作业级别应用在监管或 Orchestrator 中定义的设置。
  • “仅建议” - 允许 Healing Agent 提供有关如何修复正在运行的作业中的用户界面自动化问题的建议，但前提是监管或 Orchestrator 设置允许。
  • 与应用程序/浏览器相同- 从父级“使用应用程序/浏览器”活动继承配置。
• 出错时继续 - 指定在活动抛出错误时是否应继续自动化操作。该字段仅支持“布尔值”（True 和 False）。默认值为 False。因此，如果该字段为空且活动引发错误，系统将停止执行项目。如果该值设为 True，则无论出现何种错误，系统都将继续执行项目。

目标

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

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

• 定位方法 - 要用于标识元素的选取器类型。 可以将此属性设置为下拉菜单中的任意组合：
  • 无
  • 精确选取器- 为目标用户界面元素生成的精确选取器。
  • 模糊选取器- 模糊选取器参数。

  • Computer Vision - 要将 Computer Vision 用作定位方法，您需要转到“项目设置”>“Computer Vision”，并确保设置正确的服务器端点。您可以原样保留此字段，并使用 UiPath Cloud（默认情况下已填写），也可以通过选择特定于服务器区域的任何其他公共端点或您自己的本地部署服务器来输入其他值。

    将 Computer Vision 用作定位方法的另一种方法是将“使用本地服务器”设置为True 。这意味着UiPath.ComputerVision.LocalServer包已安装在项目中。启用“本地服务器”后，服务器值将被覆盖。但是，“本地服务器”在跨平台项目中不可用。

    • CV 控件类型 - 指示使用 Computer Vision 识别的控件类型。
    • 计算机视觉文本 - 表示使用 Computer Vision 识别的文本。
    • 计算机视觉文本出现次数- 当找到多个匹配项时，指示要使用的特定出现次数。
    • 计算机视觉文本准确性- 指示 OCR 文本匹配的准确性级别。
  • 语义选取器- 利用大型语言模型 (LLM) 为用户界面元素生成功能性、拟人化的描述。这些描述可靠性极高，既能适应用户界面的变更，又能在传统选取器失效时显着增强自动化弹性。
  • 图像（仅限 Windows）
    • 图像准确性- 指示图像匹配的准确性级别。
    • 图像出现次数- 当找到多个匹配项时，指示要使用的特定出现次数。
  • 原生文本（仅限 Windows）
    • 原生文本- 要查找来识别用户界面元素的文本。
    • 原生文本出现次数- 当找到多个匹配项时，指示要使用的特定出现次数。
• 窗口选取器（应用程序实例） - 应用程序窗口的选取器。仅在窗口附加模式设置为应用程序实例时可用。
• 等待页面加载- 在执行操作之前，等待应用程序做好接受输入的准备。选项包括：
  • 无- 不等待目标变为就绪状态。
  • “交互式”– 等待直到加载了应用程序的一部分。
  • “完整”– 等待整个应用程序被加载。
• 可见性检查- 启用后，该活动还会检查用户界面元素是否可见。您可以从下拉菜单中选择以下三个选项之一：
  • “无 ”- 不检查可见性。
  • 交互式（用于模糊选取器） - 默认选项。 检查元素是否可能可见，忽略页面滚动和其他应用程序的阻碍或应用程序已最小化。 当尝试确保您没有以 DOM 中存在但隐藏的不可见元素为目标时，此检查非常有用。
  • 完全可见 - 检查用户界面元素是否可见。
• 响应式网站 - 启用响应式网站布局。

计时

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

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

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

Windows - 旧版配置

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

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

  • “在屏幕上指定目标”- 再次指定目标。
  • 编辑目标 - 打开选择模式以配置目标。
  • 删除信息屏幕截图 - 删除目标应用程序或网页的屏幕截图。
  • 添加到对象存储库 - 将当前用户界面元素添加到库项目中，以便在整个自动化流程中重复使用该元素。

• “属性 ” - 要检索的属性的名称。

  指定目标后，可以使用下拉菜单从可检索的属性列表中进行选择。但是，计算机视觉 AI 模型用于定位单选按钮的 checked 属性需要手动添加。

  要刷新属性列表，可以使用刷新按钮或 Ctrl + R 热键。

  注意： 活动中显示的指定属性的预览值是设计时确定的值；该值可能会在运行时更改。
• “保存 位置”- 创建一个变量，在检索到属性后将其保存到其中。