Vista general del Designer

El Zoan Designer es la aplicación de escritorio donde diseñas tus automatizaciones, sin escribir código. En lugar de programar, arrastras actividades (bloques que hacen una acción concreta: abrir un navegador, leer un Excel, enviar un correo) a un lienzo y las configuras rellenando formularios.

Cada automatización que construyes se llama playbook: una secuencia de actividades, de arriba hacia abajo, que el Agent ejecuta paso a paso.

¿Dónde encaja el Designer?

El Designer es una de las dos aplicaciones que vienen en el instalador Zoan Platform (la otra es el Agent). En el Designer diseñas y pruebas; con el Agent y Nexus publicas y operas en producción. Si aún no lo tienes instalado, sigue Primeros pasos.

La interfaz, área por área

Al abrir un proyecto verás cinco zonas. Conviene memorizarlas porque las nombramos en toda la documentación.

#	Área	Dónde está	Para qué sirve
1	Paleta	Lateral izquierdo	Catálogo de todas las actividades disponibles, agrupadas por paquete. Las arrastras al canvas. Más →
2	Canvas	Centro	El lienzo donde armas el flujo apilando actividades. El orden visual es el orden de ejecución. Más →
3	Propiedades	Lateral derecho	Los parámetros de la actividad seleccionada. Aquí configuras cada actividad.
4	Variables	Panel inferior	Las variables del playbook actual: datos que viajan entre actividades. Más →
5	Toolbar	Barra superior	Acciones globales: guardar, ejecutar (probar local), publicar (subir a Nexus).

Paleta (1)

Lista jerárquica de paquetes y actividades. Tiene un buscador en la parte superior para filtrar por nombre. Solo aparecen los paquetes instalados. Ver Paleta de actividades.

Canvas (2)

Los nodos se apilan verticalmente; no hay flechas que conectar: el flujo va de arriba hacia abajo. Algunas actividades (como If, For Each, Try/Catch) contienen sub-flujos llamados lanes. Ver Canvas y nodos.

Propiedades (3)

Cuando seleccionas un nodo, este panel muestra sus parámetros. Cada campo acepta un valor literal o una expresión (si empieza con =). Ver Expresiones.

Variables (4)

Aquí declaras variables y ves su tipo. Una variable es el “recipiente” donde una actividad guarda su resultado para que otra lo use después. Ver Variables.

Toolbar (5)

Acción	Qué hace
Guardar	Persiste el proyecto en disco
Ejecutar	Ejecuta el playbook en tu máquina contra el Agent local, para probarlo. Ver Depuración
Publicar	Empaqueta el proyecto y lo sube a Nexus como una versión. Ver Publicar y versionar

Proyectos y playbooks

• Un proyecto es la carpeta que agrupa tu trabajo: uno o varios playbooks, más los recursos que necesiten (plantillas, datos de ejemplo).
• Un playbook es una automatización concreta dentro del proyecto.

Un proyecto puede tener varios playbooks. Uno de ellos es el principal (el que se ejecuta primero), y puedes invocar a los demás desde él con la actividad Invoke Playbook. Esto te permite reutilizar lógica y dividir automatizaciones grandes en piezas pequeñas y manejables.

Proyecto "Facturación"
├── main                 ← playbook principal
├── procesar-factura     ← se invoca desde main con Invoke Playbook
├── enviar-notificacion
└── plantillas/
    └── factura.docx     ← recurso, referenciable con asset("plantillas/factura.docx")

Divide y reutiliza

Si te encuentras copiando y pegando el mismo grupo de actividades, conviértelo en un sub-playbook e invócalo. Un cambio en un solo lugar se refleja en todos los que lo usan.

El flujo de trabajo, de principio a fin

1. Crear o abrir un proyecto desde la pantalla de inicio del Designer.
2. Arrastrar actividades desde la paleta al canvas, en el orden en que deben ejecutarse.
3. Configurar cada actividad en el panel de propiedades.
4. Declarar variables para pasar datos de una actividad a otra y capturar resultados.
5. Ejecutar localmente (botón Ejecutar) para verificar que funciona y corregir errores. Ver Depuración.
6. Publicar a Nexus (botón Publicar) con un número de versión, para poder ejecutarlo desatendido y programado. Ver Publicar y versionar.

Diseñar y operar son dos mundos

En el Designer pruebas en tu propia máquina, con el navegador visible y tú mirando. En producción, el bot se ejecuta solo, normalmente sin pantalla. Por eso conviene probar bien en el Designer antes de publicar: lo que falla en local, fallará igual (o peor) desatendido.

Siguientes pasos

• Canvas y nodos — cómo se ve y se opera el flujo.
• Paleta de actividades — encontrar la actividad que necesitas.
• Variables y Expresiones — mover y transformar datos.
• Primeros pasos — tutorial completo construyendo tu primer playbook.