Datos y expresiones
Referencia entradas, salidas y contexto con expresiones, rutas e IDs de nodo.
14 min de lecturaDatos disponibles
El contexto de una ejecución
Cuando Flow ejecuta un nodo reúne su input actual, los resultados ya producidos, el disparador, la ejecución, el workflow, el actor y el entorno. Las expresiones leen rutas de ese contexto y conservan el tipo cuando el campo completo es una sola expresión.
{
"input": { "customer_id": 42 },
"nodes": {
"node_cliente": {
"output": {
"client": { "id": 42, "name": "Acme", "email": "hola@acme.test" }
}
}
},
"trigger": {},
"execution": { "uuid": "exec_...", "status": "running" }
}Rutas canónicas
Cómo escribir una expresión
Encierra la ruta entre dobles llaves. Usa puntos para bajar por objetos y el ID exacto del nodo tras nodes. La forma canónica para una salida es {{nodes.<id>.output.<ruta>}}.
{{input.customer_id}}
{{nodes.node_cliente.output.client.email}}
{{nodes.node_facturas.output.items}}
{{execution.uuid}}Estructura
Diferencia entre insertar y componer
Si un campo contiene únicamente {{nodes.node_facturas.output.items}}, recibe la lista completa como lista. Si mezclas esa expresión dentro de una frase, Flow la convierte en texto; los objetos y listas se serializan como JSON. Para campos estructurados, usa una expresión completa y evita convertir accidentalmente el valor en una cadena.
Antes de mapear, observa la salida real. No presupongas si una API devuelve data.items, items o un objeto directo; esa diferencia decide la ruta correcta.
{
"recipient": "{{nodes.node_cliente.output.client.email}}",
"subject": "Resumen de {{nodes.node_cliente.output.client.name}}",
"items": "{{nodes.node_facturas.output.items}}",
"metadata": {
"execution_id": "{{execution.uuid}}"
}
}Orden correcto
Una expresión también crea dependencia
Cuando la configuración de un nodo referencia a otro, Flow registra una dependencia de datos. El productor debe ejecutarse antes del consumidor, incluso si no están unidos por una línea directa. Una referencia a un ID inexistente invalida el workflow; una referencia circular crea un ciclo y también se rechaza.
Para mantener el diagrama comprensible, conecta además el recorrido lógico cuando corresponda y evita saltos de datos innecesariamente largos.
Método recomendado
Obtén la ruta a partir de una salida real
Si una prueba aislada no dispone de los nodos anteriores, introduce en el input de prueba una estructura equivalente cuando el nodo lo permita. Para validar la dependencia completa, utiliza después Ejecutar desde aquí desde un punto que produzca esos datos.
- 1
Ejecuta el productor
Usa Probar o Ejecutar nodo con input JSON conocido.
- 2
Abre Salida
Localiza el valor y anota su jerarquía exacta.
- 3
Copia el ID
Hazlo desde el inspector para evitar errores tipográficos.
- 4
Inserta la variable
Prefiere el selector del campo y revisa la expresión generada.
- 5
Ejecuta el consumidor
Comprueba tipo, valor y ruta antes de añadir otro paso.