Ajouter et configurer un tableau de bord
Déclarer un tableau de bord, choisir son ordre, sa visibilité par groupe, ses filtres automatiques et son thème
À quoi ça sert
La page « Configuration KPI » est l'endroit où vous déclarez, dans Deltia, les tableaux de bord construits dans Metabase. Déclarer un tableau de bord consiste à lui donner un nom, à indiquer son identifiant Metabase, puis à décider qui le voit, dans quel ordre il apparaît et comment il s'affiche.
Un tableau de bord n'existe pour vos utilisateurs qu'une fois déclaré ici. À l'inverse, retirer un tableau de bord de cette page le fait disparaître de Deltia sans rien changer dans Metabase.
La page est réservée aux administrateurs du module KPI.
Concepts clés
- ID Dashboard Metabase — l'identifiant numérique du tableau de bord dans Metabase, visible dans son adresse. C'est ce qui relie la déclaration Deltia au tableau de bord réel.
- Actif — un tableau de bord actif est proposé aux utilisateurs. Inactif, il reste déclaré mais n'apparaît nulle part.
- Dashboard par défaut — celui qui s'ouvre quand un utilisateur entre dans le module sans en choisir un. Un seul à la fois.
- Ordre d'affichage — un nombre qui décide de la position dans la navigation. Les plus petits d'abord.
- Groupes autorisés — les groupes qui peuvent voir le tableau de bord. Vide, il est visible de tous. Voir Groupes.
- Durée de validité du token — le temps pendant lequel un affichage ouvert reste consultable, avant qu'un rechargement soit nécessaire.
Comment faire
Ouvrir la page d'administration
- Dans le menu, ouvrez « KPI ».
- Cliquez sur « Administration ».
La page « Configuration KPI » présente quatre onglets dans la navigation de gauche : « Dashboards », « Tableaux composés », « Widgets » et « Réglages ». L'onglet « Dashboards » ouvre la carte « Tableaux de bord », où se déclarent les tableaux de bord Metabase. Voir Administration des tableaux composés et des widgets pour les deux autres onglets.
Ajouter un tableau de bord
- Récupérez dans Metabase l'identifiant numérique du tableau de bord, visible dans son adresse.
- Sur l'onglet « Dashboards », cliquez sur « Ajouter un tableau de bord ».
- Renseignez « Nom * » — obligatoire, c'est le libellé affiché aux utilisateurs.
- Renseignez la « Description » si vous en voulez une : elle s'affiche sous le nom dans la liste d'administration.
- Renseignez « ID Dashboard Metabase * » — obligatoire, un nombre supérieur à 0.
- Renseignez « Ordre d'affichage » si l'ordre importe.
- Choisissez les « Groupes autorisés », ou laissez vide pour ouvrir le tableau de bord à tous.
- Cochez les options voulues : « Dashboard par défaut », « Actif », « Filtrer par groupes utilisateur », « Filtrer par email utilisateur », « Mode sombre ».
- Cliquez sur « Ajouter ».
Le message « Dashboard ajouté » confirme la création, et le tableau de bord apparaît dans la liste. « Actif » est coché par défaut : le tableau de bord est donc visible dès l'enregistrement.
Modifier un tableau de bord
- Sur l'onglet « Dashboards », cliquez sur l'icône de modification de la ligne.
- Modifiez les champs voulus.
- Cliquez sur « Modifier ».
Le message « Dashboard mis à jour » confirme l'enregistrement. Le bouton reste indisponible tant qu'aucune valeur n'a changé. Si vous fermez le volet avec des modifications non enregistrées, une confirmation vous est demandée.
Désigner le tableau de bord par défaut
- Ouvrez le tableau de bord voulu en modification.
- Cochez « Dashboard par défaut ».
- Cliquez sur « Modifier ».
Le tableau de bord qui portait ce statut le perd automatiquement : il n'y a jamais qu'un seul tableau de bord par défaut. Une étoile le signale dans la liste.
Réserver un tableau de bord à certains groupes
- Ouvrez le tableau de bord en modification.
- Dans « Groupes autorisés », sélectionnez les groupes concernés.
- Cliquez sur « Modifier ».
Les utilisateurs hors de ces groupes ne voient plus le tableau de bord dans la navigation, et son adresse directe ne l'affiche pas non plus. Laisser le champ vide le rouvre à tous : « Laissez vide pour rendre le tableau de bord accessible à tous les groupes. »
Restreindre les chiffres aux données de l'utilisateur
- Ouvrez le tableau de bord en modification.
- Cochez « Filtrer par groupes utilisateur » pour ne montrer que les données des groupes de la personne connectée, ou « Filtrer par email utilisateur » pour ne montrer que ce qui la concerne personnellement. Les deux options se cumulent.
- Cliquez sur « Modifier ».
Ces cases supposent que le tableau de bord Metabase attende le paramètre correspondant : « Le dashboard Metabase doit avoir un paramètre group_ids configuré » et « Le dashboard Metabase doit avoir un paramètre email configuré ». Cochée sans le paramètre en face, l'option empêche le tableau de bord de s'afficher — vérifiez le rendu après chaque changement.
Retirer un tableau de bord
- Sur l'onglet « Dashboards », cliquez sur l'icône de suppression de la ligne.
- Confirmez « Supprimer ce tableau de bord ? » : « Le tableau de bord « {nom} » ne sera plus proposé aux utilisateurs. Cette action est définitive. »
Le message « Tableau de bord supprimé » confirme le retrait. Le tableau de bord disparaît de Deltia ; il reste intact dans Metabase. Pour le masquer sans le retirer, décochez plutôt « Actif ».
Régler la durée de validité d'un affichage
- Sur l'onglet « Réglages », renseignez « Durée de validité du token (minutes) », entre 1 et 1440 (24 heures).
- Cliquez sur « Enregistrer ».
Le message « Configuration mise à jour » confirme l'enregistrement. Le réglage vaut pour tous les tableaux de bord de l'organisation. C'est la durée pendant laquelle un affichage déjà ouvert continue de répondre : au-delà, l'utilisateur doit recharger la page, ce qui réinitialise les filtres qu'il avait posés à l'intérieur du tableau de bord.
Référence
Champs d'un tableau de bord
| Champ | Obligatoire | Rôle |
|---|---|---|
| Nom | Oui | Libellé affiché aux utilisateurs et dans la navigation |
| Description | Non | Affichée sous le nom, dans la liste d'administration |
| ID Dashboard Metabase | Oui | Identifiant numérique du tableau de bord dans Metabase |
| Ordre d'affichage | Non | Position dans la liste ; les plus petits nombres d'abord |
| Groupes autorisés | Non | Vide : visible de tous. Renseigné : réservé à ces groupes |
| Dashboard par défaut | Non | S'ouvre à l'entrée dans le module. Un seul à la fois |
| Actif | Non | Coché par défaut. Décoché : masqué des utilisateurs |
| Filtrer par groupes utilisateur | Non | Restreint les chiffres aux groupes de la personne connectée |
| Filtrer par email utilisateur | Non | Restreint les chiffres à ce qui concerne la personne connectée |
| Mode sombre | Non | Affiche le tableau de bord en thème sombre |
Messages de validation
| Message | Situation |
|---|---|
| « Nom requis » | Le nom est vide |
| « Dashboard ID Metabase invalide » | L'identifiant est absent, nul ou négatif |
Colonnes de la liste
| Colonne | Contenu |
|---|---|
| Nom | Le nom, une étoile si le tableau de bord est celui par défaut, la description en dessous |
| ID Metabase | L'identifiant renseigné |
| Statut | « Actif » ou « Inactif » |
| Ordre | La valeur de l'ordre d'affichage |
| Actions | Modifier, supprimer |
Quand aucun tableau de bord n'est déclaré : « Aucun tableau de bord configuré. Ajoutez le premier pour commencer. »
Effet des réglages côté utilisateur
| Réglage | Ce que voit l'utilisateur |
|---|---|
| Actif décoché | Le tableau de bord n'apparaît pas, et son adresse directe n'affiche rien |
| Groupes autorisés renseignés | Seuls les membres de ces groupes le voient et peuvent l'ouvrir |
| Dashboard par défaut | S'ouvre à l'entrée dans le module, sauf s'il est interdit à l'utilisateur : le premier tableau de bord autorisé prend alors le relais |
| Ordre d'affichage | Détermine l'ordre dans la navigation du module |
Voir Consulter un tableau de bord.
Questions fréquentes
Que se passe-t-il si je saisis un mauvais identifiant Metabase ? Le tableau de bord est bien déclaré, mais rien ne s'affiche à l'ouverture. Corrigez l'identifiant dans le formulaire de modification.
Puis-je réutiliser deux fois le même tableau de bord Metabase ? Oui, rien ne l'interdit : deux déclarations peuvent pointer sur le même identifiant, par exemple pour proposer une version filtrée par groupes et une version ouverte, réservées à des groupes différents.
La suppression est-elle réversible ? Non. Il faut redéclarer le tableau de bord. Préférez décocher « Actif » quand le retrait est temporaire.
Peut-on définir un tableau de bord par défaut différent selon les groupes ? Non, il n'y a qu'un seul tableau de bord par défaut pour toute l'organisation. Un utilisateur qui n'y a pas droit ouvre le premier tableau de bord qui lui est autorisé.
Le thème sombre suit-il la préférence de l'utilisateur ? Non. Il se règle par tableau de bord et s'impose à tous ceux qui le consultent.