Tests et historique d'exécution

Avant qu'une automatisation travaille pour vos membres, vous voulez la voir fonctionner pour vous. Une exécution de test la démarre une fois à la demande. L'historique d'exécution affiche ensuite chaque exécution, réelle ou de test, étape par étape, pour que vous voyiez ce qui s'est passé et pourquoi une exécution a échoué.

Ouvrir les automatisations

Ce que fait réellement une exécution de test

Une exécution de test n'est pas une simulation. Elle exécute l'automatisation une fois, tout de suite :

• Les actions s'exécutent réellement. Les e-mails partent, les tags, les groupes et les accès aux cours changent, et les webhooks et les requêtes externes sont envoyés. Testez avec votre propre compte ou un membre de test, pas avec un vrai client.
• Elle utilise la dernière version enregistrée, même si vous ne l'avez pas encore publiée. Les événements réels continuent d'utiliser la version publiée jusqu'à ce que vous publiiez.
• Elle fonctionne aussi quand l'automatisation est désactivée.
• Quand le flux atteint une étape Délai ou Attendre jusqu'à la date, l'exécution de test attend comme une exécution réelle. Les étapes restantes s'exécutent réellement une fois l'attente terminée.
• Une étape Exécuter le workflow démarre réellement l'autre automatisation. Cette exécution apparaît dans l'historique d'exécution de l'autre automatisation avec la source Automatique.
• Chaque intégration utilisée par le flux doit être connectée. Sinon le test s'arrête avec « Connectez d'abord ces intégrations : » et les noms manquants.

Les exécutions de test ne comptent pas dans la liste : Dernière exécution, Exécutions (7 j), Succès (7 j) et la vue Échoué les ignorent. Un test échoué ne marque pas votre automatisation comme échouée.

Créer une automatisation

Lancer une exécution de test depuis la liste

Ouvrez le menu d'une automatisation dans la liste et choisissez Exécution de test. La boîte de dialogue explique : « Exécute le brouillon actuel une fois avec des données de test vides. Les actions sont réellement exécutées. » Ce test démarre sans données de déclencheur et sans membre. Il convient pour une vérification rapide. Pour tester avec un membre ou vos propres données, lancez le test dans l'éditeur.

Si l'automatisation a plusieurs déclencheurs, choisissez-en un sous Démarrer depuis le déclencheur. Cliquez ensuite sur Lancer l'exécution de test. Le résultat apparaît dans la même boîte de dialogue :

• Exécution de test terminée, avec la durée.
• L'exécution de test attend à une étape de délai ou d'attente quand le flux s'est mis en pause à une étape Délai ou Attendre jusqu'à la date. La suite vient plus tard.
• L'exécution de test a échoué, avec le message d'erreur de l'exécution.

Exécuter à nouveau lance un autre test. Si l'automatisation n'a pas de déclencheur, la boîte de dialogue affiche « Cette automatisation n'a aucun déclencheur de départ. »

Lancer une exécution de test dans l'éditeur

Cliquez sur Exécution de test dans l'en-tête de l'éditeur. La boîte de dialogue offre plus de contrôle :

• Si vous avez des modifications non enregistrées, une note indique « Vos modifications non enregistrées sont enregistrées avant l'exécution de test. » Le test enregistre d'abord, puis démarre. Si l'enregistrement échoue, le test ne démarre pas.
• Avec un seul déclencheur, la boîte de dialogue le nomme. Avec plusieurs, choisissez-en un sous Déclencheur.
• Charge utile correspond aux données que le déclencheur fournirait. Elle commence par {}. Saisissez les champs que lisent vos étapes, par exemple le champ qu'une condition vérifie ou celui qu'utilise une variable comme {{order_id}} : {"order_id": 1042, "amount": 4900}. Tant que le texte n'est pas du JSON valide, la boîte de dialogue affiche « JSON non valide. Veuillez vérifier la charge utile et réessayer. » et ne s'exécute pas.
• UUID du membre est le membre concerné par l'exécution. Les actions qui agissent sur un membre, par exemple ajouter un tag ou accorder un cours, en ont besoin. Laissez-le vide pour les flux sans membre, comme un planning ou un webhook. Vous trouvez l'UUID à la fin de l'adresse web quand vous ouvrez le membre dans l'espace d'administration. Un UUID inconnu arrête le test avec « Ce membre est introuvable dans cette entreprise. »

Cliquez sur Lancer le test. La boîte de dialogue se ferme, l'historique d'exécution s'ouvre et le canevas affiche la nouvelle exécution.

Ces messages arrêtent un test avant qu'il démarre :

• « Enregistrez l'automatisation une fois avant de lancer une exécution de test. »
• « Ajoutez un déclencheur et enregistrez avant de lancer une exécution de test. »
• « Ce déclencheur ne figure pas encore dans la version enregistrée. Enregistrez, puis réessayez. »
• « Cette automatisation n'a aucun déclencheur à tester. »

L'historique d'exécution

Cliquez sur Exécutions dans l'en-tête de l'éditeur. Le bouton fonctionne dès que l'automatisation est enregistrée. Le panneau liste les 50 exécutions les plus récentes qui correspondent à vos filtres, de la plus récente à la plus ancienne, et s'actualise toutes les quelques secondes. Chaque entrée affiche le statut, la source, le déclencheur, le moment où l'exécution a commencé et, une fois terminée, sa durée. Pour une exécution en attente, elle affiche aussi quand elle reprend.

Statut

• En cours : l'exécution est en cours.
• En attente : l'exécution attend à une étape Délai ou Attendre jusqu'à la date. L'entrée affiche Reprise avec la date et l'heure, dans votre heure locale, auxquelles elle continue. Si plusieurs chemins attendent, c'est l'heure la plus proche.
• Terminé : l'exécution a atteint sa fin.
• Échoué : une étape a échoué ou l'exécution a atteint une limite. Ouvrez l'exécution pour voir pourquoi.
• Annulé : l'exécution attendait et a été arrêtée parce que l'automatisation a été désactivée, archivée ou supprimée. Plus de détails plus bas.

Source

• Automatique : quelque chose sur votre plateforme a démarré l'exécution, par exemple un nouveau membre ou une commande. Les exécutions démarrées par une étape Exécuter le workflow d'une autre automatisation affichent aussi cette source.
• Planificateur : l'horloge de la plateforme a démarré l'exécution. Cela couvre les déclencheurs Selon un planning (cron), Membre inactif, Événement imminent et Renouvellement imminent.
• Manuel : une exécution de test ou une relecture.
• Webhook : un webhook entrant ou un appel d'un service externe.
• Autre : tout autre démarrage.

Filtres

Au-dessus de la liste, vous pouvez filtrer par statut (Tout statut), par source (Toute source) et par date et heure de début sous Depuis. Il n'y a pas de filtre de statut séparé pour les exécutions en attente : elles apparaissent sous En cours. Effacer les filtres réinitialise tous les filtres et indique combien sont actifs. Quand rien ne correspond, le panneau indique « Aucune exécution ne correspond à vos filtres » avec un lien Tout afficher. Avant la première exécution, il indique « Aucune exécution pour le moment ».

Examiner une exécution

Cliquez sur une exécution dans la liste. Le canevas passe à cette exécution et affiche le flux tel qu'il était dans la version utilisée par l'exécution. Une bannière en haut affiche quand l'exécution a commencé, son statut et « La relecture est en lecture seule. » Vous ne pouvez pas modifier pendant que vous examinez une exécution. Quitter la relecture ramène votre brouillon actuel.

Chaque étape atteinte par l'exécution reçoit un anneau coloré et un petit badge :

• Vert : Terminé.
• Rouge : Échoué.
• Bleu : En cours.
• Violet avec un sablier : En attente. L'étape est une étape Délai ou Attendre jusqu'à la date et l'exécution continue plus tard.
• Gris : Ignoré. L'étape a été sautée, par exemple parce qu'un filtre a arrêté ce chemin ou que l'exécution a été annulée pendant l'attente.

Les étapes sans anneau n'ont pas été atteintes.

Cliquez sur une étape pour l'ouvrir dans le panneau de droite. Paramètres affiche sa configuration, en lecture seule. Exécution affiche ce qui s'est passé :

• Statut, Démarré et Terminé. Une étape en attente affiche Reprise avec l'heure à laquelle l'exécution continue.
• Entrée et Sortie : les données que l'étape a reçues et transmises.
• Un encadré rouge avec l'erreur si l'étape a échoué. Afficher la trace ouvre des détails techniques que vous pouvez envoyer au support.
• Une Remarque jaune sur une étape terminée signifie que l'étape s'est exécutée sans rien changer, par exemple « The member already has this badge. »

Une étape que l'exécution n'a jamais atteinte indique « Aucune trace disponible ». Si toute l'exécution a échoué, la bannière affiche aussi l'erreur de l'exécution en rouge.

Relancer une exécution

Relire dans la bannière relance l'exécution. Après la question Relancer cette exécution ?, la boîte de dialogue avertit : « Exécute à nouveau le brouillon actuel avec les mêmes données. Les actions sont réellement exécutées. » La relecture utilise les mêmes données de déclencheur et le même membre que l'exécution d'origine, mais la dernière version enregistrée de votre flux. C'est donc le moyen le plus rapide de vérifier une correction : trouver l'exécution échouée, corriger l'étape, enregistrer, relancer.

La relecture est une nouvelle exécution avec la source Manuel, et le canevas passe aussitôt à celle-ci. Si vous avez remplacé le déclencheur depuis l'exécution d'origine, la relecture s'arrête avec « Le déclencheur de cette exécution n'existe plus dans la version actuelle. Lancez plutôt une nouvelle exécution de test. »

Repérer les échecs dans la liste

Vous n'avez pas besoin d'ouvrir chaque automatisation pour trouver les problèmes. La liste les montre, sur la base des exécutions réelles uniquement :

• La vue Échoué à côté de vos dossiers liste chaque automatisation dont la dernière exécution a échoué. Quand il n'y en a aucune, elle affiche Aucune automatisation échouée.
• La colonne Dernière exécution affiche Jamais, ou l'heure de la dernière exécution avec un point coloré : vert pour terminée, bleu pour en cours, gris pour annulée. Une dernière exécution échouée apparaît sous forme de badge rouge avec l'infobulle La dernière exécution a échoué.
• Succès (7 j) est la part des exécutions terminées avec succès parmi les exécutions terminées des sept derniers jours. Les exécutions encore en cours ne comptent pas. Les exécutions échouées et annulées le font baisser. Exécutions (7 j) compte toutes les exécutions des sept derniers jours et est masquée par défaut.
• Le filtre Statut de la dernière exécution trouve les automatisations par Terminé, Échoué, En cours, Annulé ou Jamais.

De là, ouvrez l'automatisation, ouvrez Exécutions, filtrez par Échoué et cliquez sur l'exécution pour voir quelle étape a échoué et pourquoi.

Activité : qui a modifié quoi

Activité dans le menu d'une automatisation liste ses 50 dernières modifications, chacune avec la personne et l'heure : Créé, Enregistré, Publié, Restaurée, Activé, Désactivé, Archivé, Désarchivée, Supprimé, Dupliqué, Importé pour une automatisation créée à partir d'un modèle, et Secret du webhook renouvelé. Les modifications faites pour plusieurs automatisations à la fois apparaissent dans chacune d'elles. Les exécutions de test et les relectures ne font pas partie de l'activité ; vous les trouvez dans l'historique d'exécution. Une nouvelle automatisation sans modification affiche « Aucune activité pour le moment. »

Vue d'ensemble des automatisations

Ce qui arrive aux exécutions en attente

Une exécution qui attend à une étape Délai ou Attendre jusqu'à la date vérifie à nouveau l'automatisation quand l'attente est terminée :

• Désactivée : une exécution réelle qui arrive à échéance pendant que l'automatisation est désactivée est annulée. Ses étapes restantes ne s'exécutent pas. Si vous réactivez l'automatisation avant la fin de l'attente, l'exécution continue normalement. Les exécutions de test et les relectures continuent même quand l'automatisation est désactivée.
• Archivée : l'exécution est annulée, exécutions de test comprises. L'archivage désactive aussi l'automatisation.
• Supprimée : l'exécution est annulée.
• Nouvelle version publiée : une exécution déjà commencée se termine avec la version avec laquelle elle a commencé. Seules les exécutions qui commencent après la publication utilisent la nouvelle version. Il en va de même pour un retour arrière.

Une exécution annulée affiche Annulé dans l'historique d'exécution, et son étape en attente passe à Ignoré. L'erreur de l'exécution en donne la raison : « L'automatisation a été mise en pause pendant que l'exécution était en attente. », ou la même chose avec archivée ou supprimée.

Conditions, branches et délais

Durée de conservation des exécutions

L'historique d'exécution conserve les exécutions pendant 90 jours. Une fois par jour, les exécutions plus anciennes sont supprimées avec l'entrée et la sortie de leurs étapes. Les exécutions encore en attente sont conservées jusqu'à ce qu'elles soient terminées.

Erreurs fréquentes et leur signification

Problèmes signalés par l'éditeur

L'éditeur marque les étapes qui posent problème avant toute exécution. L'enregistrement fonctionne quand même, mais l'automatisation risque de ne pas se comporter comme prévu :

• « Aucun type d'événement n'est sélectionné pour le déclencheur. » : choisissez ce à quoi le déclencheur réagit.
• « Un déclencheur ne doit pas avoir de connexion entrante. » : un déclencheur démarre toujours le flux. Supprimez la connexion qui y mène.
• « Aucun type n'est sélectionné pour l'action. » : choisissez ce que fait l'action.
• « L'action nécessite une intégration, mais aucune n'est choisie. » et « L’intégration requise n’est pas connectée. » : connectez le service sous Intégrations et sélectionnez la connexion dans l'étape.
• « « Jours d'inactivité » doit être au moins 1. », « « Jours avant le renouvellement » doit être au moins 1. » et « « Heures avant le début » doit être au moins 1. » : les déclencheurs Membre inactif, Renouvellement imminent et Événement imminent ne démarrent jamais sans ce nombre. Saisissez un nombre entier de 1 ou plus.
• « Le délai n'a pas de durée. » : saisissez une durée supérieure à zéro.
• « Aucun workflow n'est sélectionné dans "Exécuter le workflow". » : choisissez l'automatisation que l'étape doit démarrer.
• « Aucune connexion entrante. Ce nœud est inaccessible. » : reliez l'étape au flux ou supprimez-la.
• « Le graphe n'a pas de nœud déclencheur. » : ajoutez un déclencheur.
• « Répondre au webhook s'exécute après une étape de délai ou d'attente. L'appelant du webhook reçoit à la place la réponse par défaut. » : placez la réponse avant l'attente.

Erreurs dans une exécution échouée

L'erreur d'une exécution échouée nomme l'étape et son type, par exemple « L'étape "Envoyer un e-mail" (Action) a échoué. » ou « L'étape "Envoyer un e-mail" (Action) s'est arrêtée avec une erreur. », suivi de la raison. Les déclencheurs et les actions apparaissent avec leur nom dans la bibliothèque, les autres étapes avec le nom affiché sur le canevas. Cliquez sur l'étape rouge du canevas pour lire le message complet. Ces erreurs apparaissent dans la langue par défaut de votre plateforme, y compris pour les exécutions de test et les relectures. Causes fréquentes :

• « … s'est arrêtée avec une erreur. » : l'étape a rencontré une erreur, souvent un service externe qui a refusé la requête ou une connexion qui doit être renouvelée.
• « La requête a renvoyé HTTP … », « La requête n'a pas pu être envoyée : … » ou « L'URL "…" n'est pas valide ou n'est pas autorisée. » : une étape Faire une demande externe a reçu une erreur de votre serveur, aucune réponse à temps, une redirection, ou une adresse qu'elle n'a pas le droit d'appeler.
• « Le workflow à exécuter est introuvable. », « Le workflow à exécuter n'a aucune version publiée. » ou « Le workflow à exécuter n'a aucun déclencheur. » : l'automatisation qu'une étape Exécuter le workflow démarre a été supprimée, n'a jamais été publiée ou n'a pas de déclencheur.
• « Un workflow ne peut pas s'exécuter lui-même. » et « Les workflows sont trop imbriqués (au maximum 5 niveaux). » : des étapes Exécuter le workflow s'appellent en boucle ou trop profondément.
• « Le workflow "…" a échoué. » : l'autre automatisation a échoué. Consultez son propre historique d'exécution.
• « La limite de 500 étapes a été atteinte. » : une exécution traite au plus 500 étapes d'un seul tenant. Cela vient généralement d'une boucle sur une longue liste contenant plusieurs étapes.
• « L'exécution a pris trop de temps et a été arrêtée. » : l'exécution a duré plus longtemps que la plateforme ne le permet, par exemple parce qu'un service externe a répondu trop lentement.

Remarques sur les étapes terminées

Une remarque jaune signale une étape terminée sans avoir fait son travail :

• « No member of this business could be resolved for this run. » : l'exécution n'a pas de membre. Testez à nouveau avec un UUID du membre, ou vérifiez si le membre a été supprimé pendant une attente.
• « The configured course no longer exists. », ou la même chose pour un groupe ou un badge : choisissez-en un nouveau dans l'étape.
• « The course is not published, so no access was granted. » : publiez d'abord le cours.
• « Aucune date trouvée dans "…". Le flux a continué sans attendre. » ou « La date "…" n'a pas pu être lue. Le flux a continué sans attendre. » : une étape Attendre jusqu'à la date n'a trouvé aucune date utilisable et a continué sans attendre.
• « Le workflow "…" est en pause. Le flux a continué sans lui. » : activez l'automatisation que démarre l'étape Exécuter le workflow.

Toutes les actions ne laissent pas de remarque. Si une étape sur un membre affiche Terminé mais que rien n'a changé, vérifiez si l'exécution avait un membre sous Entrée.