1 / 14
← Inicio

Datos en la práctica

Lo que tocas en n8n al construir flujos

Esta clase recorre cosas que ves y usas en el editor: el panel de datos de cada nodo, las filas que entran y salen, cómo se parten o juntan ramas, cómo entran los archivos y qué pasa cuando algo falla en producción.

📌 Temas que verás:

  • Vista Table y JSON — qué representa cada fila
  • Por qué casi todo se procesa registro a registro
  • Split Out y Code cuando un solo registro “lleva dentro” varias cosas
  • Merge para unir dos cables del canvas
  • Convert to File y Extract from File con adjuntos
  • Error Workflow en ajustes del flujo

💡 Al final hay un autoevaluación en español para comprobar si te quedó claro.

El panel que abres en cada nodo

INPUT y OUTPUT

Cuando ejecutas un paso o todo el workflow, debajo del nodo aparecen los datos. Ahí cambias entre vista Table (tabla) y JSON. Es el sitio donde arrastras campos a otros nodos y donde entiendes qué está pasando.

Notas:

  • Lo que ves como filas en la tabla es lo que el flujo trata como registros independientes en ese punto.
  • En JSON, cada fila es un objeto con propiedades (nombre, email, etc.).
  • Si algo “no llega” al siguiente nodo, lo primero es mirar aquí si el dato existe en el OUTPUT.

El “item”: tu unidad habitual

Una fila, un paquete de datos

En el día a día, n8n aplica la mayoría de nodos una vez por cada fila (cada registro) que entra. Esa fila es lo que en la documentación se llama item: un objeto JSON con sus campos.

Por qué importa:

  • Si entran 50 contactos, un nodo que formatea texto suele producir 50 salidas, una por persona.
  • Las claves y valores son el contenido dentro de cada item; el nodo no “itera por claves” por defecto, sino por items completos.
  • En ajustes del nodo a veces verás “Execute once”: ahí el comportamiento cambia y solo mira el primer item (casos puntuales).

Listas de objetos, no un solo bloque suelto

Cómo piensa el flujo

Internamente, la salida de un nodo es una lista donde cada elemento es un objeto (tu fila). Por eso puedes tener cero, uno o cientos de registros en el mismo cable: siempre es “varios items en fila”, aunque a veces solo haya uno.

💡 Analogía: piensa en una hoja de cálculo exportada: cada fila es un item; las columnas son las propiedades del JSON. El flujo no es un grafo abstracto de “tipos de datos”, es esta lista concreta que ves en el panel.

Cuando un campo trae “varias cosas dentro”

Nodo Split Out

A veces un contacto tiene tags: ["vip", "newsletter"] o un pedido trae line_items como array. Quieres que cada etiqueta o cada línea sea su propia fila para seguir procesando. Ahí añades Split Out e indicas qué campo es el array.

Qué notarás en pantalla:

  • Antes: 1 item con un array grande en una columna.
  • Después: tantos items como elementos tenía el array (cada uno con el contexto que n8n mantenga según la configuración).

Cuando tú decides cuántas filas salen

Nodo Code

El nodo Code te deja escribir lógica propia. Si tu función devuelve un array de objetos, n8n lo convierte en varios items de salida. Es útil cuando la transformación no encaja en un nodo prefabricado.

💡 Contraste con Split Out: Split Out “abre” un campo que ya es lista; Code puede construir la lista desde reglas, APIs internas, cálculos, etc.

Dos cables que deben encontrarse

Nodo Merge

Cuando una rama trae clientes y otra trae facturas, o quieres encadenar resultados uno detrás de otro, conectas ambas entradas al nodo Merge. En la interfaz eliges el modo: por ejemplo Append (todo lo de la entrada 1 y luego todo lo de la 2) o Combine alineando por posición o por una clave común.

Nota práctica: Merge une flujos que venían por caminos distintos del canvas; no sustituye a “abrir” un array que está dentro de un solo item (eso es más terreno de Split Out).

Nombres de campo en Merge

Property Input: texto fijo o expresión

Al combinar por clave, sueles indicar qué propiedad debe coincidir entre entradas (por ejemplo id o email). Eso lo puedes escribir como texto fijo en el campo, igual que en otros nodos.

Cuándo usar expresión: si el nombre del campo depende de otra variable o de lógica dinámica, activas el modo expresión y usas {{ }}. Pero no es un requisito del nodo: lo normal es poner el nombre de la propiedad a mano cuando ya sabes cómo se llama en tus datos.

Archivos en el flujo

Binario junto al JSON

Cuando descargas un PDF, recibes un adjunto de correo o subes un CSV, n8n guarda el archivo como datos binarios ligados al item. En el panel verás referencias al binario (nombre, tipo, tamaño) además de los campos JSON.

Para qué sirve: muchos nodos siguen trabajando con columnas JSON; los nodos de archivo te permiten pasar del mundo tabla al archivo y viceversa sin perder el hilo del flujo.

Convert to File y Extract from File

Del spreadsheet al adjunto (y al revés)

Convert to File toma lo que ya tienes en columnas (JSON) y genera un archivo en un formato que elijas — CSV, hoja, imagen u otros según opciones — para enviarlo por email, subirlo a Drive, etc.

Extract from File hace el camino inverso: entra un binario (archivo subido o descargado) y saca contenido estructurado o texto que puedes mapear como campos normales en los nodos siguientes.

💡 En conjunto cubren varios formatos y el puente JSON ↔ binario que necesitas cuando el proceso mezcla APIs y ficheros.

Cuando algo rompe en producción

Error Workflow

En Workflow settings (menú del workflow, arriba a la derecha del canvas) puedes asignar otro workflow que se ejecute si este falla: por ejemplo enviar un mensaje a Slack con el error, registrar el fallo o avisar al equipo.

Reutilizar: puedes crear un solo flujo de “alertas de error” bien diseñado y enlazarlo desde muchos workflows de negocio. Así mantienes el mismo canal de monitorización sin duplicar lógica.

HTTP Request y “muchas filas”

Otro contexto

Un HTTP Request devuelve lo que la API responda: si el cuerpo es una lista, n8n puede mostrarte varias filas de salida. Eso viene del servidor externo, no de “abrir” un array que tú tenías dentro de un solo item del flujo.

💡 Para partir un solo registro que ya tienes en el canvas (un campo tipo lista dentro del JSON), en la práctica se usan sobre todo Split Out o Code; Merge sigue siendo para unir ramas.

Antes del quiz

Ideas para llevarte

  • Mira siempre el OUTPUT del nodo anterior cuando algo no cuadre.
  • Cada fila = un item; el nodo suele repetir la acción por fila.
  • Split Out expande listas dentro de un campo; Merge junta cables distintos.
  • Archivos: binario + nodos Convert to File / Extract from File.
  • Un Error Workflow puede servir para muchos flujos a la vez.

Autoevaluación

Comprueba lo aprendido

1. ¿Cuál es la estructura de datos de n8n?
A) Array
B) Objeto
C) Array de objetos
D) Grafo
2. Un nodo de n8n ejecuta su acción sobre cada ________ de los datos de entrada.
A) clave
B) valor
C) item
D) par
3. Puedes crear varios items a partir de uno usando: (marca todas las que apliquen)
4. Los nodos Convert to File / Extract from File: (marca todas las que apliquen)
5. En el nodo Merge, es obligatorio pasar Property Input como expresión.
No
6. Puedes usar el mismo Error Workflow para supervisar varios workflows distintos.
No