Canvas y nodos

El canvas (lienzo) es el área central del Designer donde se construye el flujo de la automatización. Las actividades se representan como tarjetas apiladas de arriba hacia abajo sobre una línea que las une: el orden visual es el orden de ejecución.

Tarjeta de actividad

Cada tarjeta muestra el icono de la actividad, su nombre, una línea de resumen con sus parámetros clave y, si la actividad produce un resultado, la variable de salida (→ variable). A la izquierda, cada paso lleva su número (jerárquico dentro de los contenedores: 3.2) y un punto en la línea que toma el color del estado: seleccionado, en curso, terminado o con error.

Open Browser browser-open

• browser = "chrome"
• url = empresa.Url

→ page

Los textos fijos van entre comillas ("chrome"); lo demás es una expresión que se evalúa al ejecutar, como empresa.Url.

Editar sin salir del lienzo

El botón mostrar detalles de la tarjeta (o Enter con la tarjeta enfocada, o doble clic si no es un contenedor) la despliega con sus parámetros como campos editables: los obligatorios y los que ya tienen valor, y el resto en Más opciones. Lo que cambies ahí y en el panel de Propiedades es lo mismo: se actualiza en los dos sitios.

Contenedores y carriles

Algunas actividades, como For Each, If, Try Catch, Retry o While, agrupan otras actividades en carriles. Cada carril cuelga del contenedor con su rótulo y tiene su propia secuencia de pasos. La cabecera del contenedor dice qué clase de contenedor es: Bucle, Condición, Errores, Reintento o Ámbito.

Por ejemplo, un For Each ejecuta su carril Cuerpo una vez por cada elemento de una colección:

For Each foreach

• items = items
• itemVariable = item

Un If tiene los carriles Entonces y Si no. Un Try Catch tiene Intentar, Capturar y Finalmente. Dentro de cada carril, el orden de ejecución también es de arriba hacia abajo.

Trabajar con contenedores

• Plegar y desplegar: el chevron de la tarjeta del contenedor pliega su cuerpo (con el teclado, ← y →). El botón Contraer todo / Expandir todo, sobre el lienzo, pliega o despliega todos los contenedores del playbook.
• Enfocar un contenedor: doble clic sobre su tarjeta muestra solo ese contenedor, con unas migas arriba para volver a los niveles superiores. Esc sale.
• Carril vacío: muestra Añadir actividad — pulsa aquí o arrastra una desde la paleta. Al pulsarlo se abre la paleta de comandos y la actividad elegida entra en ese carril.
• Soltar un playbook: arrastra un playbook desde el panel Proyecto al lienzo o a un carril y se crea una actividad Invoke Playbook que apunta a él.
• Carril de destino: mientras arrastras, el carril sobre el que estás se resalta y una línea indica dónde caerá la actividad.

Flujo completo

En la práctica un playbook combina varias actividades en secuencia. El siguiente ejemplo procesa una cola de facturas: obtiene un ítem, abre el navegador, invoca otro playbook para la factura y marca el ítem como exitoso.

Procesar facturas pendientes main

Queue Get Item queue-get-item

• queueName = "facturas-pendientes"

→ item

Open Browser browser-open

• browser = "chrome"
• url = "https://erp.cliente.com"

→ page

Invoke Playbook invoke-playbook

• path = "playbooks/RegistrarFactura.play"

Queue Set Transaction Status queue-set-transaction-status

• item = item
• status = "successful"

Operaciones en el lienzo

Acción	Cómo hacerlo
Añadir una actividad	Arrastrarla desde la paleta; o seleccionarla en la paleta y pulsar Enter; o buscarla con Ctrl+K. Con el teclado o Ctrl+K, entra justo después de la actividad seleccionada.
Seleccionar	Clic en la tarjeta. Con el teclado, ↑ y ↓ recorren las actividades.
Mover	Arrastrar la tarjeta. Con el teclado: Alt+↑ / Alt+↓ la sube o la baja, Alt+→ la mete en el contenedor de arriba y Alt+← la saca del contenedor.
Cortar / Copiar / Pegar	Ctrl+X / Ctrl+C / Ctrl+V
Duplicar	Ctrl+D
Habilitar / deshabilitar	Clic derecho → Habilitar/deshabilitar actividad. Una actividad deshabilitada se ve atenuada y se omite al ejecutar.
Punto de interrupción	Clic en el número del paso, o F9. Ver Depuración.
Eliminar	Supr
Deshacer / Rehacer	Ctrl+Z / Ctrl+Y (o Ctrl+Shift+Z)
Escala	El indicador de porcentaje sobre el lienzo (100 %, 110 %, 125 %, 90 %, 80 %): cada clic pasa a la siguiente.

Menú contextual (clic derecho)

Clic derecho sobre una tarjeta abre Cortar, Copiar, Pegar, Duplicar, Habilitar/deshabilitar actividad, Alternar punto de interrupción y Eliminar.

Mientras se ejecuta un playbook, el lienzo queda en solo lectura: detén la ejecución para editar.

Orden de ejecución

Las actividades se ejecutan de arriba hacia abajo y, dentro de un carril, también de arriba hacia abajo. No hay conexiones visuales entre tarjetas: el orden lo da la posición, no unas flechas.