Sobre seletores

Para automatizar ações específicas na interface do usuário, é necessário interagir com diversas janelas, botões, listas suspensas, entre outros. Uma das maneiras em que os elementos de interface gráfica podem ser identificados é usar sua posição na tela, mas isso pode não ser confiável.

Para superar esse problema, o Studio usa o que chamamos de seletores. Eles armazenam os atributos de um elemento da interface gráfica e seus pais, na forma de um fragmento XML.

Na maioria das vezes, os seletores são gerados automaticamente pelo Studio e não requerem mais nenhuma entrada sua, especialmente se os aplicativos que você estiver tentando automatizar tiverem uma interface de usuário estática.

No entanto, alguns softwares possuem layouts que se modificam e atribuem nós com valores voláteis, como alguns aplicativos web. O Studio não pode prever essas alterações e, portanto, você pode ter que gerar manualmente alguns seletores.

Um seletor tem a seguinte estrutura:

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

O último nó representa o elemento GUI que interessa a você e todos os anteriores representam os pais desse elemento. <node_1> geralmente é referido como um nó raiz, e representa a janela superior do aplicativo.

Cada nó contém um ou mais atributos que ajudam a identificar um nível específico do aplicativo selecionado.

Cada nó tem o seguinte formato: 

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

Cada atributo tem um valor atribuído. É importante escolher atributos com um valor constante. Se o valor de um atributo mudar a cada vez que o aplicativo for iniciado, o seletor não conseguirá identificar corretamente o elemento.

Os seletores são exibidos no painel Propriedades de atividades, em Entrada > Destino > Seletor. Todas as atividades relacionadas aos elementos gráficos têm essa propriedade.

A janela Opções de seleção permite selecionar e editar um destino. Para acessar essa janela, no painel Designer de Fluxo de Trabalho, clique no botão Opções no corpo de uma atividade e selecione Indicar destino na tela ou Editar destino.

A janela Editor de Seletor permite que você veja o seletor gerado automaticamente, edite-o e seus atributos. Para acessar essa janela, use o botão Reticências próximo ao campo Seletor, no painel Propriedades.

Opção	Description
Validar	O botão mostra o status do seletor, verificando a validade da definição do seletor e a visibilidade do elemento de destino na tela. O botão Validar possui três estados: O seletor está sendo validado Seletor válido Seletor inválido Seletor alterado, revalidar O botão está correlacionado aos estados de validação do UI Explore.
Indicar Elemento	Indica um novo elemento da interface gráfica para substituir o anterior.
Reparar	Permite que você indique novamente o mesmo elemento de interface gráfica de destino e repare o seletor. Essa operação não substitui completamente o seletor anterior. O botão fica disponível apenas quando o seletor for inválido.
Highlight	Traz o elemento de destino para o primeiro plano. O destaque continua até que a opção seja desabilitada com um clique. O botão será habilitado apenas se o seletor for válido.
Editar Atributos	Contém todos os componentes da aplicação necessários para identificar a aplicação de destino (uma janela, botão, etc.). Esta seção é editável.
Editar Seletor	Contém o seletor real. Esta seção é editável.
Abrir no Explorador de Interface Gráfica	Inicia o UI Explorer. A opção fica habilitada apenas para seletores válidos.

Observação: em algumas situações, quando o Studio e o aplicativo de destino são abertos com diferentes privilégios elevados, o seletor pode não funcionar. Recomendamos sempre abrir os dois aplicativos com os mesmos privilégios.

Supported tags and attributes

As seguintes tabelas apresentam a compatibilidade entre tags e atributos utilizados para criar seletores e a capacidade dos seletores:

Observação: os seletores gerados para aplicativos Java que contêm várias tags WND não podem ser usados com monitoramento de eventos.

WND

Atributo	Description	Fuzzy	RegEx	Diferenciação de maiúsculas e minúsculas
app	The file name of the application containing the UI element.
cls	Class name of the window containing the UI element.
title	The window title of the UI element.
aaname	'Active Accessibility' name of the UI element.
ctrlname (WinForms)	WinForms name of the UI element.
ctrlid (WinForms)	Win32 control ID of the window containing the UI element.
idx	The instance number of the UI element.
tid	ID of the thread that created the UI element.
pid	Process ID of the application containing the UI element.
isremoteapp
aastate	'Active Accessibility' state of the UI element.
sapClient (SAP)	SAP Client selected on the login screen.
sapLanguage (SAP)	SAP Language specified on the login screen.
sapProgram (SAP)	SAP source program that is currently being executed.
sapScreen (SAP)	SAP Screen number currently displayed.
sapSession (SAP)	SAP Session Number, also displayed in SAP GUI statusbar.
sapSysName (SAP)	SAP System Name.
sapSysNumber (SAP)	SAP Application server.
sapSysSessionId (SAP)	All SAP GUI sessions of the same connection are represented on the server with the same SysSessionId.
sapTransaction (SAP)	SAP Transaction that is currently being executed.
sapUser (SAP)	SAP User logged into the system.

HTML

Atributo	Description	Fuzzy	RegEx	Diferenciação de maiúsculas e minúsculas
url	The URL of the web page containing the current element.
htmlwindowname
title	The window title of the element.
class	Class name of the accessible context of the element.
app	The file name of the application containing the UI element
idx	The instance number of the UI element.
pid	Process ID of the application containing the UI element.
tid	ID of the thread that created the UI element.
excludehwnd
bsid (Browser Session ID)
isremoteapp

WEBCTRL

Os atributos tag e id usam valores de strings. Todos os outros atributos WEBCTRL têm valores dinâmicos.

Atributo	Description	Fuzzy	RegEx	Diferenciação de maiúsculas e minúsculas
tag	HTML tag of the element.
idx	The instance number of the UI element.
aaname	'Active Accessibility' name of the UI element.
name	Name property of the UI element.
id	The unique identifier of the UI element.
parentid	HTML ID attribute of the fist ancestor element that have ID.
class
css-selector
innertext	The innerText property of a HTML element.
visibleinnertext
isleaf
parentclass	HTML class attribute of the fist ancestor element that has class.
parentname	HTML name attribute of the fist ancestor UI element that has a name.
src	Specifies the location, or source of the element.
href	The URL of the page the link goes to.
tableCol	Table column number that contains the UI element.
tableRow	Table row number that contains the UI element.
colName	The name of the table column that contains the UI element.
rowName	The name of the table row that contains the UI element.
aria-label	Aria label attribute of the element.
aria-labelledby

CTRL

Atributo	Description	Fuzzy	RegEx	Diferenciação de maiúsculas e minúsculas
Role	The 'Active Accessibility' role property of the UI element.
name	Name property of the UI element.
automationid	The 'UI Automation' ID of the UI element.
labeledby	The 'UI Automation' labeled by attribute of the UI element.
aastate	'Active Accessibility' state of the UI element.
virtualname	The name of the element given by the underlying accessibility technology.
text	The text of the UI element as it appears on the screen.
rowName	The name of the table row that contains the UI element.
idx	The instance number of the UI element.

UIA

Atributo	Description	Fuzzy	RegEx	Diferenciação de maiúsculas e minúsculas
accelkey (Accelerator Key)
acskey (Access Key)
automationid	The 'UI Automation' ID of the UI element.
cls	Class name of the window containing the UI element.
helpText	The help string of the UI element.
legacyAccHelp (Legacy Accessible Help)
enabled
kbfocus (Is Keyboard Focusable)
ispwd (Is Password)
itemstatus
itemtype
rtid (Runtime ID)
Role	The 'Active Accessibility' role property of the UI element.
name	Name property of the UI element.
pid	Process ID of the application containing the UI element.
tableRow	Table row number that contains the UI element.
tableCol	Table column number that contains the UI element.
rowName	The name of the table row that contains the UI element.
colName	The name of the table column that contains the UI element.
idx	The instance number of the UI element.

Java

Atributo	Description	Fuzzy	RegEx	Diferenciação de maiúsculas e minúsculas
Role	The 'Active Accessibility' role property of the UI element.
name	Name property of the UI element.
virtualname	The name of the element given by the underlying accessibility technology.
javastate	The state of the UI element as provided by 'Java Accessibility Bridge.
tableRow	Table row number that contains the UI element.
tableCol	Table column number that contains the UI element.
rowName	The name of the table row that contains the UI element.
colName	The name of the table column that contains the UI element.
idx	The instance number of the UI element.

SAP

Atributo	Description	Fuzzy	RegEx	Diferenciação de maiúsculas e minúsculas
id	The unique identifier of the UI element.
leafid	Esse atributo não fica exposto no painel Atributo porque é mutuamente exclusivo com o atributo id. Ele pode ser adicionado manualmente.
tableRow	Table row number that contains the UI element.
tableCol	Table column number that contains the UI element.
colName	The name of the table column that contains the UI element.
relpath
itemId

Silverlight

Observe que a tag Silverlight não é compatível com os recursos Fuzzy, RegEx e Diferenciação de maiúsculas e minúsculas.