# Widgets

# Widgets d'exploitation

Les widgets sont des éléments de l’interface Web du module 2PIO qui permettent aux opérateurs et aux utilisateurs finaux de **piloter les équipements et de visualiser leur état**, directement depuis le tableau de bord.

Associés aux variables du module, ils permettent d’**envoyer des commandes, de consulter des états ou d’afficher des mesures,** sans avoir à accéder directement aux variables ou aux scénarios.

### 1 – Types de widgets

Différents widgets sont disponibles selon les besoins de l’installation :

- **Interrupteur** : commande marche/arrêt d’un équipement
- **Switch à glissière** : sélection entre plusieurs états ou modes de fonctionnement
- **Variateur** : réglage d’une valeur sur une plage définie
- **Variateur d’ouvrant** : commande de la position d’un ouvrant (volet, brise-soleil orientable…)
- **Capteur** : affichage d’une mesure ou d’une valeur
- **Voyant d’état** : visualisation de l’état d’une variable (marche/arrêt, défaut, alarme…)
- **Régulation** : pilotage d’un équipement à partir d’une consigne et d’une mesure

Les widgets disponibles permettent ainsi de créer une interface adaptée aux besoins de pilotage et de consultation de l’installation.

### 2 – Liaison avec les variables

Chaque widget est associé à une ou plusieurs variables du module, en local ou à distance. Selon son type et les variables utilisées, il permet de consulter une information, de transmettre une commande ou d’assurer ces deux fonctions.

### 3- Accès direct aux widgets en mode application sur smartphone

L’interface Web du module 2PIO peut être utilisée en mode application sur smartphone. Une icône placée sur l’écran d’accueil permet d’accéder rapidement à la page Widgets, sans avoir à ouvrir le navigateur et à saisir l’adresse du module.

L’utilisateur peut sélectionner l’option *« Rester connecté »* pour conserver sa session et accéder plus rapidement aux widgets lors des utilisations suivantes.

Pour découvrir les étapes d’installation et d’utilisation, consultez la page :[ accès en mode application sur smartphone](https://modlink.fr/help/link/211#bkmrk-3--acc%C3%A8s-en-mode-app)

# 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

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

1. 1. Apuyez sur <span style="background-color: rgb(53, 152, 219); color: rgb(0, 0, 0);">+ Ajouter un widget</span>
    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

[![Capture d’écran 2026-07-28 130139.jpg](https://modlink.fr/help/uploads/images/gallery/2026-07/scaled-1680-/capture-decran-2026-07-28-130139.jpg)](https://modlink.fr/help/uploads/images/gallery/2026-07/capture-decran-2026-07-28-130139.jpg)

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

#### 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
- [![Capture d’écran 2026-07-30 142750.jpg](https://modlink.fr/help/uploads/images/gallery/2026-07/scaled-1680-/capture-decran-2026-07-30-142750.jpg)](https://modlink.fr/help/uploads/images/gallery/2026-07/capture-decran-2026-07-30-142750.jpg)
    - 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

[![Capture d’écran 2026-07-30 130927.jpg](https://modlink.fr/help/uploads/images/gallery/2026-07/scaled-1680-/capture-decran-2026-07-30-130927.jpg)](https://modlink.fr/help/uploads/images/gallery/2026-07/capture-decran-2026-07-30-130927.jpg)

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

<p class="callout info">**Le mappage d'état** permet de **personnaliser l'affichage des widgets d'état** en associant <span style="text-decoration: underline;">à chaque valeur d'une variable</span> 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*</p>

<p class="callout info">**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*</p>

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

[![Capture d’écran 2026-07-28 173733.jpg](https://modlink.fr/help/uploads/images/gallery/2026-07/scaled-1680-/vjvcapture-decran-2026-07-28-173733.jpg)](https://modlink.fr/help/uploads/images/gallery/2026-07/vjvcapture-decran-2026-07-28-173733.jpg)

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


[![Capture d’écran 2026-07-30 113417.jpg](https://modlink.fr/help/uploads/images/gallery/2026-07/scaled-1680-/capture-decran-2026-07-30-113417.jpg)](https://modlink.fr/help/uploads/images/gallery/2026-07/capture-decran-2026-07-30-113417.jpg)

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

[![Capture d’écran 2026-07-30 115244.jpg](https://modlink.fr/help/uploads/images/gallery/2026-07/scaled-1680-/capture-decran-2026-07-30-115244.jpg)](https://modlink.fr/help/uploads/images/gallery/2026-07/capture-decran-2026-07-30-115244.jpg)

- Paramétrez un <span style="text-decoration: underline;">affichage visuel</span> 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 <span style="text-decoration: underline;">libellé personnalisé</span> pour chaque action configurée

[![Capture d’écran 2026-07-30 120040.jpg](https://modlink.fr/help/uploads/images/gallery/2026-07/scaled-1680-/DXJcapture-decran-2026-07-30-120040.jpg)](https://modlink.fr/help/uploads/images/gallery/2026-07/DXJcapture-decran-2026-07-30-120040.jpg)


<p class="callout warning">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  
</p>

### 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.