Een workflow testen in Shopify Flow

Je kunt een workflow testen voordat je deze activeert. Hiermee kun je je workflowlogica verifiëren en bevestigen dat je variabelen en parameters correct zijn, voordat je de workflow activeert om zelfstandig te draaien. Een workflowtest voert geen acties uit zoals het verzenden van meldingen, het updaten van bestellingen of producten, of het aanbrengen van wijzigingen in de gegevens van je livewinkel. Je kunt op elk gewenst moment een workflow testen in Shopify Flow.

Elke test begint met triggergebeurtenisgegevens. Er zijn drie manieren om triggergebeurtenisgegevens in Shopify Flow op te halen, afhankelijk van of je echte winkelgegevens of gesimuleerde winkelgegevens wilt gebruiken:

• Gebeurtenissen opnemen: met deze optie wordt een testmodus geactiveerd die controleert op livegebeurtenissen die van nature in je winkel plaatsvinden en die de workflow zouden triggeren. In deze modus kun je ook een nieuw browsertabblad openen om handmatig een liveactie uit te voeren die een testgebeurtenis met echte gegevens zou genereren, zoals het zelf aanmaken van een echte bestelling om de trigger Bestelling aangemaakt te testen.
• Gebeurtenissen aanmaken: met deze optie kun je handmatig gesimuleerde gebeurtenissen aanmaken met echte gegevens uit je winkel die de workflow zouden triggeren zonder daadwerkelijk wijzigingen in je winkel aan te brengen. Je kunt bijvoorbeeld een bestaande bestelling in het beheercentrum selecteren en de echte gegevens ervan gebruiken als de testgebeurtenis voor een trigger Bestelling aangemaakt, hoewel de bestelling al is aangemaakt.
• Gebeurtenissen genereren: vergelijkbaar met het handmatig aanmaken van een testgebeurtenis, laat deze optie Sidekick gesimuleerde testgebeurtenissen voor je genereren. Sidekick kan bijvoorbeeld twee testgebeurtenissen genereren (een geslaagde voorwaarde en een mislukte voorwaarde) om een workflow voor Bestelling aangemaakt te testen met behulp van bestaande bestelgegevens in je winkel. Vervolgens kun je die testgebeurtenissen gebruiken, bewerken of verwijderen op basis van je testvoorkeuren.

Overwegingen bij het testen van een workflow in Shopify Flow

Neem de volgende overwegingen door voordat je een workflow test:

• Workflows in testmodus gebruiken de echte gegevens van je winkel om Liquid-variabelen te retourneren en workflowlogica te bepalen, maar voeren geen acties uit en brengen geen wijzigingen aan in je winkel. Een test-run stopt bij de eerste actie die een wijziging probeert aan te brengen in de workflowlogica om onbedoelde wijzigingen te voorkomen.
• Je kunt een workflow in elk stadium van het aanmaken testen. Een workflow hoeft niet voltooid te zijn om je huidige versie te testen, maar alle stappen in de workflow moeten geldig zijn. Onvolledige of verkeerd geconfigureerde stappen kunnen niet in een test worden gebruikt.
• De lijst Recente runs van de workflow bevat geen runs van testworkflows.
• Acties in een workflow die verbinding maken met externe services, zoals HTTP-verzoek verzenden, geven tijdens een test configuratievoorbeelden weer, maar geven het bericht Kan deze actie niet simuleren weer als de geretourneerde datawaarde in plaats van de werkelijke data.

Echte opgenomen gebeurtenissen gebruiken om een workflow te testen in Shopify Flow

Bij het opnemen van gebeurtenissen gebruikt je workflow echte winkelgegevens op basis van de trigger die je hebt ingesteld, om een lijst met testgebeurtenissen te produceren. Afhankelijk van wat de triggergebeurtenis is, moet je de actie mogelijk handmatig uitvoeren om een testgebeurtenis te genereren. Als je bijvoorbeeld de gebeurtenis Collectie aangemaakt test, moet je handmatig een collectie aanmaken in het Shopify-beheercentrum, zodat de workflow de gebeurtenis kan opnemen voor het testen.

Stappen:

1. Ga in het Shopify-beheercentrum naar Apps > Flow.

2. Klik in de sectie Workflows op de workflow die je wilt testen.

3. Klik op Bewerken om de workflow-editor te openen.

4. Klik bij de trigger van de workflow op Je workflow testen.

5. Klik in het dialoogvenster Je workflow testen op + Gebeurtenis toevoegen > Gebeurtenissen opnemen om de testmodus van de workflow te activeren.

6. Optioneel: als er geen beschikbare testgebeurtenissen op natuurlijke wijze worden gegenereerd, open dan een nieuw browsertabblad en maak handmatig een gebeurtenis aan die ervoor zorgt dat de trigger de testworkflow start.

7. In het dialoogvenster met testgebeurtenissen worden alle getriggerde testgebeurtenissen weergegeven in de lijst Gebeurtenissen opnemen. Selecteer de testgebeurtenis waarvoor je de testworkflow wilt uitvoeren.

8. De workflow markeert specifieke voorwaarden en acties om het logische pad dat de workflow volgt visueel weer te geven, op basis van de triggergebeurtenis die je selecteert. Je kunt de volgende acties uitvoeren:

   • Als je een voorbeeld wilt bekijken van de toepasselijke output op basis van de gegevens van de testgebeurtenis, klik je op een voorwaarde of actiestap in de workflow en vervolgens op het tabblad Voorbeeld. Dit kan een handige manier zijn om te bevestigen dat variabelen de juiste gegevens weergeven.
   • Als je een andere testgebeurtenis wilt selecteren, kies je een nieuwe testgebeurtenis uit de lijst Gebeurtenissen opnemen.
   • Klik op de workflowtrigger op Test opnieuw starten om de testresultaten van de workflow te vernieuwen.
   • Klik op en vervolgens op Opslaan om de testgebeurtenis op te slaan. Na het opslaan van de testgebeurtenis kun je de testgegevens naar behoefte wijzigen.

9. Optioneel: klik op Opname stoppen om de luistermodus af te sluiten. Je kunt het luisteren naar live testgebeurtenissen hervatten door op Opname starten te klikken.

Gesimuleerde gebeurtenissen aanmaken om een workflow te testen in Shopify Flow

Bij het aanmaken van gesimuleerde gebeurtenissen, handmatig of via Sidekick, lever je gebeurtenisgegevens aan op basis van de trigger die je instelt om een lijst met testgebeurtenissen te produceren. Deze gesimuleerde gebeurtenissen gebruiken echte winkelgegevens, zoals product- en collectie-informatie in je winkel die daadwerkelijk bestaat, maar brengen geen feitelijke wijzigingen aan in je winkel. Je kunt de workflow vervolgens die gesimuleerde gebeurtenis laten gebruiken om de test van de workflow uit te voeren.

De gegevens die je selecteert tijdens het aanmaken van een gebeurtenis, zijn afhankelijk van het type trigger dat de workflow start. Voor een workflow die bijvoorbeeld begint met de trigger Bestelling aangemaakt, hoef je alleen een bestaande bestelling te selecteren om als testgebeurtenis te gebruiken. Voor de trigger Toestemming toegewezen aan bedrijfscontact moet je echter een bedrijfslocatie, een contactpersoon voor dat bedrijf en een toestemmingsniveau selecteren om de testgebeurtenis aan te maken.

Als je liever niet zelf de gegevens selecteert om een testgebeurtenis aan te maken, kan Sidekick een reeks testgebeurtenissen voor je genereren.

Stappen:

Opgeslagen testgebeurtenissen bewerken in Shopify Flow

Je kunt de inhoud van opgeslagen testgebeurtenissen voor je workflow op elk gewenst moment bewerken. Je kunt ook alle opgeslagen testgebeurtenissen volledig verwijderen.

Stappen:

1. Ga in het Shopify-beheercentrum naar Apps > Flow.

2. Klik in de sectie Workflows op de workflow die je wilt testen.

3. Klik op Bewerken om de workflow-editor te openen.

4. Klik bij de trigger van de workflow op Je workflow testen.

5. Beweeg de muisaanwijzer in de lijst Opgeslagen gebeurtenis over de testgebeurtenis die je wilt bewerken en klik vervolgens op … > Bewerken.

6. Update de inhoud van de velden in de testgebeurtenis. Mogelijk moet je op de X klikken om gegevens te verwijderen voordat je nieuwe gegevens kunt selecteren.

7. Klik op Opslaan.

8. Optioneel: om de opgeslagen testgebeurtenis te verwijderen, beweeg je met de muis over de testgebeurtenis die je wilt verwijderen en klik je vervolgens op … > Verwijderen.

Je workflowtest controleren

Wanneer je een workflow test in Shopify Flow, controleer dan de volgende informatie om ervoor te zorgen dat je workflow zich gedraagt zoals verwacht op basis van de testtriggergebeurtenis:

• Volgt de algehele logica van de workflow je verwachtingen? Als de voorwaarde van een testgebeurtenis bijvoorbeeld waar is, volgt de workflow dan het logische pad voor wanneer aan de voorwaarde wordt voldaan?
• Gebruikt de workflow de juiste variabelen in alle voorwaarden en acties? Je hebt de workflow bijvoorbeeld gevraagd te controleren op de variabele fulfillments_item.totalQuantity, die de som van alle aantallen orderregels voor een fulfilment retourneert, in plaats van de variabele order.fulfillmentsCount.count, die het aantal fulfilments voor de bestelling retourneert.
• Gebruikt de workflow de juiste operatoren in alle voorwaarden en variabelen?
  • Bevestig de AND/OR-logica. Controleert de voorwaarde bijvoorbeeld, bij een voorwaarde met meerdere elementen, of beide elementen waar zijn (A AND B), of slechts één (A OR B)?
  • Bevestig de logica Geen van/Minstens één van/Alle van, indien van toepassing.
  • Bevestig de correctheid van de operatoren van je variabele, zoals de logica Gelijk aan, Niet gelijk aan, Bestaat niet, Bestaat, Groter dan, Kleiner dan en Is minstens één van, indien van toepassing.
• Vinden de voorwaarden en acties van de workflow in de juiste volgorde plaats? Je workflow kan bijvoorbeeld zijn ingesteld om meerdere verschillende voorwaarden tegelijk te controleren, in plaats van één voorwaarde te controleren voordat wordt doorgegaan naar de volgende op basis van het resultaat.

Als een testworkflow zich onverwacht gedraagt, raadpleeg dan de informatie over het oplossen van fouten in Shopify Flow-workflows.