Flujo de Datos y Estructura JSON en n8n

Comprender el flujo de datos es fundamental en n8n. Cada nodo recibe datos, los procesa y emite un nuevo conjunto. Esta lección explica cómo los datos se mueven entre nodos y la importancia de la estructura JSON para una automatización efectiva.

El Flujo de Datos en n8n: Entrada y Salida

En n8n, un workflow es una secuencia de nodos interconectados. Cada nodo opera sobre los datos que recibe de su(s) nodo(s) precedente(s). Los datos fluyen de izquierda a derecha, desde el nodo Trigger inicial hasta el último nodo de acción.

Cuando un nodo ejecuta su lógica, toma los datos de entrada, realiza su operación (por ejemplo, filtrar, transformar, enviar una solicitud HTTP) y produce un conjunto de datos de salida. Estos datos de salida se convierten en la entrada para el siguiente nodo en la secuencia. Este ciclo de entrada-procesamiento-salida es la base de cómo se construyen las automatizaciones.

Para visualizar esto, al ejecutar un workflow, el panel de ejecuciones muestra los datos de entrada y salida de cada nodo. Esto permite inspeccionar la estructura y el contenido de los datos en cada etapa, lo cual es crítico para la depuración y el diseño de la lógica del workflow.

JSON: El Lenguaje de los Datos en n8n

La estructura de datos predominante en n8n es JSON (JavaScript Object Notation). JSON es un formato ligero y legible por humanos para el intercambio de datos. Todos los datos que entran y salen de un nodo, así como los datos internos que n8n utiliza para la gestión de items, se representan en JSON.

Comprender JSON es indispensable para trabajar con n8n. Un objeto JSON es una colección no ordenada de pares clave/valor. Una clave es una cadena, y un valor puede ser una cadena, un número, un booleano, un arreglo, otro objeto o null.

[
  {
    "id": 1,
    "nombre": "Producto A",
    "precio": 100.50,
    "activo": true,
    "etiquetas": ["electrónica", "hogar"]
  },
  {
    "id": 2,
    "nombre": "Producto B",
    "precio": 25.00,
    "activo": false,
    "etiquetas": ["oficina"]
  }
]

Este ejemplo muestra un arreglo de dos objetos JSON. Cada objeto representa un "item" en n8n y contiene varias propiedades (claves) con sus respectivos valores. La consistencia en la estructura JSON facilita el mapeo de datos entre nodos y el uso de expresiones.

Visualización de Datos JSON en n8n

n8n proporciona herramientas visuales para inspeccionar la estructura JSON en cada etapa del workflow. Al ejecutar un workflow de prueba o una ejecución real, puede hacer clic en cualquier nodo para ver su entrada y salida. La sección "Output" de un nodo muestra los datos JSON que el nodo ha emitido.

Dentro de la vista de salida, n8n presenta los datos de forma estructurada, permitiendo expandir y colapsar objetos y arreglos. Esto es crucial para:

• Verificar la estructura: Asegurarse de que las claves y valores esperados están presentes y tienen el tipo de dato correcto.
• Depurar errores: Identificar dónde los datos se desvían de lo esperado o dónde un nodo no está produciendo la salida correcta.
• Planificar el mapeo: Entender los "caminos" (paths) dentro del JSON para referenciar datos específicos en nodos posteriores usando expresiones.

Impacto de la Estructura JSON en las Expresiones

Las expresiones en n8n permiten referenciar dinámicamente datos de nodos anteriores. La forma en que se escriben estas expresiones depende directamente de la estructura JSON de los datos. Por ejemplo, para acceder al nombre de un producto en el JSON de ejemplo anterior, se usaría una expresión como {{ $json.nombre }} si el objeto está directamente en la raíz del item, o {{ $json.data.producto.nombre }} si está anidado.

Si la estructura JSON cambia inesperadamente (por ejemplo, una API externa modifica su respuesta), las expresiones que dependen de esa estructura pueden fallar. Por ello, es vital:

• Validar la entrada: Utilizar nodos como "IF" o "Switch" para verificar la existencia de claves o el tipo de datos antes de intentar procesarlos.
• Manejo de errores: Implementar ramas de error para capturar y gestionar situaciones donde la estructura JSON no es la esperada.
• Documentar: Registrar las estructuras JSON esperadas, especialmente cuando se interactúa con sistemas externos.

Aplicación Práctica: Inspección de Datos

El lunes, al construir o modificar un workflow, haga lo siguiente:

1. Ejecute el workflow en modo de prueba o con datos reales limitados.
2. Haga clic en cada nodo y revise la pestaña "Output".
3. Examine la estructura JSON de los datos de salida. Identifique las claves principales y los valores asociados.
4. Compare la salida con lo que espera. Si hay discrepancias, el problema se encuentra en el nodo anterior o en la configuración del nodo actual.
5. Practique la navegación por la estructura JSON, expandiendo y colapsando los objetos para familiarizarse con los "caminos" de los datos. Esto le facilitará la creación de expresiones en lecciones futuras.