Win Set Value

Win Set Value

Tipo: win-set-value  ·  Paquete: Desktop Activities v1.0.8

Asigna el valor de un campo de entrada usando el patrón Value de UIA. Es similar a Win Type con method = value, pero más directo: simplemente fija el valor, sin opciones de simulación de teclado. Rápido y fiable para campos de texto estándar.

Cómo funciona

Localiza el campo por su selector, trae su ventana al frente y le asigna value convertido a texto, reemplazando el contenido actual. En el registro queda en qué campo se escribió, nunca el valor.

Hay tres controles que no aceptan un valor por UIA y que la actividad llena como lo haría una persona, comprobando después que el valor quedó:

• Selector de fecha de Windows (el DateTimePicker de aplicaciones WinForms, MFC, VB6, Delphi…): teclea día, mes y año en el orden del formato de fecha de la máquina. value puede ser una fecha, un texto yyyy-MM-dd o una fecha en el formato del equipo.
• Celda de una grilla DataGridView de WinForms: selecciona la celda, escribe el valor y lo confirma con Tab, para que la aplicación recalcule.
• Campos de aplicaciones Java: hace clic en el campo, borra su contenido (Ctrl+A, Supr) y escribe el valor con el teclado.

Parámetros requeridos

Parámetro	Tipo	Por defecto	Descripción
selector	selector	—	El campo a asignar.
value	string	—	El valor a fijar. Los números y fechas se convierten a texto; en un selector de fecha también acepta una fecha.

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

Esta actividad no devuelve ningún valor.

Errores comunes

Mensaje	Causa y solución
El elemento no admite el patrón Value.	El control no es un campo editable para UI Automation. Usa Win Type con method = simulate.
El elemento es de solo lectura.	El campo está bloqueado (por ejemplo, hasta marcar otra opción). Habilítalo primero o revisa que sea el campo correcto.
El valor no es una fecha válida. Usa yyyy-MM-dd o el formato del equipo (…).	En un selector de fecha, value no se pudo leer como fecha. Pásala como yyyy-MM-dd o como fecha.
El selector de fecha no conservó la fecha después de escribirla campo por campo.	La aplicación rechazó o cambió la fecha (fuera de rango, día no válido). Revisa el valor.
No se puede escribir un valor vacío en una celda de la grilla; …	Las celdas de grilla no se vacían escribiendo. Usa la forma propia de la aplicación (por ejemplo, la tecla Supr con Win Key Press).
No se pudo seleccionar la celda de la grilla, así que no se enviaron teclas. / La ventana de destino no está en primer plano, así que no se enviaron teclas.	La celda o la ventana no recibieron el foco. Cierra diálogos que la tapen y reintenta.
La celda de la grilla no conservó el valor escrito (la aplicación lo rechazó o lo cambió).	La validación de la aplicación rechazó el valor. Revisa el formato esperado.
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 encontró el elemento con el selector {…}.	Ver errores comunes.

Ejemplo

Win Set Value   selector = (campo "Cantidad")   value = toString(cantidad)
Win Set Value   selector = (fecha "Vencimiento")   value = "2026-12-31"

Set Value vs Type

• Win Set Value: asignación directa por patrón Value. La opción más simple y rápida.
• Win Type: también puede simular teclado (method = simulate) para campos que lo requieran, permite añadir al contenido previo (clear = false con simulate) y acepta credenciales.

Actividades relacionadas

• Win Type — escribir con opción de simular teclado.
• Win Get Text — leer el valor actual.