DokumentationWorkflowsLogik und Daten

Felder setzen Node

Felder anlegen, umbenennen oder entfernen, z.B. die Ausgabe eines Schritts in die Form bringen, die der nächste Schritt braucht. In Werten kannst du Platzhalter wie {{ $json.user.name }} verwenden. Hier findest du Einrichtung, Felder, Ein- und Ausgaben, Testablauf und Fehlerbehebung.

8 Min LesezeitAktualisiert am

Was Felder setzen macht

Felder anlegen, umbenennen oder entfernen, z.B. die Ausgabe eines Schritts in die Form bringen, die der nächste Schritt braucht. In Werten kannst du Platzhalter wie {{ $json.user.name }} verwenden.

  • Verarbeitet einen Eingang.
  • Stellt einen Ausgang für weitere Schritte bereit.
  • Wird als normaler Schritt in den Ablauf eingebunden.

Node einrichten

  1. 01Öffne einen Workflow und füge „Felder setzen“ über Bausteine hinzu.
  2. 02Fülle die erforderlichen Felder aus. Werte aus vorherigen Schritten kannst du als Variable einsetzen.
  3. 03Nutze Testdaten oder starte einen Testlauf und prüfe die Ausgabe des Nodes.
  4. 04Verbinde den erfolgreichen Ausgang mit dem nächsten Schritt und aktiviere den Workflow erst nach einem vollständigen Probelauf.

Aktionen und Betriebsarten

Felder setzen hat eine klar abgegrenzte Aufgabe. Die verfügbaren Einstellungen erscheinen direkt im Node-Panel, sobald du den Node auswählst.

Einstellungen

FeldBedeutungBereich
Felder setzenNeue Felder oder Überschreibungen. Wähle pro Zeile den Typ (String, Number, Boolean, JSON). Werte unterstützen `{{ $json.field }}`.Standard
ImportversionWird im Node-Panel konfiguriert.Erweitert
Unterfelder anlegenPunkte im Feldnamen legen Unterfelder an. customer.name speichert name innerhalb von customer.Erweitert
Wert bei Typfehler behaltenBehält den ursprünglichen Wert, wenn er nicht zum gewählten Datentyp passt.Erweitert
Dateien weitergebenBehält Dateien bei, die zusammen mit den Eingabedaten angekommen sind.Erweitert
Felder entfernenTrag die Feldnamen ein, die weg sollen, mehrere mit Komma trennen (z.B. tmp, debug). Wird vor dem Setzen neuer Felder ausgeführt.Erweitert
Felder umbenennenLinks der bestehende Feldname, rechts der neue. Wird vor dem Setzen neuer Felder ausgeführt.Erweitert
Nur gesetzte Felder behaltenWenn an: Input-Felder werden verworfen, nur die gesetzten Felder überleben.Erweitert

Eingaben und Ausgaben

EingabeBedeutungTyp
StandardDer Node übernimmt das vollständige Ergebnis des vorherigen Schritts.JSON
AusgabeBedeutungTyp
StandardDas Ergebnis steht dem nächsten Schritt als JSON zur Verfügung.JSON

Beispiel und Testlauf

Status + Counter setzen: Starte den Node zunächst mit einem kleinen, eindeutig erkennbaren Datensatz. Öffne danach die Ausgabe und verwende nur Felder, die dort tatsächlich vorhanden sind.

Beispiel für einen Testlauf

{
  "name": "Alice",
  "score": 42
}

Zugriff und Sicherheit

Prüfe vor der Aktivierung, welche Daten in diesen Schritt gelangen und welche Daten seine Ausgabe enthält.

Schlüssel und Zugangsdaten gehören in die geschützte Verbindungsverwaltung. Trage sie nicht als normalen Text in Workflow-Felder, Testdaten oder Beschreibungen ein.

Häufige Fehler beheben

  • Keine Ausgabe: Prüfe den letzten Testlauf und ob der vorherige Node die erwarteten Felder geliefert hat.
  • Variable bleibt leer: Öffne die Ausgabe des vorherigen Schritts und übernimm den Feldnamen aus den echten Testdaten.