UiPath Studio

UiPath Studio 指南

关于选取器

要自动化用户界面中的特定操作,您需要与各种窗口、按钮、下拉列表和许多其他用户界面进行交互。大多数 RPA 产品通过依赖用户界面元素的屏幕位置来实现这一点,这种方法根本不可靠。

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

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

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

选取器具有以下结构:

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

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

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

每个节点的格式如下:

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

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

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

The Selector Editor window enables you to see the automatically-generated selector and edit it and its attributes. To access this window, in the Workflow Designer panel, click the Options Options button button in the body of an activity and select Edit Selector.

This can also be done by using the Ellipsis 图像替代文本 button next to the Selector field, in the Properties panel.

选项
描述

验证

The button shows the status of the selector by checking the validity of the selector definition and the visibility of the target element on the screen.
The Validate button has three states:
图像替代文本 Selector is being validated
图像替代文本 Valid selector
图像替代文本 Invalid selector
图像替代文本 Modified selector, revalidate

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

指出元素

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

修复

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

Highlight

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

编辑属性

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

编辑选取器

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

在用户界面探测器中打开

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

Note:

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

Supported Tags and Attributes

The following tables present the compatibility between tags and attributes used to build selectors and the selector capability:

Note:

Selectors generated for Java applications which contain multiple WND tags cannot be used with events monitoring.

WND

属性
Fuzzy
RegEx
Case-Sensitive

app

check_mark

check_mark

check_mark

cls

check_mark

check_mark

check_mark

title

check_mark

check_mark

check_mark

aaname

check_mark

check_mark

check_mark

ctrlname (WinForms)

check_mark

check_mark

check_mark

ctrlid (WinForms)

check_mark

check_mark

check_mark

idx

no_right

no_right

no_right

tid

no_right

no_right

no_right

pid

no_right

no_right

no_right

isremoteapp

no_right

no_right

no_right

aastate

check_mark

check_mark

check_mark

sapClient (SAP)

check_mark

check_mark

check_mark

sapLanguage (SAP)

check_mark

check_mark

check_mark

sapProgram (SAP)

check_mark

check_mark

check_mark

sapScreen (SAP)

no_right

no_right

no_right

sapSession (SAP)

no_right

no_right

no_right

sapSysName (SAP)

check_mark

check_mark

check_mark

sapSysNumber (SAP)

no_right

no_right

no_right

sapSysSessionId (SAP)

check_mark

check_mark

check_mark

sapTransaction (SAP)

check_mark

check_mark

check_mark

sapUser (SAP)

check_mark

check_mark

check_mark

HTML

属性
Fuzzy
RegEx
Case-Sensitive

url

check_mark

check_mark

check_mark

htmlwindowname

check_mark

check_mark

check_mark

title

check_mark

check_mark

check_mark

app

no_right

no_right

no_right

idx

no_right

no_right

no_right

pid

no_right

no_right

no_right

tid

no_right

no_right

no_right

excludehwnd

no_right

no_right

no_right

bsid (Browser Session ID)

no_right

no_right

no_right

isremoteapp

no_right

no_right

no_right

WEBCTRL

The tag and idx attributes use string values. All other WEBCTRL attributes have dynamic values.

属性
Fuzzy
RegEx
Case-Sensitive

tag

no_right

no_right

no_right

idx

check_mark

check_mark

check_mark

aaname

check_mark

check_mark

check_mark

name

check_mark

check_mark

check_mark

id

check_mark

check_mark

check_mark

parentid

check_mark

check_mark

check_mark

class

check_mark

check_mark

check_mark

css-selector

no_right

no_right

no_right

innertext

check_mark

check_mark

check_mark

isleaf

check_mark

check_mark

check_mark

parentclass

check_mark

check_mark

check_mark

parentname

check_mark

check_mark

check_mark

title

check_mark

check_mark

check_mark

src

check_mark

check_mark

check_mark

href

check_mark

check_mark

check_mark

tableCol

check_mark

check_mark

check_mark

tableRow

check_mark

check_mark

check_mark

colName

check_mark

check_mark

check_mark

rowName

check_mark

check_mark

check_mark

CTRL

属性
Fuzzy
RegEx
Case-Sensitive

role

check_mark

check_mark

check_mark

name

check_mark

check_mark

check_mark

automationid

check_mark

check_mark

check_mark

labeledby

check_mark

check_mark

check_mark

aastate

check_mark

check_mark

check_mark

virtualname

check_mark

check_mark

check_mark

text

check_mark

check_mark

check_mark

rowName

check_mark

check_mark

check_mark

idx

no_right

no_right

no_right

UIA

属性
Fuzzy
RegEx
Case-Sensitive

accelkey (Accelerator Key)

check_mark

check_mark

check_mark

acskey (Access Key)

check_mark

check_mark

check_mark

automationid

check_mark

check_mark

check_mark

cls

check_mark

check_mark

check_mark

helpText

check_mark

check_mark

check_mark

legacyAccHelp (Legacy Accessible Help)

check_mark

check_mark

check_mark

enabled

check_mark

check_mark

check_mark

kbfocus (Is Keyboard Focusable)

check_mark

check_mark

check_mark

ispwd (Is Password)

check_mark

check_mark

check_mark

itemstatus

check_mark

check_mark

check_mark

itemtype

check_mark

check_mark

check_mark

rtid (Runtime ID)

check_mark

check_mark

check_mark

role

check_mark

check_mark

check_mark

name

check_mark

check_mark

check_mark

pid

check_mark

check_mark

check_mark

tableRow

no_right

no_right

no_right

tableCol

no_right

no_right

no_right

rowName

check_mark

check_mark

check_mark

colName

check_mark

check_mark

check_mark

idx

no_right

no_right

no_right

Java

属性
Fuzzy
RegEx
Case-Sensitive

role

check_mark

check_mark

check_mark

name

check_mark

check_mark

check_mark

virtualname

check_mark

check_mark

check_mark

javastate

check_mark

check_mark

check_mark

tableRow

no_right

no_right

no_right

tableCol

no_right

no_right

no_right

rowName

check_mark

check_mark

check_mark

colName

check_mark

check_mark

check_mark

idx

no_right

no_right

no_right

SAP

属性
Fuzzy
RegEx
Case-Sensitive

id

check_mark

check_mark

check_mark

leafid
This attribute is not exposed in the Attribute panel because it is mutual-exclusive with the id attribute. It can be added manually.

check_mark

check_mark

check_mark

tableRow

no_right

no_right

no_right

tableCol

no_right

no_right

no_right

colName

check_mark

check_mark

check_mark

relpath

check_mark

check_mark

check_mark

itemId

check_mark

check_mark

check_mark

Silverlight

Please note that the Silverlight tag does not support Fuzzy, RegEx, and Case-Sensitive capabilities.

Updated 11 days ago



关于选取器


Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.