Acerca de los selectores

Para automatizar acciones específicas en la interfaz de usuario, es necesario interactuar con varias ventanas, botones, listas desplegables y muchos otros. La identificación de los elementos de la interfaz de usuario se realiza, entre otras cosas, a través de su posición en la pantalla, pero esto puede ser poco fiable.

To overcome this problem, Studio uses what we call selectors. These store the attributes of a graphical user interface element and its parents, in the shape of an XML fragment.

La mayoría de las veces, los selectores son generados automáticamente por Studio y no requieren más información por tu parte, especialmente si las aplicaciones que intentas automatizar tienen una interfaz de usuario estática.

However, some software programs have changing layouts and attribute nodes with volatile values, such as some web-apps. Studio cannot predict these changes and, therefore, you might have to manually generate some selectors.

Un selector tiene la siguiente estructura:

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

El último nodo representa el elemento de GUI que le interesa y todos los anteriores representan los elementos principales de ese elemento. <node_1> generalmente se denomina nodo raíz y representa la ventana superior de la aplicación.

En cada uno de los nodos hay uno o varios atributos que le ayudan a identificar correctamente un nivel específico de la aplicación seleccionada.

Cada nodo tiene el siguiente formato: 

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

En cada atributo se asigna un valor. Es importante elegir atributos con un valor constante. Si el valor de un atributo cambia cada vez que se inicia la aplicación, el selector no podrá identificar correctamente el elemento.

Los selectores se muestran en el panel de propiedades de las actividades, en Entrada > Destino > Selector. En todas las actividades relacionadas con los elementos gráficos aparece esta propiedad.

La ventana Opciones de selección te permite seleccionar y editar un destino. Para acceder a esta ventana, en el panel del Diseñador de flujo de trabajo, haz clic en el botón Opciones en el cuerpo de una actividad y selecciona Indicar destino en pantalla o Editar destino.

La ventana de Editor de Selectores te permite ver el selector generado automáticamente y editarlo, así como sus atributos. Para acceder a esta ventana, utiliza el botón de puntos suspensivos junto al campo Selector, en el panel de propiedades.

Opción	Descripción
Validar	En este botón se muestra el estado del selector comprobando la validez de la definición del mismo y la visibilidad del elemento de destino en la pantalla. El botón Validar tiene tres estados: El selector se está validando Selector válido Selector inválido Selector modificado, revalidar El botón está relacionado con los estados de validación de UI Explorer.
Indicar elemento	Indica un nuevo elemento de la interfaz de usuario que sustituye al anterior.
Reparar	Permite volver a indicar el mismo elemento de interfaz de usuario de destino y reparar el selector. Este proceso no sustituye por completo al selector anterior. El botón está disponible solo cuando el selector no es válido.
Resaltar	Coloca el elemento de destino al primer plano. Esta opción permanece encendida hasta que se desactiva con un clic. El botón solo se habilita si el selector es válido.
Editar atributos	Incluye todos los componentes de la aplicación necesarios para identificar la actividad de destino (una ventana, un botón, etc.). Esta sección se puede editar.
Selector de edición	Contiene el selector actual. Esta sección se puede editar.
Abrir en Explorador de IU	Inicia el explorador de la interfaz de usuario. Se habilita la opción solo para los selectores válidos.

Nota: En algunos casos, cuando Studio y la aplicación de destino se abren con diferentes permisos avanzados, es posible que el selector no funcione. Se recomienda abrir siempre ambas aplicaciones con los mismos privilegios.

Etiquetas y atributos compatibles

En las siguientes tablas se presenta la compatibilidad entre las etiquetas y los atributos utilizados para construir selectores y la capacidad del selector:

Nota: Los selectores generados por aplicaciones Java con múltiples etiquetas WND no se pueden usar con supervisión de eventos.

WND

Atributo	Completo	Expresiones regulares	Sensible a las mayúsculas y minúsculas
app
cls
title
aaname
ctrlname (WinForms)
ctrlid (WinForms)
idx
tid
pid
isremoteapp
aastate
sapClient (SAP)
sapLanguage (SAP)
sapProgram (SAP)
sapScreen (SAP)
sapSession (SAP)
sapSysName (SAP)
sapSysNumber (SAP)
sapSysSessionId (SAP)
sapTransaction (SAP)
sapUser (SAP)

HTML

Atributo	Completo	Expresiones regulares	Sensible a las mayúsculas y minúsculas
url
htmlwindowname
title
class
app
idx
pid
tid
excludehwnd
bsid (Browser Session ID)
isremoteapp

WEBCTRL

Los atributos tag e idx utilizan una cadena de valores. Todos los demás atributos WEBCTRL tienen valores dinámicos.

Atributo	Completo	Expresiones regulares	Sensible a las mayúsculas y minúsculas
tag
idx
aaname
name
id
parentid
class
css-selector
innertext
visibleinnertext
isleaf
parentclass
parentname
src
href
tableCol
tableRow
colName
rowName
aria-label
aria-labelledby

CTRL

Atributo	Completo	Expresiones regulares	Sensible a las mayúsculas y minúsculas
Rol
name
automationid
labeledby
aastate
virtualname
text
rowName
idx

UIA

Atributo	Completo	Expresiones regulares	Sensible a las mayúsculas y minúsculas
accelkey (Accelerator Key)
acskey (Access Key)
automationid
cls
helpText
legacyAccHelp (Legacy Accessible Help)
enabled
kbfocus (Is Keyboard Focusable)
ispwd (Is Password)
itemstatus
itemtype
rtid (Runtime ID)
Rol
name
pid
tableRow
tableCol
rowName
colName
idx

Java

Atributo	Completo	Expresiones regulares	Sensible a las mayúsculas y minúsculas
Rol
name
virtualname
javastate
tableRow
tableCol
rowName
colName
idx

SAP

Atributo	Completo	Expresiones regulares	Sensible a las mayúsculas y minúsculas
id
leafid Dicho atributo no se expone en el panel de Atributos porque es mutuamente excluyente con el atributo id. Puedes agregar manualmente.
tableRow
tableCol
colName
relpath
itemId

Silverlight

Ten en cuenta que la etiqueta Silverlight no admite las funciones Fuzzy, RegEx y Case-Sensitive.