Code-Node

Ausführliche Erklärung

Code-Nodes erweitern die Möglichkeiten vorkonfigurierter Workflow-Bausteine, indem sie Anwenderinnen und Anwendern erlauben, maßgeschneiderte Programmlogik in einen automatisierten Ablauf einzubetten. In der weit verbreiteten Plattform n8n können Code-Nodes wahlweise JavaScript (unterstützt Node.js) oder Python ausführen und greifen dabei auf Daten vorheriger Workflow-Schritte zu. Der Code wird in einem integrierten Editor geschrieben und läuft in einer kontrollierten Umgebung – bei JavaScript in einer Sandbox, bei Python über einen Subprocess.

Für kleine und mittlere Unternehmen ist diese Funktion relevant, wenn Standard-Workflow-Bausteine an ihre Grenzen stoßen: etwa beim Umformatieren komplexer Datenstrukturen aus APIs, bei firmenspezifischen Berechnungen oder bei der Implementierung von Geschäftslogik, die sich nicht visuell abbilden lässt. Code-Nodes bieten dabei zwei Ausführungsmodi: "Run Once for All Items" verarbeitet alle eingehenden Datensätze in einem Durchlauf, während "Run Once for Each Item" den Code für jeden einzelnen Datensatz ausführt. n8n stellt integrierte Hilfsmethoden und Variablen zur Verfügung, auf die per Dollar-Syntax ($input, $node, $http) zugegriffen wird.

Zu beachten ist, dass bei selbst gehosteten n8n-Instanzen externe npm-Module eingebunden werden können, während die Cloud-Version aus Sicherheitsgründen nur ausgewählte integrierte Module zulässt. Python-Unterstützung ist ebenfalls primär für selbst gehostete Umgebungen verfügbar und nutzt Pyodide, eine WebAssembly-Portierung von CPython, was die Paketauswahl einschränkt. Code-Nodes ersetzen in n8n ab Version 0.198.0 die älteren Function- und Function-Item-Nodes und bieten eine einheitliche, flexiblere Schnittstelle.

Code-Beispiel

// Code-Node in n8n (JavaScript)
// Normalisiert Datumsfelder über alle Items
const items = $input.all();
const result = [];

for (const item of items) {
  const datum = item.json.buchungsdatum;
  // Umwandlung verschiedener Formate
  const normalized = new Date(datum)
    .toLocaleDateString('de-AT', {
      year: 'numeric',
      month: '2-digit',
      day: '2-digit'
    });
  
  result.push({
    json: {
      ...item.json,
      buchungsdatum: normalized
    }
  });
}

return result;