Suivre les exécutions
Onglet des exécutions, statuts et résultats, filtres, et historique des modifications apportées aux règles
À quoi ça sert
L'onglet « Exécutions » est le journal de ce que les automatisations ont fait : quand, pour quelle règle, avec quel résultat, et pourquoi elles ont échoué. C'est là qu'on vérifie qu'une règle nouvellement créée agit comme prévu, et là qu'on diagnostique une règle qui ne produit rien.
Deux journaux coexistent, à ne pas confondre : les exécutions, qui tracent les déclenchements, et l'historique, qui trace les modifications apportées aux règles elles-mêmes.
Un point important : une règle dont la condition renvoie faux ne laisse aucune trace. L'absence de ligne n'est pas une erreur, c'est le comportement normal d'une condition non satisfaite.
Concepts clés
- Exécution — un déclenchement d'une règle par un évènement. Une ligne par règle déclenchée.
- Statut — l'état de l'exécution : « Terminée », « Échec », « En attente de confirmation », « Refusée », « En attente », « En cours ».
- Résultat — le détail par action : le nom de l'action et, pour les mises à jour, le nombre d'objets modifiés.
- Erreur — la cause de l'échec, affichée sur la ligne.
- Historique — le journal des créations, modifications, suppressions et activations de règles.
Comment faire
Consulter les exécutions
- Ouvrez « Administration » puis « Automatisations ».
- Cliquez sur l'onglet « Exécutions ».
Le nombre total d'exécutions s'affiche à côté des onglets. La liste est paginée : le nombre de lignes par page se règle en bas du tableau.
Quand rien n'a encore été déclenché, la liste affiche « Aucune exécution pour le moment. ». Si le chargement échoue, le message « Impossible de charger les exécutions. » s'affiche avec un bouton « Réessayer » : c'est distinct d'une liste vide.
Filtrer les exécutions
- Dans l'onglet « Exécutions », cliquez sur « Filtres ».
- Ajoutez un ou plusieurs critères, puis appliquez.
Le nombre de critères actifs s'affiche à côté du bouton. Quand aucune ligne ne correspond, la liste affiche « Aucune exécution ne correspond au filtre. ».
Les filtres et le tri sont conservés dans l'adresse de la page : le lien peut être partagé ou mis en favori.
Ne voir que les échecs
- Cliquez sur « Filtres ».
- Ajoutez un critère sur « Statut » égal à « Échec ».
La colonne « Erreur » donne alors la cause de chaque échec.
Trier les exécutions
- Cliquez sur l'en-tête d'une colonne triable : « Date », « Règle » ou « Statut ».
Le tri porte sur une seule colonne à la fois.
Consulter l'historique des règles
- Placez-vous sur l'onglet « Règles ».
- Cliquez sur l'icône d'historique, à droite de l'en-tête, à côté de « Nouvelle règle ».
Le volet « Historique des automatisations » liste les évènements datés. Quand rien n'a encore été modifié, il affiche « Aucun événement pour le moment. ».
Diagnostiquer une règle qui ne fait rien
- Ouvrez l'onglet « Exécutions » et filtrez sur le nom de la règle.
- Aucune ligne : la règle n'a pas été déclenchée. Vérifiez qu'elle est « Activée », que le champ surveillé a bien changé, et que sa condition n'est pas systématiquement fausse.
- Une ligne « Échec » : lisez la colonne « Erreur ».
- Une ligne « Terminée » avec une action « ignorée » : la condition de cette action est fausse, ou sa confirmation a été refusée.
- Une ligne « Terminée » avec « 0 modifiée » : le filtre de l'action ne correspond à aucun objet.
Référence
Colonnes des exécutions
| Colonne | Contenu | Triable | Filtrable |
|---|---|---|---|
| Date | Date et heure du déclenchement | Oui | Oui |
| Règle | Le nom de la règle | Oui | Oui |
| Déclencheur | Le module et l'entité si elle est connue (la boîte mail pour un e-mail reçu), ou « Date » suivi de l'expression cron pour une règle planifiée | Non | Non |
| Statut | L'état de l'exécution | Oui | Oui |
| Résultat | Une pastille par action | Non | Non |
| Erreur | La cause de l'échec | Non | Oui |
Statuts d'une exécution
| Statut | Signification |
|---|---|
| Terminée | Toutes les actions se sont exécutées sans erreur |
| Échec | Au moins une action a échoué, ou la règle ne pouvait pas s'exécuter |
| En attente de confirmation | La question est posée à l'utilisateur et attend sa réponse |
| Refusée | L'utilisateur a refusé la confirmation de niveau règle |
| En attente | L'exécution est enregistrée et attend d'être traitée |
| En cours | L'exécution est en train de se dérouler |
Une exécution qui reste durablement « En attente » signale que le traitement a été interrompu. Le rattrapage la reprend, au plus tard cinq minutes après, en repartant juste après la dernière action déjà terminée avec succès : les actions précédentes ne s'exécutent pas une seconde fois.
Pastilles de résultat
| Pastille | Signification |
|---|---|
| Nom de l'action seul | L'action a abouti et ne compte pas d'objets, par exemple la création d'une tâche |
| Nom de l'action suivi de « 3 modifiées » | L'action de mise à jour a modifié ce nombre d'objets. « 0 modifiée » signale un filtre qui ne correspond à rien |
| Nom de l'action suivi de « ignorée » | La condition de l'action est fausse, sa confirmation a été refusée, ou il n'y avait rien à faire |
| Nom de l'action suivi de « erreur » | L'action a échoué. La cause est dans la colonne « Erreur » |
| Nom de l'action suivi de « en attente de validation » | L'action est soumise à validation : elle s'exécutera si un valideur la valide. L'exécution, elle, est « Terminée ». Voir Valider les actions des automatisations |
| « 2 tâches créées sur 3 » ou « Liste vide » sous la pastille | L'action répète « Créer une tâche » sur une liste : le nombre d'éléments traités avec succès sur le total. Une liste vide donne « Liste vide ». Voir Répéter une action sur une liste |
| « Réponse de l'IA » sous la pastille | L'action a un pré-traitement IA : déroulez-la pour lire chaque valeur renvoyée par le modèle, « Non trouvé » quand il a répondu vide. Voir Pré-traiter une action avec l'IA |
Le nom de l'action dit aussi ce qu'elle visait : l'entité CRM ou le type de tâche, par exemple « Créer une fiche CRM Contact », et, pour une mise à jour ciblée par un filtre, ce filtre relu en toutes lettres entre parenthèses. La cible affichée est celle que l'action visait au moment de l'exécution : modifier ensuite la règle ne change pas les lignes passées. Une exécution antérieure à cette mention, ou une action qui ne vise ni entité CRM ni type de tâche (envoi d'e-mail, compétence, devis…), n'affiche que le nom de l'action. Pour une exécution déclenchée par un e-mail, le filtre n'est plus affiché une fois l'exécution terminée.
Filtres disponibles
| Champ | Opérateurs |
|---|---|
| Statut | égal, différent de, fait partie de, ne fait pas partie de |
| Règle | égal, différent de, contient, ne contient pas, commence par, finit par, est vide, n'est pas vide |
| Date | égal, supérieur à, supérieur ou égal, inférieur à, inférieur ou égal, entre |
| Erreur | contient, ne contient pas, est vide, n'est pas vide |
Évènements de l'historique
| Évènement | Signification |
|---|---|
| Automatisations initialisées | Première règle créée dans l'organisation |
| Règle configurée | Une règle a été créée ou modifiée |
| Règle supprimée | Une règle a été supprimée |
| Activation de la règle modifiée | Une règle a été activée ou désactivée |
| Rôles valideurs modifiés | Les rôles qui valident les actions en attente ont changé |
| Modèle de notification enregistré | Un modèle de notification a été créé ou modifié. Voir Envoyer une notification depuis une règle |
| Modèle de notification supprimé | Un modèle de notification a été supprimé |
Exécution déclenchée par un e-mail
Un e-mail est traité, jamais conservé (hors les pièces jointes qu'une action est configurée pour ranger : voir Ranger les pièces jointes d'un e-mail reçu). Une fois l'exécution terminée, son historique ne garde de l'e-mail que la boîte, la date de réception et l'identifiant du message : l'objet, le corps, les adresses et les réponses de l'IA ne se relisent plus. Voir Choisir un déclencheur.
Ce qui ne laisse pas de trace
- Une règle désactivée : elle n'est jamais déclenchée.
- Une règle dont la condition est fausse : elle est écartée avant tout enregistrement.
- Un évènement qui ne correspond à aucune règle.
Questions fréquentes
Une exécution disparaît-elle au bout d'un certain temps ?
Les exécutions restent consultables ; l'application ne propose pas de purge.
Pourquoi une exécution est-elle en « Échec » alors que ma règle semble bonne ?
Lisez la colonne « Erreur ». Les causes les plus fréquentes sont un champ inexistant dans les paramètres d'une action, une valeur mal formée, une formule appliquée à un champ vide, ou l'enchaînement de règles arrivé à sa limite.
Puis-je relancer une exécution en échec ?
Non. Corrigez la règle, puis reproduisez la modification qui la déclenche.
Puis-je voir l'objet exact qui a déclenché une exécution ?
Non directement. La colonne « Déclencheur » indique le module et l'entité ; recoupez avec la date pour retrouver l'objet concerné dans son module. Pour un e-mail reçu, le contenu n'est pas conservé : seuls la boîte, la date de réception et l'identifiant du message restent.
Une règle supprimée fait-elle disparaître ses exécutions ?
Non. Les lignes restent, mais les colonnes « Règle » et « Déclencheur » affichent un tiret : elles s'appuient sur la règle, qui n'existe plus. Voir Créer une règle.
Se déclencher sur un e-mail ou un webhook
Faire partir une règle à la réception d'un e-mail dans une boîte surveillée ou d'un appel sur un webhook exposé par l'organisation
Demander une confirmation avant d'exécuter
Confirmation au niveau de la règle ou d'une action, effet d'un refus et cas où la confirmation n'est pas demandée