Win Attach

Tipo: win-attach · Paquete: Desktop Activities v1.0.8 · Salida: ZoanDesktopSession

Se conecta a una ventana de Windows y devuelve una sesión (ZoanDesktopSession). Es el punto de partida para interactuar con una aplicación de escritorio: una vez conectado, las demás actividades actúan sobre esa ventana.

Cómo funciona

Localiza la ventana indicada por el selector (esperando hasta timeout a que exista) y abre una sesión. Del selector solo usa los nodos de ventana (wnd): si lleva también nodos de control, se ignoran, porque lo que se conecta es la ventana. Al conectarse, trae la ventana al frente (y la restaura si estaba minimizada).

Si la ventana es de una aplicación Java, conecta además el puente con Swing y espera hasta 30 s a que esté listo, para que las actividades del body vean sus controles. Si no lo logra, sigue y lo deja como advertencia en el registro.

Tienes dos modos:

Con body: las actividades dentro heredan la sesión automáticamente (no configuras session). Al terminar el body —bien o con error— la sesión se libera sola; la ventana queda abierta. En este modo la actividad no devuelve salida.
Sin body: guarda la sesión en una variable de salida; pásala como session a las demás actividades y ciérrala con Win Close.

Parámetros requeridos

Parámetro	Tipo	Por defecto	Descripción
`selector`	`selector`	—	La ventana a la que conectarse (nodo `wnd` con `process`, `title` y/o `cls`).

Parámetros opcionales

Parámetro	Tipo	Por defecto	Descripción
`timeout`	`number`	`30000`	Máximo en ms a esperar a que la ventana exista. Vacío = el tiempo de espera de interfaz del proyecto o, si no lo define, 30000.

Sub-flujos

`body`

Opcional. Actividades que se ejecutan con esta ventana; heredan la sesión. Si se omite, la sesión se devuelve como salida.

Salida

Sin body: devuelve un ZoanDesktopSession. Pásalo como session a las demás actividades de escritorio y ciérralo con Win Close.
Con body: no devuelve ningún valor.

Errores comunes

Mensaje	Causa y solución
`No se encontró el elemento con el selector {…}.` seguido de `Diagnóstico: …`	Ninguna ventana visible cumplió el selector dentro de `timeout`. Comprueba que la aplicación esté abierta (o ábrela antes con Open App) y que el título no haya cambiado; usa comodines (`Factura *`) para títulos variables.
`'selector' es obligatorio y debe ser un selector de escritorio válido.`	Falta el selector o no es de escritorio. Captúralo de nuevo con UI Discover.

Ejemplo

Win Attach   selector = (ventana "Bloc de notas")
 └─ body:
      Win Type   selector = (área de texto)   text = "Hola mundo"
      Win Key Press   keys = "ctrl+s"

Sin body, guardando la sesión para usarla en varios pasos:

Win Attach   selector = (ventana "Facturación")   → output: app
Win Type     session = app   selector = (campo "Cliente")   text = cliente
Win Click    session = app   selector = (botón "Buscar")
Win Close    session = app

Actividades relacionadas

Open App — lanzar la aplicación antes de conectarse.
Win Close — cerrar la ventana y liberar la sesión.
Win Focus — traer la ventana al frente.