Testen und Durchläufe

Bevor eine Automation für Ihre Mitglieder arbeitet, möchten Sie sehen, dass sie für Sie funktioniert. Ein Testlauf startet sie einmal auf Abruf. Die Durchläufe zeigen dann jeden Lauf, echt oder Test, Schritt für Schritt, damit Sie sehen, was passiert ist und warum ein Lauf fehlgeschlagen ist.

Automationen öffnen

Was ein Testlauf wirklich tut

Ein Testlauf ist keine Simulation. Er führt die Automation einmal aus, sofort:

• Aktionen werden wirklich ausgeführt. E-Mails gehen hinaus, Tags, Gruppen und Kurszugänge ändern sich, und Webhooks und externe Anfragen werden gesendet. Testen Sie mit Ihrem eigenen Konto oder einem Testmitglied, nicht mit einem echten Kunden.
• Er verwendet die neueste gespeicherte Version, auch wenn Sie sie noch nicht veröffentlicht haben. Echte Ereignisse verwenden weiter die veröffentlichte Version, bis Sie veröffentlichen.
• Er funktioniert auch, während die Automation ausgeschaltet ist.
• Erreicht der Ablauf einen Schritt Verzögerung oder Bis Datum warten, wartet der Testlauf wie ein echter Lauf. Die restlichen Schritte laufen echt, sobald das Warten vorbei ist.
• Ein Schritt Workflow ausführen startet die andere Automation echt. Dieser Lauf erscheint in den Durchläufen der anderen Automation mit der Quelle Automatisch.
• Jede Integration, die der Ablauf verwendet, muss verbunden sein. Sonst stoppt der Test mit „Verbinden Sie zuerst diese Integrationen:“ und den fehlenden Namen.

Testläufe zählen in der Liste nicht: Letzter Lauf, Läufe (7 T.), Erfolg (7 T.) und die Ansicht Fehlgeschlagen ignorieren sie. Ein fehlgeschlagener Test markiert Ihre Automation nicht als fehlgeschlagen.

Eine Automation erstellen

Einen Testlauf aus der Liste starten

Öffnen Sie in der Liste das Menü einer Automation und wählen Sie Testlauf. Der Dialog erklärt: „Führt den aktuellen Entwurf einmal mit leerem Test-Payload aus. Aktionen werden wirklich ausgeführt.“ Dieser Test startet ohne Auslöserdaten und ohne Mitglied. Er eignet sich für eine schnelle Prüfung. Um mit einem Mitglied oder eigenen Daten zu testen, starten Sie den Test im Editor.

Hat die Automation mehrere Auslöser, wählen Sie einen unter Mit Trigger starten. Klicken Sie dann auf Testlauf starten. Das Ergebnis erscheint im selben Dialog:

• Testlauf abgeschlossen, mit der Dauer.
• Der Testlauf wartet an einem Verzögerungs- oder Warteschritt, wenn der Ablauf an einem Schritt Verzögerung oder Bis Datum warten pausiert. Der Rest folgt später.
• Testlauf fehlgeschlagen, mit der Fehlermeldung des Laufs.

Erneut ausführen startet einen weiteren Test. Hat die Automation keinen Auslöser, zeigt der Dialog „Diese Automation hat keinen Trigger als Startpunkt.“

Einen Testlauf im Editor starten

Klicken Sie im Kopf des Editors auf Testlauf. Der Dialog bietet mehr Kontrolle:

• Haben Sie ungespeicherte Änderungen, sagt ein Hinweis „Ungespeicherte Änderungen werden vor dem Testlauf gespeichert.“ Der Test speichert zuerst und startet dann. Schlägt das Speichern fehl, startet der Test nicht.
• Bei einem Auslöser nennt der Dialog ihn. Bei mehreren wählen Sie einen unter Trigger.
• Payload sind die Daten, die der Auslöser liefern würde. Es beginnt als {}. Geben Sie die Felder ein, die Ihre Schritte lesen, zum Beispiel das Feld, das eine Bedingung prüft, oder das ein Platzhalter wie {{order_id}} verwendet: {"order_id": 1042, "amount": 4900}. Solange der Text kein gültiges JSON ist, zeigt der Dialog „Ungültiges JSON. Bitte überprüfen Sie die Payload und versuchen Sie es erneut.“ und läuft nicht.
• Mitglieds-UUID ist das Mitglied, um das es im Lauf geht. Aktionen, die auf ein Mitglied wirken, zum Beispiel einen Tag hinzufügen oder einen Kurs vergeben, brauchen eines. Lassen Sie das Feld bei Abläufen ohne Mitglied leer, etwa bei einem Zeitplan oder einem Webhook. Die UUID finden Sie am Ende der Webadresse, wenn Sie das Mitglied im Adminbereich öffnen. Eine unbekannte UUID stoppt den Test mit „Dieses Mitglied wurde in diesem Business nicht gefunden.“

Klicken Sie auf Testlauf ausführen. Der Dialog schließt sich, die Durchläufe öffnen sich, und die Arbeitsfläche zeigt den neuen Lauf.

Diese Meldungen stoppen einen Test, bevor er beginnt:

• „Speichern Sie die Automation einmal, bevor Sie einen Testlauf starten.“
• „Fügen Sie einen Auslöser hinzu und speichern Sie, bevor Sie einen Testlauf starten.“
• „Dieser Auslöser ist noch nicht in der gespeicherten Version. Speichern Sie und versuchen Sie es erneut.“
• „Diese Automation hat keine Trigger zum Testen.“

Die Durchläufe

Klicken Sie im Kopf des Editors auf Durchläufe. Die Schaltfläche funktioniert, sobald die Automation gespeichert ist. Das Panel listet die 50 neuesten Läufe, die zu Ihren Filtern passen, die neuesten zuerst, und aktualisiert sich alle paar Sekunden. Jeder Eintrag zeigt den Status, die Quelle, den Auslöser, wann der Lauf begann und, sobald er beendet ist, wie lange er gedauert hat. Bei einem wartenden Lauf zeigt er außerdem, wann er weitergeht.

Status

• Wird ausgeführt: Der Lauf ist im Gang.
• Wartet: Der Lauf wartet an einem Schritt Verzögerung oder Bis Datum warten. Der Eintrag zeigt Weiter ab mit Datum und Uhrzeit in Ihrer Ortszeit, zu der er weitergeht. Warten mehrere Pfade, ist es die früheste Zeit.
• Abgeschlossen: Der Lauf hat sein Ende erreicht.
• Fehlgeschlagen: Ein Schritt ist fehlgeschlagen oder der Lauf hat eine Grenze erreicht. Öffnen Sie den Lauf, um zu sehen, warum.
• Abgebrochen: Der Lauf hat gewartet und wurde gestoppt, weil die Automation ausgeschaltet, archiviert oder gelöscht wurde. Mehr dazu weiter unten.

Quelle

• Automatisch: Etwas in Ihrer Plattform hat den Lauf gestartet, zum Beispiel ein neues Mitglied oder eine Bestellung. Läufe, die ein Schritt Workflow ausführen einer anderen Automation gestartet hat, zeigen ebenfalls diese Quelle.
• Zeitplan: Die Uhr der Plattform hat den Lauf gestartet. Das betrifft die Auslöser Nach Zeitplan (Cron), Mitglied inaktiv, Event beginnt bald und Verlängerung steht bevor.
• Manuell: ein Testlauf oder eine Wiederholung.
• Webhook: ein eingehender Webhook oder ein Aufruf eines externen Dienstes.
• Sonstige: jeder andere Start.

Filter

Über der Liste können Sie nach Status (Beliebiger Status), nach Quelle (Beliebige Quelle) und nach einem Startdatum mit Uhrzeit unter Seit filtern. Es gibt keinen eigenen Statusfilter für wartende Läufe: Sie erscheinen unter Wird ausgeführt. Filter zurücksetzen setzt alle Filter zurück und zeigt, wie viele aktiv sind. Passt nichts, sagt das Panel „Keine Durchläufe entsprechen Ihren Filtern“ mit einem Link Alle anzeigen. Vor dem ersten Lauf steht dort „Noch keine Durchläufe“.

Einen Lauf ansehen

Klicken Sie in der Liste auf einen Lauf. Die Arbeitsfläche wechselt zu diesem Lauf und zeigt den Ablauf so, wie er in der Version war, die der Lauf verwendet hat. Ein Banner oben zeigt, wann der Lauf begann, seinen Status und „Die Wiedergabe ist schreibgeschützt.“ Sie können nicht bearbeiten, während Sie einen Lauf ansehen. Wiedergabe beenden bringt Ihren aktuellen Entwurf zurück.

Jeder Schritt, den der Lauf erreicht hat, bekommt einen farbigen Ring und ein kleines Badge:

• Grün: Abgeschlossen.
• Rot: Fehlgeschlagen.
• Blau: Wird ausgeführt.
• Lila mit einer Sanduhr: Wartet. Der Schritt ist ein Schritt Verzögerung oder Bis Datum warten, und der Lauf geht später weiter.
• Grau: Übersprungen. Der Schritt wurde ausgelassen, zum Beispiel weil ein Filter diesen Pfad gestoppt hat oder der Lauf während des Wartens abgebrochen wurde.

Schritte ohne Ring wurden nicht erreicht.

Klicken Sie auf einen Schritt, um ihn im Panel rechts zu öffnen. Einstellungen zeigt seine Konfiguration, schreibgeschützt. Durchlauf zeigt, was passiert ist:

• Status, Gestartet und Beendet. Ein wartender Schritt zeigt Weiter ab mit der Zeit, zu der der Lauf weitergeht.
• Eingabe und Ausgabe: die Daten, die der Schritt bekommen und weitergegeben hat.
• Ein roter Kasten mit dem Fehler, wenn der Schritt fehlgeschlagen ist. Trace anzeigen öffnet technische Details, die Sie an den Support senden können.
• Ein gelber Hinweis an einem abgeschlossenen Schritt bedeutet, dass der Schritt lief, aber nichts geändert hat, zum Beispiel „The member already has this badge.“

Ein Schritt, den der Lauf nie erreicht hat, zeigt „Kein Trace verfügbar“. Ist der ganze Lauf fehlgeschlagen, zeigt das Banner zusätzlich den Fehler des Laufs in Rot.

Einen Lauf wiederholen

Wiedergeben im Banner startet den Lauf erneut. Nach der Frage Diesen Durchlauf erneut ausführen? warnt der Dialog: „Führt den aktuellen Entwurf erneut mit derselben Payload aus. Aktionen werden wirklich ausgeführt.“ Die Wiederholung verwendet dieselben Auslöserdaten und dasselbe Mitglied wie der ursprüngliche Lauf, aber die neueste gespeicherte Version Ihres Ablaufs. Damit ist sie der schnellste Weg, eine Korrektur zu prüfen: fehlgeschlagenen Lauf finden, Schritt korrigieren, speichern, wiederholen.

Die Wiederholung ist ein neuer Lauf mit der Quelle Manuell, und die Arbeitsfläche wechselt sofort zu ihm. Haben Sie den Auslöser seit dem ursprünglichen Lauf ersetzt, stoppt die Wiederholung mit „Den Auslöser dieses Laufs gibt es in der aktuellen Version nicht mehr. Starten Sie stattdessen einen neuen Testlauf.“

Fehlschläge in der Liste erkennen

Sie müssen nicht jede Automation öffnen, um Probleme zu finden. Die Liste zeigt sie, nur auf Basis echter Läufe:

• Die Ansicht Fehlgeschlagen neben Ihren Ordnern listet jede Automation, deren letzter Lauf fehlgeschlagen ist. Gibt es keine, zeigt sie Keine fehlgeschlagenen Automationen.
• Die Spalte Letzter Lauf zeigt Nie oder die Zeit des letzten Laufs mit einem farbigen Punkt: grün für abgeschlossen, blau für laufend, grau für abgebrochen. Ein fehlgeschlagener letzter Lauf erscheint als rotes Badge mit dem Tooltip Letzter Lauf fehlgeschlagen.
• Erfolg (7 T.) ist der Anteil der abgeschlossenen Läufe an den beendeten Läufen der letzten sieben Tage. Laufende Läufe zählen nicht. Fehlgeschlagene und abgebrochene Läufe senken ihn. Läufe (7 T.) zählt alle Läufe der letzten sieben Tage und ist standardmäßig ausgeblendet.
• Der Filter Status letzter Lauf findet Automationen nach Abgeschlossen, Fehlgeschlagen, Läuft, Abgebrochen oder Nie.

Von dort öffnen Sie die Automation, öffnen Durchläufe, filtern nach Fehlgeschlagen und klicken auf den Lauf, um zu sehen, welcher Schritt fehlgeschlagen ist und warum.

Aktivität: wer was geändert hat

Aktivität im Menü einer Automation listet ihre letzten 50 Änderungen, jede mit Person und Uhrzeit: Erstellt, Gespeichert, Veröffentlicht, Zurückgesetzt, Aktiviert, Deaktiviert, Archiviert, Archivierung aufgehoben, Gelöscht, Dupliziert, Importiert für eine Automation aus einer Vorlage und Webhook-Secret erneuert. Änderungen, die für mehrere Automationen gleichzeitig gemacht wurden, erscheinen bei jeder von ihnen. Testläufe und Wiederholungen gehören nicht zur Aktivität; Sie finden sie in den Durchläufen. Eine neue Automation ohne Änderungen zeigt „Noch keine Aktivität.“

Automationen im Überblick

Was mit wartenden Läufen passiert

Ein Lauf, der an einem Schritt Verzögerung oder Bis Datum warten wartet, prüft die Automation erneut, wenn das Warten vorbei ist:

• Ausgeschaltet: Ein echter Lauf, der fällig wird, während die Automation aus ist, wird abgebrochen. Seine restlichen Schritte laufen nicht. Schalten Sie die Automation wieder ein, bevor das Warten endet, geht der Lauf normal weiter. Testläufe und Wiederholungen gehen auch weiter, während die Automation aus ist.
• Archiviert: Der Lauf wird abgebrochen, Testläufe eingeschlossen. Das Archivieren schaltet die Automation außerdem aus.
• Gelöscht: Der Lauf wird abgebrochen.
• Neue Version veröffentlicht: Ein Lauf, der schon begonnen hat, endet mit der Version, mit der er begonnen hat. Nur Läufe, die nach dem Veröffentlichen beginnen, verwenden die neue Version. Dasselbe gilt für ein Zurücksetzen.

Ein abgebrochener Lauf zeigt in den Durchläufen Abgebrochen, und sein wartender Schritt wird zu Übersprungen. Der Fehler des Laufs sagt, warum: „Die Automation wurde pausiert, während der Lauf wartete.“, oder dasselbe mit archiviert oder gelöscht.

Bedingungen, Verzweigungen und Verzögerungen

Wie lange Läufe aufbewahrt werden

Die Durchläufe bewahren Läufe 90 Tage auf. Einmal am Tag werden ältere Läufe zusammen mit der Eingabe und Ausgabe ihrer Schritte gelöscht. Läufe, die noch warten, bleiben erhalten, bis sie beendet sind.

Häufige Fehler und was sie bedeuten

Probleme, die der Editor markiert

Der Editor markiert Schritte mit Problemen, bevor Sie irgendetwas ausführen. Speichern funktioniert trotzdem, aber die Automation verhält sich womöglich nicht wie erwartet:

• „Beim Auslöser ist kein Ereignistyp ausgewählt.“: Wählen Sie, worauf der Auslöser reagiert.
• „Ein Auslöser sollte keine eingehende Verbindung haben.“: Ein Auslöser startet den Ablauf immer. Entfernen Sie die Verbindung, die in ihn hineinführt.
• „Bei der Aktion ist kein Typ ausgewählt.“: Wählen Sie, was die Aktion tut.
• „Die Aktion benötigt eine Integration, aber es ist keine ausgewählt.“ und „Die benötigte Integration ist nicht verbunden.“: Verbinden Sie den Dienst unter Integrationen und wählen Sie die Verbindung im Schritt aus.
• „„Tage inaktiv“ muss mindestens 1 sein.“, „„Tage vor Verlängerung“ muss mindestens 1 sein.“ und „„Stunden vor Beginn“ muss mindestens 1 sein.“: Die Auslöser Mitglied inaktiv, Verlängerung steht bevor und Event beginnt bald starten nie ohne diese Zahl. Geben Sie eine ganze Zahl ab 1 ein.
• „Die Verzögerung hat keine Dauer.“: Geben Sie eine Dauer größer als null ein.
• „Für „Workflow ausführen“ ist kein Workflow ausgewählt.“: Wählen Sie die Automation, die der Schritt starten soll.
• „Keine eingehende Verbindung. Dieser Knoten ist nicht erreichbar.“: Verbinden Sie den Schritt mit dem Ablauf oder löschen Sie ihn.
• „Der Ablauf hat keinen Auslöser.“: Fügen Sie einen Auslöser hinzu.
• „Auf Webhook antworten läuft nach einem Verzögerungs- oder Warteschritt. Der Webhook-Aufrufer erhält stattdessen die Standardantwort.“: Setzen Sie die Antwort vor das Warten.

Fehler in einem fehlgeschlagenen Lauf

Der Fehler eines fehlgeschlagenen Laufs nennt den Schritt und seinen Typ, zum Beispiel „Schritt "E-Mail senden" (Aktion) ist fehlgeschlagen.“ oder „Schritt "E-Mail senden" (Aktion) wurde mit einem Fehler beendet.“, gefolgt vom Grund. Trigger und Aktionen erscheinen mit ihrem Namen aus der Bibliothek, alle anderen Schritte mit dem Namen auf der Arbeitsfläche. Klicken Sie auf den roten Schritt auf der Arbeitsfläche, um die vollständige Meldung zu lesen. Diese Fehler erscheinen in der Standardsprache Ihrer Plattform, auch bei Testläufen und Wiederholungen. Häufige Ursachen:

• „… wurde mit einem Fehler beendet.“: Der Schritt ist auf einen Fehler gestoßen, oft ein externer Dienst, der die Anfrage abgelehnt hat, oder eine Verbindung, die erneuert werden muss.
• „Die Anfrage lieferte HTTP …“, „Die Anfrage konnte nicht gesendet werden: …“ oder „Die URL "…" ist ungültig oder nicht erlaubt.“: Ein Schritt Externe Anfrage senden hat von Ihrem Server einen Fehler, keine rechtzeitige Antwort, eine Weiterleitung oder eine Adresse bekommen, die er nicht aufrufen darf.
• „Der auszuführende Workflow wurde nicht gefunden.“, „Der auszuführende Workflow hat keine veröffentlichte Version.“ oder „Der auszuführende Workflow hat keinen Auslöser.“: Die Automation, die ein Schritt Workflow ausführen startet, wurde gelöscht, nie veröffentlicht oder hat keinen Auslöser.
• „Ein Workflow kann sich nicht selbst ausführen.“ und „Workflows sind zu tief verschachtelt (höchstens 5 Ebenen).“: Schritte Workflow ausführen rufen sich im Kreis oder zu tief gegenseitig auf.
• „Der Workflow "…" ist fehlgeschlagen.“: Die andere Automation ist fehlgeschlagen. Sehen Sie sich ihre eigenen Durchläufe an.
• „Das Schrittlimit von 500 wurde erreicht.“: Ein Lauf führt höchstens 500 Schritte am Stück aus. Das kommt meist von einer Schleife über eine lange Liste mit mehreren Schritten darin.
• „Der Lauf hat zu lange gedauert und wurde gestoppt.“: Der Lauf hat länger gedauert, als die Plattform erlaubt, zum Beispiel weil ein externer Dienst zu langsam geantwortet hat.

Hinweise an abgeschlossenen Schritten

Ein gelber Hinweis markiert einen Schritt, der abgeschlossen wurde, ohne seine Aufgabe zu erledigen:

• „No member of this business could be resolved for this run.“: Der Lauf hat kein Mitglied. Testen Sie erneut mit einer Mitglieds-UUID, oder prüfen Sie, ob das Mitglied während eines Wartens gelöscht wurde.
• „The configured course no longer exists.“, oder dasselbe für eine Gruppe oder ein Abzeichen: Wählen Sie im Schritt ein neues Element.
• „The course is not published, so no access was granted.“: Veröffentlichen Sie zuerst den Kurs.
• „Kein Datum in "…" gefunden. Der Ablauf wurde ohne Warten fortgesetzt.“ oder „Das Datum "…" konnte nicht gelesen werden. Der Ablauf wurde ohne Warten fortgesetzt.“: Ein Schritt Bis Datum warten hat kein verwendbares Datum gefunden und ist ohne Warten weitergegangen.
• „Der Workflow "…" ist pausiert. Der Ablauf wurde ohne ihn fortgesetzt.“: Schalten Sie die Automation ein, die der Schritt Workflow ausführen startet.

Nicht jede Aktion hinterlässt einen Hinweis. Zeigt ein Mitgliederschritt Abgeschlossen, aber nichts hat sich geändert, prüfen Sie, ob der Lauf unter Eingabe ein Mitglied hatte.