Vérifier l’historique d’exécution et les erreurs d’une règle

Lorsqu'une règle d'automatisation doit faire quelque chose mais que rien ne se passe, l'historique d'exécution vous aide. Il vous montre, pour chaque règle, quelles actions se sont exécutées et quand, si elles ont réussi, et quel message d'erreur est enregistré en cas de problème.

Ouvrir l'historique d'une règle

Vous trouvez l'historique directement dans la liste de vos règles d'automatisation. Chaque règle comporte, sur le bord droit, un bouton en forme de flèche qui permet de déplier et de replier l'historique.

1. La page Automatisations n'est actuellement pas liée dans le menu de navigation de gauche — Univents la déploie progressivement. Si vous êtes connecté à votre workspace, vous pouvez tout de même l'ouvrir directement : ajoutez automations à la fin de l'adresse dans la barre d'adresse de votre navigateur — par exemple, .../home/dein-workspace/events devient .../home/dein-workspace/automations.
2. Dans la liste des règles, repérez la règle que vous souhaitez vérifier. Sur le bord gauche, vous voyez le nom de la règle, le déclencheur et les actions enregistrées.
3. Pour cette règle, cliquez à droite sur le bouton en forme de flèche Afficher l'historique.
4. Sous la règle, la section Historique d'exécution s'ouvre et affiche les différentes exécutions.
5. Pour la fermer, cliquez à nouveau sur le même bouton, qui s'intitule désormais Masquer l'historique.

S'il n'y a pas encore d'exécution, le message Aucune exécution pour le moment. s'affiche à la place. C'est normal pour les règles qui viennent d'être créées ou qui ne se sont pas encore déclenchées.

Lire le statut d'une exécution

Chaque entrée de l'historique correspond à une seule action de la règle et commence par une étiquette de statut colorée. À côté, en petits caractères, vous voyez le type d'action technique, par exemple pour l'envoi d'un e-mail ou la définition d'un champ.

Voici les statuts possibles :

• Démarrée : l'action a commencé, mais n'est pas encore terminée.
• Terminé : l'action s'est déroulée avec succès.
• Échec : l'action n'a pas pu être exécutée. C'est ici qu'il vaut la peine de consulter le message d'erreur.
• Ignoré : l'action n'a volontairement pas été exécutée, par exemple parce qu'une condition n'était pas remplie.
• À vérifier : l'action nécessite un contrôle manuel avant de poursuivre.

Vous voyez ainsi d'un coup d'œil si une règle fonctionne correctement ou si elle reste bloquée sur une action précise.

Horodatages et informations complémentaires

Sous le statut, chaque entrée affiche les horodatages de l'exécution. Les deux s'affichent avec la date et l'heure.

• Démarrée à : le moment où l'action a commencé.
• Exécutée à : le moment où l'action s'est terminée.

Si seule une heure de démarrage est présente, l'action est soit encore en cours, soit interrompue en cours de route. Pour certaines entrées, vous voyez en plus le repère Canonique. Il désigne l'exécution de référence lorsque la même action a été déclenchée plusieurs fois. Vous savez ainsi quelle entrée compte réellement et lesquelles ne sont que des déclenchements multiples.

Quelle branche a été exécutée

Lorsqu'une règle comporte plusieurs branches (ramifications), chaque exécution indique en plus quelle branche a été empruntée — par exemple « Branche “Événements d'entreprise” choisie ». Si la branche a été supprimée depuis, vous voyez à la place « Une branche supprimée depuis ». Si aucune des branches ne correspondait et qu'il n'y a pas de branche Sinon, rien ne se passe — l'exécution affiche « Aucune branche n'a correspondu et il n'y a pas de branche Sinon — c'est pourquoi rien ne s'est passé. ».

Comprendre les erreurs

Lorsqu'une entrée porte le statut Échec, l'historique affiche directement sous l'entrée un message d'erreur compréhensible, en rouge. Univents traduit la cause technique en un message clair, par exemple « L'envoi d'e-mails n'est pas configuré pour ce workspace. », « L'enregistrement lié est introuvable. », « Cet outil n'est pas inclus dans votre offre. » (pour Exécuter un outil sans l'offre Growth) ou « Statut modifié. Ce changement n'a pas déclenché d'autres automatisations — la chaîne a atteint sa longueur maximale. » (pour Modifier le statut, lorsque des règles se déclencheraient mutuellement trop souvent).

1. Dépliez l'Historique d'exécution de la règle concernée.
2. Repérez l'entrée portant l'étiquette Échec.
3. Lisez le message d'erreur en rouge en dessous. Si Univents ne connaît pas la cause exacte, vous y voyez « Erreur inconnue — voir les détails ci-dessous. » et, en dessous, le message d'erreur technique d'origine s'affiche en plus, en gris.
4. Modifiez l'action concernée de la règle et corrigez la valeur erronée.

Notez le texte exact du message d'erreur avant de modifier quoi que ce soit. Si vous contactez le support Univents, ce texte précis permet de cerner rapidement le problème.

Questions fréquentes

Pourquoi l'historique est-il vide alors que la règle est active ? L'historique ne se remplit que lorsque le déclencheur se produit réellement. Une règle active sans événement correspondant ne génère pas encore d'exécutions. Vérifiez que le déclencheur choisi correspond bien à l'opération attendue.

Que signifie Ignoré ? La règle a été déclenchée, mais une condition enregistrée n'était pas remplie ; l'action a donc été omise. Examinez les conditions de la règle si vous vous attendiez à ce que l'action s'exécute.

Pourquoi la même action apparaît-elle plusieurs fois ? Lorsqu'une opération est déclenchée plusieurs fois, il peut y avoir plusieurs entrées. L'exécution marquée Canonique est celle de référence. Les autres sont des déclenchements secondaires que vous pouvez généralement ignorer lors de la vérification.

Pourquoi ne trouve-je pas « Automatisations » dans le menu ? La page n'est actuellement pas liée dans la navigation de gauche, le temps qu'Univents la déploie progressivement. Vous pouvez tout de même y accéder de façon fiable via l'adresse directe, comme décrit plus haut sous « Ouvrir l'historique d'une règle ».