Widgets

• Présentation
• Gestion des widgets
• Widgets préconfigurés

Présentation

Un widget est un élément du tableau de bord qui permet d'interagir avec le système pour lire ou modifier une variable.

On distingue deux types de widgets :

• les widgets d'action
  ils permettent d’envoyer des commandes d'action directement depuis le tableau de bord (par exemple un interrupteur pour allumer et éteindre un appareil).
  
  
• les widgets d'états
  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 d'action

• 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
• Variateur d’ouvrant : permet de piloter la position d’un ouvrant (volet, BSO…)
  exemple : ouverture partielle, fermeture complète
• Switch à glissière : permet de basculer entre plusieurs états
  exemple : auto / manuel / arrêt

2- Widgets d'états

• Capteur (affichage de valeur) : affiche 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

3- Widgets avancés

• Régulation : permet 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 direct en mode application sur Smartphone  
Permet un accès rapide aux widgets pour piloter les équipements et consulter leur état.
L’utilisateur peut rester connecté afin d’accéder aux widgets sans avoir à s’authentifier à chaque utilisation.

Gestion des widgets

Les widgets sont administrés depuis la page d'accueil du tableau de bord en cliquant le bouton Gérer les widgets, ou directement depuis le menu "Widgets". 
Ce gestionnaire permet d'ajouter, de modifier, de réorganiser et de supprimer les widgets.

1- Créer un widget

La création de widgets est réservée aux utilisateurs disposant des droits appropriés

1. 1. Apuyez sur  + Ajouter un widget
      

   2. Une nouvelle fenêtre s'ouvre, configurez les paramètres du widget :

      • Nom du widget ;
      • Variable d'entrée associée ;
      • Scénario à associer (si applicable) ;
      • Type de widget.

      Les autres champs sont facultatifs et permettent de personnaliser l'affichage du widget, notamment :

      • son emplacement ;
      • son icône ;
      • l'unité de la valeur affichée

Le nouveau widget est alors ajouté au tableau de bord.

Bonnes pratiques :
- 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
- Consultez régulièrement les widgets d'état pour contrôler le bon fonctionnement du système et détecter rapidement toute anomalie 

1.1- Modifier ou supprimer un widget

Une fois le widget créé, vous pouvez à tout moment le modifier ou le supprimer 

• • Pour modifier un widget, cliquez sur l'icône Modifier, apportez les modifications souhaitées, puis enregistrez-les
•  
  • Si vous n'avez plus besoin d'un widget, cliquez sur l'icône Supprimer, puis confirmez l'opération
    Le widget est alors retiré du gestionnaire et ne sera plus affiché sur le tableau de bord

2- Configurer les mappages d'état et d'action

Le mappage d'état permet de personnaliser l'affichage des widgets d'état en associant à chaque valeur d'une variable une icône, une couleur et un libellé.
Il permet ainsi de représenter visuellement les différents états de la variable de manière adaptée à votre application

Le mappage d'action permet d'associer chaque valeur lue à la commande de sortie à exécuter.
Le libellé décrit l'action qui sera envoyée lorsque cette valeur est sélectionnée ou reçue

• Pour définir le mappage, cliquez sur l’icône Réglages du widget
  Une fenêtre de configuration s’ouvre

• Pour ajouter une correspondance, cliquez sur Ajouter un état / Ajouter un mappage (selon le type de widget)

• Cliquez sur chaque état / action nouvellement créé pour saisir les paramètres de configuration

• Paramétrez un affichage visuel pour chaque état configuré
  • Icône : symbole affiché dans le widget ;
  • Couleur : couleur associée à cet état ;
  • Libellé : texte affiché pour identifier l’état
• Paramétrez un libellé personnalisé pour chaque action configurée

Le mappage est prioritaire sur la configuration générale des états. 
Lorsqu’un état possède un mappage personnalisé, ses paramètres d’affichage remplacent ceux définis dans la configuration des états

3- Outils de gestion des widgets

Dépliez le widget pour afficher l'ensemble des informations, notamment tous les états associés
Plusieurs fonctions facilitent également l'administration des widgets.
Vous pouvez rechercher un widget, le filtrer selon son type, réorganiser son affichage, l'exporter ou l'importer afin de simplifier sa gestion et son déploiement.

• Rechercher un widget
  Permet de retrouver rapidement un widget en saisissant tout ou partie de son nom dans le champ de recherche
• Filtrer les widgets
  Permet d'afficher uniquement les widgets d'un type donné (interrupteur, interrupteur à glissière, bouton, widget d'état, etc.) afin de faciliter leur gestion
• Réorganiser les widgets
  Permet de modifier l'ordre d'affichage des widgets dans le gestionnaire ou sur le tableau de bord
• Exporter des widgets
  Permet d'exporter un ou plusieurs widgets afin de les sauvegarder ou de les réutiliser sur une autre installation
• Importer des widgets
  Permet d'importer des widgets afin de les intégrer rapidement dans une nouvelle configuration

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.

1- Widgets disponibles

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.