Verarbeitung von Mehrfach-Datei-Uploads mit Binärdaten und sequenzieller Abwicklung - n8n-Workflow

• Benutzer, die komplexe Dateiverarbeitungslogik benötigen.


• Entwickler, die den Umgang mit Binärdaten in n8n beherrschen.


• Unternehmen, die eine sequenzielle Stapelverarbeitung von Uploads erfordern.


• Alle, die nach fortgeschrittenen n8n-Vorlagen suchen, die sich auf Flusssteuerung und Dateioperationen konzentrieren.

Dieser fortgeschrittene n8n-Workflow befasst sich mit einer gängigen Herausforderung in der Automatisierung: der effizienten Handhabung mehrerer Binärdateien, die gleichzeitig über ein einziges Formularereignis übermittelt werden. Wenn ein n8n-Auslöser mehrere Dateien empfängt, werden diese oft zu einem einzigen Array zusammengefasst, was sequentielle Operationen erschweren kann.

Diese spezielle n8n-Vorlage nutzt robuste Flusssteuerungsmechanismen. Sie verwendet den n8n-Knoten Split Out Files, um das anfängliche Eingangselement in einzelne Elemente zu zerlegen, gefolgt von einer benutzerdefinierten Schleife (Loop Over Items). Dieser n8n-Workflow demonstriert, wie die spezielle Variable {{$runIndex}} innerhalb des n8n-Knotens Read/Write File genutzt werden kann, um korrekt benannte Binärdatenfelder (z. B. files0, files1) abzurufen, was ein präzises Speichern und eine sequenzielle Verarbeitung für jede hochgeladene Datei gewährleistet. Dies ist ein entscheidendes Muster für eine robuste Dateiverwaltung in n8n.

Der n8n-Workflow durchläuft einen Fünf-Schritte-Prozess, der auf robuste Dateiaufteilung und Schleifen ausgelegt ist:

1. Auslösen durch Formularübermittlung: Der n8n-Workflow startet, wenn das n8n-Trigger-Element Form - Load Multiple Files übermittelt wird, wobei ein Array von Dateien erfasst wird (hier für JSON-Dateien konfiguriert).


2. Aufteilen des Stapels: Das einzelne eingehende Element, das das Datei-Array enthält, wird sofort an den n8n-Knoten Split Out Files weitergeleitet. Dieser wesentliche n8n-Knoten zerlegt das Array in separate, einzelne Elemente und stellt sicher, dass die erforderlichen Binärdaten für jede Datei erfolgreich weitergegeben werden.


3. Initiieren der Schleife: Die einzelnen Elemente fließen in den n8n-Knoten Loop Over Items (konfiguriert als Batch-Aufteilung der Größe 1). Dies garantiert eine strikt sequenzielle Verarbeitung für jedes Datei-Element.


4. Dateien sequenziell speichern: Innerhalb der Schleife führt der n8n-Knoten Save Each File den Schreibvorgang durch. Ein Schlüsselelement der Konfiguration dieses n8n-Knotens ist die dynamische Referenz, die zur Abfrage der Binärdaten-Eigenschaft verwendet wird: =files_{{$runIndex}}. Die Variable {{$runIndex}} liefert die aktuelle Schleifenzahl und ermöglicht es dem n8n-Workflow, die Binärdatei, die dem aktuell verarbeiteten Element entspricht, präzise abzurufen und zu speichern.


5. Abschluss des n8n-Workflows: Nachdem alle Dateien die Schleife durchlaufen haben, fährt der Ablauf zum n8n-Knoten Continue Once (ein No-Operation-Knoten, der so konfiguriert ist, dass er einmal ausgeführt wird). Dieser Schritt normalisiert den Ausgabestrom, sodass unabhängig von der ursprünglichen Dateianzahl nur ein einziges Element nachgelagert weiterläuft.

Um diese n8n-Vorlage zu verwenden, gehen Sie wie folgt vor:

1. Importieren: Laden Sie die bereitgestellten JSON-Daten herunter und importieren Sie diese direkt in Ihre n8n-Instanz.


2. Auslöser aktivieren: Suchen Sie den n8n-Trigger-Knoten Form - Load Multiple Files. Stellen Sie sicher, dass der n8n-Workflow aktiv ist, damit die Webhook-URL generiert wird.


3. Formular testen: Greifen Sie im Browser auf die generierte Formular-URL zu (verfügbar in den Trigger-Einstellungen).


4. Dateien hochladen: Laden Sie mehrere JSON-Dateien hoch (oder ändern Sie bei Bedarf die Dateitypeinstellungen im n8n-Knoten) und senden Sie das Formular ab.


5. Berechtigungen prüfen: Der n8n-Knoten Save Each File verwendet das lokale Dateisystem. Stellen Sie sicher, dass Ihre n8n-Umgebung über die erforderlichen Berechtigungen verfügt, um Dateien am gewünschten Speicherort zu schreiben.

Form - Load Multiple Files (n8n Trigger):
Funktion: Startet den n8n-Workflow bei Übermittlung eines Webformulars.
Wichtige Konfiguration: Konfiguriert, um mehrere Datei-Eingaben (files) zu akzeptieren, und beschränkt die Eingabetypen auf .json.
Split Out Files (n8n Node):
Funktion: Wandelt das einzelne eingehende Element, das ein Datei-Array enthält, in mehrere separate Elemente um und ermöglicht so eine elementweise Verarbeitung.
Wichtige Konfiguration: Field To Split Out ist auf files gesetzt; Include Binary Data ist aktiviert, was für die Beibehaltung des Dateiinhaltes unerlässlich ist.
Loop Over Items (n8n Node - Split In Batches):
Funktion: Verwaltet den sequenziellen Ausführungsfluss und verarbeitet jedes Datei-Element nacheinander.
Wichtige Konfiguration: Dient als entscheidender Flusssteuerungsmechanismus in diesem n8n-Workflow.
Save Each File (n8n Node - Read/Write File):
Funktion: Speichert den Binärinhalt des aktuellen Datei-Elements im lokalen Dateisystem.
Wichtige Konfiguration: Der Data Property Name wird dynamisch auf =files{{$runIndex}} gesetzt, um die Binärdaten, die der aktuellen Position des Elements in der Schleife entsprechen, präzise abzurufen. Der File Name ist auf out{{ $json.files.filename }} festgelegt.
Continue Once (n8n Node - NoOp):
Funktion: Dieser n8n-Hilfsknoten stellt sicher, dass nach Abschluss der Schleife nur ein einziges Datenelement den n8n-Workflowpfad weiter verfolgt, was nachfolgende Operationen optimiert.
Wichtige Konfiguration: Auf Execute Once eingestellt.