El editor de flujos es donde creas y modificas los flujos. Colocas bloques en un lienzo, conectas sus salidas con las entradas de otros bloques, completas sus ajustes y despliegas. El borrador se guarda mientras trabajas; nada se ejecuta hasta que despliegues.
Crear un flujo
- Abre Automation. La lista muestra todos los flujos de todos los hosts, primero los flujos raíz.
- Selecciona New flow.
- Completa el cuadro de diálogo:
| Campo | Significado |
|---|---|
| Host | IoT o General. «Dónde se ejecuta el flujo y qué bloques puede usar. No se puede cambiar después.» |
| Name | El nombre del flujo |
| Slug | Su identificador corto: letras minúsculas, dígitos, - y _, hasta 32 caracteres. No se puede cambiar después. |
| Start from | An empty flow, o una plantilla del host. Consulta Flow templates. |
- Selecciona Create. Se abre el editor.
Todo flujo tiene desde el inicio un bloque Flow input. Es la entrada de los mensajes que le pasa otro flujo y, en un flujo raíz, la entrada de los mensajes de sus dispositivos. No se puede eliminar; déjalo sin conectar si nada pasa mensajes a este flujo.
El editor de un vistazo
| Área | Qué contiene |
|---|---|
| Barra superior | El nombre y el estado del flujo, el estado de guardado (Saving…, Saved, Not saved yet), cifras en vivo (Live o Every 5 s, mensajes por segundo, mensajes en espera, errores en 24 h) y los botones Activity, Webhooks, Test, Versions, Failed messages, Discard draft y Deploy |
| Paleta | Node Types: todos los bloques del host, en orden alfabético, con un cuadro de búsqueda |
| Lienzo | Los bloques y sus conexiones |
| Panel lateral | Los ajustes del bloque seleccionado o el panel Activity |
Webhooks aparece cuando un flujo desplegado tiene un disparador Webhook. Versions aparece tras el primer despliegue. Discard draft aparece mientras el borrador difiere de la versión desplegada.
Añadir bloques
- Arrastra un bloque desde la paleta al lienzo, o haz clic en él.
- O haz clic derecho en el lienzo y elige Add a block here…, o haz clic derecho en una conexión y elige Add a block in between…. El selector Add a block busca por nombre, descripción o tipo.
- Un bloque que no se puede usar aparece en gris, con el motivo: «Your plan does not include this block.», «This block needs a configuration that is not set up yet.», «The module this block belongs to is not installed.», «This block does not run on this flow’s host.» o «You need the permission … to use this block.»
Conectar bloques
- Arrastra desde un puerto de salida (lado derecho de un bloque) hasta un puerto de entrada (lado izquierdo de otro).
- Un bloque puede tener varias salidas, por ejemplo yes y no, o una por regla de un Switch. Al pasar el cursor sobre un puerto se muestra su nombre.
- La mayoría de los bloques también tienen una salida error. Conéctala para gestionar tú los errores de ese bloque; si no, los errores van a los disparadores Catch del flujo. Consulta Trigger blocks.
- Para mover el extremo de una conexión, arrastra su asa hasta otro puerto. Para cambiar la salida de la que sale una conexión, haz clic derecho en ella y elige Change port….
- Selecciona una conexión y pulsa Supr, o haz clic derecho en ella y elige Delete connection.
Las conexiones muestran un recuento de mensajes una vez que el flujo se ejecuta («12 messages»).
Editar un bloque
Haz clic en un bloque. El panel lateral se abre con tres pestañas:
| Pestaña | Muestra |
|---|---|
| Settings | Label, Description (una nota para las personas; no hace nada) y los ajustes propios del bloque. «Los cambios se aplican mientras escribes. Deshaz con Ctrl+Z.» |
| Messages | Los últimos mensajes que pasaron por el bloque, In y Out, con Test with this input. El contenido de los mensajes solo se muestra a las personas autorizadas a depurar. |
| Help | La referencia del bloque: qué hace, sus puertos y ajustes |
Los ajustes que toman un valor permiten elegir su tipo: Number, Text, Yes / no, JSON, Variable (una ruta como msg.payload.level o flow.limit), Expression, Environment variable o Current time. Los ajustes que eligen una conexión (un broker MQTT, un endpoint HTTP) muestran tus conexiones de ese tipo, con Manage connections. Consulta Connections and secrets.
El bloque Script abre un editor de código con buscar y reemplazar, formateo, pantalla completa y Test the script. Consulta The script block.
Trabajar con muchos bloques
| Acción | Cómo |
|---|---|
| Seleccionar varios | Clic con Shift o Ctrl, o mantén Shift y arrastra un marco (Select blocks with a frame) |
| Copiar, cortar, pegar, duplicar | El menú del clic derecho o los atajos de teclado habituales |
| Agrupar | Selecciona, haz clic derecho, Group…; dale al grupo un nombre y un color |
| Comentar | Haz clic derecho en el lienzo, Add a comment here. Los comentarios no hacen nada al ejecutar el flujo. |
| Omitir un bloque | Clic derecho, Skip: el bloque permanece pero no se ejecuta |
| Ordenar | Arrange the blocks en la barra de herramientas |
| Buscar | Find a block busca en nombres, tipos, descripciones e identificadores |
| Navegar | Acercar y alejar, Fit to screen, Mini map, Fullscreen |
Pulsa ? en el lienzo para ver los atajos de teclado.
Problemas
El editor comprueba el flujo mientras lo construyes. Los problemas se marcan en los bloques y se listan en Problems:
| Problema | Significado |
|---|---|
| «Setting is required.» | Completa el ajuste. |
| «This block is not connected to anything.» / «Nothing is connected to this block.» | Conéctalo o elimínalo. |
| «A flow can have only one Flow input block.» | Elimina el sobrante. |
| «These blocks send messages round in a loop that never waits…» | Pon en el bucle un bloque de espera (un retardo, un temporizador, una llamada), o rómpelo. |
| «A Run flow block cannot run its own flow.» | Elige otro flujo. |
| «This block is not available here. It keeps its connections but cannot run.» | El bloque procede de una importación y no existe en este host. |
Un flujo con errores no se puede desplegar: «Fix the problems marked on the canvas first.»
Guardado
El borrador se guarda automáticamente en el servidor mientras editas. El estado de guardado muestra Saving…, Saved o «Not saved. Retry». Los cambios no guardados también se conservan en tu navegador: si sales y vuelves, el editor ofrece restaurarlos.
Si otra persona guardó el mismo flujo mientras tanto, el editor muestra «This flow was saved by someone else» con:
- Merge: conserva lo que solo cambió un lado y guarda el resultado como borrador. Revísalo antes de desplegar; Undo vuelve a tu versión.
- Overwrite with mine: conserva tu versión.
Desplegar
- Selecciona Deploy. El cuadro de diálogo «Deploy name» dice: «Esto se convierte en la versión n del flujo y empieza a ejecutarse.»
- Lee las advertencias y la lista de cambios, si las hay.
- Elige What restarts: Only the blocks that changed (por defecto), Every block of the changed flows o Every flow of this host. Los bloques que no se reinician conservan su memoria.
- Deja marcada Run the flow after the deploy para ejecutarlo, o desmárcala para desplegarlo desactivado.
- Opcionalmente escribe una Note («Qué cambió»). Aparece en la lista de versiones.
- Si el flujo tiene bloques que actúan fuera de él (Code, Control, External, System de riesgo), el cuadro de diálogo los lista: marca I understand what these blocks do y escribe el nombre del flujo.
- Selecciona Desplegar (o Confirmar y desplegar).
Un despliegue puede rechazarse: por un problema, por un límite del plan («Tu plan permite n flujos: …»), por falta de un permiso o porque alguien desplegó entretanto. El diálogo indica el motivo. Consulta Límites de flujos.
Un flujo que es raíz debe permanecer activado y aprobado: «Este flujo es raíz, así que debe permanecer activado y aprobado: de lo contrario, los datos de los dispositivos no se almacenarían.»
Flujos de solo lectura
Verás «Puedes ver este flujo pero no cambiarlo.» cuando no tengas el permiso para gestionar la automatización, cuando el flujo esté eliminado (restáuralo primero) o cuando lo haya creado un módulo (una regla de la tarjeta Reglas: insignia Creado por). Consulta Hosts, el flujo raíz y los flujos raíz de perfil y Versiones, pruebas y reversión.