Durch das Debuggen können du verstehen, was in einem Workflow passiert, den problematischen Schritt identifizieren und die zwischen verschiedenen Blöcken übergebenen Daten überprüfen.
Es gibt zwei Hauptsituationen:
- Debugging während der Workflow-Einrichtung;
- Debuggen eines bereits veröffentlichten Workflows.
¶ 1. Debuggen du während der Workflow-Einrichtung
Beim Erstellen oder Ändern eines Workflows wird empfohlen, die Schritte schrittweise zu testen.
¶ Testest du zuerst den Auslöser
Beginnen du mit der Konfiguration des Workflow-Triggerblocks, zum Beispiel:
- manuelle Auslösung;
- Empfangen eines Webhooks;
- Einreichen eines Formulars;
- eine geplante Ausführung.
Verwendet die Test-Trigger-Schaltfläche, um Beispieldaten abzurufen.
Bei einigen Auslösern müssen du das erwartete Ereignis tatsächlich auslösen. Um beispielsweise einen Webhook zu testen, senden du eine Anfrage an die von Robin bereitgestellte URL.
Sobald der Test abgeschlossen ist, zeigt Robin die vom Trigger erzeugten Daten an. Diese Daten können in nachfolgenden Schritten des Workflows verwendet werden.
¶ Testest du die Blöcke Schritt für Schritt
Nachdem du den Auslöser getestet haben, konfigurieren und testest du dann jeden Block in der Reihenfolge des Workflows.
Für jeden neuen Block:
- konfiguriert seine Einstellungen;
- wählt Daten aus vorherigen Schritten aus;
- startet seinen Test;
- prüft das Ergebnis, bevor es zum nächsten Block übergeht.
Mit dieser Methode können du den Schritt, der ein Problem verursacht, sofort identifizieren.
Ein Block kann grundsätzlich nur dann korrekt getestet werden, wenn vorhergehende Blöcke bereits über Testdaten verfügen.
¶ Untersuche den Ein- und Ausgang eines Blocks
Untersucht nach dem Testen eines Blocks die in seinem Ergebnis angezeigten Daten.
Überprüfen du insbesondere:
- die vom Block empfangenen Daten;
- die aus den vorherigen Schritten berechneten Parameter;
- die produzierte Ausgabe;
- etwaige Fehlermeldungen;
- die in den folgenden Schritten verwendeten Bezeichner, Daten, Status oder Werte.
Die Daten fließen im Workflow von oben nach unten. Jeder Block kann die von vorherigen Blöcken erzeugten Ausgaben verwenden.
Wenn ein Suchblock beispielsweise keine Elemente zurückgibt, erhalten nachfolgende Blöcke möglicherweise eine leere Liste oder einen nicht vorhandenen Wert.
¶ Überprüfen du die in dynamischen Feldern verwendeten Daten
Wenn ein Feld Daten aus einem vorherigen Schritt verwendet, überprüfen du Folgendes:
- der richtige Quellblock ist ausgewählt;
- das richtige Feld wird verwendet;
- der Wert existiert tatsächlich in den Testdaten;
- der Datentyp ist korrekt;
- Der Wert entspricht dem vom Block erwarteten Format.
Beispiele für häufige Probleme:
- Verwendung einer Kennung anstelle eines Namens;
- Verwenden von Text anstelle einer Liste;
- Datum in falschem Format angegeben;
- Feld fehlt bei einigen Ereignissen;
- leere Liste;
- Ungültige Verbindung oder Autorisierung.
¶ Testest du die verschiedenen Zweige
Wenn dein Workflow über einen Router, eine Bedingung oder mehrere Zweige verfügt, testest du jeden Fall separat.
Bereitet Daten zur Überprüfung vor:
- der Fall, in dem die Bedingung wahr ist;
- der Fall, in dem die Bedingung falsch ist;
- jeder mögliche Wert eines Routers;
- das Verhalten bei fehlenden Daten;
- das Verhalten, wenn kein Element gefunden wird.
Nur weil ein Zweig funktioniert, heißt das nicht, dass die anderen auch funktionieren.
¶ Hüten du sich vor unveröffentlichten Änderungen
Im Editor vorgenommene Änderungen bleiben in einer Entwurfsversion, bis du sie veröffentlichen.
Der automatisch ausgeführte Workflow verwendet weiterhin die neueste veröffentlichte Version. Denkst du daran, die neue Version zu veröffentlichen, damit deine Änderungen wirksam werden.
¶ 2. Debuggen du einen veröffentlichten Workflow
Sobald der Workflow veröffentlicht ist, erfolgt das Debuggen anhand des Ausführungsverlaufs.
¶ Ausführungen ansehen
Von Robin:
- Öffnen du das Menü Ausführungen ;
- sucht nach der betreffenden Ausführung;
- Schaust du sich seinen Status an.
So können du überprüfen, ob der Workflow zu welchem Zeitpunkt tatsächlich gestartet wurde und ob er erfolgreich war.
¶ Vergleichst du eine erfolgreiche Ausführung und eine fehlerhafte Ausführung
Wenn der Workflow zuvor funktioniert hat, wird eine alte erfolgreiche Ausführung mit der fehlerhaften Ausführung verglichen.
Achten du insbesondere auf einen Unterschied in:
- die vom Trigger empfangenen Daten;
- das Vorhandensein oder Fehlen eines Feldes;
- das Format eines Werts;
- die verwendete Verbindung;
- der Zweig folgte;
- die Antwort einer externen Anwendung.
Dieser Vergleich hilft oft dabei, festzustellen, ob das Problem beim Workflow selbst oder bei den verarbeiteten Daten liegt.
¶ Korrigieren und dann erneut veröffentlichen
Nachdem du das Problem identifiziert haben:
- kehrt zum Workflow-Editor zurück;
- korrigiert die Konfiguration;
- testet die relevanten Schritte erneut;
- veröffentlicht die neue Version;
- verursacht eine neue Ausführung;
- prüft sein Ergebnis im Ausführungsverlauf.
An einem Entwurf vorgenommene Änderungen werden erst berücksichtigt, wenn du die neue Version veröffentlichen.
¶ Best Practices
Bei der Entwicklung eines Workflows:
- testet die Blöcke in ihrer Ausführungsreihenfolge;
- prüft systematisch die Ausgabe jedes Blocks;
- testet die verschiedenen Zweige und Bedingungen;
- verwendet Daten, die für reale Fälle repräsentativ sind;
- prüft Fälle, in denen Daten oder eine Liste leer sind;
- veröffentlicht nach einer Korrektur immer erneut;
- steuert die tatsächliche Ausführung nach der Veröffentlichung.
Die Hauptregel ist einfach:
Testest du während der Konfiguration jeden Block und überprüfen du seine Ausgabe. Sobald der Workflow veröffentlicht ist, überprüfen du die Ausführungen, um zu sehen, welche Schritte abgeschlossen wurden, und um schnell zu ermitteln, bei welchem Schritt ein Problem vorliegt.
Diese Seite scheint dir nicht klar zu sein oder benötigen du Hilfe? Zögern du nicht, uns zu kontaktieren support@zozio.tech !