Un scénario peut écrire dans un fichier journal afin de vous aider à garder une trace de ce qui s'est passé.
Je vous présente ici quelques techniques pour y parvenir.
La façon la plus facile pour ajouter du texte dans un fichier journal est par une action de type Log.
Ceci écrira dans le log d'exécution du scénario.
La chaîne est au format #[Objet][Equipement][Commande]#, par exemple #[Cuisine][Capteur Zooz 4-en-1][Luminosité]#.
Pour voir le fichier journal du scénario, vous devez cliquer sur l'icône dans le haut de la fenêtre d'édition du scénario.
Et voilà le résultat :
Un bloc de code est un endroit où il est possible d'ajouter des lignes de code PHP qui seront exécutées lorsque le scénario sera lancé.
Le bloc de code offre plus de possibilités pour écrire dans les fichiers journaux.
Dans le scénario, le bloc de code s'ajoute en choisissant sous .
C'est dans ce bloc de code qu'il est possible d'ajouter une instruction qui écrira dans un fichier journal.
Tout comme les actions de type Log, la méthode $scenario->setLog() permet d'écrire dans le log d'exécution du scénario.
$scenario->setLog('Mon message');
N'oubliez pas le point-virgule à la fin de l'instruction. Après tout, c'est du PHP!
La méthode log::add() vous permet d'écrire dans un fichier journal de votre choix et de spécifier le niveau de gravité du message.
Si le fichier journal n'existe pas, Jeedom le créera automatiquement avant d'y inscrire votre message. Si le fichier journal existe, votre message sera ajouté à la suite des autres messages de ce fichier.
log::add('nom_du_fichier_journal', 'niveau_de_log', 'message');
Les paramètres de cette méthode vont comme suit :
Souvent, on utilisera le fichier nommé alertes pour enregistrer le message dans le log des alertes.
Attention : selon les configurations du niveau de log, seuls les messages d'un certain niveau seront enregistrés.
N'oubliez pas le point-virgule à la fin de l'instruction!
log::add('alertes', 'ALERT', 'Mon message');
Voici un exemple de scénario qui illustre les différentes façons d'écrire dans un fichier journal.
Il est possible d'enregistrer un message qui contient des valeurs retrouvées automatiquement par Jeedom.
Pour en savoir plus : « Scénario qui inscrit dans un fichier journal une valeur retrouvée automatiquement (Vous ne possédez pas les droits pour accéder à cette fiche.) ».
▼Publicité
