Win Get Text

Win Get Text

Tipo: win-get-text  ·  Paquete: Desktop Activities v1.0.8  ·  Salida: string

Lee el texto o valor de un elemento de una aplicación de escritorio: una etiqueta, un campo, una celda. Es la actividad clave para extraer datos de una app: un total, un estado, un resultado.

Cómo funciona

Localiza el elemento por su selector (esperando hasta timeout) y devuelve, en este orden, lo primero que el control ofrezca:

1. Su valor (patrón Value de UIA): el contenido de un campo de texto o un combo.
2. Su texto completo (patrón Text de UIA): el contenido de un documento o un área de texto enriquecido.
3. Su nombre: el texto de una etiqueta, un botón o una celda.

En aplicaciones Java el texto se lee por el puente con Swing. Solo lee: no hace clic ni trae la ventana al frente.

Parámetros requeridos

Parámetro	Tipo	Por defecto	Descripción
selector	selector	—	El elemento cuyo texto leer.

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.
timeout	number	30000	Máximo en ms a esperar el elemento. Vacío = el tiempo de espera de interfaz del proyecto o, si no lo define, 30000.

Salida

Devuelve un string con el texto o valor del elemento, tal como lo muestra la aplicación (con su formato de números y fechas). Si el control no tiene texto, devuelve vacío (o null); usa str(...) para tratarlo siempre como texto.

Errores comunes

Mensaje	Causa y solución
No se encontró el elemento con el selector {…}.	El elemento no apareció en timeout. Ver errores comunes.
No se pudo localizar el control Java sin ambigüedad, así que no se hizo nada. …	En una app Java hay varios controles iguales. Agrega un ancla o un idx al selector.

Ejemplo

Win Get Text   selector = (etiqueta "Saldo actual")   → output: saldoTexto
Set Variable   name = saldo   value = parseDouble(replace(replace(saldoTexto, "$", ""), ",", ""))

Actividades relacionadas

• Win Get Attribute — leer una propiedad concreta (enabled, checked…).
• Win Extract Table — leer una tabla completa de una vez.