Manejo de Carga Múltiple de Archivos con Datos Binarios y Procesamiento Secuencial - Flujo de trabajo de n8n

• Usuarios que necesitan lógica compleja de procesamiento de archivos.


• Desarrolladores que dominan el manejo de datos binarios en n8n.


• Empresas que requieren el procesamiento por lotes secuencial de subidas.


• Cualquiera que busque plantillas avanzadas de n8n centradas en el control de flujo y operaciones de archivo.

Este flujo de trabajo avanzado de n8n aborda un desafío común en la automatización: gestionar eficientemente múltiples archivos binarios enviados simultáneamente a través de un único evento de formulario. Cuando un disparador de n8n recibe varios archivos, a menudo se agrupan en un solo array, lo que puede complicar las operaciones secuenciales.

Esta plantilla específica de n8n utiliza técnicas robustas de control de flujo. Emplea el nodo Split Out Files de n8n para descomponer el elemento de entrada inicial en elementos individuales, seguido de un bucle personalizado (Loop Over Items). Este flujo de n8n demuestra cómo aprovechar la variable especial {{$runIndex}} dentro del nodo Read/Write File de n8n para acceder correctamente a campos de datos binarios nombrados dinámicamente (ej. files0, files1), asegurando el guardado preciso y el procesamiento secuencial de cada archivo subido. Este es un patrón crítico para una gestión de archivos robusta en n8n.

El flujo de trabajo de n8n se ejecuta a través de un proceso de cinco pasos diseñado para la división robusta de archivos y el bucle:

1. Disparador de Envío de Formulario: El flujo de n8n se inicia cuando se envía el disparador Form - Load Multiple Files de n8n, capturando un array de archivos (configurado aquí para archivos JSON).


2. División del Lote: El elemento único entrante que contiene el array de archivos se pasa inmediatamente al nodo Split Out Files de n8n. Este nodo esencial de n8n rompe el array en elementos separados e individuales, asegurando que los datos binarios requeridos se transmitan con éxito para cada archivo.


3. Inicio del Bucle: Los elementos individuales fluyen hacia el nodo Loop Over Items de n8n (configurado como Split in Batches de tamaño 1). Esto garantiza un procesamiento secuencial estricto para cada elemento de archivo.


4. Guardado Secuencial de Archivos: Dentro del bucle, el nodo Save Each File de n8n realiza la operación de escritura. Una característica clave de configuración de este nodo de n8n es la referencia dinámica utilizada para recuperar la propiedad de datos binarios: =files_{{$runIndex}}. La variable {{$runIndex}} proporciona el recuento actual del bucle, permitiendo que el flujo de n8n recupere y guarde con precisión el archivo binario asociado al elemento específico que se está procesando actualmente.


5. Finalización del Flujo de Trabajo de n8n: Después de que todos los archivos se procesan a través del bucle, el flujo continúa hacia el nodo Continue Once de n8n (un nodo de No Operación configurado para ejecutarse una vez). Este paso normaliza el flujo de salida, asegurando que solo un elemento continúe aguas abajo, independientemente del recuento inicial de archivos.

Para utilizar esta plantilla de n8n, sigue estos pasos:

1. Importar: Descarga los datos JSON proporcionados e impórtalos directamente en tu instancia de n8n.


2. Activar Disparador: Localiza el nodo disparador Form - Load Multiple Files de n8n. Asegúrate de que el flujo de trabajo de n8n esté activo para que se genere la URL del webhook.


3. Probar Formulario: Accede a la URL del formulario generada (disponible en la configuración del disparador) en tu navegador.


4. Subir Archivos: Sube múltiples archivos JSON (o cambia la configuración del tipo de archivo en el nodo de n8n si es necesario) y envía el formulario.


5. Revisar Credenciales: El nodo Save Each File de n8n utiliza el sistema de archivos local. Asegúrate de que tu entorno n8n tenga los permisos necesarios para escribir archivos en la ubicación deseada.

Form - Load Multiple Files (Disparador de n8n):
Función: Inicia el flujo de trabajo de n8n tras el envío de un formulario web.
Configuración Clave: Configurado para aceptar múltiples entradas de archivo (files) y restringe los tipos de entrada a .json.
Split Out Files (Nodo de n8n):
Función: Transforma el elemento único entrante que contiene un array de archivos en múltiples elementos separados, permitiendo el procesamiento individual.
Configuración Clave: Field To Split Out se establece en files; Include Binary Data está marcado, lo cual es esencial para preservar el contenido del archivo.
Loop Over Items (Nodo de n8n - Split In Batches):
Función: Gestiona el flujo de ejecución secuencial, procesando cada elemento de archivo uno a uno.
Configuración Clave: Actúa como un mecanismo de control de flujo crucial en este flujo de trabajo de n8n.
Save Each File (Nodo de n8n - Read/Write File):
Función: Guarda el contenido binario del elemento de archivo actual en el sistema de archivos local.
Configuración Clave: La Data Property Name se establece dinámicamente a =files{{$runIndex}} para recuperar con precisión los datos binarios correspondientes a la posición actual del elemento en el bucle. El File Name se establece en out{{ $json.files.filename }}.
Continue Once (Nodo de n8n - NoOp):
Función: Este nodo de utilidad de n8n asegura que solo un elemento de datos continúe por la ruta del flujo de trabajo de n8n después de que concluya el bucle, agilizando las operaciones subsiguientes.
Configuración Clave: Establecido en Execute Once.