Outre les widgets intégrés, votre organisation peut en conserver ses propres. Le moyen le plus simple est d’enregistrer une carte configurée comme widget. Les administrateurs peuvent aussi créer des widgets à partir d’un modèle HTML, avec leur propre formulaire de réglages et leurs emplacements de données, et publier des versions de ces widgets. Les widgets sont disponibles dans la bibliothèque de widgets.
La bibliothèque de widgets
Ouvrez Widgets dans le menu (sous Configuration). « Tout ce qui peut être placé sur un tableau de bord. »
| Rayon | Contient |
|---|---|
| Système | Les widgets intégrés et ceux ajoutés par les modules (« Les modules ajoutent des widgets à mesure qu’ils sont activés. ») |
| Organisation | Widgets partagés avec toute l’organisation |
| Mes widgets | Vos widgets privés (« Les widgets que vous créez apparaissent dans ce rayon. ») |
| Favoris | Les widgets que vous avez marqués d’une étoile, depuis n’importe quel rayon |
Le tableau affiche Nom, Catégorie et Utilisé par (nombre de cartes qui l’utilisent), avec un filtre Type : Intégré, Modèle HTML, Cadre de plugin. Modifier ouvre un widget que vous pouvez changer.
| Qui | Peut |
|---|---|
| Chaque membre (Créer et modifier vos propres widgets privés) | Créer des widgets privés pour soi-même |
| Administrateurs (Créer et modifier des widgets, Publier des versions de widgets) | Créer, modifier et publier des widgets pour tout le monde |
Votre offre définit le nombre de widgets personnalisés partagés que votre organisation peut avoir. Les widgets privés de chaque membre sont comptés dans son propre quota, sous la même limite ; ainsi, les widgets privés ne consomment jamais les widgets partagés.
Enregistrer une carte comme widget
- Configurez une carte sur un tableau comme vous le souhaitez.
- Dans ses réglages, sélectionnez Enregistrer comme widget… (« Enregistre les réglages et données actuels de cette carte comme widget réutilisable dans votre bibliothèque. »).
- Le widget apparaît sous Mes widgets : « Enregistré comme widget dans votre bibliothèque. » Placez-le sur n’importe quel tableau depuis Ajouter un widget > Mes widgets.
Créer un widget
- Dans la bibliothèque de widgets, sélectionnez Nouveau widget.
- Choisissez comment commencer : À partir d’un graphique prêt à l’emploi (un graphique intégré avec vos valeurs par défaut) ou À partir d’un modèle HTML.
- Saisissez un Nom et une Catégorie, puis choisissez Moi uniquement ou Tout le monde (administrateurs uniquement).
- Sélectionnez Créer. L’éditeur de widget s’ouvre.
L’éditeur de widget
L’éditeur affiche un Aperçu en direct à gauche et le formulaire Réglages à droite. L’aperçu est dessiné par le même cadre isolé qu’utilise un tableau ; ce que vous voyez est donc ce que reçoivent les tableaux. Les onglets :
| Onglet | Contient |
|---|---|
| Modèle | Le HTML d’un widget à modèle HTML. Un widget intégré ou de plugin indique qu’il « est rendu par du code que nous fournissons, il n’y a donc pas de modèle à modifier ici ». |
| Schéma | Les champs de réglage : Clé, Libellé, Type. « Chaque champ ajouté ici apparaît dans le panneau de droite — et dans le tiroir qu’un opérateur ouvre sur un placement. » Supprimer un champ supprime aussi sa valeur par défaut. |
| Données | Jusqu’à 6 emplacements de données : Clé d’emplacement, Libellé, Forme (scalaire, série, tableau, enregistrement), Obligatoire. « Un emplacement indique ce dont le widget a BESOIN — un scalaire, une série — jamais d’où cela provient. » Chaque carte choisit la source. |
| Actions | Lecture seule : les actions se définissent carte par carte, dans le tiroir de réglages du tableau. |
Utiliser comme valeurs par défaut écrit les réglages affichés dans les valeurs par défaut du widget.
Écrire un modèle HTML
- Un champ de réglage est un jeton : un champ
titles’écrit{{title}}. - Un emplacement de données scalaire
mains’écrit{{data_main}}. Les formes plus riches se trouvent danswindow.WIDGET_DATA.<slot>pour le script propre au modèle. - Pour rendre un élément cliquable, appelez
window.widgetAction()ou attribuez à un élémentdata-widget-action. La carte exécute alors les actions configurées par son tableau ; le modèle ne nomme jamais de destination.
<div style="font: 600 32px system-ui">{{data_main}} {{unit}}</div>
<div style="color: #666">{{caption}}</div>
<button data-widget-action>Details</button>
Le modèle s’exécute dans un cadre sans accès à Hermetry, à votre session ou aux autres cartes, sous sa propre politique de sécurité du contenu. Les widgets à modèle s’affichent sur les écrans d’affichage.
Brouillons, versions et publication
Un widget a un statut : Brouillon, Publié ou Archivé. Vos modifications vont dans le brouillon et sont enregistrées au fil de la saisie (également avec Ctrl+S) ; l’en-tête affiche « non enregistré… » puis Enregistré. Annuler et rétablir (Ctrl+Z, Ctrl+Maj+Z) fonctionnent pendant la modification. Les tableaux ne voient que les versions publiées, donc un brouillon ne modifie jamais un tableau.
| Action | Effet |
|---|---|
| Publier | Transforme le brouillon en nouvelle version (depuis Brouillon ou Publié). Les cartes des tableaux la suivent. |
| Dépublier | Remet un widget publié en Brouillon. |
| Archiver | Retire un widget brouillon ou publié (Archivé). |
| Restaurer | Remet un widget archivé en Brouillon. |
L’éditeur ne propose que les actions autorisées par le statut du widget.
Lorsqu’une publication modifie des réglages déjà utilisés par des cartes, la boîte de dialogue Modifications des réglages depuis la dernière publication les liste : champs renommés, supprimés, de type modifié, restreints ou dépréciés. Si un nouveau champ remplace un champ supprimé, indiquez-le (« caption devient … ») et les valeurs passent dans ce nouveau champ. Les cartes déjà sur les tableaux conservent les anciennes valeurs par défaut conserve les cartes existantes telles qu’elles apparaissent aujourd’hui ; désactivée, les cartes qui n’ont jamais défini de valeur suivent la nouvelle valeur par défaut.
Si deux personnes modifient un même widget, la seconde sauvegarde est refusée plutôt que d’écraser silencieusement la première.
Widgets système
Un widget système est livré avec la plateforme. Sa modification affiche « Ceci est un widget système. Il est livré avec la plateforme, donc les modifications faites ici ne sont pas celles qu’une mise à niveau conservera. » Un widget partagé de votre organisation ne peut pas reprendre le nom de type d’un widget de la plateforme.
Déplacer des widgets
Un fichier de tableau nomme les widgets utilisés par ses cartes mais ne contient pas leurs définitions. Avant d’importer dans une autre organisation un tableau qui utilise vos propres widgets, recréez-les là-bas. Voir Modèles de tableaux et fichiers de tableau.

