Win Type

Win Type

Tipo: win-type  ·  Paquete: Desktop Activities v1.0.8

Escribe texto en un campo de entrada de una aplicación de escritorio. Es la forma de llenar formularios: usuario, contraseña, valores de búsqueda, datos de captura.

Cómo funciona

Localiza el campo por su selector, trae su ventana al frente y escribe el text según method (ver métodos de interacción):

• value (por defecto): asigna el texto por el patrón Value de UIA, de una vez. Reemplaza el contenido del campo aunque clear = false. Si el campo no admite el patrón Value o es de solo lectura para UIA, pasa solo a simular el teclado.
• simulate: enfoca el campo (en aplicaciones Java, con un clic en él), lo vacía con Ctrl+A y Supr si clear = true, y teclea el texto letra por letra. Con clear = false el texto se añade donde esté el cursor.

Los selectores de fecha de Windows y las celdas de grilla DataGridView se llenan con el teclado y se verifican, igual que en Win Set Value. En el registro queda en qué campo se escribió, nunca el texto.

Parámetros requeridos

Parámetro	Tipo	Por defecto	Descripción
selector	selector	—	El campo donde escribir.
text	string | credential	—	El texto a escribir. Acepta una credencial (credential("nombre")["campo"]) sin exponer su valor.

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.
clear	bool	true	Borrar el campo antes de escribir. Con method = value el contenido se reemplaza siempre.
method	string	value	Método: value (patrón Value de UIA, rápido) · simulate (simula pulsaciones de teclado).
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

Esta actividad no devuelve ningún valor.

Errores comunes

Mensaje	Causa y solución
El elemento está fuera del área visible y no se pudo desplazar hasta él, …	El campo 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 campos iguales; no se escribe en lo que tenga el foco. Agrega un ancla o un idx al selector.
El valor no es una fecha válida. … / El selector de fecha no conservó la fecha …	En un selector de fecha. Ver Win Set Value.
No se puede escribir un valor vacío en una celda de la grilla; … / La celda de la grilla no conservó el valor escrito …	En una celda de grilla. Ver Win Set Value.
No se encontró el elemento con el selector {…}.	Ver errores comunes.

Ejemplo

Win Type   selector = (campo "Usuario")   text = credential("erp")["user"]
Win Type   selector = (campo "Clave")     text = credential("erp")["password"]
Win Click  selector = (botón "Ingresar")

Agregar texto al final de un campo sin borrar lo que ya tiene:

Win Key Press   selector = (campo "Observaciones")   keys = "ctrl+end"
Win Type        selector = (campo "Observaciones")   text = " Revisado."   method = simulate   clear = false

¿value o simulate?

Empieza con value (por defecto): es instantáneo y seguro. Cambia a simulate si el campo necesita los eventos de cada tecla (autocompletados, máscaras de formato) o si con value el texto no “entra” correctamente.

Credenciales sin exponer

Para usuarios y contraseñas, usa credential("nombre")["campo"]: el valor nunca queda en el playbook ni en los logs. Ver Uso de credenciales.

Actividades relacionadas

• Win Set Value — asignar un valor directo (solo método Value).
• Win Key Press — enviar teclas especiales (Tab, Enter…).
• Win Get Text — leer el valor de un campo.