Mikodawa Flow

Datos y expresiones

Referencia entradas, salidas y contexto con expresiones, rutas e IDs de nodo.

14 min de lectura
01

Datos 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.

json
{
  "input": { "customer_id": 42 },
  "nodes": {
    "node_cliente": {
      "output": {
        "client": { "id": 42, "name": "Acme", "email": "hola@acme.test" }
      }
    }
  },
  "trigger": {},
  "execution": { "uuid": "exec_...", "status": "running" }
}
02

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>}}.

text
{{input.customer_id}}
{{nodes.node_cliente.output.client.email}}
{{nodes.node_facturas.output.items}}
{{execution.uuid}}
03

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.

json
{
  "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}}"
  }
}
04

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.

05

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. 1

    Ejecuta el productor

    Usa Probar o Ejecutar nodo con input JSON conocido.

  2. 2

    Abre Salida

    Localiza el valor y anota su jerarquía exacta.

  3. 3

    Copia el ID

    Hazlo desde el inspector para evitar errores tipográficos.

  4. 4

    Inserta la variable

    Prefiere el selector del campo y revisa la expresión generada.

  5. 5

    Ejecuta el consumidor

    Comprueba tipo, valor y ruta antes de añadir otro paso.