Widgets

Les widgets constituent les éléments de base d'un tableau de bord et se répartissent en trois grandes catégories :

Modification des widgets

Déplacer un widget

Les widgets peuvent être déplacés en cliquant et en maintenant enfoncé le bouton de glisser-déposer situé en haut à gauche du widget (affiché uniquement lorsque vous survolez le widget). Un contour indique l'emplacement où le widget sera placé lorsque vous relâcherez le bouton.

Masque d'édition

Le masque de modification s'ouvre en cliquant sur le bouton Modifier :

Cela ouvre la boîte de dialogue de modification du widget.

La partie gauche du masque d'édition contient les paramètres généraux du widget, tandis que la partie droite contient les paramètres spécifiques au type de widget sélectionné.

Paramètre	Description
Version	Liste déroulante située dans le coin supérieur droit de cette boîte de dialogue. Cinq versions d’un widget sont conservées afin de pouvoir annuler les modifications
Titre	Titre affiché
Afficher	Cette option permet de masquer les widgets.
Intervalle de rafraîchissement (en secondes)	Définit la fréquence à laquelle ce widget actualise ses données (en secondes). Si ce champ est laissé vide, l'intervalle par défaut du tableau de bord, soit 180 secondes, est utilisé.
Masquer sur petit écran	Cette option permet de masquer les widgets sur les petits écrans (téléphones).
Afficher uniquement s'il contient des données	Certains widgets peuvent être configurés pour ne s'afficher que s'ils contiennent effectivement des données. Le widget n'apparaît pas pendant le chargement et ne s'affichera qu'une fois le chargement terminé, s'il contient des données.
Activer l'exportation d'images	Active un bouton « appareil photo » lorsque l'on survole le widget, permettant aux utilisateurs d'en faire une capture d'écran.
Mettre en évidence les modifications	Si cette option est activée, les widgets seront mis en évidence lorsque leurs données auront changé. L'option « visuel » fait clignoter le widget pendant 10 secondes, tandis que l'option « audio » émet en plus un bref signal sonore de notification.
Masquer dans le rapport	Cette option permet de spécifier si ce widget particulier doit apparaître dans les rapports PDF, lorsqu’un tel rapport est configuré pour le tableau de bord actuel.
Largeur	Largeur minimale du widget en pixels ou en pourcentage (facultatif). Si la largeur minimale n’est pas spécifiée, la taille des widgets est automatiquement ajustée en fonction de l’espace disponible. Pour aligner deux widgets strictement côte à côte, définissez la largeur minimale sur « 50 % » pour les deux. Pour forcer un widget à utiliser toute la largeur de la tuile, définissez la largeur minimale sur « 100 % ». Largeur maximale du widget (facultatif). Si cette option est définie, les meilleurs résultats sont obtenus lorsqu’une largeur minimale est également définie. Pour éviter que les graphiques ne soient illisibles, la largeur minimale doit être configurée en pixels plutôt qu’en pourcentage.
Hauteur	Hauteur minimale du widget (facultatif). Ceci est utile pour les widgets qui ne définissent pas eux-mêmes leur hauteur (par exemple, la carte géographique). Hauteur maximale du widget (facultatif).
Regrouper avec le précédent	Permet de regrouper des widgets. Dans l'exemple suivant, le widget 2 du groupe a l'option « Regrouper avec le précédent » activée.
Classe CSS	Attribue une classe CSS personnalisée à ce widget en particulier (facultatif).
Répéter	Utilisez la fonction de répétition pour créer plusieurs widgets du même type pour chaque entrée du jeu de résultats de la requête sélectionnée. Plus d'informations

Aperçu du widget

Widget « Répéter »

Le widget « Répéter » n'est actuellement disponible que pour les widgets « Graphique » et « Texte ».

L'option de répétition d'un widget permet de répéter une instance du widget pour chaque entrée trouvée dans le jeu de résultats de la requête.

Cela facilite la création de widgets répétitifs à partir de données répétitives.

Dans l'exemple ci-dessous, on accède à un tableau contenant les informations sur les employés, et pour chaque employé (ligne), un widget de texte est créé.

L'itérateur utilisé est « loopRow » ; ainsi, si chaque ligne du jeu de résultats comporte une colonne « name », on peut utiliser : « loopRow.name » pour accéder à la valeur de cette colonne.

Supprimer un widget

Pour supprimer un widget, utilisez l’option « Supprimer le widget » dans le menu Édition du widget.