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 | 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.
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 » |
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 |
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.
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.