Troubleshooting

Typische Probleme & Lösungen

Problem: Mein Workflow schlägt mit einem 401 Unauthorized-Fehler fehl.

• Ursache: Deine Credentials (API-Key, Token, etc.) sind falsch, abgelaufen oder haben nicht die nötigen Berechtigungen.

1

Prüfe die Credentials

Gehe zu Settings > Credentials und öffne die betreffenden Credentials.

2

Vergleiche Werte exakt

Überprüfe, ob der API-Key oder das Token exakt mit dem aus dem Drittsystem übereinstimmt (keine Leerzeichen!).

3

OAuth2 & Token erneuern

Wenn du OAuth2 verwendest, versuche, das Token manuell zu erneuern.

4

Prüfe Scopes / Berechtigungen im Drittsystem

Überprüfe im Drittsystem, ob der API-Key noch gültig ist und die erforderlichen Berechtigungen (Scopes) hat (z.B. read:orders, write:products).

---

Problem: Mein If-Knoten funktioniert nicht wie erwartet und geht immer in den falschen Pfad.

• Ursache: Meistens liegt es am Datentyp-Vergleich oder an der genauen Syntax der Expression.

1

Logge den Input

Füge direkt vor dem If-Knoten einen Log-Knoten ein und gib den Wert aus, den du prüfen möchtest (Value 1 in deiner Bedingung). Schau dir im Log-Fenster den genauen Wert und seinen Datentyp an.

2

Typ-Vergleich

Achte darauf, dass du die richtigen Typen vergleichst. Der String "5" ist nicht dasselbe wie die Zahl 5. Wähle im If-Knoten den korrekten Datentyp für Value 2 aus (String, Number, Boolean).

3

Expression-Syntax prüfen

Überprüfe deine {{...}}-Expression auf Tippfehler. Ein fehlendes json oder ein falscher Knotenname sind häufige Fehlerquellen.

---

Problem: Ein Wert aus einem vorherigen Knoten ist in einem späteren Knoten "undefined" oder nicht verfügbar.

• Ursache: Der Knoten, der die Daten liefert, wurde noch nicht ausgeführt, oder du greifst auf den falschen Teil des Output-Objekts zu.

1

Ausführungsreihenfolge prüfen

Stelle sicher, dass die Verbindungslinien (Noodles) korrekt vom datenliefernden zum datenempfangenden Knoten verlaufen.

2

Output inspizieren

Klicke im Test-Fenster auf den datenliefernden Knoten und schau dir seine Output-Daten genau an. Wie ist die Struktur? Liegt der Wert, den du brauchst, direkt im json-Objekt oder ist er tiefer verschachtelt?

3

Expression anpassen

Passe deine Expression an die Struktur an. Wenn der Output z.B. {"data": {"id": 123}} ist, musst du mit {{$node["NodeName"].json.data.id}} darauf zugreifen.

---

Problem: Mein Loop over Items-Knoten startet nicht oder wirft einen Fehler.

• Ursache: Der Input für den Loop-Knoten ist kein Array.

1

Output des vorherigen Knotens prüfen

Überprüfe den Output des Knotens, der die Daten für die Schleife liefert.

2

Sicherstellen, dass ein Array übergeben wird

Stelle sicher, dass der Wert, den du an den Loop-Knoten übergibst, ein JSON-Array ist (erkennbar an den eckigen Klammern [...]).

3

Einzelobjekt in Array umwandeln

Wenn der API-Call bei nur einem Ergebnis kein Array, sondern nur ein einzelnes Objekt zurückgibt, musst du dies mit einem If-Knoten oder einem Function-Knoten abfangen und das einzelne Objekt manuell in ein Array mit einem Element packen: [ { ... } ].

---

Problem: Mein Workflow bricht ohne ersichtlichen Grund oder Fehlermeldung ab.

• Ursache: Oft liegt dies an einem nicht behandelten Fehler in einem Function-Knoten (JavaScript) oder an einem Speicherlimit, wenn extrem große Datenmengen verarbeitet werden.

1

JavaScript-Fehler abfangen

Wickle den Code in deinem Function-Knoten in einen try...catch-Block und gib den Fehler im catch-Block mit console.error(e) aus. Dieser Fehler erscheint dann in den Logs.

2

Datenmenge reduzieren

Überprüfe, ob du wirklich alle Daten laden musst. Kannst du die Anfrage mit Filtern einschränken? Verarbeitest du vielleicht versehentlich 100.000 statt 100 Datensätze?

3

Logs Schritt für Schritt prüfen

Gehe die Logs Schritt für Schritt durch. Welcher war der letzte Knoten, der erfolgreich ausgeführt wurde? Das Problem liegt meist im direkt darauffolgend.