Plugin permettant de créer un agenda et de déclencher des actions (commande ou scénario).


1. Configuration du plugin

La configuration est très simple, après téléchargement du plugin, il vous suffit de l’activer et c’est tout.

Si vous désactiver le plugin tous les évènements sont definitevement supprimés, il faudra les recreer. Il n’existe aucun moyen de les récuperer. Donc attention à bien faire attention avant désactiver ou supprimer le plugin

2. Configuration des équipements

La configuration des équipements Agenda est accessible à partir du menu plugin puis organisation.

Une fois dessus vous retrouvez ici la liste de vos Agenda.

Vous retrouvez ici toute la configuration de votre équipement :

  • Nom de l’équipement : nom de votre agenda.

  • Objet parent : indique l’objet parent auquel appartient l’équipement.

  • Catégorie : les catégories de l’équipement (il peut appartenir à plusieurs catégories).

  • Activer : permet de rendre votre équipement actif.

  • Visible : le rend visible sur le dashboard.

  • Widget, nombre de jours : définit le nombre de jours d’événements à afficher sur le widget.

  • Nombre d’événements maximum : défini le nombre maximum d’événements à afficher sur le dashboard.

  • Ne pas afficher le statut et les commandes d’activation/désactivation : permet de masquer le statut de l’agenda ainsi que les commandes d’activation ou non de celui-ci.

  • Liste des événements de l’agenda : affichage en dessous de la liste de tous les événements de l’agenda (un clic dessus permet d’éditer l’événement directement).

  • Ajouter événement : permet d’ajouter un événement à l’agenda.

  • Agenda : Affichage d’une vue type agenda avec tous les événements vous pouvez vous déplacer dedans, choisir de l’afficher par semaine ou jour, déplacer des événements (glisser/déposer) et un clic sur un événement vous ouvrira sa fenêtre d’édition.

3. Edition d’un événement

Partie la plus importante du plugin, c’est ici que vous allez pouvoir configurer votre événement.

3.1. Evènement

Ici vous retrouvez :

  • Nom de l’événement : Nom de votre événement.

  • Icône : permet d’ajouter une icône devant le nom de votre équipement (pour ce faire il faut cliquer sur "Choisir une icône").

  • Couleur : permet de choisir la couleur de votre événement (une coche vous permet aussi de le rendre transparent).

  • Couleur du texte : permet de choisir la couleur du texte de votre événement.

  • Ne pas afficher dans le dashboard : permet de ne pas afficher cet événement sur le widget.

3.2. Action de début

Permet de choisir la ou les action(s) à faire lors du lancement de l’événement.

Pour ajouter une action il suffit de cliquer sur le bouton + au bout de la ligne puis vous allez avoir un bouton pour chercher une commande une fois celle-ci trouvé vous aurez le choix des options si elle en a. VOus pouvez ajouter autant d’action que vous le voulez.

Il est possible de modifier l’ordre des actions en maintenant/glissant celle-ci

3.3. Action de fin

Idem à l’action de début mais cette fois si c’est la ou les action(s) à effectuer à la fin de l’événement.

3.4. Programmation

C’est ici que se trouve toute la gestion temporelle de votre événement :

  • Début : Date de début de l’événement.

  • Fin : Date de fin de l’événement.

  • Toute la journée : permet de définir l’événement sur toute la journée.

  • Inclure par un autre agenda : Permet d’inclure un autre événement dans votre événement courant. Par exemple, si vous avez un événement A répété tous les lundis, et que vous incluez cet événement A dans votre événement courant, alors celui-ci sera automatiquement répété tous les lundis.

  • Inclure : permet de forcer une date d’occurence, vous pouvez en mettre plusieurs en les séparant par des , (virgules), vous pouvez aussi définir une plage avec des : (deux points).

  • Répété : permet de dire que votre événement est répété (si cette case n’est pas cochée vous n’aurez pas les options qui suivent).

  • Mode de répétition : permet de spécifier le mode de répétition, soit simple : tous les jours, tous les X jours…​ ou répétition tous les 1er, 2ème…​ pour répéter un événement tous les 3ème lundis du mois par exemple (les options qui suivent peuvent être différentes en fonction de ce choix).

  • Répéter tous les : [mode répétition simple seulement] permet de définir la fréquence de répétition de l’événement (ex tous les 3 jours ou tous les 2 mois…​).

  • Le : [mode répétition le premier, le deuxième…​ seulement] : permet de choisir une répetition tous les 2ème lundis du mois par exemple.

  • Uniquement les : permet de restreindre la répétition à certains jours de la semaine.

  • Restriction : permet de restreindre l’événement seulement les jours fériés ou d’exclure les jours fériés.

  • Jusqu’à : donne la date de fin d’occurence de l’événement.

  • Exclure par un autre agenda : permet de mettre en exclusion cet événement en fonction d’un autre agenda (pour éviter par exemple que 2 événements contradictoires se retrouvent ensemble).

  • Exclure : idem que "Inclure" mais cette fois pour exclure des dates.

Les jours feriés sont ceux Francais et uniquement les Francais cela ne marche donc pas pour les autres pays
En haut à droite vous avez 3 boutons, un pour supprimer, un pour sauvegarder et un pour dupliquer. Lors du clic sur ce dernier jeedom vous affiche l’evenement resultant de la duplication pour que vous puissiez changer le nom par exemple.Il ne faut donc pas oublier de sauvegarder suite à un clic sur le bouton dupliquer

4. Agenda, commandes et scénario

Un agenda possède plusieurs commandes :

  • Activer : permet d’activer l’agenda.

  • Désactiver : permet de désactiver l’agenda.

  • En cours : donne la liste des événements en cours séparés par des virgules, pour l’utiliser dans un scénario le plus simple et d’utiliser l’opérateur contient ( matches ) ou ne contient pas ( not matches ), par exemple [Appartement][test][En cours] matches "/Anniv/", sera vrai si dans la liste des événements en cours il y a un "Anniv"

Il est possible d’utiliser la commande "En cours" comme déclencheur dans un scénario, chaque mise à jour de l’information déclenchera l’éxecution du scénario. Cependant, Il est préférable d’utiliser cette commande dans un scénario programmé avec un test sur la valeur.