Win Select

Tipo: win-select · Paquete: Desktop Activities v1.0.9

Selecciona un ítem de un ComboBox (lista desplegable) o lista de una aplicación de escritorio, por su texto o por su índice (posición).

Cómo funciona

Localiza el control por su selector, trae su ventana al frente, lo abre si es desplegable y busca el ítem así:

Si item es un número entero que corresponde a una posición existente (desde 0), elige el ítem de esa posición.
Si no, el ítem cuyo texto sea igual a item, sin distinguir mayúsculas.
Si no hay uno igual, el primero que coincida como patrón: comodines * y ? (Bodega *) o expresión regular entre barras (/^Bod/).

Luego lo selecciona (con el patrón de selección de UIA o, si el ítem no lo admite, con un clic), cierra el desplegable y comprueba que el control quedó con ese ítem. Si no quedó, lo intenta de nuevo con un clic en el ítem y, si aún no coincide, la actividad falla diciendo qué se pidió y qué quedó: nunca sigue con otro valor. El desplegable queda cerrado también cuando la actividad falla, así que lo que haga la actividad siguiente con el teclado no cambia la selección. Desde la versión 1.0.9.

En aplicaciones Java (Swing) la selección se hace por el puente con Swing: abre el combo, espera loadWait ms a que carguen sus opciones y elige la que coincida con item.

Parámetros requeridos

Parámetro	Tipo	Por defecto	Descripción
`selector`	`selector`	—	El ComboBox o lista.
`item`	`string \| int`	—	Texto (admite comodines o `/regex/`) o posición (desde 0) del ítem a seleccionar.

Parámetros opcionales

Parámetro	Tipo	Por defecto	Descripción
`session`	`ZoanDesktopSession`	—	Sesión de Win Attach. Dentro de un `body` se toma sola; sin sesión, el selector debe incluir la ventana.
`loadWait`	`int`	`700`	Ms a esperar tras abrir el combo para que carguen sus opciones (combos que las traen de una base de datos al abrirse). En las demás aplicaciones es el máximo que se espera a que aparezcan las opciones después de abrir el combo (desde la versión 1.0.9).
`timeout`	`number`	`30000`	Máximo en ms a esperar el control. Vacío = el tiempo de espera de interfaz del proyecto o, si no lo define, 30000.

Salida

Esta actividad no devuelve ningún valor.

Errores comunes

Mensaje	Causa y solución
`No se encontró el elemento entre los … elemento(s) de la lista.`	Ningún ítem coincide con `item`. Revisa el texto exacto con Win List Items o usa un comodín. Si el número es `0`, la lista aún no había cargado sus opciones.
`Se pidió «…», pero el control quedó con «…» después de seleccionarlo.`	La aplicación no dejó el ítem seleccionado (lo revierte, lo valida o el combo no responde a la selección). Revisa si el valor está permitido en ese momento del formulario; el mensaje dice qué quedó. Desde la versión 1.0.9.
`No se encontró el elemento entre los … elemento(s) disponibles.`	Lo mismo, en un combo de una aplicación Java. Si las opciones cargan despacio, sube `loadWait`.
`El elemento está fuera del área visible y no se pudo desplazar hasta él, …`	El combo está oculto por el desplazamiento de su contenedor. Agrega un Win Scroll antes.
`No se pudo localizar el control Java sin ambigüedad, así que no se hizo nada. …`	En una app Java hay varios combos iguales. Agrega un ancla o un `idx` al selector.
`No se encontró el elemento con el selector {…}.`	Ver errores comunes.

Ejemplo

Win Select   selector = (combo "Ciudad")   item = "Bogotá"      // por texto
Win Select   selector = (combo "Tipo")     item = 0             // primer ítem (por índice)
Win Select   selector = (combo "Bodega")   item = "Bodega *"    // el primero que empiece por "Bodega "

Actividades relacionadas

Win List Items — ver qué opciones tiene el combo.
Win Get Text — leer la opción seleccionada.