5.24 Créer un scénario provoqué

Sous Jeedom, les scénarios permettent d'automatiser des comportements, par exemple ouvrir la lumière de la cuisine quand la porte s'ouvre.

Vous devez d'abord ajouter vos appareils connectés à Jeedom et idéalement les associer aux objets qui représentent les pièces de votre maison.

Écriture d'un scénario

Lançons-nous maintenant dans un scénario qui fera allumer la lumière lorsque la porte s'ouvre.

Pour ajouter un scénario :

Rendez-vous dans le menu Outils / Scénarios puis cliquez sur Ajouter.
Donnez un nom au scénario, par exemple « Porte ouverte allume lumière ». Vous verrez alors l'écran de configuration du scénario.
Vous pouvez regrouper les scénarios afin de mieux vous y retrouver.
Certains aiment les regrouper par fonctionnalité (ex : Lumières, Chauffage), d'autres par pièce (ex : Cuisine, Salon) ou encore par appareil (ex : Store, Porte). À vous de décider.

Si le regroupement ne vous intéresse pas pour l'instant, je vous suggère de mettre tous vos scénario dans un groupe nommé « Maison ».
L'information la plus importante dans cet écran, c'est le mode du scénario. C'est là que vous indiquez ce qui va le déclencher.
- Il peut être provoqué, par exemple par l'ouverture d'une porte.
- Il peut être programmé, par exemple tous les jours à 8h00.
- Il peut également être une combinaison des deux, par exemple allumer les lumières dès qu'une présence est détectée (provoqué) OU lorsqu'il est 21h00 (programmé).
  
  Dans le scénario que nous bâtissons, nous allons choisir Provoqué puisque c'est l'ouverture de la porte qui sera le déclencheur.
Un scénario peut être provoqué par un équipement ou encore par un événement.
Les événements sont représentés par des mots-clés, par exemple :
- #start# pour le démarrage de Jeedom
- #begin_backup# pour le début d'une sauvegarde
- #begin_update# pour le début d'une mise à jour
- #user_connect# lorsqu'un usager se connecte à Jeedom
- etc.
Pour préciser quel équipement provoquera le scénario, vous devez cliquez sur le bouton +Déclencheur puis sur l'icône Choisir une commande.
Dans la fenêtre qui apparaît, sélectionnez l'objet auquel le détecteur d'ouverture de porte est associé. Vous pourrez ensuite sélectionner le détecteur puis la commande qui déclenchera l'action. Dans notre cas, ce sera son état.

Vous verrez apparaître une chaîne composée de l'objet, de l'équipement puis de la commande :

#[Maison][Porte 2020-F][Etat]#
Si vous laissez le déclencheur comme cela, le scénario sera déclenché dès que l'état change.
Il est également possible de déclencher le scénario seulement lorsque l'équipement a une valeur précise.

Il faut à ce moment compléter le déclencheur à la main. Pour que le scénario se déclenche seulement lorsque la porte est ouverte :

#[Maison][Porte 2020-F][Etat]# == 1
Pour indiquer ce que le scénario fera, vous devez cliquer sur l'onglet Ajouter bloc dans le haut de l'écran.
Plusieurs types de blocs sont disponibles, par exemple Si/Alors/Sinon, Action, Boucle, Dans, etc. Ici, nous allons choisir Action.
Au bas de la ligne Action, cliquez sur Ajouter puis choisissez Action.
Cliquez sur l'icône Sélectionner la commande.
Indiquez quel équipement sera affecté et quelle commande sera effectuée dessus.

Vous verrez alors la chaîne qui indique ce qui se passera, dans mon cas :

#[Cuisine][Interrupteur lumière][Switch 0 On]#
Si vous désirez que la lumière demeure allumée, votre scénario est complet.
Par contre, si vous désirez, par exemple, qu'elle s'éteigne après 1 minute, cliquez à nouveau sur Ajouter au bas de la ligne Action puis choisissez Bloc Dans.
Ce bloc attend une durée en minutes. Entrez 1.
Ajoutez une action puis indiquez que la lumière doit être fermée : #[Cuisine][Interrupteur lumière][Switch 0 Off]#.
Cliquez finalement sur Sauvegarder.

Tester le scénario

Pour tester le scénario, il est possible de cliquer sur le bouton Exécuter.

Si vous désirez avoir plus d'informations sur ce qui se passe pendant l'exécution, vous pouvez appuyer sur Ctrl+Exécuter sous Windows ou ⌘ Cmd+Exécuter sous Mac.

Ceci enregistrera le scénario, l'exécutera puis affichera le log.

Dans cet impression d'écran, on voit que le scénario a été lancé manuellement, que la condition a été évaluée à Faux (la porte n'était pas ouverte) et que rien d'autre ne s'est produit puisque la condition n'était pas respectée.

Log du scénario

Modifier un scénario existant

Pour modifier un scénario, suivez ces étapes :

Rendez-vous dans Outils / Scénarios.
Sélectionnez le scénario à modifier.
Vous obtiendrez le même écran que lors de la création du scénario. Vous pouvez y modifier les informations de base dans l'écran qui apparaît : Nom du scénario, mode, déclencheur, etc.
Pour modifier les détails du scénario, cliquez sur l'onglet Scénario dans le haut de l'écran.
Vous obtiendrez le même écran que vous avez ajouté un bloc. Vous pouvez y modifier les conditions et actions à exécuter.