En plus des widgets intégrés, votre organisation peut conserver ses propres widgets. Le plus simple consiste à 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 propres 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 que les modules ajoutent (« Les modules fournissent des widgets à mesure qu’ils sont activés. ») |
| Organisation | Widgets partagés avec l’ensemble de 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, quel que soit le 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 module. 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 tous |
Votre offre définit le nombre de widgets personnalisés partagés que votre organisation peut avoir. Les widgets privés de chaque membre comptent dans son propre quota, dans la même limite, de sorte que les widgets privés n’entament jamais les widgets partagés.
Enregistrer une carte comme widget
- Configurez une carte sur un tableau de bord comme vous le souhaitez.
- Dans ses réglages, sélectionnez Enregistrer comme widget… (« Enregistre les réglages et les données actuels de cette carte sous forme de 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 (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é que celui utilisé par un tableau de bord : ce que vous voyez est 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 module indique qu’il « est généré par du code que nous livrons, il n’y a donc aucun 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, ainsi que dans le tiroir qu’un opérateur ouvre sur un emplacement. » 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 sa source. |
| Actions | Lecture seule : les actions se définissent par carte, dans le tiroir de réglages du tableau. |
Utiliser comme valeurs par défaut enregistre dans les valeurs par défaut du widget les réglages affichés à l’écran.
Écrire un modèle HTML
- Un champ de réglage est un jeton : le champ
titles’écrit{{title}}. - Un emplacement de données scalaire
mains’écrit{{data_main}}. Les formes plus riches sont danswindow.WIDGET_DATA.<slot>pour le script propre au modèle. - Pour rendre un élément cliquable, appelez
window.widgetAction()ou donnez à un élémentdata-widget-action. La carte exécute alors les actions configurées par son tableau ; le modèle ne désigne 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 ni 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 fur et à mesure de la saisie (ou 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 : 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 changements d’état autorisés 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 (« est désormais …ยิ่ง »)
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. Son édition affiche « Ceci est un widget système. Il est livré avec la plateforme, donc les modifications faites ici ne sont pas conservées lors d’une mise à niveau. » 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 indique 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 tableaux.