Häufige Probleme und Lösungen
Workflow wird nicht ausgelöst
Symptome: Ihr Workflow wird nicht ausgeführt, wenn Sie es erwarten.
Mögliche Ursachen:
- Workflow nicht aktiviert: Stellen Sie sicher, dass der Workflow auf “Active” und nicht auf “Draft” gesetzt ist
- Trigger-Bedingungen nicht erfüllt: Überprüfen Sie, ob der Trigger Ihrem erwarteten Ereignis entspricht
- Feld nicht überwacht: Bei “Record is Updated”-Triggern stellen Sie sicher, dass das betreffende Feld überwacht wird
- Berechtigungen: Prüfen Sie, ob Sie die Berechtigung haben, Workflows auszuführen
Lösungen:
- Überprüfen Sie den Workflow-Status in der Workflow-Liste
- Testen Sie mit der spezifischen Aktion, von der Sie erwarten, dass sie ihn auslöst
- Überprüfen Sie die Trigger-Konfiguration
- Wenden Sie sich wegen der Berechtigungen an Ihren Administrator
Workflow-Trigger zu früh (leere Felder)
Symptome: Beim manuellen Erstellen eines Datensatzes in der UI wird Ihr Workflow ausgelöst, bevor Sie alle Felder ausfüllen konnten. Der Workflow läuft mit überwiegend leeren Feldwerten.
Warum das passiert: Twenty speichert alles in Echtzeit — es gibt keinen separaten “edit”- vs. “read”-Modus. Wenn Sie einen Datensatz erstellen, wird er sofort gespeichert und löst das Ereignis “Record is created” aus, bevor Sie weitere Felder ausfüllen können.
Wann “Record is created” gut funktioniert:
- Über API-Aufrufe erstellte Datensätze (Felder werden in einer einzigen Anfrage befüllt)
- Über Import erstellte Datensätze
- Automatisches Erstellen von Datensätzen aus anderen Workflows
Lösung: Für Datensätze, die manuell in der UI erstellt werden, verwenden Sie stattdessen “Record is created or updated” als Trigger. Auf diese Weise:
- Der Workflow wird ausgelöst, nachdem der Benutzer das Ausfüllen und Speichern der Felder abgeschlossen hat
- Sie erhalten die vollständigen Daten statt leerer Werte
Wenn der Workflow nur einmal pro Datensatz ausgeführt werden soll, fügen Sie eine Filter-Aktion hinzu, um ein Feld wie createdAt equals updatedAt (erste Speicherung) zu prüfen, oder verwenden Sie ein benutzerdefiniertes Kontrollkästchen, um zu verfolgen, ob der Workflow bereits ausgeführt wurde.
Fehlgeschlagene Aktionen
Symptome: Der Workflow wird ausgeführt, aber einige Aktionen schlagen fehl.
Mögliche Ursachen:
- Fehlende Daten: Erforderliche Felder sind leer
- Ungültige Verweise: Variablen aus vorherigen Schritten existieren nicht
- API-Fehler: Externe Dienste liefern Fehler zurück
- Berechtigungsprobleme: Die Aktion erfordert Berechtigungen, die Sie nicht haben
Lösungen:
- Überprüfen Sie die Details der Workflow-Ausführung auf Fehlermeldungen
- Stellen Sie sicher, dass alle Pflichtfelder Werte haben
- Testen Sie die API-Verbindungen separat
- Überprüfen Sie die Rollenberechtigungen
Fehler bei HTTP-Anfragen
Symptome: HTTP-Request-Aktionen schlagen fehl oder liefern unerwartete Ergebnisse.
Häufige Fehlercodes:
- 400: Ungültige Anfrage - überprüfen Sie das Format des Request-Body
- 401: Nicht autorisiert - überprüfen Sie den API-Schlüssel
- 403: Verboten - überprüfen Sie die API-Berechtigungen
- 404: Nicht gefunden - überprüfen Sie die Endpunkt-URL
- 429: Zu viele Anfragen - implementieren Sie eine Ratenbegrenzung
- 500: Serverfehler - Problem mit dem externen Dienst
Lösungen:
- Überprüfen Sie die API-Endpunkt-URL
- Überprüfen Sie die Authentifizierungs-Header
- Testen Sie den API-Aufruf zunächst außerhalb von Twenty
- Fügen Sie Fehlerbehandlung in Code-Aktionen hinzu
Fehler in Code-Aktionen
Symptome: JavaScript-Code wird nicht ausgeführt.
Häufige Probleme:
- Syntaxfehler: Tippfehler oder ungültiges JavaScript
- Undefinierte Variablen: Verweise auf Variablen, die nicht existieren
- Typfehler: Operationen auf falschen Datentypen
- Timeouts: Code benötigt zu lange zur Ausführung
Lösungen:
- Verwenden Sie die integrierte Validierung des Code-Editors
- Testen Sie die Code-Logik zuerst in einer JavaScript-Konsole
- Fügen Sie console.log-Anweisungen zum Debuggen hinzu
- Vereinfachen Sie komplexe Operationen
E-Mail wird nicht gesendet
Symptome: Die Aktion “Send Email” liefert keine E-Mails aus.
Mögliche Ursachen:
- Kein E-Mail-Konto verbunden: Prüfen Sie Settings → Accounts
- Ungültige E-Mail-Adresse: Die E-Mail-Adresse des Empfängers ist fehlerhaft
- Sendelimits: Ratenbegrenzung des E-Mail-Anbieters erreicht
- Spamfilter: E-Mails werden blockiert
Lösungen:
- Überprüfen Sie die Verbindung des E-Mail-Kontos
- Validieren Sie die E-Mail-Adressen der Empfänger
- Überprüfen Sie die Limits des E-Mail-Anbieters
- Überprüfen Sie den E-Mail-Inhalt auf Spam-Auslöser
Workflows debuggen
Workflow-Läufe verwenden
- Gehen Sie zum Workflow-Editor
- Öffnen Sie das Panel Runs
- Finden Sie den fehlgeschlagenen Lauf
- Klicken Sie, um die Details Schritt für Schritt zu sehen
- Überprüfen Sie Fehlermeldungen und Ausgabedaten
Einzelschritte testen
- Für Code-Aktionen verwenden Sie die Schaltfläche Test
- Für HTTP-Anfragen testen Sie den Endpunkt separat
- Erstellen Sie Testdatensätze, um Workflows auszulösen
- Verwenden Sie manuelle Trigger für kontrollierte Tests
Häufige Debugging-Muster
Logging hinzufügen:
Verwenden Sie Code-Aktionen, um Zwischenwerte zum Debuggen zu protokollieren.
Schritte isolieren:
Testen Sie jeden Schritt unabhängig, um Fehler zu identifizieren.
Datenfluss prüfen:
Stellen Sie sicher, dass jeder Schritt die erwarteten Eingabedaten erhält.
Bewährte Verfahren zur Vermeidung von Problemen
Vor der Aktivierung
- Testen Sie im Entwurfsmodus gründlich
- Validieren Sie alle API-Verbindungen
- Überprüfen Sie die Trigger-Bedingungen sorgfältig
- Dokumentieren Sie das erwartete Verhalten
Während der Entwicklung
- Verwenden Sie aussagekräftige Schrittnamen
- Fügen Sie Kommentare in Code-Aktionen hinzu
- Testen Sie mit realistischen Daten
- Planen Sie für Randfälle
Nach der Aktivierung
- Überwachen Sie die ersten Läufe genau
- Richten Sie Benachrichtigungen für Fehler ein
- Überprüfen Sie den Ausführungsverlauf regelmäßig
- Halten Sie Workflows nach Möglichkeit einfach
