Débogage

Écrit une ligne horodatée au passage de l'appel, lisible sept jours dans le journal du plan. Il n'interrompt jamais l'appel, même si l'écriture échoue.

En bref

Le texte d'aide affiché dans la fenêtre est : « Écrit une ligne horodatée dans le journal de débogage, consultable pendant 7 jours depuis la liste des plans de numérotation. Utilisez {{variable}} pour afficher la valeur d'une variable. N'interrompt jamais l'appel. »

Comment ça marche

C'est l'outil qui répond à « mais pourquoi cet appel ne fait-il pas ce que j'attends ». Posez-le là où vous doutez, appelez, lisez la trace.

Au passage de l'appel, le module écrit une ligne : la date et l'heure, le numéro de l'appelant, et votre message. Puis l'appel continue, sans délai perceptible et sans qu'aucune annonce soit jouée. Même une écriture impossible ne l'interrompt pas.

Le message accepte les {{variables}}, remplacées au moment de l'écriture. C'est là tout l'intérêt : au lieu de constater qu'une branche a été prise, vous lisez avec quelles valeurs elle l'a été. Un message qui n'en contient aucune reste utile comme repère de passage.

La lecture se fait sur Plans de numérotation, par l'icône bloc-notes de la ligne du plan. La page Journal de débogage de ce guide décrit cet écran : le regroupement par appel, le bouton Actualiser, et le fuseau horaire d'affichage.

Les trois limites à connaître

• Un message est retenu sur 500 caractères. Au-delà il est coupé, sans avertissement.
• L'installation entière peut écrire 500 lignes par jour. Au plafond, une dernière ligne annonce que le journal est tronqué, et plus rien n'est écrit jusqu'au lendemain. Ce plafond vaut pour tous vos plans réunis, pas pour un seul.
• Les lignes sont conservées 7 jours, puis supprimées.

Ce qu'il faut saisir

La marche à suivre

1. Ouvrez l'éditeur du plan à observer.
2. Posez le module Débogage sur la branche dont vous doutez, et reliez-le en série : l'entrée vient du nœud précédent, la sortie repart vers la suite.
3. Ouvrez-le et écrivez le Message. Nommez la branche plutôt que l'évidence : branche du soir vous dira plus que ici.
4. Ajoutez les variables utiles, copiées depuis le panneau Variables disponibles, par exemple saisie={{saisie}} nom={{odoo_partner_name}}.
5. Cliquez sur Sauver.
6. Vérifiez que la sortie du module est bien reliée à la suite du plan.
7. Cliquez sur Appliquer les modifications dans le bandeau du haut.
8. Appelez votre numéro en empruntant la branche observée.
9. Revenez sur Plans de numérotation, cliquez sur l'icône bloc-notes de la ligne du plan, et lisez les lignes. Actualiser relit le journal après un nouvel appel.

Si ça ne marche pas

Aucune ligne n'apparaît dans le journal. Quatre vérifications, dans l'ordre : le Message n'est pas vide, car un message vide n'écrit rien ; le module est relié dans le plan et pas seulement posé à côté ; le plan a été enregistré et appliqué depuis ; un appel a bien emprunté cette branche.

Mon message est coupé au milieu. Un message est retenu sur 500 caractères. Découpez-le en deux modules si vous avez besoin de plus.

Une ligne annonce que le journal est tronqué. Le plafond de 500 lignes pour la journée est atteint, et plus rien ne sera écrit avant demain. Retirez les Débogage qui écrivent à chaque appel et ne gardez que ceux du diagnostic en cours.

Les lignes d'il y a dix jours ont disparu. La conservation est de sept jours. C'est volontaire, et il n'y a pas de réglage.

L'appel se coupe juste après le module. Ce n'est pas le Débogage : il n'interrompt jamais l'appel. C'est sa sortie unique qui n'est reliée à rien. Reliez-la à la suite du plan.