Acerca de los selectores

Selectores en Automatización de IU: cómo identifican los elementos de la IU, la estructura de las etiquetas, los tipos de atributos y las mejores prácticas.

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 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:

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

WND

Atributo	Completo	Expresiones regulares	Sensible a las mayúsculas y minúsculas	SO
app	✅	✅	✅	Windows macOS
cls	✅	✅	✅	Ventanas
title	✅	✅	✅	Windows macOS
aaname	✅	✅	✅	Ventanas
ctrlname (WinForms)	✅	✅	✅	Ventanas
ctrlid (WinForms)	✅	✅	✅	Ventanas
idx	❌	❌	❌	Windows macOS
tid	❌	❌	❌	Windows macOS
pid	❌	❌	❌	Windows macOS
isremoteapp	❌	❌	❌	Ventanas
aastate	✅	✅	✅	Ventanas
Rol	✅	✅	✅	macOS
enabled	✅	✅	✅	macOS
enfocado	✅	✅	✅	macOS
seleccionados	✅	✅	✅	macOS
Expandido	✅	✅	✅	macOS
sapClient (SAP)	✅	✅	✅	Windows macOS
sapLanguage (SAP)	✅	✅	✅	Windows macOS
sapProgram (SAP)	✅	✅	✅	Windows macOS
sapScreen (SAP)	❌	❌	❌	Windows macOS
sapSession (SAP)	❌	❌	❌	Windows macOS
sapSysName (SAP)	✅	✅	✅	Windows macOS
sapSysNumber (SAP)	❌	❌	❌	Windows macOS
sapSysSessionId (SAP)	✅	✅	✅	Windows macOS
sapTransaction (SAP)	✅	✅	✅	Windows macOS
sapUser (SAP)	✅	✅	✅	Windows macOS
curlApplet (Curl)	✅	✅	✅	Ventanas

HTML

Atributo	Completo	Expresiones regulares	Sensible a las mayúsculas y minúsculas	SO
url	✅	✅	✅	Windows macOS Linux
htmlwindowname	✅	✅	✅	Windows macOS Linux
title	✅	✅	✅	Windows macOS Linux
class	✅	✅	✅	Windows macOS Linux
app	❌	❌	❌	Windows macOS Linux
idx	❌	❌	❌	Windows macOS Linux
pid	❌	❌	❌	Windows macOS Linux
tid	❌	❌	❌	Windows macOS Linux
excludehwnd	❌	❌	❌	Windows macOS Linux
bsid (Browser Session ID)	❌	❌	❌	Windows macOS Linux
isremoteapp	❌	❌	❌	Windows 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	✅	✅	✅	Windows macOS Linux
idx	❌	❌	❌	Windows macOS Linux
aaname	✅	✅	✅	Windows macOS Linux
name	✅	✅	✅	Windows macOS Linux
id	✅	✅	✅	Windows macOS Linux
parentid	✅	✅	✅	Windows macOS Linux
class	✅	✅	✅	Windows macOS Linux
css-selector	❌	❌	❌	Windows macOS Linux
innertext	✅	✅	✅	Windows macOS Linux
visibleinnertext	✅	✅	✅	Windows macOS Linux
isleaf	✅	✅	✅	Windows macOS Linux
parentclass	✅	✅	✅	Windows macOS Linux
parentname	✅	✅	✅	Windows macOS Linux
src	✅	✅	✅	Windows macOS Linux
href	✅	✅	✅	Windows macOS Linux
tableCol	✅	✅	✅	Windows macOS Linux
tableRow	✅	✅	✅	Windows macOS Linux
colName	✅	✅	✅	Windows macOS Linux
rowName	✅	✅	✅	Windows macOS Linux
aria-label	✅	✅	✅	Windows macOS Linux
aria-labelledby	✅	✅	✅	Windows 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	✅	✅	✅	Windows macOS
name	✅	✅	✅	Windows macOS
virtualname	✅	✅	✅	Windows macOS
javastate	✅	✅	✅	Windows macOS
tableRow	❌	❌	❌	Windows macOS
tableCol	❌	❌	❌	Windows macOS
rowName	✅	✅	✅	Windows macOS
colName	✅	✅	✅	Windows macOS
idx	❌	❌	❌	Windows macOS
cls	✅	✅	✅	Windows macOS
Clase accesible	✅	✅	✅	Windows macOS

SAP

Atributo	Completo	Expresiones regulares	Sensible a las mayúsculas y minúsculas	SO
id	✅	✅	✅	Windows macOS
IDDeLaHoja Este atributo no se expone en el panel Atributo porque es mutuamente excluyente con el atributo id . Se puede añadir manualmente.	✅	✅	✅	Windows macOS
idx	❌	❌	❌	Windows macOS
text	✅	✅	✅	Windows macOS
Información sobre herramientas	✅	✅	✅	Windows macOS
Tipo	✅	✅	✅	Windows macOS
tableRow	❌	❌	❌	Windows macOS
tableCol	❌	❌	❌	Windows macOS
colName	✅	✅	✅	Windows macOS
Información sobre herramientas de columna	✅	✅	✅	Windows macOS
relpath	✅	✅	✅	Windows macOS
itemId	✅	✅	✅	Windows 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 es compatible con las capacidades 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