Recursos · Integración n8n

Nodo Split Out n8nConfigura Split Out en n8n.

Una lista guardada dentro de un solo item sigue siendo un solo item. El nodo Split Out n8n la convierte en items separados, uno por entrada. Tres parámetros lo gobiernan: el campo que se reparte, lo que viaja con cada item y una lista corta de opciones.

Probar el nodo Split Out en n8nVer los 3 parámetros

Reseñas verificadas en Trustpilot · Agencia de IA, automatización y growth

Por qué automatizar

¿Para qué sirve el nodo Split Out n8n?

Split Out toma un item de entrada que contiene una lista y la convierte en items separados, uno por entrada. Su propia descripción lo resume: convertir una lista que está dentro de un item en items distintos. Nada más cambia. El nodo se ejecuta sobre cada item de entrada y nunca abre un flujo por sí solo: delante hay siempre un disparador, un Schedule Trigger, un Webhook o el trigger de una herramienta.

El primer caso aparece cuando la lista está anidada. No vive en la raíz del item, sino bajo una clave padre. La notación con punto está activa por defecto, así que data.items vale como nombre de campo tal cual. Cuando las claves llevan puntos propios, para eso existe la opción Disable Dot Notation, y sin ella el nodo busca un hijo que no existe.

Segundo caso, el del número de ejecuciones. Mientras la lista duerme dentro de un item, el nodo siguiente corre una sola vez. Con Fields To Split Out apuntando al campo correcto, cada entrada pasa a ser un item, y lo que venga detrás se ejecuta una vez por entrada: un mensaje por entrada en Slack, o una fila por entrada en Google Sheets.

Tercer caso, el del contexto que se pierde. Las entradas de la lista suelen ser pobres y el dato que hace falta está fuera de ellas. Include decide qué acompaña a cada item nuevo, y Selected Other Fields deja llevar solo las dos o tres claves que de verdad se usan después, sin arrastrar todo el item padre.

¿Cuándo conviene otro nodo? Si nada tiene que convertirse en un item aparte y solo hace falta renombrar o reordenar claves, el trabajo es de Edit Fields (Set). Split Out entra cuando el número de items tiene que cambiar, por ejemplo después de una llamada con HTTP Request que devuelve la lista completa en una sola respuesta.

Los límites conviene tenerlos claros antes de montar nada. El nodo está en la versión 1 y se queda en tres parámetros. Fields To Split Out es obligatorio: vacío, bloquea la ejecución. Los datos binarios van por su camino, la ayuda del panel indica usar $binary para repartir el item de entrada por dato binario, y Include Binary manda sobre su presencia en los items nuevos. Para situar la plataforma entera, la Reseña n8n entra en detalle.

Parámetros

¿Qué parámetros ofrece Split Out ?

El nodo Split Out tiene 3 parámetros. Para cada uno: el nodo tal como lo configuras en n8n, qué cambia el parámetro y nuestras notas de campo.

01

Fields To Split Out

fieldToSplitOut

Lo que ves en n8n

Notas y casos de uso

Aquí el nodo aprende qué clave lleva la lista. Con el campo relleno, cada entrada sale convertida en un item propio. Vacío no hay ejecución, porque el campo es obligatorio.

Parámetros clave

  • Fields To Split Out: el nombre de los campos de entrada que se reparten en items separados, con comas cuando hay varios. El panel invita a arrastrar los campos desde la izquierda o a escribir su nombre, y una expresión como {{ $json.orders }} también funciona. Para datos binarios, usa $binary.
Casos de uso
un item con una lista de facturas se convierte en un item por factura, listo para tratarlas una a una.
02

Include

include

Lo que ves en n8n

Notas y casos de uso

Repartir una lista deja fuera el resto del item salvo que se indique lo contrario. Este selector responde a eso: si hay que copiar los demás campos en los items nuevos.

Parámetros clave

  • No Other Fields: no se incluye ningún otro campo, cada item se queda con el contenido de la entrada.
  • All Other Fields: se incluyen todos los demás campos en cada item nuevo.
  • Selected Other Fields: solo se incluyen los campos seleccionados.
  • Fields To Include: aparece con la opción anterior, una lista de campos separados por comas, del tipo email, name.
Casos de uso
mantener el identificador del pedido en cada línea repartida para saber luego a qué pedido pertenece.
03

Options

options

Lo que ves en n8n

Notas y casos de uso

Detrás de "Add option" esperan tres ajustes, y cada uno resuelve algo que solo se nota con datos reales. Una opción que no se añade conserva su valor por defecto.

Parámetros clave

  • Disable Dot Notation: impide referirse a un campo hijo con la forma parent.child en el nombre del campo.
  • Destination Field Name: el campo de salida bajo el cual se coloca el contenido repartido.
  • Include Binary: indica si los datos binarios de la entrada viajan a los items nuevos.
Casos de uso
fijar un nombre de campo de destino para que el contenido llegue bajo la clave que el nodo siguiente ya espera.
Necesitas ayuda

¿Necesitas ayuda para automatizar Split Out con n8n?

El equipo te responde directamente.

Cada mensaje lo lee una persona.

FAQ

Preguntas frecuentes sobre Split Out

01¿El nodo Split Out n8n es gratis en Cloud y en autoalojado?
Sí. Split Out es un nodo core que viene con n8n, así que no hay nada que instalar ni coste adicional por el lado de n8n. Funciona igual en n8n Cloud, la oferta alojada por n8n, y en una instancia propia levantada con Docker o npm en Community Edition, bajo licencia Sustainable Use. Un flujo montado en un sitio corre idéntico en el otro, algo que importa cuando el prototipo nace en Cloud y termina en un servidor propio. El nodo no añade cuota ni facturación por item.
02¿Hace falta alguna credencial para usar Split Out?
No, no hay nada que autenticar. El nodo no tiene credential, es decir ninguna credencial guardada dentro de n8n, ni selector Authentication. Ninguna cuenta que enlazar, ninguna clave que guardar. Una vez colocado en el lienzo, lo único que necesita son datos llegando a su entrada. Esos datos vienen de otro sitio, porque el nodo no abre un flujo: delante hay un Schedule Trigger, un Webhook o el trigger de una herramienta, y Split Out se ejecuta sobre cada item de entrada. Toda la configuración cabe en los tres parámetros del panel.
03¿Qué límites tiene el nodo Split Out?
Hace una sola cosa. Lee un campo que contiene una lista y convierte sus entradas en items separados, y ese es todo el contrato que anuncia su descripción. Tres parámetros, versión 1: más allá de eso el nodo no responde. El campo Fields To Split Out es obligatorio, y un valor vacío bloquea la ejecución en vez de dejar pasar los datos. Si un flujo heredado muestra menos opciones que las descritas aquí, está usando una versión anterior del nodo, y un nodo nunca cambia de versión por su cuenta.
04¿Cuándo repartir la lista y cuándo dejarla en un item?
Depende de cuántas veces tenga que correr el paso siguiente. Un nodo colocado detrás de Split Out ve cada entrada como un item, así que se ejecuta una vez por entrada en lugar de una sola vez para toda la lista. La lista se queda entera cuando el paso siguiente necesita verla completa, o cuando solo toca renombrar y reordenar claves, terreno de Edit Fields (Set) y no de un cambio en el número de items. La pregunta no es el dato, son las ejecuciones.
05¿n8n o Make para repartir listas en items?
Depende de qué pese más. Make, antes Integromat, es una plataforma de automatización alojada, sin opción de autoalojamiento y facturada por operación, fácil de arrancar y de prever con volúmenes pequeños. n8n se autoaloja con Docker o npm, así que los datos se quedan en una infraestructura bajo control, y también existe la oferta alojada para quien no quiere gestionar servidores. Repartir una lista multiplica los pasos posteriores, conviene mirar el modelo de coste antes de decidir. En un flujo que reparte listas largas la cuenta cambia rápido, y la respuesta depende sobre todo del volumen que pase cada mes.
Hack'celeration Lab

Recibe nuestros tips de integración cada semana.

Sin spam. Cancela cuando quieras.

Misma plataforma

Otros docs útiles sobre este stack.

Ver todas las integraciones