Flows ausführen

Hier erfahren Sie, wie Sie Ihre Test-Flows ausführen und die Ergebnisse lesen.

Schnellaktionen

• Einzelnen Flow ausführen: Klicken Sie auf ▶️ auf einer Flow-Karte
• Alle aktiven ausführen: Klicken Sie auf "Alle aktiven Flows ausführen"
• Vom Dashboard: Nutzen Sie das Schnellaktionen-Panel

Übersicht

Sobald Sie einen Flow erstellt haben, können Sie ihn ausführen, um alle Steps automatisch durchlaufen zu lassen. Flowguard simuliert Benutzeraktionen und meldet, ob der Flow bestanden oder fehlgeschlagen ist.

Möglichkeiten, Flows auszuführen

1. Einen einzelnen Flow ausführen

Von der Flows-Seite:

1. Finden Sie den Flow, den Sie ausführen möchten
2. Klicken Sie auf den Play-Button (▶️) auf der Flow-Karte
3. Der Flow beginnt sofort mit der Ausführung
4. Der Status aktualisiert sich in Echtzeit

Vom Dashboard:

1. Finden Sie den Flow im Bereich der letzten Flows
2. Klicken Sie auf den Play-Button auf der Flow-Karte
3. Überwachen Sie die Ausführung

Vom Flow-Editor: Derzeit müssen Flows von der Flows-Seite oder dem Dashboard aus gestartet werden. Ein "Ausführen"-Button im Editor wird möglicherweise in Zukunft hinzugefügt.

2. Alle aktiven Flows ausführen

Vom Dashboard:

1. Klicken Sie auf Alle aktiven Flows ausführen
2. Alle als "Aktiv" markierten Flows werden ausgeführt
3. Überwachen Sie den Fortschritt auf dem Dashboard

Von der Flows-Seite:

1. Klicken Sie auf Alle aktiven ausführen in der Toolbar
2. Alle aktiven Flows werden der Reihe nach ausgeführt
3. Ergebnisse aktualisieren sich, sobald jeder Flow abgeschlossen ist

TIP

Nur Flows mit "Aktiv"-Status werden einbezogen, wenn Sie alle Flows ausführen. Inaktive Flows werden übersprungen.

Ausführungsprozess

Wenn Sie einen Flow ausführen, durchläuft Flowguard diese Schritte:

Initialization

• Status → Running
• Start time recorded
• Browser launched

Step Execution

• Steps run in order
• Actions performed
• Progress tracked

Completion

• Status → Passed/Failed
• Duration calculated
• Results saved

1. Initialisierung

• Flow-Status wechselt zu "Läuft"
• Start-Zeitstempel wird aufgezeichnet
• Vorherige Ergebnisse werden gelöscht

2. Step-Ausführung

Steps werden der Reihe nach von oben nach unten ausgeführt:

• Jeder Step führt seine Aktion aus
• Wenn ein Step fehlschlägt, kann die Ausführung stoppen (abhängig von den Einstellungen)
• Fortschritt wird in Echtzeit verfolgt

3. Abschluss

• Endstatus wird bestimmt (Bestanden oder Fehlgeschlagen)
• Ausführungsdauer wird berechnet
• Ergebnisse werden gespeichert
• Screenshots werden erfasst (falls aktiviert)

Ergebnisse verstehen

Bestandene Flows

Ein Flow besteht, wenn:

• ✅ Alle Steps erfolgreich ausgeführt werden
• ✅ Alle Assertions wahr sind
• ✅ Keine Fehler auftreten
• ✅ Die Ausführung innerhalb des Timeouts abgeschlossen wird

Bestandene Flows zeigen:

• Grünes "Bestanden"-Badge
• Häkchen-Symbol
• Dauer in Millisekunden
• Zeitstempel der Fertigstellung

Fehlgeschlagene Flows

Ein Flow schlägt fehl, wenn:

• ❌ Ein Step einen Fehler verursacht
• ❌ Eine Assertion fehlschlägt
• ❌ Ein Element nicht gefunden werden kann
• ❌ Das Timeout überschritten wird
• ❌ Netzwerkprobleme auftreten

Fehlgeschlagene Flows zeigen:

• Rotes "Fehlgeschlagen"-Badge
• X-Symbol
• Fehlermeldung
• Welcher Step fehlgeschlagen ist
• Zeitstempel des Fehlers

Laufende Flows

Ein Flow wird als laufend angezeigt, wenn:

• 🟠 Die Ausführung gerade stattfindet
• 🟠 Steps verarbeitet werden
• 🟠 Noch nicht abgeschlossen

Laufende Flows zeigen:

• Oranges "Läuft"-Badge
• Lade-Spinner
• Aktuellen Fortschritt

Ergebnisse im Detail ansehen

Letzte Ausführung

Klicken Sie auf einen Flow, um Folgendes zu sehen:

• Status - Bestanden, Fehlgeschlagen oder Läuft
• Zeitstempel - Wann er ausgeführt wurde
• Dauer - Wie lange es gedauert hat
• Step-Ergebnisse - Einzelne Step-Resultate
• Fehlerdetails - Falls fehlgeschlagen

Step-für-Step-Ergebnisse

Jeder Step zeigt:

• Step-Nummer und Typ
• Erfolgs- oder Fehlerstatus
• Dauer
• Fehlermeldung (falls fehlgeschlagen)
• Screenshot (falls aktiviert)

Fehlermeldungen

Häufige Fehler - Aufklappen für Lösungen

Fehler	Ursache	Lösung
Element nicht gefunden	Selektor passt nicht	Selektor aktualisieren, Wait-Step hinzufügen
Timeout überschritten	Step dauerte zu lange	Timeout erhöhen, Seitenladen prüfen
Navigation fehlgeschlagen	URL nicht erreichbar	URL prüfen, Website-Status verifizieren
Assertion fehlgeschlagen	Inhalt entspricht nicht	Erwarteten Wert aktualisieren, Timing prüfen

Ausführungseinstellungen

Steuern Sie, wie Flows ausgeführt werden, indem Sie die Einstellungen konfigurieren:

Timeout

Was es ist: Maximale Zeit (in Millisekunden) zum Warten auf jeden Step.

Standard: 30000ms (30 Sekunden)

Wann anpassen:

• Erhöhen für langsam ladende Seiten
• Verringern für schnelle Aktionen (schnellere Fehlererkennung)

Beispiel:

Timeout: 60000  (1 Minute für langsame Seiten)
Timeout: 10000  (10 Sekunden für schnelle Tests)

Wiederholungen

Was es ist: Anzahl der Wiederholungsversuche für einen fehlgeschlagenen Step, bevor der Flow als fehlgeschlagen markiert wird.

Standard: 0 (keine Wiederholungen)

Wann anpassen:

• Erhöhen für instabile Tests (sporadische Fehler)
• Bei 0 belassen für zuverlässige Tests

Beispiel:

Retries: 3  (Bis zu 3 Mal versuchen, bevor fehlgeschlagen wird)

WARNING

Hohe Wiederholungszahlen können echte Probleme verbergen. Nutzen Sie Wiederholungen mit Vorsicht und untersuchen Sie, warum Steps sporadisch fehlschlagen.

Screenshots

Was es ist: Screenshots während der Ausführung für Debugging erfassen.

Standard: Aktiviert

Wann anpassen:

• Aktivieren zum Debuggen fehlgeschlagener Flows
• Deaktivieren um die Ausführung zu beschleunigen

Beispiel:

Screenshot: Enabled  (Bilder zur Überprüfung erfassen)
Screenshot: Disabled (Schnellere Ausführung)

Aktive Flows überwachen

Echtzeit-Updates

Wenn Flows ausgeführt werden, sehen Sie:

• Statusänderungen (Läuft → Bestanden/Fehlgeschlagen)
• Aktualisierung des Dauer-Zählers
• Fortschrittsanzeigen

Mehrere Flows gleichzeitig

Wenn mehrere Flows ausgeführt werden:

• Jeder Flow wird unabhängig ausgeführt
• Ergebnisse aktualisieren sich bei Abschluss
• Keine garantierte Reihenfolge (parallele Ausführung in zukünftigen Versionen möglich)

Ausführung abbrechen

Sie können einen laufenden Flow jederzeit abbrechen. Der Flow wird als "Abgebrochen" markiert und die Ausführung stoppt sofort. Bereits abgeschlossene Steps bleiben in den Ergebnissen aufgezeichnet.

Tipps

Vor dem Ausführen

Checkliste vor der Ausführung

• [ ] Alle Steps korrekt konfiguriert
• [ ] Selektoren sind genau
• [ ] Beschreibungen zur Klarheit hinzugefügt
• [ ] Step-Reihenfolge ergibt Sinn
• [ ] Manuell in der Vorschau getestet

Passenden Status setzen:

• Als Aktiv markieren für regelmäßiges Testen
• Als Inaktiv markieren, wenn noch in Entwicklung

Nach dem Ausführen

Aktionen nach der Ausführung

Wenn bestanden	Wenn fehlgeschlagen
✅ Gut. Ausführungszeit notieren	🔍 Prüfen, welcher Step fehlschlug
Für regelmäßige Läufe einplanen	Selektoren bei Bedarf aktualisieren
	Timeouts anpassen
	Beheben und erneut ausführen

Regelmäßiges Testen

Wann Sie Ihre Flows ausführen sollten

Auslöser	Priorität
WordPress-Core-Updates	🔴 Kritisch
Plugin-Updates	🔴 Kritisch
Theme-Änderungen	🟠 Hoch
Inhaltsänderungen	🟡 Mittel
Code-Deployments	🔴 Kritisch
Geplant (automatisiert)	✅ Laufend

Was Sie testen sollten:

• Wichtige User Journeys
• Kernfunktionen
• Häufige Workflows
• Kürzlich geänderte Seiten

Fehlerbehebung

Flow startet nicht

Mögliche Ursachen:

• Flow ist auf Inaktiv gesetzt
• Keine Steps im Flow
• Browser-/Serverproblem

Lösungen:

1. Prüfen Sie, ob der Flow Aktiv ist
2. Prüfen Sie, ob Steps existieren
3. Seite aktualisieren
4. Browser-Konsole prüfen

Flow schlägt immer fehl

Mögliche Ursachen:

• Selektoren sind veraltet
• Seitenstruktur hat sich geändert
• Timeouts zu kurz
• Element lädt langsam

Lösungen:

1. Flow im Editor öffnen
2. Jeden Step manuell testen
3. Selektoren mit dem Picker aktualisieren
4. Wait-Steps hinzufügen
5. Timeouts erhöhen

Flow besteht unerwartet

Mögliche Ursachen:

• Assertions sind zu allgemein
• Falsche Elemente werden geprüft
• Website-Verhalten hat sich geändert

Lösungen:

1. Assertion-Bedingungen überprüfen
2. Assertions spezifischer machen
3. Zusätzliche Verifizierungsschritte hinzufügen
4. Manuell testen zur Bestätigung

Langsame Ausführung

Mögliche Ursachen:

• Viele Wait-Steps
• Lange Timeouts
• Langsames Laden der Seite
• Viele Screenshots

Lösungen:

1. Wait-Dauern reduzieren
2. Timeouts optimieren
3. Screenshots deaktivieren
4. Unnötige Steps entfernen
5. Website-Performance verbessern

Sporadische Fehler

Mögliche Ursachen:

• Timing-Probleme
• Dynamische Inhalte
• Race Conditions
• Netzwerk-Instabilität

Lösungen:

1. Wait-Steps vor Aktionen hinzufügen
2. Timeouts erhöhen
3. Wiederholungen hinzufügen (mit Vorsicht)
4. Selektoren spezifischer machen
5. Auf AJAX-Abschluss prüfen

Ausführungsprotokolle lesen

Step-Ergebnisse

Jeder ausgeführte Step zeichnet auf:

• Step-Nummer - Position im Flow
• Step-Typ - Ausgeführte Aktion
• Status - Erfolg oder Fehler
• Dauer - Benötigte Zeit
• Details - Zusätzliche Informationen

Fehlerprotokolle

Fehlgeschlagene Steps enthalten:

• Fehlertyp - Was schiefgelaufen ist
• Fehlermeldung - Beschreibung
• Stack Trace - Technische Details (für Entwickler)
• Screenshot - Visuelle Darstellung des Fehlers

Performance-Daten

Ausführungsdaten umfassen:

• Gesamtdauer - Vollständige Flow-Ausführungszeit
• Step-Dauern - Individuelle Step-Zeiten
• Langsamste Steps - Performance-Engpässe

Nutzen Sie diese Daten, um Flows zu optimieren.

Tipps für zuverlässige Flows

Flows widerstandsfähig machen

Stabile Selektoren verwenden:

• IDs und Data-Attribute bevorzugen
• Generierte Klassennamen vermeiden
• Nicht nur auf Struktur verlassen

Passende Waits hinzufügen:

• Nach Navigation warten
• Auf AJAX-Requests warten
• Auf Animationen warten

Bedingungen verifizieren:

• Prüfen, dass Elemente sichtbar sind, bevor Sie klicken
• Prüfen, ob die Seite korrekt geladen wurde
• Erwartete Inhalte verifizieren

Grenzfälle behandeln

Verschiedene Zustände berücksichtigen:

• Bereits eingeloggt vs. ausgeloggt
• Leerer Warenkorb vs. Artikel im Warenkorb
• Verschiedene Bildschirmgrößen

Variabilität einplanen:

• Dynamische Inhalte
• Wechselnde Zeitstempel
• Zufällige Reihenfolgen

Flows pflegen

Regelmäßige Updates:

• Flows monatlich überprüfen
• Nach Website-Änderungen aktualisieren
• Veraltete Flows archivieren

Änderungen dokumentieren:

• Notieren, warum Selektoren geändert wurden
• Aufzeichnen, wann Steps modifiziert wurden
• Flow-Zweck erklären

Fortgeschrittene Themen

Ausführungsreihenfolge

Derzeit werden Flows einzeln nacheinander ausgeführt. Die Reihenfolge hängt ab von:

• Wie sie gestartet wurden (einzeln vs. alle)
• System-Scheduling
• Verfügbare Ressourcen

Datenweitergabe

INFO

Die Datenweitergabe zwischen Steps (mithilfe von Variablen) ist ein geplantes Feature für zukünftige Versionen.

Bedingte Steps

INFO

Bedingte Ausführung (If/Else-Logik) ist ein geplantes Feature für zukünftige Versionen.

Nächste Schritte

• Step Types - Alle verfügbaren Aktionen
• Einstellungen - Standardverhalten konfigurieren
• Entwickler-Referenz - API für eigene Integrationen

Hilfe benötigt?

Wenn Flows nicht wie erwartet funktionieren:

1. Schauen Sie in diesem Guide nach Fehlerbehebungstipps
2. Lesen Sie die Step Types-Dokumentation
3. Untersuchen Sie Ihre Website mit den Browser-DevTools
4. Stellen Sie sicher, dass WordPress und Flowguard aktuell sind
5. Kontaktieren Sie den Support