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.

Para solucionar este problema, Studio recurre a lo que llamamos selectores. Estos almacenan los atributos de un elemento de la interfaz gráfica de usuario y sus matrices, en forma de fragmento XML.

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.

No obstante, en algunos programas de software existen diseños cambiantes y nodos de atributos con valores volátiles, como es el caso de algunas aplicaciones web. Studio, por su parte, no puede predecir estos cambios y, por lo tanto, es posible que tenga que generar manualmente algunos selectores.

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.

Supported tags and attributes

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	Descripción	Completo	Expresiones regulares	Sensible a las mayúsculas y 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	Descripción	Completo	Expresiones regulares	Sensible a las mayúsculas y 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

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

Atributo	Descripción	Completo	Expresiones regulares	Sensible a las mayúsculas y 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	Descripción	Completo	Expresiones regulares	Sensible a las mayúsculas y minúsculas
Rol	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	Descripción	Completo	Expresiones regulares	Sensible a las mayúsculas y 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)
Rol	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	Descripción	Completo	Expresiones regulares	Sensible a las mayúsculas y minúsculas
Rol	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	Descripción	Completo	Expresiones regulares	Sensible a las mayúsculas y minúsculas
id	The unique identifier of the UI element.
leafid	Dicho atributo no se expone en el panel de Atributos porque es mutuamente excluyente con el atributo id. Puedes agregar 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

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