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.

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	Descripción	Completo	Expresiones regulares	Sensible a las mayúsculas y minúsculas
app	El nombre del archivo de la aplicación que contiene el elemento de IU.
cls	Nombre de clase de la ventana que contiene el elemento de IU.
title	El título de la ventana del elemento de IU.
aaname	Nombre del elemento de IU 'Active Accessibility'.
ctrlname (WinForms)	Nombre de WinForms del elemento de IU.
ctrlid (WinForms)	ID de control de Win32 de la ventana que contiene el elemento de IU.
idx	El número de instancia del elemento de IU.
tid	ID del hilo que creó el elemento de IU.
pid	ID de proceso de la aplicación que contiene el elemento de IU.
isremoteapp
aastate	Estado de 'Active Accessibility' del elemento de IU.
sapClient (SAP)	Cliente SAP seleccionado en la pantalla de inicio de sesión.
sapLanguage (SAP)	Idioma de SAP especificado en la pantalla de inicio de sesión.
sapProgram (SAP)	Programa origen de SAP que se ejecuta actualmente.
sapScreen (SAP)	Número de pantalla de SAP actualmente mostrado.
sapSession (SAP)	Número de sesión de SAP, también se muestra en la barra de estado de SAP GUI.
sapSysName (SAP)	Nombre del sistema SAP.
sapSysNumber (SAP)	Servidor de aplicaciones SAP.
sapSysSessionId (SAP)	Todas las sesiones de GUI SAP de la misma conexión se representan en el servidor con el mismo SysSessionId.
sapTransaction (SAP)	Transacción de SAP que se está ejecutando.
sapUser (SAP)	Usuario de SAP que ha iniciado sesión en el sistema.

HTML

Atributo	Descripción	Completo	Expresiones regulares	Sensible a las mayúsculas y minúsculas
url	La URL de la página web que contiene el elemento actual.
htmlwindowname
title	El título de la ventana del elemento.
class	Nombre de clase del contexto accesible del elemento.
app	El nombre del archivo de la aplicación que contiene el elemento de la IU
idx	El número de instancia del elemento de IU.
pid	ID de proceso de la aplicación que contiene el elemento de IU.
tid	ID del hilo que creó el elemento de IU.
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	Etiqueta HTML del elemento.
idx	El número de instancia del elemento de IU.
aaname	Nombre del elemento de IU 'Active Accessibility'.
name	Propiedad de nombre del elemento de IU.
id	El identificador único del elemento de IU.
parentid	Atributo ID HTML del primer elemento antecesor que tiene ID.
class
css-selector
innertext	La propiedad de Texto interna de un elemento HTML.
visibleinnertext
isleaf
parentclass	Atributo de clase HTML del primer elemento antecesor que tiene clase.
parentname	Atributo de nombre HTML del primer elemento de IU antecesor que tiene un nombre.
src	Especifica la ubicación u origen del elemento.
href	La URL de la página a la que va el enlace.
tableCol	Número de columna de la tabla que contiene el elemento de IU.
tableRow	Número de fila de la tabla que contiene el elemento de IU.
colName	El nombre de la columna de la tabla que contiene el elemento de IU.
rowName	El nombre de la fila de la tabla que contiene el elemento de IU.
aria-label	Atributo de etiqueta aria del elemento.
aria-labelledby

CTRL

Atributo	Descripción	Completo	Expresiones regulares	Sensible a las mayúsculas y minúsculas
Rol	La propiedad de rol 'Active Accessibility' del elemento de IU.
name	Propiedad de nombre del elemento de IU.
automationid	El ID de 'Automatización de IU' del elemento de IU.
labeledby	La 'Automatización de IU' etiquetada mediante el atributo del elemento de IU.
aastate	Estado de 'Active Accessibility' del elemento de IU.
virtualname	El nombre del elemento dado por la tecnología de accesibilidad subyacente.
text	El texto del elemento de IU tal como aparece en la pantalla.
rowName	El nombre de la fila de la tabla que contiene el elemento de IU.
idx	El número de instancia del elemento de IU.

UIA

Atributo	Descripción	Completo	Expresiones regulares	Sensible a las mayúsculas y minúsculas
accelkey (Accelerator Key)
acskey (Access Key)
automationid	El ID de 'Automatización de IU' del elemento de IU.
cls	Nombre de clase de la ventana que contiene el elemento de IU.
helpText	La cadena de ayuda del elemento de IU.
legacyAccHelp (Legacy Accessible Help)
enabled
kbfocus (Is Keyboard Focusable)
ispwd (Is Password)
itemstatus
itemtype
rtid (Runtime ID)
Rol	La propiedad de rol 'Active Accessibility' del elemento de IU.
name	Propiedad de nombre del elemento de IU.
pid	ID de proceso de la aplicación que contiene el elemento de IU.
tableRow	Número de fila de la tabla que contiene el elemento de IU.
tableCol	Número de columna de la tabla que contiene el elemento de IU.
rowName	El nombre de la fila de la tabla que contiene el elemento de IU.
colName	El nombre de la columna de la tabla que contiene el elemento de IU.
idx	El número de instancia del elemento de IU.

Java

Atributo	Descripción	Completo	Expresiones regulares	Sensible a las mayúsculas y minúsculas
Rol	La propiedad de rol 'Active Accessibility' del elemento de IU.
name	Propiedad de nombre del elemento de IU.
virtualname	El nombre del elemento dado por la tecnología de accesibilidad subyacente.
javastate	El estado del elemento de IU proporcionado por 'Java Accessibility Bridge.
tableRow	Número de fila de la tabla que contiene el elemento de IU.
tableCol	Número de columna de la tabla que contiene el elemento de IU.
rowName	El nombre de la fila de la tabla que contiene el elemento de IU.
colName	El nombre de la columna de la tabla que contiene el elemento de IU.
idx	El número de instancia del elemento de IU.

SAP

Atributo	Descripción	Completo	Expresiones regulares	Sensible a las mayúsculas y minúsculas
id	El identificador único del elemento de IU.
leafid	Dicho atributo no se expone en el panel de Atributos porque es mutuamente excluyente con el atributo id. Puedes agregar manualmente.
tableRow	Número de fila de la tabla que contiene el elemento de IU.
tableCol	Número de columna de la tabla que contiene el elemento de IU.
colName	El nombre de la columna de la tabla que contiene el elemento de IU.
relpath
itemId

Silverlight

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