Workflow-Durchläufe finden und überwachen

Nachdem ein Workflow ausgeführt wurde, stellt Flow ein Protokoll der Ereignisse bereit, das als Workflow-Durchlauf bezeichnet wird. Mit diesem Protokoll kannst du seine Leistung und sein Verhalten überwachen.

Auf Workflow-Durchläufe zugreifen

Du kannst alle Workflow-Durchläufe in der Flow-App überwachen. Die Überprüfung von Workflow-Durchläufen kann dir dabei helfen, potenzielle Probleme mit dem Verhalten des Workflows zu identifizieren.

Möglicherweise möchtest du Durchläufe für alle Workflows überprüfen, wenn du eine Fehlerbehebung durchführst oder nicht sicher bist, welchen Workflow du überprüfen sollst. Wenn du genau weißt, welchen Workflow du überprüfen möchtest, kannst du auf die letzten Durchläufe nur für diesen Workflow zugreifen.

Schritte:

Suche nach einem bestimmten Workflow-Durchlauf

Du kannst mit einer der folgenden Methoden in Flow nach Workflow-Durchläufen suchen:

• Von Ressourcenseiten im Shopify-Adminbereich, z. B. von einer Bestellung oder einem Produkt.
• Innerhalb der Flow-App kannst du die Listen der letzten Durchläufe mit den folgenden gängigen Suchfiltern filtern:
  • Nach Text in Schrittdaten, z. B. einer Kunden-ID oder Bestell-ID.
  • Nach Zeitraum, z. B. nach Datum und Uhrzeit, zu denen der Durchlauf stattfinden sollte.

Was durchsucht werden kann

Die Liste Letzte Durchläufe in der Flow-App bietet die Möglichkeit, die gesamte Liste der Durchläufe mit einer beliebigen Kombination der folgenden Filter zu filtern:

• Enthält Text: Nach den reinen Textinhalten der Daten filtern, die im Workflow-Durchlauf verwendet wurden, z. B. eine Bestell-ID in einer Trigger-Nutzlast oder der Name eines Tags in einer Bedingung.
• Workflows: Nach dem Namen des Workflows filtern.
• Durchgeführte Aktionen: Danach filtern, ob der Durchlauf Aktionen ausgeführt hat (wahr) oder nichts unternommen hat (falsch).
• Fehler: Danach filtern, ob der Durchlauf Fehler enthält.
• Startzeit: Nach einem Datums- und Zeitbereich filtern, in dem der Durchlauf hätte beginnen sollen. Mehr Informationen zum Filtern von Durchläufen nach Zeit.
• Trigger-Typ: Danach filtern, wie der Durchlauf gestartet wurde. Zu den Optionen gehören ein Trigger-Ereignis, ein manueller Durchlauf oder eine manuelle Wiederholung.
• Wiederholungsstatus: Danach filtern, ob der Durchlauf Wiederholungen enthält.
• Durchlauf-ID: Nach einer bestimmten Durchlauf-ID filtern. Du kannst auch Wiederholungen einbeziehen, die sich auf eine bestimmte Durchlauf-ID beziehen.
• Tags: Danach filtern, welche Workflow-Tags für den Durchlauf gelten.

Bevor du mit der Suche beginnst, überlege, nach welchen Informationen du im Workflow-Durchlauf suchen kannst. Diese Informationen werden in den Details des Workflow-Durchlaufs angezeigt und umfassen die folgenden Typen:

• Alle IDs für Ressourcen, die im Workflow-Durchlauf verwendet wurden, wie z. B. Bestell-IDs oder Kunden-IDs.
• Alle Texte oder Daten, die im Workflow-Durchlauf enthalten waren, z. B. ein Tag-Name oder ein Produkttitel.

Beachte bei der Suche nach einem Workflow-Durchlauf außerdem die folgenden Einschränkungen:

• Bei der Suche wird nicht zwischen Groß- und Kleinschreibung unterschieden.
• Der Such-String sollte keine Satzzeichen enthalten. Wenn du beispielsweise nach einer Bestell-ID suchst, suche nach 43843493 anstatt nach gid://shopify/Order/43843493.
• Die Protokolle enthalten nicht alle Details zu den in deinem Workflow verwendeten Ressourcen. Wenn du beispielsweise eine Produkt-ID in deinem Workflow verwendest, enthält das Protokoll des Workflow-Durchlaufs nicht den Produktnamen oder -titel, es sei denn, du hast diese Felder ebenfalls verwendet.
• Die Suche ist auf die Workflow-Durchläufe der letzten 14 Tage beschränkt.

Suche über den Shopify-Adminbereich

Für Ressourcen, die über ein Menü Weitere Aktionen verfügen, kannst du eine Suche nach Workflow-Durchläufen starten, indem du die Option Flow-Durchläufe suchen auswählst. Diese Option ist für die folgenden Ressourcen verfügbar:

• Bestellungen
• Bestellentwürfe
• Kunden
• Produkte
• Varianten
• Kollektionen

Wenn du Probleme hast, einen Durchlauf zu finden, dann sieh dir an, was durchsucht werden kann.

Schritte:

1. Öffne im Shopify-Adminbereich die Ressource, nach der du suchen möchtest, z. B. eine Bestellung oder ein Produkt.
2. Klicke auf Weitere Aktionen.
3. Klicke auf Flow-Durchläufe suchen.

Suche nach Text in Schrittdaten

In der Flow-App kannst du nach allen Daten suchen, die in den Abschnitten mit den Schrittdaten in einem Workflow-Durchlauf enthalten waren.

Wenn du Probleme hast, einen Durchlauf zu finden, dann sieh dir an, was durchsucht werden kann.

Schritte:

1. Klicke in der Liste Letzte Durchläufe der Flow-App auf Filter hinzufügen.
2. Wähle Enthält Text aus.
3. Gib den Text oder die ID für die Suche ein.

Suche nach Zeitraum

Beachte die folgenden Überlegungen, um einen Workflow-Durchlauf nach Zeitraum zu finden:

• Wenn sich die Zeitzone auf deinem Gerät von der Zeitzone deines Shops unterscheidet, sind Datum und Uhrzeit für einen Workflow-Durchlauf möglicherweise ungenau. Berücksichtige diesen Unterschied bei dem von dir verwendeten Filter Startzeit.
• In Shops mit hohem Volumen musst du möglicherweise einen engen Zeitraum und andere Filter verwenden, um die Suche nach einem bestimmten Workflow-Durchlauf zu erleichtern.
• Workflow-Durchläufe werden nur 14 Tage lang gespeichert, nachdem der Durchlauf abgeschlossen ist.
• Es kann zu einer Verzögerung zwischen der Ausführung eines Workflows und der Anzeige der Ergebnisse auf der Seite Letzte Durchläufe kommen. Wenn die Ergebnisse für einen kürzlich ausgeführten Workflow noch nicht verfügbar sind, warte einige Minuten und versuche es erneut.

Schritte:

1. Klicke in der Liste Letzte Durchläufe der Flow-App auf Filter hinzufügen und dann auf Startzeit.
2. Gib in das Feld Von ein Datum und eine Uhrzeit ein, die dem Zeitpunkt entsprechen, zu dem das Ereignis hätte stattfinden sollen. Verwende beispielsweise für einen Trigger vom Typ Bestellung erstellt die Uhrzeit, zu der die Bestellung erstellt wurde. Stelle sicher, dass du den richtigen Wert für AM/PM eingibst.
3. Gib in das Feld Bis ein Datum und eine Uhrzeit ein, die 10 Minuten nach dem Datum und der Uhrzeit im Feld Von liegen.
4. Überprüfe die Suchergebnisse. Workflows werden normalerweise genau zur gleichen Zeit wie ein auslösendes Ereignis oder kurz danach ausgeführt.
5. Klicke auf ein Ergebnis, das mit der Zeit übereinstimmt, und überprüfe, ob die angezeigte Ressource mit der Ressource übereinstimmt, nach der du suchst, z. B. der Bestellung.

Spalten in der Liste der letzten Durchläufe

Die Liste der letzten Durchläufe eines Workflows zeigt wichtige Daten zu den Workflow-Durchläufen an:

Details zu einem Workflow-Durchlauf anzeigen

Um auf detaillierte Informationen zu einem einzelnen Workflow zuzugreifen, klicke auf die Zeile für den Workflow-Durchlauf.

Oben zeigt der Abschnitt Status an, ob der Workflow abgeschlossen wurde. Der Abschnitt Aktionen gibt an, wie viele Aktionen im Workflow erfolgreich ausgeführt wurden.

Der Abschnitt Details zeigt eine Vorschau des Workflows an und hebt den oder die Pfade hervor, die der Workflow durchlaufen hat.

Nach der Workflow-Vorschau kannst du die Ergebnisse, Protokolle und Daten für jeden Schritt im Workflow einsehen.

Für jeden Schritt kannst du den Abschnitt Schrittdaten erweitern, um die Daten einzusehen, die im Workflow-Durchlauf verwendet wurden. Diese Daten enthalten alle IDs für Ressourcen, die im Workflow-Durchlauf verwendet wurden, z. B. Bestell-IDs oder Kunden-IDs, sowie alle Texte oder Daten, die im Workflow-Durchlauf enthalten waren, z. B. einen Tag-Namen oder einen Produkttitel.

Workflows mit „For-Each-Schleife“-Aktionen

Workflows, die die Aktion For-Each-Schleife (iterieren) enthalten, wiederholen Schritte mehrmals. In der Workflow-Vorschau hebt Flow hervor, wie viele Artikel einem Pfad gefolgt sind.

Flow zeigt auch die Ergebnisse jeder Schleifeniteration an und ermöglicht es dir, nach ausgeführten Aktionen und Fehlern zu filtern, um Fehler in Schleifen schnell zu beheben.

Laufende Workflow-Durchläufe abbrechen

Du kannst einen Workflow-Durchlauf mit dem Status Wird ausgeführt oder Ratenbegrenzt abbrechen, wenn du einen Workflow anhalten möchtest, bevor er abgeschlossen ist. Das Abbrechen eines Workflow-Durchlaufs kann eine nützliche Option sein, um das Erreichen von API-Limits zu vermeiden, wenn du bemerkst, dass der Workflow nicht wie beabsichtigt ausgeführt wird, oder um zu verhindern, dass fehlgeschlagene Durchläufe deine Liste Letzte Durchläufe überladen.

Überlegungen zum Abbrechen von laufenden Workflow-Durchläufen

Bevor du einen laufenden Workflow-Durchlauf abbrichst, beachte die folgenden Überlegungen:

• Du musst ein Desktop-Gerät verwenden, um Workflow-Durchläufe in der Flow-App abzubrechen.
• Du kannst keine Durchläufe abbrechen, die bereits abgeschlossen sind.
• Abgebrochene Durchläufe können zu einem späteren Zeitpunkt nicht fortgesetzt werden. Wenn der Workflow erneut ausgeführt werden muss, kannst du warten, bis der Workflow automatisch ausgelöst wird, den Durchlauf wiederholen oder einen neuen Workflow-Durchlauf manuell starten.
• Das Abbrechen von Workflow-Durchläufen deaktiviert den zugehörigen Workflow nicht automatisch. Das Deaktivieren eines Workflows bricht jedoch automatisch alle seine laufenden Workflow-Durchläufe ab.
• Das Abbrechen von Workflow-Durchläufen kann je nach Komplexität des Workflows einige Sekunden bis zu einer Minute dauern.

Laufende Workflow-Durchläufe abbrechen

Du kannst einen laufenden Workflow-Durchlauf jederzeit abbrechen. Es gibt mehrere Möglichkeiten, laufende Workflow-Durchläufe abzubrechen:

• Um einen bestimmten Durchlauf abzubrechen, kannst du ihn direkt auf der Detailseite des Workflow-Durchlaufs abbrechen.
• Um mehrere Durchläufe für einen einzelnen Workflow abzubrechen, kannst du die Durchläufe stapelweise aus der Liste Letzte Durchläufe des Workflows abbrechen.

Schritte:

Fehlerbehebung bei Workflow-Durchläufen

In einigen Fällen kann bei einem Workflow-Durchlauf ein Fehler auftreten oder er wird nicht wie beabsichtigt ausgeführt. Meistens geschieht dies, wenn ein Konfigurationsproblem mit dem Workflow vorliegt. Mehr Informationen zur Fehlerbehebung bei Flow-Fehlern und zum Wiederholen von Workflow-Durchläufen, um das Ergebnis vergangener Durchläufe rückwirkend zu korrigieren.