Paleta de actividades

La paleta es el panel del lateral izquierdo del Designer. Es tu catálogo: contiene todas las actividades que puedes usar, agrupadas por paquete. Construir un playbook consiste, en buena parte, en encontrar la actividad correcta aquí y arrastrarla al canvas.

Qué es una actividad

Una actividad es el bloque mínimo de trabajo: hace una acción concreta. Por ejemplo:

• Open Browser abre un navegador.
• Excel Read Range lee un rango de celdas.
• SMTP Send envía un correo.
• If decide entre dos caminos.

Cada actividad tiene un título visible (ej. “Open Browser”) y un tipo técnico (ej. browser-open). En la documentación verás ambos; en la paleta buscas por cualquiera de los dos.

Buscar una actividad

En la parte superior de la paleta hay un buscador. Empieza a escribir y la lista se filtra en vivo, mientras tecleas, por nombre o por tipo:

• Escribe excel → ves todas las actividades del paquete Excel.
• Escribe read → ves todas las actividades de lectura de cualquier paquete (Excel Read Range, Read CSV, Read File, Read JSON…).
• Escribe browser-open → encuentras la actividad por su tipo técnico exacto.

¿No sabes qué actividad necesitas?

Piensa en el verbo (abrir, leer, escribir, enviar, hacer clic) y en el sistema (Excel, navegador, correo). Busca por cualquiera de los dos. El catálogo de actividades de esta documentación agrupa todo por paquete con una descripción de cada una.

Organización por paquete

Las actividades están agrupadas en paquetes, cada uno con su icono y color:

Paquete	Para qué sirve
Core	Lógica del flujo: variables, condiciones, bucles, logs, manejo de errores
Browser	Automatización web (Chrome/Edge): navegar, clic, llenar formularios, extraer datos
Desktop	Automatización de aplicaciones de escritorio Windows
Excel / Word	Documentos de Office
Files	Archivos y carpetas
Data Table	Manipulación de tablas de datos
HTTP / Database / SFTP	Integraciones con APIs, bases de datos y servidores
Outlook / SMTP	Correo electrónico
PDF / OCR	Documentos PDF y reconocimiento de texto en imágenes

El catálogo completo, con cada actividad documentada, está en Actividades.

Haz clic en el nombre de un paquete para colapsar o expandir su lista. Colapsar los paquetes que no usas mantiene la paleta ordenada.

Agregar una actividad al canvas

Tienes dos formas:

1. Arrastrar y soltar: toma la actividad de la paleta y suéltala en la posición deseada del canvas.
2. Doble clic: agrega la actividad al final del flujo actual.

Una vez en el canvas, selecciona el nodo para configurarlo en el panel de propiedades.

¿Por qué no aparece un paquete?

La paleta muestra solo los paquetes instalados en el Agent de tu máquina. Si esperas un paquete y no lo ves:

Causa	Solución
El paquete no está instalado	Instálalo desde Nexus → Paquetes
El Agent no está ejecutándose	Abre el Zoan Agent (ícono en la bandeja del sistema)
El Designer abrió antes de conectar el Agent	Reinicia el Designer una vez el Agent esté conectado

Nota

Los paquetes oficiales de Zoan (Core, Browser, Excel, etc.) vienen disponibles por defecto. Los paquetes personalizados que hayas creado con el SDK deben publicarse e instalarse antes de aparecer en la paleta.

Siguientes pasos

• Canvas y nodos — qué hacer con la actividad una vez en el lienzo.
• Catálogo de actividades — referencia completa de cada actividad.