Testen en uitvoeringen

Voordat een automatisering voor je leden werkt, wil je zelf zien dat ze werkt. Een testrun start haar één keer op verzoek. In het overzicht Uitvoeringen zie je daarna elke uitvoering, echt of test, stap voor stap, zodat je ziet wat er is gebeurd en waarom een uitvoering is mislukt.

Automatiseringen openen

Wat een testrun echt doet

Een testrun is geen simulatie. Hij voert de automatisering één keer uit, en wel meteen:

• Acties worden echt uitgevoerd. E-mails gaan de deur uit, tags, groepen en cursustoegang veranderen, en webhooks en externe verzoeken worden verstuurd. Test met je eigen account of een testlid, niet met een echte klant.
• Hij gebruikt de laatst opgeslagen versie, ook als je die nog niet hebt gepubliceerd. Echte gebeurtenissen blijven de gepubliceerde versie gebruiken tot je publiceert.
• Hij werkt ook als de automatisering is uitgeschakeld.
• Bereikt de flow een stap Vertraging of Wachten tot, dan wacht de testrun net als een echte uitvoering. De overige stappen draaien echt zodra het wachten voorbij is.
• Een stap Workflow uitvoeren start de andere automatisering echt. Die uitvoering verschijnt in het overzicht Uitvoeringen van de andere automatisering met de bron Automatisch.
• Elke integratie die de flow gebruikt, moet gekoppeld zijn. Anders stopt de test met “Koppel eerst deze integraties:” en de ontbrekende namen.

Testruns tellen niet mee in de lijst: Laatste uitvoering, Uitvoeringen (7 d), Succes (7 d) en de weergave Mislukt negeren ze. Een mislukte test markeert je automatisering niet als mislukt.

Een automatisering bouwen

Een testrun starten vanuit de lijst

Open in de lijst het menu van een automatisering en kies Testrun. Het venster legt uit: “Voert het huidige concept één keer uit met lege testgegevens. Acties worden echt uitgevoerd.” Deze test start zonder triggergegevens en zonder lid. Hij is handig voor een snelle controle. Wil je testen met een lid of met je eigen gegevens, start de test dan in de editor.

Heeft de automatisering meerdere triggers, kies er dan een onder Starten vanaf trigger. Klik daarna op Testrun starten. Het resultaat verschijnt in hetzelfde venster:

• Testrun afgerond, met de duur.
• De testrun wacht bij een vertragings- of wachtstap als de flow is gepauzeerd bij een stap Vertraging of Wachten tot. De rest volgt later.
• Testrun mislukt, met de foutmelding van de uitvoering.

Opnieuw uitvoeren start nog een test. Heeft de automatisering geen trigger, dan toont het venster “Deze automatisering heeft geen trigger om vanaf te starten.”

Een testrun starten in de editor

Klik in de kop van de editor op Testrun. Dit venster geeft je meer controle:

• Heb je niet-opgeslagen wijzigingen, dan meldt een notitie: “Je niet-opgeslagen wijzigingen worden vóór de testrun opgeslagen.” De test slaat eerst op en start dan. Mislukt het opslaan, dan start de test niet.
• Met één trigger noemt het venster die trigger. Met meerdere kies je er een onder Trigger.
• Gegevens (JSON) zijn de gegevens die de trigger zou leveren. Het veld begint als {}. Vul de velden in die je stappen lezen, bijvoorbeeld het veld dat een voorwaarde controleert of dat een variabele zoals {{order_id}} gebruikt: {"order_id": 1042, "amount": 4900}. Zolang de tekst geen geldige JSON is, toont het venster “Ongeldige JSON. Controleer de gegevens en probeer het opnieuw.” en voert het niets uit.
• UUID van lid (optioneel) is het lid om wie de uitvoering draait. Acties die met een lid werken, zoals een tag toevoegen of een cursus toekennen, hebben er een nodig. Laat het veld leeg voor flows zonder lid, zoals een planning of een webhook. Je vindt de UUID aan het einde van het webadres als je het lid in de beheeromgeving opent. Een onbekende UUID stopt de test met “Dit lid is niet gevonden in dit bedrijf.”

Klik op Testrun uitvoeren. Het venster sluit, het overzicht Uitvoeringen gaat open en het canvas toont de nieuwe uitvoering.

Deze meldingen stoppen een test voordat hij begint:

• “Sla de automatisering één keer op voordat je een testrun start.”
• “Voeg een trigger toe en sla op voordat je een testrun start.”
• “Deze trigger staat nog niet in de opgeslagen versie. Sla op en probeer het opnieuw.”
• “Sleep eerst een trigger naar het canvas. Een testrun start altijd bij een trigger.”

Het overzicht Uitvoeringen

Klik in de kop van de editor op Uitvoeringen. De knop werkt zodra de automatisering is opgeslagen. Het paneel toont de 50 meest recente uitvoeringen die bij je filters passen, de nieuwste eerst, en ververst om de paar seconden. Elke regel toont de status, de bron, de trigger, wanneer de uitvoering is gestart en, zodra ze klaar is, hoe lang ze duurde. Bij een wachtende uitvoering toont ze ook wanneer die verdergaat.

Status

• Wordt uitgevoerd: de uitvoering loopt.
• Wachtend: de uitvoering wacht bij een stap Vertraging of Wachten tot. De regel toont Gaat verder met de datum en het tijdstip in je lokale tijd waarop ze verdergaat. Wachten meerdere paden, dan is het het vroegste tijdstip.
• Afgerond: de uitvoering heeft haar einde bereikt.
• Mislukt: een stap is mislukt of de uitvoering liep tegen een limiet aan. Open de uitvoering om te zien waarom.
• Geannuleerd: de uitvoering stond te wachten en is gestopt omdat de automatisering is uitgeschakeld, gearchiveerd of verwijderd. Meer daarover verderop.

Bron

• Automatisch: iets op je platform heeft de uitvoering gestart, bijvoorbeeld een nieuw lid of een bestelling. Uitvoeringen die een stap Workflow uitvoeren van een andere automatisering heeft gestart, tonen ook deze bron.
• Planner: de klok van het platform heeft de uitvoering gestart. Dat geldt voor de triggers Volgens planning (cron), Lid inactief, Evenement begint binnenkort en Verlenging binnenkort.
• Handmatig: een testrun of een uitvoering die opnieuw is afgespeeld.
• Webhook: een inkomende webhook of een aanroep van een externe dienst.
• Overig: elke andere start.

Filters

Boven de lijst filter je op status (Elke status), op bron (Elke bron) en op een startdatum en -tijd onder Sinds. Er is geen apart statusfilter voor wachtende uitvoeringen: die staan onder Wordt uitgevoerd. Filters wissen zet alle filters terug en toont hoeveel er actief zijn. Past er niets, dan meldt het paneel “Geen uitvoeringen voor deze filters” met een link Alles tonen. Vóór de eerste uitvoering staat er “Nog geen uitvoeringen. Klik op Testrun om er een te starten.”

Een uitvoering bekijken

Klik op een uitvoering in de lijst. Het canvas schakelt over naar die uitvoering en toont de flow zoals die was in de versie die de uitvoering gebruikte. Een balk bovenaan toont wanneer de uitvoering is gestart, haar status en “Het canvas is alleen-lezen.” Zolang je een uitvoering bekijkt, kun je niets bewerken. Afspelen stoppen brengt je huidige concept terug.

Elke stap die de uitvoering heeft bereikt, krijgt een gekleurde ring en een klein label:

• Groen: Afgerond.
• Rood: Mislukt.
• Blauw: Wordt uitgevoerd.
• Paars met een zandloper: Wachtend. De stap is een stap Vertraging of Wachten tot en de uitvoering gaat later verder.
• Grijs: Overgeslagen. De stap is overgeslagen, bijvoorbeeld omdat een filter dit pad heeft gestopt of de uitvoering tijdens het wachten is geannuleerd.

Stappen zonder ring zijn niet bereikt.

Klik op een stap om die in het paneel rechts te openen. Instellingen toont de configuratie, alleen-lezen. Uitvoering toont wat er is gebeurd:

• Status, Gestart en Afgerond. Een wachtende stap toont Gaat verder met het tijdstip waarop de uitvoering verdergaat.
• Invoer en Uitvoer: de gegevens die de stap heeft ontvangen en doorgegeven.
• Een rood vak met de fout als de stap is mislukt. Stacktrace tonen opent technische details die je naar support kunt sturen.
• Een gele melding Let op bij een afgeronde stap betekent dat de stap wel is uitgevoerd, maar niets heeft veranderd, bijvoorbeeld “The member already has this badge.”

Een stap die de uitvoering nooit heeft bereikt, toont “Dit blok is tijdens de uitvoering niet bereikt.” Is de hele uitvoering mislukt, dan toont de balk ook de fout van de uitvoering in rood.

Een uitvoering opnieuw afspelen

Opnieuw afspelen in de balk start de uitvoering opnieuw. Na de vraag Deze uitvoering opnieuw afspelen? waarschuwt het venster: “Voert het huidige concept opnieuw uit met dezelfde gegevens. Acties worden echt uitgevoerd.” Het opnieuw afspelen gebruikt dezelfde triggergegevens en hetzelfde lid als de oorspronkelijke uitvoering, maar de laatst opgeslagen versie van je flow. Zo controleer je een correctie het snelst: zoek de mislukte uitvoering, verbeter de stap, sla op en speel opnieuw af.

Het opnieuw afspelen is een nieuwe uitvoering met de bron Handmatig, en het canvas schakelt er meteen naar over. Heb je sinds de oorspronkelijke uitvoering de trigger vervangen, dan stopt het afspelen met “De trigger van deze run bestaat niet meer in de huidige versie. Start in plaats daarvan een nieuwe testrun.”

Fouten opsporen in de lijst

Je hoeft niet elke automatisering te openen om problemen te vinden. De lijst toont ze, alleen op basis van echte uitvoeringen:

• De weergave Mislukt naast je mappen toont elke automatisering waarvan de laatste uitvoering is mislukt. Is er geen, dan staat er Geen mislukte automatiseringen.
• De kolom Laatste uitvoering toont Nooit, of het tijdstip van de laatste uitvoering met een gekleurde stip: groen voor afgerond, blauw voor lopend, grijs voor geannuleerd. Een mislukte laatste uitvoering verschijnt als rood label met de tooltip Laatste uitvoering mislukt.
• Succes (7 d) is het aandeel afgeronde uitvoeringen onder de voltooide uitvoeringen van de afgelopen zeven dagen. Uitvoeringen die nog lopen, tellen niet mee. Mislukte en geannuleerde uitvoeringen verlagen het percentage. Uitvoeringen (7 d) telt alle uitvoeringen van de afgelopen zeven dagen en is standaard verborgen.
• Het filter Status laatste uitvoering vindt automatiseringen op Afgerond, Mislukt, Bezig, Geannuleerd of Nooit.

Open van daaruit de automatisering, open Uitvoeringen, filter op Mislukt en klik op de uitvoering om te zien welke stap is mislukt en waarom.

Activiteit: wie wat heeft gewijzigd

Activiteit in het menu van een automatisering toont de laatste 50 wijzigingen, elk met de persoon en het tijdstip: Aangemaakt, Opgeslagen, Gepubliceerd, Teruggedraaid, Ingeschakeld, Uitgeschakeld, Gearchiveerd, Gedearchiveerd, Verwijderd, Gedupliceerd, Geïmporteerd voor een automatisering die uit een sjabloon is gemaakt, en Webhookgeheim vernieuwd. Wijzigingen die voor meerdere automatiseringen tegelijk zijn gedaan, verschijnen bij elk van die automatiseringen. Testruns en opnieuw afgespeelde uitvoeringen horen niet bij de activiteit; die vind je in het overzicht Uitvoeringen. Een nieuwe automatisering zonder wijzigingen toont “Nog geen activiteit.”

Overzicht van automatiseringen

Wat er met wachtende uitvoeringen gebeurt

Een uitvoering die wacht bij een stap Vertraging of Wachten tot, controleert de automatisering opnieuw zodra het wachten voorbij is:

• Uitgeschakeld: een echte uitvoering die aan de beurt komt terwijl de automatisering uitstaat, wordt geannuleerd. De overige stappen draaien niet. Schakel je de automatisering weer in voordat het wachten voorbij is, dan gaat de uitvoering gewoon verder. Testruns en opnieuw afgespeelde uitvoeringen gaan ook verder als de automatisering uitstaat.
• Gearchiveerd: de uitvoering wordt geannuleerd, testruns inbegrepen. Archiveren schakelt de automatisering ook uit.
• Verwijderd: de uitvoering wordt geannuleerd.
• Nieuwe versie gepubliceerd: een uitvoering die al is gestart, wordt afgerond met de versie waarmee ze is begonnen. Alleen uitvoeringen die na het publiceren starten, gebruiken de nieuwe versie. Hetzelfde geldt bij terugzetten naar een eerdere versie.

Een geannuleerde uitvoering toont Geannuleerd in het overzicht Uitvoeringen, en haar wachtende stap wordt Overgeslagen. De fout van de uitvoering zegt waarom: “De automatisering is gepauzeerd terwijl de run wachtte.”, of hetzelfde met gearchiveerd of verwijderd.

Voorwaarden, vertakkingen en vertragingen

Hoe lang uitvoeringen bewaard blijven

Uitvoeringen worden 90 dagen bewaard. Eén keer per dag worden oudere uitvoeringen verwijderd, samen met de invoer en uitvoer van hun stappen. Uitvoeringen die nog wachten, blijven bewaard tot ze klaar zijn.

Veelvoorkomende fouten en wat ze betekenen

Problemen die de editor markeert

De editor markeert stappen met problemen voordat je iets uitvoert. Opslaan werkt nog steeds, maar de automatisering doet misschien niet wat je verwacht:

• “Bij de trigger is geen gebeurtenistype gekozen.”: kies waarop de trigger reageert.
• “Een trigger mag geen inkomende verbinding hebben.”: een trigger start altijd de flow. Verwijder de verbinding die erin leidt.
• “Bij de actie is geen type gekozen.”: kies wat de actie doet.
• “De actie heeft een integratie nodig, maar er is er geen gekozen.” en “De vereiste integratie is niet gekoppeld.”: koppel de dienst onder Integraties en kies de koppeling in de stap.
• “‘Dagen inactief’ moet 1 of meer zijn.”, “‘Dagen voor verlenging’ moet 1 of meer zijn.” en “‘Uren voor de start’ moet 1 of meer zijn.”: de triggers Lid inactief, Verlenging binnenkort en Evenement begint binnenkort starten nooit zonder dit getal. Vul een geheel getal van 1 of meer in.
• “De vertraging heeft geen duur.”: vul een duur groter dan nul in.
• “Bij ‘Workflow uitvoeren’ is geen workflow geselecteerd.”: kies de automatisering die de stap moet starten.
• “Geen inkomende verbinding. Deze stap is onbereikbaar.”: verbind de stap met de flow of verwijder hem.
• “De flow heeft geen trigger.”: voeg een trigger toe.
• “Reageren op webhook wordt pas na een vertragings- of wachtstap uitgevoerd. De aanroeper van de webhook krijgt in plaats daarvan het standaardantwoord.”: zet het antwoord vóór het wachten.

Fouten in een mislukte uitvoering

De fout van een mislukte uitvoering noemt de stap bij zijn interne ID en type, bijvoorbeeld “Stap ‘n4’ (action) is mislukt.” of “Stap ‘n4’ (action) is gestopt met een fout.”, gevolgd door de reden. Klik op de rode stap op het canvas om de volledige melding te lezen. Deze fouten verschijnen in de standaardtaal van je platform, ook bij testruns en opnieuw afgespeelde uitvoeringen. Vaak voorkomende oorzaken:

• “… is gestopt met een fout.”: de stap liep tegen een fout aan, vaak een externe dienst die het verzoek heeft geweigerd of een koppeling die vernieuwd moet worden.
• “Het verzoek gaf HTTP … terug: …”, “Het verzoek kon niet worden verzonden: …” of “De URL ‘…’ is ongeldig of niet toegestaan.”: een stap Externe aanvraag versturen kreeg een fout van je server, geen antwoord op tijd, een doorverwijzing, of een adres dat hij niet mag aanroepen.
• “De uit te voeren workflow is niet gevonden.”, “De uit te voeren workflow heeft geen gepubliceerde versie.” of “De uit te voeren workflow heeft geen trigger.”: de automatisering die een stap Workflow uitvoeren start, is verwijderd, nooit gepubliceerd of heeft geen trigger.
• “Een workflow kan zichzelf niet uitvoeren.” en “Workflows zijn te diep genest (maximaal 5 niveaus).”: stappen Workflow uitvoeren roepen elkaar in een kring of te diep aan.
• “De workflow ‘…’ is mislukt.”: de andere automatisering is mislukt. Bekijk haar eigen overzicht Uitvoeringen.
• “De limiet van 500 stappen is bereikt.”: een uitvoering voert in één keer hoogstens 500 stappen uit. Dat komt meestal door een lus over een lange lijst met meerdere stappen erin.
• “De run duurde te lang en is gestopt.”: de uitvoering duurde langer dan het platform toestaat, bijvoorbeeld omdat een externe dienst te traag antwoordde.

Meldingen bij afgeronde stappen

Een gele melding markeert een stap die is afgerond zonder zijn werk te doen:

• “No member of this business could be resolved for this run.”: de uitvoering heeft geen lid. Test opnieuw met een UUID van lid (optioneel), of controleer of het lid tijdens het wachten is verwijderd.
• “The configured course no longer exists.”, of hetzelfde voor een groep of een badge: kies een nieuwe in de stap.
• “The course is not published, so no access was granted.”: publiceer eerst de cursus.
• “Geen datum gevonden in ‘…’. De flow is verdergegaan zonder te wachten.” of “De datum ‘…’ kon niet worden gelezen. De flow is verdergegaan zonder te wachten.”: een stap Wachten tot heeft geen bruikbare datum gevonden en is verdergegaan zonder te wachten.
• “De workflow ‘…’ is gepauzeerd. De flow is zonder die workflow verdergegaan.”: schakel de automatisering in die de stap Workflow uitvoeren start.

Niet elke actie laat een melding achter. Toont een ledenstap Afgerond maar is er niets veranderd, controleer dan of de uitvoering onder Invoer een lid had.