# Widgets de contrôle et d'affichage

# Présentation des widgets

Un widget est un élément du tableau de bord qui permet d'interagir avec le système pour :

- piloter les équipements
- visualiser les données issues des capteurs
- accéder aux principales informations de supervision

On distingue deux principaux types de widgets :

- **les widgets de contrôle**   
    graphiques et interactifs, ils permettent d’envoyer des commandes d'actions directement depuis le tableau de bord (par exemple un interrupteur pour allumer et éteindre un appareil).
- **les widgets d’affichage** textuels ou numériques, ils permettent de visualiser des états ou des mesures sans possibilité d'interaction

Selon le type de widget, différentes fonctionnalités peuvent être disponibles :

- affichage d’état,
- commande manuelle,
- variation,
- visualisation de mesures,
- retour d’information,
- pilotage d’équipements

### 1- Widgets de contrôle

- Interrupteur : permet de commander une sortie en ON/OFF.  
    *exemple : éclairage, relais*
- Variateur : permet d’ajuster une valeur sur une plage définie  
    *exemple : variation d’intensité lumineuse, consigne*
- <span style="color: rgb(34, 34, 34);">Variateur d’ouvrant : p</span>ermet de piloter la position d’un ouvrant (volet, BSO…)  
    *exemple : ouverture partielle, fermeture complète*
- <span style="color: rgb(34, 34, 34);">Switch à glissière : p</span>ermet de basculer entre plusieurs états  
    *exemple : auto / manuel / arrêt*

### 2- Widgets d'affichage

- <span role="text">Capteur (affichage de valeur) : a</span>ffiche une mesure issue d’un capteur  
    *exemple : température, humidité, niveau*
- Voyant d’état : indique l’état d’une variable  
    *exemple : marche/arrêt, défaut, alarme*

### <span role="text">3- Widgets avancés</span>

- <span style="color: rgb(34, 34, 34);">Régulation : p</span>ermet de piloter automatiquement un équipement en fonction d’une consigne et d’une mesure  
    *exemple : régulation de température, gestion de ventilation*

# Accès et gestion des widgets

Selon le rôle attribué à l’utilisateur, certains widgets peuvent être accessibles en consultation uniquement ou ne pas être disponibles.

L’accès à la gestion des widgets s’effectue :

- depuis le bouton **« Gérer les widgets »** de la page d’accueil du tableau de bord,
- ou via le menu de navigation **« Widgets »**

<p class="callout info">L’accès, la création et la modification ou la suppression des widgets dépendent des droits attribués à l’utilisateur ainsi que de son rôle</p>

# Widgets préconfigurés

Les widgets préconfigurés sont fournis par défaut avec le système afin de faciliter la mise en service et l’exploitation de l’installation. Ils permettent d’afficher et de piloter rapidement les principales fonctions du module sans nécessiter de configuration avancée.  
Ils apparaissent sur la page d’accueil du tableau de bord ou bien depuis le menu Widget.

Les widgets préconfigurés peuvent être utilisés tels quels ou adaptés selon les besoins de l’installation et les autorisations accordées à l’utilisateur.

#### 4.1- Widgets disponibles

Les widgets peuvent être de différents types :

- **Interrupteur** : permet de contrôler un appareil (allumer / éteindre)
- **Variable** : affiche une valeur numérique ou état logique (température, niveau, pourcentage ...)
- **Capteur** : permet de visualiser les données provenant directement des capteurs connectés au module

Deux widgets préconfigurés sont disponibles par défaut :

- un widget de type **switch ON/OFF** permettant le pilotage d’une sortie bistable
- un widget de type **bouton** permettant l’envoi d’une commande impulsionnelle

Ces widgets permettent une mise en service rapide des fonctions de commande principales sans configuration supplémentaire.

L’accès, la création et la modification des widgets dépendent des droits attribués à l’utilisateur ainsi que de son rôle.

# Création de widget

<p class="callout warning">La création de widgets est réservée aux utilisateurs disposant des droits appropriés (Super administrateur ou Installateur)</p>

1. 1. Accédez au tableau de bord ou aller dans le menu "*Widget*"
    2. Cliquez sur"**gérer les widgets**"
    3. Cliquer sur "**ajouter un nouveau widget**" et configurez les paramètres du widget :  
        \- le nom et le type de widget  
        \- le choix de la variable d'entrée  
        \- l'emplacement et le choix de l'icone   
        \- le lien avec un scénario ...

Le widget est alors ajouté au tableau de bord.

<p class="callout success"><span style="text-decoration: underline;">Bonnes pratiques</span> :  
- Limiter le nombre de widgets afin de conserver une interface lisible  
- Donner un nom explicite à chaque widget  
- Réserver les widgets techniques aux utilisateurs expérimentés  
- Vérifier régulièrement les widgets d’état et de connectivité  
</p>