Acceder al Canvas
El canvas se abre automáticamente cuando creas o editas un workflow. Ve a Flowker → Workflows, y luego crea un workflow nuevo o haz clic en Edit Workflow en uno existente.
Conceptos básicos del canvas
El canvas tiene las siguientes interacciones:
- Desplazar: haz clic y arrastra en el fondo del canvas para moverte.
- Zoom: usa la rueda de desplazamiento o el gesto de pellizco para acercar y alejar.
- Seleccionar: haz clic en un nodo para seleccionarlo y ver su resumen.
- Configurar: haz doble clic en un nodo para abrir su panel de configuración en el lado derecho.
- Conectar: arrastra desde el conector de salida de un nodo hasta el conector de entrada de otro nodo para crear una conexión.
- Eliminar: selecciona un nodo o una conexión y presiona la tecla de eliminar, o usa el menú contextual.
Tipos de nodo
Los workflows de Flowker tienen cuatro tipos de nodo.
Nodo Trigger
El nodo Trigger define el evento que inicia el workflow. Un workflow activo debe tener al menos un nodo disparador. Un workflow en draft puede estar vacío u omitir un disparador mientras lo diseñas. La validación de guardado en el nivel de nodo sigue aplicando. Cuando haces doble clic en un nodo disparador, se abre el panel Configure Trigger con los siguientes campos:
Después de seleccionar un tipo de disparador, pueden aparecer campos de configuración adicionales según el esquema del disparador. Para el disparador de webhook, esos campos son el path, el método y el contrato de entrada. Consulta Configurar un disparador de webhook para ver qué acepta cada contrato. Para el disparador de programación, son la expresión cron, la zona horaria y el flag de habilitado. Consulta Ejecutar un workflow según una programación.
Los tipos de disparador disponibles incluyen:
Los tipos de disparador vienen del catálogo de Flowker y pueden variar según la configuración de tu entorno. La lista de arriba refleja los disparadores disponibles de forma predeterminada.
Nodo Executor Call
Los nodos Executor Call hacen operaciones específicas llamando a ejecutores registrados en el catálogo de Flowker. Cada ejecutor es una integración ya construida con productos Lerian o servicios externos. Cuando haces doble clic en un nodo de llamada a ejecutor, se abre el panel Configure Executor Call. Sus dos primeros campos forman una cascada: la configuración de proveedor que eliges primero decide qué ejecutores ofrece el segundo campo.
Después de seleccionar un ejecutor, aparecen campos de configuración adicionales según el esquema del ejecutor (por ejemplo, parámetros de mapeo de datos).
Los ejecutores disponibles incluyen:
Los ejecutores vienen del catálogo de Flowker y pueden variar según
OPENAPI_NATIVE_PROVIDERS, la política de fixtures y la resolución correcta del proveedor y de la especificación. La tabla es ilustrativa. Inspecciona el catálogo en ejecución para ver los ejecutores disponibles en tu despliegue.Nodo Conditional
Los nodos Conditional ramifican el workflow según condiciones evaluadas en tiempo de ejecución. Un nodo condicional tiene una condición estructurada formada por cases. Cada case tiene una o más reglas y enruta la ejecución por su propio camino de salida cuando coincide. El nodo condicional evalúa los cases en orden, y gana el primer case que coincide. Un camino default opcional captura las ejecuciones que no coinciden con ningún case. Así, un nodo condicional tiene una conexión de salida por case, más el camino default cuando está habilitado. Cuando haces doble clic en un nodo condicional, se abre su panel de configuración con el condition builder visual, donde defines los cases y las reglas dentro de cada case (el valor que se prueba, un operador de comparación y el valor con el que se compara).Los workflows guardados con una expresión de condición de texto libre heredada conservan los caminos de salida true/false originales. Los condicionales nuevos usan el condition builder.
Nodo Action
Los nodos Action hacen una acción en el nivel del workflow sin llamar a un servicio externo. El tipo de acción disponible esset_output, que define la salida final de la ejecución. Es útil como paso terminal de un workflow, sobre todo con respuestas de webhook síncronas.
Los valores de salida admiten referencias ${...} que se resuelven contra el contexto del workflow (por ejemplo, ${workflow.<field>} para el payload del disparador, o ${execution.id}). Para los workflows disparados por un webhook síncrono, un nodo set_output también puede llevar un responseStatusCode (entero, 200–599) para anular el estado HTTP de la respuesta sync.
Configurar nodos
Para configurar cualquier nodo, haz doble clic en él en el canvas. Un panel de configuración se desliza desde el lado derecho. Cada tipo de nodo tiene su propia disposición de panel:
- Trigger: campo Name + lista desplegable de tipo de disparador + campos de esquema propios del disparador.
- Executor Call: lista desplegable Provider + lista desplegable Executor + nombre completado automáticamente + campos de esquema propios del ejecutor.
- Conditional: campo Name + el condition builder visual (cases y reglas).
- Action: campo Name + la configuración de salida
set_output.
Conexiones
Las conexiones definen el orden en que se ejecutan los nodos. Cada conexión forma una arista dirigida desde la salida de un nodo hasta la entrada de otro nodo.
- Un nodo puede tener varias conexiones de salida (por ejemplo, los nodos condicionales tienen una por case, más el camino default cuando está habilitado).
- Un nodo puede recibir entrada de varias fuentes.
- Las conexiones circulares (bucles) no se admiten.