Code Node im Griff: Datenverarbeitung, API-Aufrufe und Dateigenerierung - n8n-Workflow

Entwickler und technisch versierte Nutzer, die benutzerdefiniertes JavaScript innerhalb von n8n nutzen möchten.
Nutzer, die komplexe Datentransformationen oder Aggregationen durchführen müssen, die mit Standard-n8n-Nodes nicht möglich sind.
Automatisierungsspezialisten, die die verschiedenen Ausführungsmodi des n8n Code Nodes verstehen möchten (Pro Element vs. Einmal für alle).
Jeder, der n8n-Vorlagen nutzt, um seine Fähigkeiten im Bereich benutzerdefinierter Skripte zu verbessern.

Der n8n Code Node ist wohl das mächtigste Werkzeug auf der Plattform, da er es Benutzern ermöglicht, benutzerdefinierte JavaScript-Logik direkt in ihren n8n-Workflow einzubinden. Dieser spezielle n8n-Workflow dient als praktische Anleitung und demonstriert vier kritische Anwendungsfälle für den Code Node:

1. Elementanreicherung: Berechnung neuer Felder (wie Alter und vollständiger Name) für einzelne Elemente.


2. Externe Integration: Durchführung asynchroner HTTP-Anfragen an externe APIs mithilfe integrierter Helferfunktionen.


3. Datenaggregation: Zusammenfassung aller eingehenden Daten (z. B. Berechnung des Durchschnittsalters).


4. Dateigenerierung: Erstellung von Binärdaten (wie einem CSV-Bericht) aus aggregierten JSON-Eingaben.

Indem Benutzer dieser n8n-Vorlage folgen, können sie schnell vom grundlegenden Flow-Aufbau zum Skripten leistungsstarker, dynamischer Automatisierungen übergehen.

Dieser umfassende n8n-Workflow beginnt mit einem manuellen n8n-Trigger („Start Tutorial“) und durchläuft mehrere logische Schritte, wobei jeder Schritt einen anderen Aspekt des Code Nodes hervorhebt:

1. Dateninitialisierung: Der n8n-Node 1. Sample Data initialisiert eine Liste von Benutzerobjekten. Der n8n-Node 2. Split Out Users stellt sicher, dass jeder Benutzer zu einem einzelnen Element wird, wodurch die Daten für die „Pro Element“-Verarbeitung vorbereitet werden.


2. Pro-Element-Transformation (Lokal): Der Code Node 3. Process Each User wird für jedes Benutzerelement ausgeführt. Er berechnet den fullName und das genaue age des Benutzers mithilfe von JavaScript-Datumsfunktionen.


3. Pro-Element-Transformation (Externe API): Der Code Node 4. Fetch External Data (Advanced) läuft weiterhin pro Element. Er demonstriert, wie this.helpers.httpRequest verwendet wird, um basierend auf dem Vornamen eine externe API (genderize.io) aufzurufen und die Daten um die Geschlechtsswahrscheinlichkeit anzureichern.


4. Aggregation: Der Code Node 5. Calculate Average Age schaltet in den Modus „Einmal für alle Elemente ausführen“ (Run Once for All Items). Er verwendet die Funktion $items(), um auf alle Ergebnisse der vorherigen Schritte zuzugreifen, und berechnet eine einzige Zusammenfassung, die die Gesamtzahl der Benutzer und das Durchschnittsalter enthält. Dies ist eine entscheidende Funktion des n8n Nodes bei der Verarbeitung großer Datenmengen.


5. Dateigenerierung (Experte): Der letzte Code Node 6. Create a Binary File (Expert) aggregiert die Daten erneut, generiert einen CSV-String und verwendet this.helpers.prepareBinaryData, um den String in eine sofort nutzbare Binärberichtsdatei innerhalb des n8n-Workflows umzuwandeln.

Um diesen n8n-Workflow zu installieren und zu testen, gehen Sie wie folgt vor:

1. JSON kopieren: Kopieren Sie den bereitgestellten n8n-Workflow-JSON-Code.


2. In n8n importieren: Klicken Sie in Ihrer n8n-Instanz auf „Neu“ und wählen Sie „Aus JSON importieren“. Fügen Sie den Code ein und klicken Sie auf „Importieren“.


3. Logik prüfen: Sehen Sie sich die an den Code Nodes angehefteten Haftnotizen an, um Erklärungen zum JavaScript-Code und den Ausführungsmodi zu erhalten.


4. Ausführen: Da der Start-Trigger von n8n ein Manueller Trigger ist, klicken Sie auf „Workflow ausführen“ und anschließend auf „Tutorial starten“, um den n8n-Workflow Schritt für Schritt auszuführen.


5. Ausgabe prüfen: Überprüfen Sie die Ausgabe jedes Code Nodes, um zu sehen, wie sich die Datenstruktur ändert – von einzelnen Elementen zu einem einzigen aggregierten Bericht, der sowohl JSON-Metadaten als auch eine binäre CSV-Datei enthält. Für diese spezielle n8n-Vorlage sind keine externen Anmeldeinformationen erforderlich.

Tutorial starten (Manueller Trigger): Der Startpunkt im n8n-Trigger zum manuellen Ausführen dieses n8n-Workflows.
1. Beispiel-Daten (Set n8n Node): Initialisiert den Workflow mit einem Beispiel-Array von Benutzerobjekten, das als Eingabe für das Tutorial dient.
2. Benutzer aufteilen (Split Out n8n Node): Essentieller n8n Node, der das einzelne Element mit dem Benutzer-Array in mehrere Einzelelemente umwandelt, sodass die nachfolgenden Code Nodes diese nacheinander verarbeiten können.
3. Jeden Benutzer verarbeiten (Code n8n Node): Funktion ist die Berechnung abgeleiteter Daten (fullName, age) für das aktuelle Element. Wichtige Konfiguration: Der Modus ist auf Einmal für jedes Element ausführen eingestellt.
4. Externe Daten abrufen (Erweitert) (Code n8n Node): Funktion ist die Demonstration asynchroner Operationen unter Verwendung von await this.helpers.httpRequest, um externe Daten (Geschlechtsschätzung) für den aktuellen Benutzer abzurufen. Wichtige Konfiguration: Der Modus ist auf Einmal für jedes Element ausführen eingestellt.
5. Durchschnittsalter berechnen (Code n8n Node): Funktion ist die Aggregation von Daten aus allen vorherigen Elementen. Es nutzt $items() und JavaScript reduce, um das Durchschnittsalter zu berechnen. Wichtige Konfiguration: Der Modus ist auf Einmal für alle Elemente ausführen eingestellt.

• 6. Binärdatei erstellen (Experte) (Code n8n Node): Funktion ist die Generierung eines CSV-Berichts aus den aggregierten Daten und deren Umwandlung in eine Binärdatei mithilfe von this.helpers.prepareBinaryData. Wichtige Konfiguration: Der Modus ist auf Einmal für alle Elemente ausführen eingestellt.