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 Editor de selectores te permite ver el selector generado automáticamente y editarlo y sus atributos. Para acceder a esta ventana, utiliza el botón Elipsis junto al campo Selector , en el panel 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.

En macOS, los tipos de selector wnd, ax, java, y sap se pueden utilizar para diferentes casos de uso:

• Los selectores AX están disponibles para todos los tipos de aplicaciones de escritorio macOS.
• Los selectores de SAP están disponibles para la GUI de SAP para Java en macOS y requieren un servidor SAP con los scripts habilitados. Estos selectores son los más estables para las aplicaciones SAP y ofrecen la mejor gama de características, como extraer datos de la tabla.
• Los selectores Java están disponibles para las aplicaciones Java. Dado que la GUI de SAP para Java también es una aplicación basada en Java, se puede utilizar la estrategia de selección de Java para cambiar desde la predeterminada y obtener selectores de Java en su lugar.

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	SO
app				Ventanas macOS
cls				Ventanas
title				Ventanas macOS
aaname				Ventanas
ctrlname (WinForms)				Ventanas
ctrlid (WinForms)				Ventanas
idx				Ventanas macOS
tid				Ventanas macOS
pid				Ventanas macOS
isremoteapp				Ventanas
aastate				Ventanas
Rol				macOS
enabled				macOS
enfocado				macOS
seleccionados				macOS
Expandido				macOS
sapClient (SAP)				Ventanas macOS
sapLanguage (SAP)				Ventanas macOS
sapProgram (SAP)				Ventanas macOS
sapScreen (SAP)				Ventanas macOS
sapSession (SAP)				Ventanas macOS
sapSysName (SAP)				Ventanas macOS
sapSysNumber (SAP)				Ventanas macOS
sapSysSessionId (SAP)				Ventanas macOS
sapTransaction (SAP)				Ventanas macOS
sapUser (SAP)				Ventanas macOS
curlApplet (Curl)				Ventanas

HTML

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

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	SO
tag				Ventanas macOS Linux
idx				Ventanas macOS Linux
aaname				Ventanas macOS Linux
name				Ventanas macOS Linux
id				Ventanas macOS Linux
parentid				Ventanas macOS Linux
class				Ventanas macOS Linux
css-selector				Ventanas macOS Linux
innertext				Ventanas macOS Linux
visibleinnertext				Ventanas macOS Linux
isleaf				Ventanas macOS Linux
parentclass				Ventanas macOS Linux
parentname				Ventanas macOS Linux
src				Ventanas macOS Linux
href				Ventanas macOS Linux
tableCol				Ventanas macOS Linux
tableRow				Ventanas macOS Linux
colName				Ventanas macOS Linux
rowName				Ventanas macOS Linux
aria-label				Ventanas macOS Linux
aria-labelledby				Ventanas macOS Linux

CTRL

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

UIA

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

Java

Atributo	Completo	Expresiones regulares	Sensible a las mayúsculas y minúsculas	SO
Rol				Ventanas macOS
name				Ventanas macOS
virtualname				Ventanas macOS
javastate				Ventanas macOS
tableRow				Ventanas macOS
tableCol				Ventanas macOS
rowName				Ventanas macOS
colName				Ventanas macOS
idx				Ventanas macOS
cls				Ventanas macOS
Clase accesible				Ventanas macOS

SAP

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

AX

Atributo	Completo	Expresiones regulares	Sensible a las mayúsculas y minúsculas	SO
Rol				macOS
Subrol				macOS
name				macOS
title				macOS
Identificador				macOS
Nombre de archivo				macOS
url				macOS
Ayuda				macOS
enabled				macOS
enfocado				macOS
seleccionados				macOS
Expandido				macOS
idx				macOS
Número de filas				macOS
Número de columnas				macOS
tableRow				macOS
tableCol				macOS
rowName				macOS
colName				macOS

cURL

Atributo	Completo	Expresiones regulares	Sensible a las mayúsculas y minúsculas	SO
cls				Ventanas
Rol				Ventanas
text				Ventanas
title				Ventanas
tableRow				Ventanas
tableCol				Ventanas
colHeader				Ventanas
idx				Ventanas

Silverlight

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

Atributo	Completo	Expresiones regulares	Sensible a las mayúsculas y minúsculas	SO
Rol				Ventanas
name				Ventanas
text				Ventanas
idx				Ventanas

RDP

La etiqueta RDP se utiliza para la automatización remota y sus atributos son idénticos a los de la etiqueta WND.

Atributo	Completo	Expresiones regulares	Sensible a las mayúsculas y minúsculas	SO
app				Ventanas
cls				Ventanas
title				Ventanas
aaname				Ventanas
ctrlname (WinForms)				Ventanas
ctrlid (WinForms)				Ventanas
idx				Ventanas
tid				Ventanas
pid				Ventanas