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.

Modifier le masque

Le masque d'édition peut être ouvert en cliquant sur le bouton Modifier :

Cela ouvre la boîte de dialogue d'édition 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 propres au type de widget sélectionné. 

Paramètre

Description

Version

Menu déroulant dans le coin supérieur droit de cette boîte de dialogue. 5 versions d'un widget sont conservées pour pouvoir annuler les modifications

Afficher

Les widgets peuvent être masqués à l'aide de cette option.

Titre

Titre affiché

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'image

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, les widgets sont automatiquement redimensionnés 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 des graphiques 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).

Grouper avec le précédent

Peut être utilisé pour 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

Attribuez une classe CSS personnalisée à ce widget 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 de répétition 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 basés sur des 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 texte est créé.

L'itérateur utilisé est loopRow. Ainsi, si chaque ligne de l'ensemble de résultats comporte une colonne « nom », nous pouvons utiliser : loopRow.name pour accéder à la valeur de cette colonne.

image-20241118-134936.png

Supprimer un widget

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