Vista general del Designer

El Zoan Designer es la aplicación de escritorio donde diseñas tus automatizaciones. Arrastras actividades (bloques que hacen una acción concreta: abrir un navegador, leer un Excel, enviar un correo) a un lienzo y las configuras en un panel de propiedades.

Cada automatización que construyes se llama playbook: una secuencia de actividades, de arriba hacia abajo, que el robot 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, depuras y publicas; con el Agent y Zoan Cloud 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. Las nombramos así en toda la documentación.

#	Área	Dónde está	Para qué sirve
1	Panel izquierdo	Junto al riel, a la izquierda	Una vista a la vez, elegida en el riel: Esquema, Actividades (la paleta) o Proyecto. Más →
2	Lienzo	Centro	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, con su ayuda. Más →
4	Panel inferior	Bajo el lienzo	Pestañas Problemas, Consola, Variables, Argumentos, Pila de llamadas y Puntos de interrupción.
5	Barra superior	Arriba	Grabar, Depurar, Ejecutar y Publicar, la paleta de comandos (Ctrl+K) y tu cuenta de Zoan Cloud.

El riel y el panel izquierdo (1)

El riel, en el borde izquierdo, muestra cada vista con su icono y su nombre. Pulsar la vista activa oculta el panel y deja más espacio al lienzo.

Vista	Qué muestra
Esquema	El árbol numerado del playbook, con los mismos números que el lienzo. Los botones 1 · 2 · 3 · 4 pliegan hasta ese nivel y los pasos con error llevan un punto rojo (el riel también).
Actividades	La paleta: todas las actividades instaladas, agrupadas por paquete, con Recientes y Favoritas arriba. Ver Paleta de actividades.
Proyecto	Los archivos del proyecto: playbooks, datos y recursos. Desde aquí abres, renombras, duplicas o excluyes archivos del paquete, y arrastras un playbook al lienzo para invocarlo.
Paquetes	Abre el Gestor de paquetes para instalar o actualizar paquetes de actividades. Un contador avisa cuando hay versiones nuevas.
Ajustes	Abre la Configuración del Designer: idioma, editor, sesión de Zoan Cloud y atajos de teclado.

Lienzo (2)

Las actividades se apilan verticalmente sobre una línea que las une; no hay flechas que conectar. Algunas actividades (If, For Each, Try Catch…) contienen carriles con sus propios pasos: Cuerpo, Entonces, Si no, Intentar, Capturar, Finalmente. Sobre el lienzo, una fila de pestañas muestra los playbooks abiertos y, a la derecha, las acciones de edición (nuevo playbook, guardar, deshacer, rehacer, cortar, copiar, pegar), el recuento de actividades y la escala. Ver Canvas y nodos.

Propiedades (3)

Al seleccionar una actividad, este panel muestra su nombre, su descripción y sus parámetros agrupados por sección, con la salida (Guardar resultado en) al final. El icono ? junto al nombre abre la página de esa actividad en esta documentación. Cada campo con ƒx acepta una expresión. Mientras depuras, la cabecera suma Inspección y Locales para ver valores.

Panel inferior (4)

Pestaña	Para qué
Problemas	Errores y avisos del playbook en vivo, sin ejecutar. Un clic lleva a la actividad y al campo.
Consola	Lo que pasa al ejecutar: mensajes de Log, errores y duración.
Variables	Las variables del playbook, con su tipo y valor inicial. Ver Variables.
Argumentos	Las entradas y salidas del playbook.
Pila de llamadas	Dónde está detenida la ejecución al depurar.
Puntos de interrupción	Todos los del proyecto.

Ctrl+J pliega o despliega el panel.

Barra superior (5)

Acción	Qué hace
Menú ☰	Los menús Archivo, Editar, Ver, Depurar, Herramientas y Ayuda. Alt lo abre.
Nombre del proyecto	Cambia de proyecto, abre uno reciente o las propiedades del proyecto.
Paleta de comandos (Ctrl+K)	Busca comandos, actividades (las añade tras la seleccionada) y archivos. También acepta un error pegado o el id de una ejecución de Zoan Cloud para ir a la actividad que falló.
Grabar	Convierte en actividades lo que haces en el navegador o en una aplicación de escritorio. Ver UI Discover.
Depurar (F6) / Ejecutar (F5)	Ejecutan el playbook en tu máquina. Ver Depuración.
Publicar	Sube el proyecto a Zoan Cloud como una versión nueva, o lo guarda como archivo .zoan. Ver Publicar y versionar.

La barra de estado, abajo, muestra el modo (Diseño, Ejecutando, En pausa), la actividad seleccionada, la conexión de la extensión Discover, el recuento de errores y avisos (un clic abre Problemas) y el ambiente de Zoan Cloud (un clic lo cambia).

Tu sesión de Zoan Cloud

Para publicar, depurar contra Zoan Cloud y usar sus colas, credenciales y procesos, pulsa Iniciar sesión en Zoan Cloud en la barra superior. El Designer abre el navegador en Autorizar Zoan Designer. Entras como en el portal (con tu contraseña, el doble factor o el inicio de sesión único de tu organización) y vuelves a la app. El Designer nunca ve tu contraseña.

Desde la versión 1.2.30, Zoan Designer y Zoan Agent comparten tu sesión en el equipo:

• Si ya iniciaste sesión en Zoan Agent con el mismo Zoan Cloud, el Designer entra con esa sesión sin abrir el navegador.
• Si el Designer está abierto cuando inicias o cierras sesión en Zoan Agent, se pone al día solo, sin reiniciarlo.
• Cerrar sesión en el Designer cierra la sesión también en Zoan Agent y en Zoan Cloud.
• Cada Zoan Cloud (cada dirección u organización) tiene su propia sesión: si el Designer y el Agent usan Zoan Cloud distintos, no se mezclan.
• La sesión se guarda cifrada y solo la puede abrir tu usuario de Windows. En un servidor con varias personas conectadas, cada una tiene la suya.

Al actualizar a esta versión, la sesión que ya tenías se conserva: no hace falta volver a iniciarla.

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, Config.xlsx).
• Un playbook es una automatización concreta dentro del proyecto (un archivo .play en la carpeta playbooks).

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

Proyecto "Facturación"
├── playbooks/
│   ├── main.play             ← playbook principal
│   ├── ProcesarFactura.play  ← se invoca desde main con Invoke Playbook
│   └── EnviarNotificacion.play
└── 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 playbook aparte 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

flowchart LR
  A[Crear o abrir proyecto] --> B[Añadir actividades] --> C[Configurar propiedades] --> D[Declarar variables] --> E[Ejecutar y depurar] --> F[Publicar a Zoan Cloud]
  E -. corregir .-> B

1. Crear o abrir un proyecto desde la pantalla de inicio, en blanco o desde una plantilla con el manejo de errores ya resuelto.
2. Añadir actividades desde la paleta (arrastrando) o con Ctrl+K, 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 o depurar para verificar que funciona. El panel Problemas te avisa antes de ejecutar de lo que fallaría. Ver Depuración.
6. Publicar a Zoan Cloud con un número de versión, para ejecutarlo desatendido y programado. Antes de subir, el Designer comprueba que cada actividad exista en la versión publicada de su paquete. Ver Publicar y versionar.

Diseñar y operar

En el Designer pruebas en tu propia máquina, con el navegador visible y tú mirando. En producción, el robot se ejecuta solo, a menudo sin pantalla. Probar bien en el Designer antes de publicar te ahorra diagnosticar en producción.

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.