Nouveau : le pare-feu IA surveille toute la plateforme et explique chaque incident en termes simples. Découvrez comment ça marche

Vos propres widgets

La bibliothèque de widgets : enregistrer une carte comme widget, créer des widgets à modèle HTML avec réglages et emplacements, et publier des versions en toute sécurité.

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

RayonContient
SystèmeLes widgets intégrés et ceux ajoutés par les modules (« Les modules ajoutent des widgets à mesure qu’ils sont activés. »)
OrganisationWidgets partagés avec toute l’organisation
Mes widgetsVos widgets privés (« Les widgets que vous créez apparaissent dans ce rayon. »)
FavorisLes 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.

QuiPeut
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

  1. Configurez une carte sur un tableau comme vous le souhaitez.
  2. 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. »).
  3. 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

  1. Dans la bibliothèque de widgets, sélectionnez Nouveau widget.
  2. 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.
  3. Saisissez un Nom et une Catégorie, puis choisissez Moi uniquement ou Tout le monde (administrateurs uniquement).
  4. 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 :

OngletContient
ModèleLe 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émaLes 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éesJusqu’à 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.
ActionsLecture 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 title s’écrit {{title}}.
  • Un emplacement de données scalaire main s’écrit {{data_main}}. Les formes plus riches se trouvent dans window.WIDGET_DATA.<slot> pour le script propre au modèle.
  • Pour rendre un élément cliquable, appelez window.widgetAction() ou attribuez à un élément data-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.

ActionEffet
PublierTransforme le brouillon en nouvelle version (depuis Brouillon ou Publié). Les cartes des tableaux la suivent.
DépublierRemet un widget publié en Brouillon.
ArchiverRetire un widget brouillon ou publié (Archivé).
RestaurerRemet 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.