Workflow-runs zoeken en monitoren

Nadat een workflow is uitgevoerd, biedt Flow een logboek van wat er is gebeurd, een zogeheten workflow-run, waarmee je de prestaties en het gedrag ervan kunt monitoren.

Toegang krijgen tot workflow-runs

Je kunt alle workflow-runs monitoren in de Flow-app. Het controleren van workflow-runs kan je helpen potentiële problemen met het gedrag van de workflow te identificeren.

Je kunt de runs van alle workflows bekijken wanneer je problemen oplost of niet zeker weet welke workflow je moet controleren. Als je precies weet welke workflow je wilt controleren, heb je toegang tot de recente runs voor alleen die workflow.

Stappen:

Een specifieke workflow-run zoeken

Je kunt in Flow op een van de volgende manieren naar workflow-runs zoeken:

• Vanaf bronpagina's in het Shopify-beheercentrum, zoals een bestelling of product.
• Vanuit de Flow-app kun je de lijsten met recente runs filteren met de volgende veelgebruikte zoekfilters:
  • Op tekst in stapgegevens, zoals een klant-ID of bestellings-ID.
  • Op tijdsbestek, zoals de datum en tijd waarop de run had moeten plaatsvinden.

Waarnaar je kunt zoeken

De lijst Recente runs in de Flow-app bevat de optie om de hele lijst met runs te filteren op een willekeurige combinatie van de volgende filters:

• Bevat tekst: Filter op de onbewerkte tekstinhoud van de gegevens die in de workflow-run zijn gebruikt, zoals een bestellings-ID in een trigger-payload of de tagnaam in een voorwaarde.
• Workflows: Filter op de naam van de workflow.
• Onderomen acties: Filter op of de run acties heeft uitgevoerd (waar) of niets heeft gedaan (onwaar).
• Fouten: Filter op of de run fouten bevat.
• Starttijd: Filter op een datum- en tijdsbereik waarop de run had moeten starten. Meer informatie over het filteren van runs op tijd.
• Triggertype: Filter op hoe de run is gestart. Opties zijn onder meer een trigger-event, een handmatige run of een handmatige nieuwe poging.
• Status nieuwe poging: Filter op of de run nieuwe pogingen bevat.
• Run-ID: Filter op een specifieke run-ID. Je kunt er ook voor kiezen om nieuwe pogingen met betrekking tot een opgegeven run-ID op te nemen.
• Tags: Filter op welke workflow-tags van toepassing zijn op de run.

Bedenk voordat je gaat zoeken naar welke informatie je kunt zoeken in de workflow-run. Deze informatie wordt weergegeven in de gegevens van de workflow-run en omvat de volgende typen:

• Alle ID's voor resources die zijn gebruikt in de workflow-run, zoals bestellings-ID's of klant-ID's.
• Alle tekst of gegevens die zijn opgenomen in de workflow-run, zoals een tagnaam of producttitel.

Houd daarnaast bij het zoeken naar een workflow-run rekening met de volgende beperkingen:

• De zoekopdracht is niet-hoofdlettergevoelig.
• De zoektekenreeks mag geen leestekens bevatten. Als je bijvoorbeeld zoekt naar een bestellings-ID, zoek dan op 43843493 in plaats van op gid://shopify/Order/43843493.
• De logboeken bevatten niet alle gegevens over resources die in je workflow worden gebruikt. Als je bijvoorbeeld een product-ID in je workflow gebruikt, bevat het logboek van de workflow-run niet de productnaam of -titel, tenzij je die velden ook hebt gebruikt.
• De zoekopdracht is beperkt tot de workflow-runs van de afgelopen 14 dagen.

Zoeken vanuit het Shopify-beheercentrum

Voor resources met een menu Meer acties kun je een zoekopdracht naar een workflow-run starten door de optie Zoeken in Flow-runs te kiezen. Deze optie is beschikbaar voor de volgende resources:

• Bestellingen
• Conceptbestellingen
• Klanten
• Producten
• Varianten
• Collecties

Als je problemen hebt met het vinden van een run, controleer dan waarnaar je kunt zoeken.

Stappen:

1. Open in het Shopify-beheercentrum de resource waarnaar je wilt zoeken, zoals een bestelling of product.
2. Klik op Meer acties.
3. Klik op Zoeken in Flow-runs.

Zoeken op tekst in stapgegevens

In de Flow-app kun je zoeken naar alle gegevens die zijn opgenomen in de secties met stapgegevens in een workflow-run.

Als je problemen hebt met het vinden van een run, controleer dan waarnaar je kunt zoeken.

Stappen:

1. Klik in de lijst Recente runs van de Flow-app op Filter toevoegen.
2. Kies Bevat tekst.
3. Voer de tekst of ID in om op te zoeken.

Zoeken op tijdsbestek

Neem de volgende overwegingen door voor het vinden van een workflow-run op tijdsbestek:

• Als de tijdzone op je apparaat verschilt van de tijdzone van je winkel, zijn de datum en tijd voor een workflow-run mogelijk onnauwkeurig. Houd rekening met dit verschil in het filter Starttijd dat je gebruikt.
• In winkels met een hoog volume moet je mogelijk een krap tijdsbestek en andere filters gebruiken om het gemakkelijker te maken een specifieke workflow-run te vinden.
• Workflow-runs worden slechts 14 dagen bewaard nadat de run is voltooid.
• Er kan een vertraging zitten tussen het moment waarop een workflow wordt uitgevoerd en het moment waarop de resultaten ervan worden weergegeven op de pagina Recente runs. Als de resultaten voor een recente workflow nog niet beschikbaar zijn, wacht dan een paar minuten en probeer het opnieuw.

Stappen:

1. Klik in de lijst Recente runs van de Flow-app op Filter toevoegen en klik vervolgens op Starttijd.
2. Voer in het veld Vanaf een datum en tijd in die gelijk is aan de tijd waarop de gebeurtenis had moeten plaatsvinden. Gebruik bijvoorbeeld voor een trigger Bestelling aangemaakt de tijd waarop de bestelling is aangemaakt. Zorg ervoor dat je de juiste AM/PM-waarde invoert.
3. Voer in het veld Tot een datum en tijd in die 10 minuten na de datum en tijd bij Vanaf ligt.
4. Controleer de zoekresultaten. Workflows worden meestal op precies hetzelfde tijdstip als een trigger-event of kort daarna uitgevoerd.
5. Klik op een resultaat dat overeenkomt met de tijd en controleer of de weergegeven resource overeenkomt met de resource die je zoekt, zoals de bestelling.

Kolommen in de lijst met recente runs

De lijst met recente runs van een workflow geeft belangrijke gegevens weer over de workflow-runs:

De gegevens van een workflow-run bekijken

Klik op de rij voor de workflow-run om gedetailleerde informatie over een afzonderlijke workflow te openen.

Bovenaan geeft de sectie Status aan of de workflow is voltooid. De sectie Acties geeft aan hoeveel acties in de workflow met succes zijn uitgevoerd.

De sectie Gegevens toont een voorbeeld van de workflow en markeert de paden die de workflow heeft gevolgd.

Na het workflow-voorbeeld kun je de resultaten, logs en gegevens voor elke stap in de workflow bekijken.

Voor elke stap kun je de sectie Stapgegevens uitklappen om de gegevens te bekijken die in de workflow-run zijn gebruikt. Deze gegevens omvatten alle ID's voor resources die in de workflow-run zijn gebruikt, zoals bestellings-ID's of klant-ID's, en alle tekst of gegevens die in de workflow-run zijn opgenomen, zoals een tagnaam of producttitel.

Workflows met 'Voor elke loop'-acties

Workflows met de actie Voor elke loop (herhalen) herhalen stappen meerdere keren. Flow markeert hoeveel artikelen een pad hebben gevolgd in het workflow-voorbeeld.

Flow geeft ook de resultaten van elke loop-iteratie weer en stelt je in staat om te filteren op uitgevoerde acties en fouten om snel problemen met loops op te lossen.

Lopende workflow-runs annuleren

Je kunt een workflow-run met de status Bezig of Rate-limited annuleren als je een workflow wilt stoppen voordat deze is voltooid. Het annuleren van een workflow-run kan handig zijn om te voorkomen dat je API-limieten bereikt, wanneer je merkt dat de workflow niet naar behoren werkt, of om te voorkomen dat mislukte runs je lijst met Recente runs onoverzichtelijk maken.

Aandachtspunten voor het annuleren van lopende workflow-runs

Lees de volgende aandachtspunten door voordat je een lopende workflow-run annuleert:

• Je moet een desktopapparaat gebruiken om workflow-runs in de Flow-app te annuleren.
• Je kunt geen runs annuleren die al zijn voltooid.
• Geannuleerde runs kunnen niet op een later tijdstip worden hervat. Als je de workflow opnieuw wilt uitvoeren, kun je wachten tot de workflow automatisch wordt getriggerd, de run opnieuw proberen of handmatig een nieuwe workflow-run starten.
• Het annuleren van workflow-runs schakelt de bijbehorende workflow niet automatisch uit. Als je echter een workflow uitschakelt, worden alle lopende workflow-runs ervan automatisch geannuleerd.
• Het kan enkele seconden tot een minuut duren om workflow-runs te annuleren, afhankelijk van de complexiteit van de workflow.

Lopende workflow-runs annuleren

Je kunt een lopende workflow-run op elk moment annuleren. Er zijn meerdere manieren om lopende workflow-runs te annuleren:

• Om een specifieke run te annuleren, kun je dit rechtstreeks doen vanaf de gegevenspagina van de workflow-run.
• Om meerdere runs voor één workflow te annuleren, kun je runs in bulk annuleren vanuit de lijst Recente runs van de workflow.

Stappen:

Problemen met workflow-runs oplossen

In sommige gevallen kan een workflow-run een fout tegenkomen of niet naar behoren werken. Meestal gebeurt dit wanneer er een configuratieprobleem is met de workflow. Meer informatie over het oplossen van problemen met Flow-fouten en het opnieuw proberen van workflow-runs om met terugwerkende kracht het resultaat van eerdere runs te corrigeren.