Dépannage du moteur de règles

Résolvez les erreurs de règles dans Kilo IoT — nœuds manquants, CEL invalide, attachement de limite, limites de déploiement.

Cette page couvre les problèmes les plus courants que vous rencontrerez lors de la création, du déploiement et de la gestion des règles d’automatisation : erreurs de validation à la génération, problèmes d’exécution et limites de la plateforme.

Erreurs de génération

Lorsque vous cliquez sur Enregistrer et générer dans la barre latérale des résultats de génération, la plateforme valide le diagramme entier avant de produire un artefact. Si la validation échoue, des messages d’erreur apparaissent dans la barre latérale. Voici les erreurs que vous pouvez voir, leur cause et comment les corriger.

Erreur	Cause	Correction
Événement de début manquant	Le diagramme ne contient aucun nœud Événement de début	Faites glisser un Événement de début depuis la palette sur le canevas. Chaque règle doit commencer par exactement un seul Événement de début.
Événement de fin manquant	Le diagramme ne contient aucun nœud Événement de fin	Ajoutez au moins un Événement de fin. Chaque chemin d’exécution doit se terminer par un Événement de fin.
Plusieurs événements de début	Plus d’un Événement de début existe sur le canevas	Supprimez les événements de début supplémentaires. Une règle ne peut avoir qu’un seul point d’entrée.
Aucun flux sortant	Un nœud n’a aucune flèche sortante (et ce n’est pas un Événement de fin)	Reliez le nœud à l’étape suivante du workflow. Chaque nœud non terminal a besoin d’un flux sortant.
Événement de début sans flux sortant	L’Événement de début n’est connecté à aucun nœud	Dessinez un flux de séquence de l’Événement de début vers le premier nœud de traitement de votre règle.
Condition manquante	Une branche de passerelle exclusive n’a aucune expression de condition CEL assignée	Ouvrez les propriétés de la passerelle et ajoutez une expression CEL à chaque branche non par défaut. Une branche doit être marquée comme par défaut (aucune condition n’est requise pour la branche par défaut).
Expression invalide	Une expression CEL contient une erreur de syntaxe	Vérifiez l’expression pour des parenthèses non appariées, des guillemets manquants autour des chaînes ou des opérateurs incorrects. Voir Référence CEL pour la syntaxe valide.
La condition doit renvoyer un booléen	Une expression de condition de passerelle renvoie une valeur non booléenne	Les conditions de passerelle doivent évaluer à vrai ou faux. Utilisez des opérateurs de comparaison (>, <, ==, !=, >=, <=) ou des opérateurs logiques (&&, ||, !).
Événement d’erreur frontière non rattaché	Un événement d’erreur frontière existe sur le canevas mais n’est pas rattaché à un nœud de tâche	Faites glisser l’événement d’erreur frontière sur une tâche de script, un nœud Définir une alarme ou un nœud d’enrichissement. Il doit être visuellement attaché au bord d’une tâche.
Cible sortante de l’événement frontière	Le flux sortant d’un événement d’erreur frontière pointe vers autre chose qu’une tâche ou un Événement de fin	Redirigez le chemin d’erreur vers une tâche (l’étape de gestion) ou vers un Événement de fin.
La branche par défaut ne doit pas avoir de condition	Le flux marqué comme défaut pour la passerelle porte encore une condition CEL	Effacez la condition du flux par défaut. Le flux par défaut s’exécute précisément lorsque rien d’autre ne correspond, il n’a donc pas sa propre expression.
La passerelle doit se scinder ou fusionner	Une passerelle exclusive a exactement un flux entrant et un flux sortant	Une passerelle doit soit prendre une décision (deux flux sortants ou plus), soit réunir des chemins (deux flux entrants ou plus). Une passerelle de passage ne fait rien — supprimez-la et reliez directement les nœuds.
Identifiant d’élément en double	Deux éléments sur le canevas partagent le même identifiant	Généralement le résultat de l’importation ou d’une modification externe d’un diagramme. Supprimez puis rajoutez l’un des deux éléments.
Paramètre d’entrée ou de sortie non pris en charge	Le paramètre d’entrée ou de sortie d’un nœud n’est pas une expression CEL	Les entrées et sorties n’acceptent que des expressions CEL. Saisissez à nouveau le paramètre dans le panneau des propriétés.
Paramètre Exécuter une commande invalide	Un nœud Exécuter une commande a un paramètre sans nom, sans valeur ou avec un nom utilisé deux fois	Ouvrez le panneau des propriétés du nœud et donnez à chaque paramètre un nom unique ainsi qu’une valeur ou une expression.
Type d’élément inconnu	Un nœud non reconnu existe sur le canevas	Supprimez l’élément inconnu et remplacez-le par un type de nœud pris en charge depuis la palette. Cela peut se produire si un diagramme a été importé ou modifié en externe.

Résolution des erreurs de génération

1. Lisez le message d’erreur dans la barre latérale des résultats de génération : il identifie le problème et souvent le nœud précis.

2. Fermez la barre latérale et corrigez le problème sur le canevas.

3. Cliquez sur Générer à nouveau pour revérifier.

Plusieurs erreurs peuvent apparaître simultanément. Corrigez-les toutes avant de relancer la génération.

Problèmes courants

"J’ai créé un déclencheur, mais rien ne se passe"

Un déclencheur enregistré ne surveille que sa condition. Il ne contient ni alarme, ni commande, ni autre réponse, et il n’est pas attaché automatiquement à une règle.

Que faire :

1. Retournez à l’onglet Règles et créez ou modifiez la règle qui doit réagir.

2. Sélectionnez l’Événement de début, cliquez sur son crayon, et définissez Source de départ sur Condition du déclencheur.

3. Sélectionnez le déclencheur enregistré et cliquez sur Enregistrer en bas du panneau de l’Événement de début.

4. Ajoutez les nœuds de réponse, puis enregistrez la règle depuis la barre d’outils de l’éditeur.

5. Générez la règle et déployez son artefact depuis l’onglet Artefacts .

Voir D’un déclencheur à une règle en cours d’exécution pour le workflow complet.

"Mon déclencheur est absent de l’Événement de début"

Le Condition du déclencheur champ apparaît uniquement après que vous avez modifié le Source de départ de l’Événement de début Lecture de capteur sur Condition du déclencheur. Il répertorie les déclencheurs enregistrés pour l’organisation actuelle et ne charge actuellement que la première page des résultats.

Que faire :

• Vérifiez que le déclencheur a été créé dans la même organisation que la règle.

• Vérifiez que Condition du déclencheur est sélectionné comme source de départ.

• Si le déclencheur existe mais se trouve au-delà de la première page, il ne peut pas encore être sélectionné dans ce champ.

"La règle est verrouillée et je ne peux pas la modifier"

Un autre membre de l’équipe modifie actuellement la règle. L’icône de verrou sur la ligne de la règle indique qui détient le verrou et quand il expire.

Que faire :

• Attendez l’expiration du verrou. La date d’expiration du verrou est affichée dans l’interface dans l’infobulle du verrou.

• Contactez la personne qui détient le verrou et demandez-lui d’enregistrer puis de quitter.

• Si le détenteur du verrou n’est pas disponible et que vous êtes le propriétaire de l’organisation, vous pouvez forcer le déverrouillage de la règle depuis la liste des Règles. Voir Modifier les verrous et les passations d’équipe pour plus de détails.

"La génération a réussi mais la règle ne s’exécute pas"

La génération et le déploiement sont deux étapes distinctes. Une génération réussie crée un artefact, mais l’artefact n’est pas déployé automatiquement.

Que faire :

1. Allez à l’onglet Artefacts de la page du moteur de règles.

2. Trouvez la génération que vous venez de créer.

3. Cliquez sur Déployer pour lancer le traitement de la règle à partir de sa source de capteur ou de déclencheur sélectionnée.

"La règle a été arrêtée de force"

La plateforme surveille la santé de l’exécution. Si une règle rencontre des erreurs persistantes pendant son exécution, elle est automatiquement arrêtée pour éviter des défaillances en cascade. L’artefact affiche le statut Arrêté de force (rouge) dans l’onglet Artefacts.

Que faire :

1. Ouvrez la règle dans l’éditeur et examinez la logique.

2. Vérifiez si les capteurs référencés sont toujours actifs et envoient des données.

3. Vérifiez que toutes les expressions CEL sont valides pour les formes réelles des données produites par vos capteurs.

4. Vérifiez les nœuds d’enrichissement — le capteur cible a peut-être été supprimé ou mis hors ligne.

5. Corrigez le problème, générez un nouvel artefact et déployez-le.

Voir Sécurité d’urgence pour plus de détails.

"L’enrichissement échoue sans cesse"

Le nœud d’enrichissement récupère la dernière lecture d’un autre capteur. Si ce capteur est hors ligne, supprimé ou n’a jamais envoyé de données, l’enrichissement échoue.

Que faire :

• Vérifiez que le capteur cible existe et qu’il envoie activement des données.

• Attachez un Événement d’erreur frontière au nœud d’enrichissement afin que la règle gère l’échec avec souplesse au lieu de s’arrêter complètement. Voir Modèle 4 : enrichissement sécurisé contre les erreurs.

"L’enregistrement automatique a échoué"

Une interruption réseau ou un problème temporaire du serveur a empêché l’enregistrement automatique.

Que faire :

• Une boîte de dialogue apparaît avec deux options : Réessayer (tente d’enregistrer à nouveau) ou Retour à la règle (revient à la liste des Règles sans enregistrer les dernières modifications).

• Essayez Réessayer d’abord. Si l’échec se répète, enregistrez manuellement à l’aide du Enregistrer bouton.

• Si l’enregistrement manuel échoue aussi, vérifiez votre connexion réseau.

"Je ne peux pas restaurer une règle depuis la corbeille"

La règle a peut-être dépassé la période de conservation de la corbeille et été supprimée définitivement.

Que faire :

• Vérifiez l’onglet Corbeille . Si la règle n’est plus listée, elle a été supprimée définitivement et ne peut pas être récupérée.

• Si la règle est toujours dans l’onglet Corbeille mais que la restauration échoue, vérifiez si votre organisation a atteint la limite de règles de son abonnement. Restaurer une règle compte dans le quota de règles actives.

"J’ai accidentellement restauré la mauvaise version"

Restaurer une version ne détruit rien. La restauration crée une nouvelle version courante, et la version précédemment active est conservée dans l’historique.

Que faire :

1. Ouvrez l’onglet Historique .

2. Trouvez la version qui était active avant la restauration accidentelle.

3. Affichez-la (icône en forme d’œil) et cliquez sur Restaurer cette version pour la rendre à nouveau active.

Sessions de débogage

"J’ai démarré une session de débogage et rien ne se passe"

Une session de débogage charge la règle, place l’exécution sur l’Événement de début et attend votre intervention. Elle n’exécute pas la règle toute seule.

Que faire :

1. Regardez en bas du canevas pour la barre d’outils de débogage. Elle flotte au-dessus du diagramme ; elle ne se trouve pas dans la barre d’en-tête à côté de Enregistrer et générer.

2. Appuyez sur Exécuter (F10) pour exécuter jusqu’au premier point d’arrêt ou jusqu’à la fin, ou sur Passer au suivant (F9) pour avancer d’un élément.

3. Vérifiez que la session est active : l’Événement de début a un contour bleu, et le panneau de débogage à droite liste vos variables initiales.

Voir Déboguer les règles.

"Un élément est entouré de rouge"

Un contour rouge marque l’élément qui a déclenché l’erreur la plus récente — ce n’est pas un point d’arrêt (un petit point rouge au-dessus de l’élément) et ce n’est pas la position actuelle (un contour bleu). Commencez par l’expression sur cet élément.

Que faire :

1. Ouvrez les propriétés de l’élément et lisez son expression.

2. Vérifiez que chaque nom qu’elle utilise existe dans l’onglet Variables. Une expression qui lit vars.RH échoue si rien nommé RH n’a été fourni comme contexte initial ou produit par un nœud précédent.

3. Vérifiez l’onglet Le préfixe vars. est présent — RH > 70 n’est pas la même chose que vars.RH > 70.

4. Vérifiez que l’expression renvoie le bon type. Une condition de passerelle doit produire vrai ou faux.

5. Collez l’expression dans Évaluer dans l’onglet Watch pour la tester par rapport à l’état actuel.

"La passerelle n’a pris aucune branche"

Deux causes différentes, avec des correctifs différents.

Une condition n’a pas pu être évaluée. Si une condition sur la passerelle génère une erreur — le plus souvent parce qu’elle référence une variable absente — la passerelle s’arrête avec une erreur et la règle ne va pas plus loin. Elle ne pas retombe sur le flux par défaut. La passerelle sera entourée de rouge ; suivez les étapes ci-dessus.

Aucune condition ne correspondait et il n’y a pas de défaut. Si toutes les conditions ont renvoyé faux et qu’aucun flux n’est marqué comme défaut, l’exécution n’a nulle part où aller. Ouvrez la passerelle, choisissez le flux de repli, et cliquez sur Définir comme défaut.

"Les boutons de débogage sont grisés"

Les contrôles d’étape sont disponibles lorsque la session est en pause. Ils sont désactivés lorsque la règle s’exécute, lorsqu’une boîte de dialogue d’effet secondaire attend une réponse, et après l’échec du chargement d’une règle. Stop reste disponible en permanence.

Si le chargement de la règle a échoué, démarrez une nouvelle session.

"Mes points d’arrêt ont disparu"

Deux causes :

• Vous avez utilisé Exécuter ignorer les points d’arrêt (F11). Cela désactive tous les points d’arrêt et les laisse désactivés pour le reste de la session. Réactivez-les depuis l’onglet Points d’arrêt.

• L’éditeur s’est rechargé. Les points d’arrêt sont liés aux éléments du diagramme chargé. Une notification vous indique combien ont été supprimés afin que vous puissiez les rajouter.

"La session s’est terminée alors que je travaillais encore"

Une session de débogage dure 30 minutes, mesurées à partir de son démarrage. Le fait de parcourir la règle pas à pas ne la prolonge pas. Vous recevez un avertissement peu avant son expiration ; démarrez une nouvelle session pour continuer.

Limites d’abonnement

Chaque formule d’abonnement inclut un nombre maximal de règles d’automatisation actives. Ces limites affectent plusieurs opérations :

• Création de règles : Le Ajouter une règle le bouton de l’onglet Règles est désactivé lorsque votre organisation atteint sa limite de règles. Un message explique que la limite a été atteinte.

- **Restauration depuis la corbeille :** restaurer une règle supprimée compte comme l’ajout d’une règle active. Si vous êtes à la limite, la restauration ne se poursuivra pas. - **Clonage de règles :** cloner crée une nouvelle règle, ce qui compte dans la limite.

Pour vérifier votre utilisation actuelle et les limites de votre formule, rendez-vous dans les paramètres d’abonnement de votre organisation. Pour augmenter la limite, mettez à niveau votre formule ou supprimez les règles dont vous n’avez plus besoin.