Comment tester le code d'une règle de création automatique d'incidents et utiliser l'aide (« Tester le code », « Effacer », « Aide ») (chargeur et prestataire logistique) ?

Pour tester le code d'une règle de création automatique d'incidents (boutons « Tester le code », « Effacer » et « Aide »), utilisez les trois boutons situés au-dessus de l'éditeur « Code de la condition » de la page « Nouvelle règle » ou « Modifier la règle ».

Qui peut le faire : un administrateur du compte (chargeur ou prestataire logistique).

Tester le code sur une commande

Étape 1 : sur la page « Nouvelle règle » ou « Modifier la règle », dans le bloc « 1. Paramétrage des conditions de déclenchement », cliquez sur « Tester le code ». Le panneau « Règle de test » s'ouvre à droite avec le texte « Testez vos règles en sélectionnant l'une de vos commandes. ».

Étape 2 : ouvrez la liste « Choisissez une commande pour démarrer la simulation… » et choisissez une commande par son numéro.

Étape 3 : lisez le résultat sous la commande. Par exemple, pour la règle « Taux de complétion < 90% » testée sur une commande complétée à 100 %, le panneau affiche « Aucun incident ne sera créé ».

Étape 4 : pour essayer une autre commande, choisissez-la dans la liste, ou cliquez sur « Relancer le test » après avoir modifié le code. Le lien « Voir la commande » ouvre la commande choisie dans un nouvel onglet.

Étape 5 : pour fermer le panneau, cliquez sur la double flèche en haut à gauche du panneau.

Ce qui se passe ensuite : le test n'enregistre rien et ne crée aucun incident : il montre seulement ce que la règle ferait avec cette commande. Si la condition est fausse, le panneau affiche « Aucun incident ne sera créé ». Si elle est vraie, il affiche « Un incident sera créé, voici un aperçu » avec la priorité, le statut, le type, la date de création, le commentaire de l'incident et le « Contexte de la commande » (les données de la commande lues par le code). Sans commande choisie, le message « Sélectionnez une commande pour tester la règle. » s'affiche ; si le code renvoie autre chose que vrai ou faux, c'est « La règle doit renvoyer un booléen. ».

Effacer le code

Le bouton « Effacer » remplace tout le code de l'éditeur par un gabarit vide : une fonction evaluate qui renvoie faux, avec un commentaire qui invite à vérifier l'état de la commande puis à renvoyer true pour activer la création d'incidents. Le texte de « Description de la condition » n'est pas modifié.

Utiliser l'aide pour écrire la condition

Étape 1 : cliquez sur « Aide ». La fenêtre « Aide » s'ouvre avec la phrase « Voici une invite LLM qui peut vous aider à écrire une fonction correcte pour implémenter votre condition ».

Étape 2 : lisez l'invite, ou cliquez sur « Copier ». Le message « Contenu copié dans le presse-papier » s'affiche. Collez l'invite dans l'outil d'IA de votre choix en remplaçant « Votre condition ici » par votre condition.

Étape 3 : cliquez sur « Fermer ».

L'invite impose quatre contraintes au code : écrire une seule fonction nommée evaluate qui reçoit la commande, renvoyer une valeur booléenne (true crée un incident, false n'en crée pas), n'utiliser aucun import et ne pas utiliser de code asynchrone ni de boucle infinie. Elle décrit aussi la structure de l'objet commande, qui contient notamment : l'identifiant (id), la référence chargeur (shipper_order_reference), le type (order_type), le statut (status), les dates de création et de mise à jour, le taux de complétion en pourcentage (service_rate_in_percent), les champs personnalisés du compte (custom_fields), l'entrepôt (warehouse), le chargeur (customer), le transporteur (carrier et carrier_id), le statut de transport (transport_status), le numéro de suivi (tracking_number), le commentaire (comment), les dates d'enlèvement et de livraison prévues et effectives (pickup_planned_datetime_range, pickup_effective_execution_date, delivery_planned_datetime_range, delivery_effective_execution_date), les adresses d'enlèvement et de livraison (pickup_address et delivery_address : nom, adresse, code postal, ville, pays, téléphone, e-mail), les commandes liées (linked_orders) et les lignes (order_items : quantités attendues et réelles, référence, lot, SSCC).

Si un message d'erreur s'affiche, par exemple « Il y a des erreurs dans le code, veuillez vérifier », consultez « Messages d'erreur dans les automatisations : que signifient-ils ? (chargeur) » ou « Messages d'erreur dans les automatisations : que signifient-ils ? (prestataire logistique) ».