Créer un scénario personnalisé***

Pour créer ou modifier des scénarios, il est recommandé d’utiliser un ordinateur.
L’édition sur téléphone peut entraîner des problèmes d’affichage ou une visibilité limitée des paramètres avancés

1- Généralités

Les scénarios personnalisés permettent d'adapter le fonctionnement du module à des besoins spécifiques qui ne sont pas couverts par les scénarios préconfigurés ou les scénarios modèles.
Ils offrent une grande souplesse pour automatiser des actions en fonction d'événements, de mesures, d'états ou de conditions définies par l'utilisateur.

Prérequis pour la création d'un scénario personnalisé :
- Disposer des droits d'accès nécessaires
- Définir toutes les variables associées
- Insérer et connecter les blocs fonctionnels (test, compteurs, sorties, régulation, utilitaires ...)
- Vérifier que le scénario forme une boucle fonctionnelle complète

1. Préparer un scénario

Pour créer un scénario personnalisé, il n'est pas nécessaire de partir de zéro. Un scénario préconfiguré ou un scénario modèle importé peut servir de base de travail. Il suffit alors de modifier les paramètres, les conditions ou les actions existantes afin d'adapter le fonctionnement aux besoins spécifiques de l'installation. Cette méthode facilite la prise en main et accélère la création de nouveaux scénarios.

Depuis l'accueil, ouvrez un scénario ~~existant~~préconfiguré ou ~~créez-en~~bien importez un ~~nouveau~~scénario modèle
Assurez-vous que les objets nécessaires sont déjà configurés dans la section Objet
Vérifiez que les variables associées sont publiées pour le scénario

2. Construire le flux

Créez la logique de votre scénario en utilisant les blocs disponibles dans la barre latérale :

Glissez-déposez les blocs pour construire votre logique
Reliez les blocs en respectant les limites de connexion propres à chacun
Utilisez des blocs de test pour créer des conditions et des embranchements clairs
Ajoutez des commentaires dans les champs prévus afin de faciliter la maintenance et la compréhension du scénario

Décrire ici :

Structure d'un scénario

Présenter les éléments qui composent un scénario :

Déclencheurs

Les déclencheurs déterminent quand le scénario est exécuté.

Exemples :

Changement d'état d'une entrée.
Valeur d'une mesure.
Horaire ou calendrier.
Modification d'une variable.

Conditions

Les conditions permettent de vérifier qu'un ou plusieurs critères sont respectés avant l'exécution des actions.

Exemples :

Température supérieure à une valeur définie.
Sortie actuellement inactive.
Plage horaire spécifique.

Actions

Les actions définissent les opérations à exécuter lorsque les conditions sont remplies.

Exemples :

Activer une sortie.
Désactiver une sortie.
Modifier une variable.
Envoyer une notification.

Utilisation des blocs de fonction

Les blocs de fonction permettent de construire la logique du scénario en associant différentes fonctions.

1.2- Programmation par boucles

Chaque scénario doit former une boucle fonctionnelle complète :
entrée → test / logique → sortie / action → mise à jour variable d’état

Il est impératif de refermer la boucle fonctionnelle : toute commande générée par un bloc de sortie doit avoir un impact sur un état ou une variable réutilisable par un bloc d’entrée, garantissant ainsi un fonctionnement cohérent du scénario.
Un scénario est structuré sous forme de boucles logiques :

Entrée dans une boucle
Tests (servant de déclencheurs)
Tests de conditions
Actions
Retour
- dans la même boucle
- dans une autre boucle

1.3- Tests

Les tests remplacent la notion de "trigger"
Les tests peuvent porter sur :

variables locales,
variables distantes (autres modules),
états d’entrées
états de sorties

1.4- Actions

Les actions possibles incluent notamment :

l'écriture de variables
la commande de sorties
la modification d’états utilisateurs
l'envoi d’email
l'envoi de SMS

Avant de commencer un scénario, assurez-vous que :
- les objets nécessaires sont correctement configurés dans la section « Objets »
- les variables associées sont bien publiées et disponibles pour le scénario

Pour construire un scénario, attrapez les blocs disponibles dans le bandeau latéral, puis faites-les glisser vers l’espace de travail dédié afin de les déposer et les organiser selon la logique souhaitée.

Vous pouvez ensuite les positionner et les relier entre eux pour définir le fonctionnement du scénario.

1. Préparer un scénario

Depuis l'accueil, ouvrez un scénario existant ou créez-en un nouveau
Assurez-vous que les objets nécessaires sont déjà configurés dans la section Objet
Vérifiez que les variables associées sont publiées pour le scénario

2. Construire le flux

Créez la logique de votre scénario en utilisant les blocs disponibles dans la barre latérale :

Glissez-déposez les blocs pour construire votre logique
Reliez les blocs en respectant les limites de connexion propres à chacun
Utilisez des blocs de test pour créer des conditions et des embranchements clairs
Ajoutez des commentaires dans les champs prévus afin de faciliter la maintenance et la compréhension du scénario

3. Enregistrer et déployer

Une fois le scénario configuré :

Sauvegardez le scénario depuis la barre latérale afin de générer la version compilée
Redémarrez le module pour synchroniser les scénarios et appliquer les modifications
Testez le comportement via les widgets ou les entrées physiques reliées

Un redémarrage du module est nécessaire pour appliquer un nouveau scénario

4. Bonnes pratiques

Renommez les blocs avec des noms explicites pour accélérer les revues
Utilisez les scénarios de test pour valider les flux avant mise en production
Gardez un scénario de réserve pour les actions critiques afin d'éviter l'indisponibilité

3- Créer un scénario personnalisé ???

L’utilisateur définit toutes les variables, blocs et connexions.
Nécessite de :
- Définir les variables
- Insérer et connecter les blocs fonctionnels (tests, compteurs, régulation, utilitaires, sorties)
- Vérifier que le scénario forme une boucle complète pour garantir son fonctionnement

Cliquer sur "Nouveau scénario" dans le bandeau latéral à la droite de l'écran

3.1- Sauvegarder un scénario

Depuis un serveur distant
Bibliothèque de scénarios disponible depuis le serveur de ModLink.
Il faudra adapter et personnaliser les paramètres à la configuration de l'installation.
En local depuis l'ordinateur utilisé

La barre d’icônes de visualisation affichée sur la droite de l'écran permet de :
- agrandir la vue
- réduire la vue
- recentrer l’affichage sur la zone des blocs scénario
- verrouiller et déverrouiller les blocs
- réinitialiser l'édition de blocs

2. Accéder au menu "scénario"

Sélectionnez le menu « Scénarios » dans la barre de menus située en haut de l'interface.
Dans le bandeau de gauche, cliquez sur « Nouveau scénario », puis sur « Éditer » pour commencer.

2.1- Sélectionner le type de bloc

Dans la barre latérale, repérez les blocs qui correspondent aux actions que vous voulez effectuer :

Insérer un bloc "Test d’entrée"

Ces blocs permettent de vérifier l'état d'une entrée (par exemple un capteur, un interrupteur, un bouton ...).
Ils agissent alors comme un filtre dans votre scénario. Tout ce qui suit ne se déclenche que si la condition définie est remplie.
Choisissez parmi :

un appui (simple, double, long…),
un test d’état,
un test de changement d’état ...

Ajouter un bloc de condition "Test variables"

Les blocs de conditions permettent de vérifier des états et de contrôler la logique du scénario avant d’exécuter une action.

Types de blocs de test de variables :

Test variable simple : vérifie la valeur actuelle d’une variable,
Test changement de variable : détecte si une variable a changé depuis la dernière lecture,
Test variable égale : compare la valeur d’une variable à une valeur précise

Pour chaque bloc de condition :

Sélectionnez le type de test adapté,
Renseignez les paramètres nécessaires (variable à tester, valeur cible, etc.),
Donnez un nom et un descriptif au bloc,
Reliez-le aux blocs précédents via les points de connexion (ronds rouges).

💡 Astuce : Les blocs de conditions peuvent avoir plusieurs sorties pour gérer différents chemins selon le résultat du test.

Ajouter un bloc de sortie "Contact sortie"

Les blocs de sortie définissent l’action finale ou le résultat du scénario.

Types de sortie disponibles :

On / Off / Flip : activation, désactivation ou inversion de l’état d’un module,
Impulsion cyclique : envoie des impulsions répétées selon un intervalle défini,
On / Off après temporisation : déclenche une action avec délai,
BSO : contrôle des brise-soleil orientables,
Ouvrant : commande d’ouverture ou de fermeture d’un ouvrant (volet, porte, fenêtre)

Pour chaque bloc de sortie :

Sélectionnez le type de sortie,
Renseignez les paramètres spécifiques,
Donnez un nom et un descriptif,
Reliez-le aux blocs précédents via les points de connexion (ronds rouges).

💡 Astuce : Plusieurs blocs de sortie peuvent être utilisés pour des actions différentes selon les conditions

Ajouter des blocs d’action sur les variables

Ces blocs permettent de modifier ou de suivre des variables dans votre scénario.

Types de blocs d’action sur les variables :

Action variable : modifier la valeur d’une variable,
Incrémenter un compteur : augmenter la valeur d’une variable compteur,
Décrémenter un compteur : diminuer la valeur d’une variable compteur.

Pour chaque bloc d’action :

Sélectionnez le type d’action,
Renseignez la variable concernée et la valeur ou l’incrément/décrément,
Donnez un nom et un descriptif,
Reliez-le aux blocs précédents via les points de connexion (ronds rouges).

Ajouter des blocs de régulation du chauffage

Ces blocs permettent de piloter et réguler le chauffage dans un scénario.

Types de blocs de régulation :

Régulation température consigne : ajuste la température cible d’une zone,
Mode chauffage / arrêt : active ou désactive le chauffage,
Mode confort / éco / hors gel : sélectionne un programme prédéfini selon les besoins,
Pilotage via capteur : ajuste le chauffage en fonction de la température mesurée, de l’occupation ou d’autres variables.

Pour chaque bloc de régulation :

Sélectionnez le type de régulation,
Renseignez les paramètres nécessaires (zone, consigne, capteur),
Donnez un nom et un descriptif,
Reliez-le aux blocs précédents via les points de connexion (ronds rouges).

2.2- Insérer et organiser

- attrapez les différents blocs depuis le bandeau latéral
- faites-les glisser vers l’espace de travail dédié et placez-les à l’endroit souhaité

2.3- Configurer les blocs

Renseignez les paramètres suivants :
- Nom du bloc (
- Descriptif
- Choix de l'entrée / sortie à tester
- Module associé
- Scénario
- Définissez la condition : par exemple ON, OFF, ou autre état spécifique selon votre matériel
- Condition par défaut si tout est faux

2.4- Effectuer les connexions

- reliez les blocs entre eux pour définir la logique de fonctionnement du scénario, identifier les points de connexion
(ronds de couleur) - chaque bloc possède des entrées et des sorties
- Relier les blocs entre eux
Cliquez sur la sortie d’un bloc et faites glisser vers l’entrée du bloc suivant.
Reliez la sortie du bloc aux actions à exécuter si la condition est vraie et éventuellement à une autre sortie si la
condition est fausse
- Vérifier la logique
Assurez-vous que le flux respecte la séquence souhaitée et que tous les blocs nécessaires sont connectés

2.5- Tester le scénario

Une fois les connexions effectuées, lancez une simulation ou un test pour vérifier que le scénario fonctionne correctement (un redémarrage du module est nécessaire)

Disposez les blocs de manière ordonnée pour que le flux reste clair et lisible
cela facilitera la compréhension et la maintenance du scénario

8. Ajouter des sauts

Les blocs de saut permettent de rediriger le flux du scénario vers un autre bloc, sans exécuter la séquence linéaire.

Placez le bloc exactement à l’endroit où vous souhaitez insérer le "saut",
Reliez-le au bloc de départ via les ronds rouges,
Vérifiez que le saut ne crée pas de boucle infinie

9. Construire la logique du scénario

Faites glisser les blocs de fonctions depuis la barre latérale gauche pour compléter votre scénario,
Renseignez les paramètres de chaque bloc,
Reliez tous les blocs entre eux via les points de connexion (ronds rouges),
Vérifiez que la logique est cohérente et complète

10. Finaliser et tester

Vérifiez tous les paramètres et liaisons,
Sauvegardez votre scénario pour qu’il soit actif,
Testez-le pour vous assurer que le fonctionnement correspond à vos attentes