Studio
2023.4
False
横幅背景图像
Studio 用户指南
上次更新日期 2024年4月3日

关于选取器

要自动执行用户界面中的特定操作,您需要与各种窗口、按钮、下拉列表以及许多其他元素交互。可以识别用户界面元素的一种方法是使用它们在屏幕上的位置,但这可能不可靠。

为了解决这个问题,UiPath Studio 使用我们所称的选取器。它们以 XML 片段的形式存储图形用户界面元素及其父元素的属性。

大多数情况下,选取器是由 Studio 自动生成的,并且不需要您额外输入,特别是当您尝试自动化的应用程序具有静态用户界面时。

然而,有些软件程序的布局可以变化,且属性节点的值也不是一成不变,例如一些网页应用程序。UiPath Studio 无法预测这些更改,因此,您可能必须手动生成一些选取器。

选取器具有以下结构:

<node_1/><node_2/>...<node_N/><node_1/><node_2/>...<node_N/>

最后一个节点表示您感兴趣的图形用户界面元素,而前面的所有节点都表示该元素的父元素。<node_1> 通常称为根节点,表示应用程序的顶部窗口。

每个节点都有一个或多个属性,可以帮助您正确识别所选应用程序的特定级别。

每个节点的格式如下: 

<ui_system attr_name_1='attr_value_1' ... attr_name_N='attr_value_N'/><ui_system attr_name_1='attr_value_1' ... attr_name_N='attr_value_N'/>

每个属性都有一个赋值。重要的是选择具有常量值的属性。如果每次应用程序启动时,属性的值都会发生变化,则选取器将无法正确识别元素。

系统会在活动“属性”面板中的“输入”>“目标”>“选取器”下现实选取器。与图形元素相关的所有活动都具有此属性。



“选择选项”窗口用于选择和编辑目标。要访问此窗口,请在“工作流设计器”面板中单击“选项” 按钮,然后选择“在屏幕上指定目标”或“编辑目标”。



“选取器编辑器”窗口用于查看自动生成的选取器以及编辑该选取器及其属性。要访问此窗口,请使用省略号 按钮,该按钮位于“属性”面板中的“选取器”字段旁边。



选项

描述

验证

该按钮通过检查选取器定义的有效性以及目标元素在屏幕上的可见性来显示选取器的状态。

验证按钮具有三种状态:

  • docs image 正在验证选取器
  • docs image 有效选取器
  • docs image 无效选取器
  • docs image 修改的选取器,重新验证

该按钮与用户界面探测器验证状态相关。

指出元素

指出一个新的用户界面元素以替换前一个。

修复

使您能够重新指定相同的目标用户界面元素并修复选取器。此操作并不完全替换以前的选取器。只有在选取器无效时,该按钮才可用。

高亮显示

将目标元素置于前台。高亮显示一直持续到该选项被单击禁用为止。仅当选取器有效时才会启用该按钮。

编辑属性

包含标识目标应用程序时所需的所有应用程序组件(窗口、按钮等)。该部分可以编辑。

编辑选取器

保存实际的选取器。该部分可以编辑。

在用户界面探测器中打开

启动用户界面探测器。该选项仅对有效的选取器启用。

注意:在某些情况下,当以不同的提升权限打开 Studio 和目标应用程序时,选取器可能无法工作。我们建议始终以相同的权限打开这两个应用程序。

支持的标签和属性

下表列出了用于构建选取器和选取器功能的标记和属性之间的兼容性:

注意:为包含多个 WND 标签的 Java 应用程序生成的选取器不能与事件监控功能一起使用。

WND

属性

模糊

正则表达式

区分大小写

app

available

available

available

cls

available

available

available

title

available

available

available

aaname

available

available

available

ctrlname (WinForms)

available

available

available

ctrlid (WinForms)

available

available

available

idx

不可用

不可用

不可用

tid

不可用

不可用

不可用

pid

不可用

不可用

不可用

isremoteapp

不可用

不可用

不可用

aastate

available

available

available

sapClient (SAP)

available

available

available

sapLanguage (SAP)

available

available

available

sapProgram (SAP)

available

available

available

sapScreen (SAP)

不可用

不可用

不可用

sapSession (SAP)

不可用

不可用

不可用

sapSysName (SAP)

available

available

available

sap 系统编号 (SAP)

不可用

不可用

不可用

sapSysSessionId (SAP)

available

available

available

sapTransaction (SAP)

available

available

available

sapUser (SAP)

available

available

available

HTML

属性

模糊

正则表达式

区分大小写

url

available

available

available

htmlwindowname

available

available

available

title

available

available

available

class

available

available

available

app

不可用

不可用

不可用

idx

不可用

不可用

不可用

pid

不可用

不可用

不可用

tid

不可用

不可用

不可用

excludehwnd

不可用

不可用

不可用

bsid(浏览器会话 ID)

不可用

不可用

不可用

isremoteapp

不可用

不可用

不可用

WEBCTRL

tagidx 属性使用字符串值。所有其他 WEBCTRL 属性都具有动态值。

属性

模糊

正则表达式

区分大小写

tag

available

available

available

idx

available

available

available

aaname

available

available

available

name

available

available

available

id

available

available

available

parentid

available

available

available

class

available

available

available

css-selector

不可用

不可用

不可用

innertext

available

available

available

visibleinnertext

available

available

available

isleaf

available

available

available

parentclass

available

available

available

parentname

available

available

available

src

available

available

available

href

available

available

available

tableCol

available

available

available

tableRow

available

available

available

colName

available

available

available

rowName

available

available

available

aria-label

available

available

available

aria-labelledby

available

available

available

CTRL

属性

模糊

正则表达式

区分大小写

角色

available

available

available

name

available

available

available

automationid

available

available

available

labeledby

available

available

available

aastate

available

available

available

virtualname

available

available

available

text

available

available

available

rowName

available

available

available

idx

不可用

不可用

不可用

UIA

属性

模糊

正则表达式

区分大小写

accelkey(加速键)

available

available

available

acskey(访问密钥)

available

available

available

automationid

available

available

available

cls

available

available

available

helpText

available

available

available

legacyAccHelp(旧版辅助功能帮助)

available

available

available

enabled

available

available

available

kbfocus(键盘是否可聚焦)

available

available

available

ispwd(为密码)

available

available

available

itemstatus

available

available

available

itemtype

available

available

available

rtid(运行时 ID)

available

available

available

角色

available

available

available

name

available

available

available

pid

available

available

available

tableRow

不可用

不可用

不可用

tableCol

不可用

不可用

不可用

rowName

available

available

available

colName

available

available

available

idx

不可用

不可用

不可用

Java

属性

模糊

正则表达式

区分大小写

角色

available

available

available

name

available

available

available

virtualname

available

available

available

javastate

available

available

available

tableRow

不可用

不可用

不可用

tableCol

不可用

不可用

不可用

rowName

available

available

available

colName

available

available

available

idx

不可用

不可用

不可用

SAP

属性

模糊

正则表达式

区分大小写

id

available

available

available

leafid

“属性”面板未公开此属性,因其与“id”属性互斥。不过可以手动添加。

available

available

available

tableRow

不可用

不可用

不可用

tableCol

不可用

不可用

不可用

colName

available

available

available

relpath

available

available

available

itemId

available

available

available

Silverlight

请注意, Silverlight 标签不支持“ 模糊”、“正则 表达式”和 “区分大小写” 功能。

  • 支持的标签和属性
  • WND
  • HTML
  • WEBCTRL
  • CTRL
  • UIA
  • Java
  • SAP
  • Silverlight

此页面是否有帮助?

获取您需要的帮助
了解 RPA - 自动化课程
UiPath Community 论坛
Uipath 白色徽标
信任与安全
© 2005-2024 UiPath. All rights reserved.