Tableaux de bord
Un tableau de bord place côte à côte plusieurs widgets — chiffres clés, listes de décisions, barres de proportion, graphiques, tableaux — alimentés chacun par une requête d'un connecteur. Il s'ouvre depuis le menu comme un écran, et se construit dans Liberty Next → Construire → Tableaux de bord.
Vue d'ensemble
Widgets
Les widgets se placent sur une grille de 12 colonnes, dans leur ordre de déclaration. Chacun occupe une largeur de 1 à 12 colonnes et une hauteur de 1 à 8 lignes, et porte un titre ainsi qu'un sous-titre facultatif : une ligne sous le titre qui précise ce que couvre le widget.
| Widget | Affiche | Réglages |
|---|---|---|
| KPI | Un chiffre calculé sur toutes les lignes d'une requête. | Connecteur, requête, colonne, agrégation (count, sum, avg, min, max, ou none pour la valeur de la première ligne), format, et comparaison avec la période précédente. |
| Chiffre | Une carte chiffrée lue sur la première ligne de la requête, avec une ligne de détail en dessous. | Colonne de valeur, Format, Unité, Ligne secondaire. |
| Liste | Une liste de décisions ou un classement : une ligne par enregistrement, avec une pastille de couleur, un titre, un sous-titre, un chiffre et une étiquette. | Colonne de titre (obligatoire), Colonne de sous-titre, Colonne de valeur, format, unité, Colonne de compte et Libellé du compte, Colonne de tonalité, Colonne d'étiquette, Lignes affichées. |
| Barres | Un classement avec une barre de proportion sous chaque ligne. | Colonne de libellé et Colonne de valeur (obligatoires), Colonne de sous-libellé, format, unité, Barre en part de, Note sous les barres, Lignes affichées. |
| Graphique | Un graphique en barres, courbes, aires ou secteurs. | Un graphique enregistré dans Liberty Next → Construire → Graphiques, ou un connecteur, une requête et une définition de graphique écrits dans le widget — voir Graphiques. |
| Table | Les lignes d'une requête. | Connecteur, requête, colonnes à afficher (toutes si vide), nombre maximal de lignes. |
| Texte | Un bloc de Markdown : à quoi sert la page, comment la lire. Titres, listes et liens sont acceptés. | Texte (Markdown). |
| Tâches | Les tâches Nomaflow avec leur prochaine exécution, leur planification en clair et leur dernier état, et Exécuter / Mettre en pause / Reprendre. Réservé aux superutilisateurs. | Tâches (ids, dans l'ordre) — vide = toutes les tâches planifiées —, Seulement ces étiquettes, Lignes maximum (12 si vide). |
| Liens | Une carte de points d'entrée : des éléments du menu de l'application du tableau de bord, ou des adresses web. | Liens par ligne (1 à 4) ; pour chaque lien, un Élément de menu ou une URL, une Icône, un Libellé (vide : celui de l'élément de menu) et une Description. |
Un widget dont l'utilisateur ne peut pas lancer la requête est masqué ; le reste du tableau de bord s'affiche. Chaque carte porte son titre et son sous-titre à l'intérieur, et la page s'agrandit avec ses widgets : elle défile jusqu'au dernier.
Chiffre, liste et barres
Ces trois widgets font d'un tableau de bord une page de synthèse : les chiffres qui comptent, ce qui demande une décision et les proportions, chacun lu par une requête écrite pour lui.
- Format : Nombre, Entier, Monnaie (euros, sans décimales pour un montant rond) ou Pourcentage (0–1) — un ratio entre 0 et 1, affiché en pourcentage. L'unité suit le chiffre (
utilisateurs,lignes) ; une devise porte son propre symbole. - Ligne secondaire (chiffre) : une phrase dont les marqueurs sont remplis à partir de la première ligne,
{COLONNE}ou{COLONNE:format}—{ENABLED:integer} actifs · {DISABLED:integer} désactivésdonne 380 actifs · 32 désactivés. Un marqueur qui nomme une colonne inconnue reste tel quel. - Colonne de tonalité (liste) : une colonne valant
ok,warn,errorouinfocolore la pastille en vert, orange, rouge ou bleu ; toute autre valeur donne une pastille grise. La requête décide du ton — une période clôturée, un montant au-delà d'un seuil. - Libellé du compte (liste) : le texte autour de la colonne de compte,
{n} lignes de conflit. La Colonne d'étiquette affiche sa valeur sous forme d'étiquette à côté du titre, dans le ton de la ligne. - Barre en part de (barres) : Le total des lignes — les barres totalisent 100 % — ou La plus grande ligne, qui occupe la barre entière.
L'éditeur affiche un aperçu du widget dès que le connecteur, la requête et les colonnes obligatoires sont choisis.
Tâches
Une carte Tâches place l'ordonnanceur sur un tableau de bord. Chaque ligne présente la tâche — un clic l'ouvre dans Nomaflow —, sa prochaine exécution ou En pause, sa planification en clair (chaque jour à 03:00), l'état de sa dernière exécution, et trois boutons : Exécuter avec les valeurs enregistrées de la tâche, Mettre la planification en pause, Reprendre la planification — appliqués aussitôt. Sans identifiants, la carte liste les tâches planifiées, la plus proche d'abord, éventuellement limitées à certaines étiquettes (main, nomasx1). La carte se rafraîchit d'elle-même pendant une exécution.
La carte est réservée aux superutilisateurs : pour les autres, elle n'apparaît pas sur le tableau de bord.
Texte et liens
Ces deux widgets font d'un tableau de bord la page d'accueil d'une application : quelques lignes sur ce qu'elle fait, les chiffres, puis par où commencer.
- Un widget Texte ou Liens occupant toute la largeur de la grille (12 colonnes) prend la hauteur de son contenu, sans barre de défilement ; plus étroit, il défile dans sa tuile.
- Un widget Liens n'affiche que les éléments de menu que l'utilisateur peut ouvrir : une entrée que ses rôles n'accordent pas disparaît de la carte. Une URL s'ouvre dans un nouvel onglet du navigateur. Un lien vers une URL exige un libellé.
- À l'export, un texte garde son Markdown et une carte de liens devient un tableau (Lien, Description).
La période
Un tableau de bord peut porter une période : un sélecteur de dates dans sa barre, appliqué à tous les widgets.
- Préréglages : Aujourd'hui, Hier, 7 derniers jours, 30 derniers jours, Ce mois-ci, Mois dernier, Ce trimestre, Cette année, Année dernière, 12 derniers mois, Toutes les dates. Le préréglage Hier couvre hier et aujourd'hui.
- Une période libre : choisir une date de début puis une date de fin dans le calendrier de deux mois, puis Appliquer.
- Base de dates : quand le tableau de bord propose plusieurs dates (Date du document, Payée le), un choix Date en bas du panneau indique celle à laquelle s'applique la période.
Le tableau de bord s'ouvre sur son propre préréglage, sinon sur celui de l'application (Liberty Next → Administrer → App → Période par défaut (tableaux de bord), Ce mois-ci par défaut). Un choix dure tant que l'onglet du tableau de bord reste ouvert.
Ce que reçoivent les requêtes
| Paramètre | Valeur |
|---|---|
:PERIOD_FROM, :PERIOD_TO | La période choisie, sous forme de dates. Toutes les dates lie 0001-01-01 à 9999-12-31. |
:PREV_FROM, :PREV_TO | La période précédente (voir ci-dessous). |
:PERIOD_BASIS | La base de dates choisie, quand le tableau de bord en propose plusieurs. |
Une requête qui ne les cite pas n'est pas concernée. Quand la période désigne sa colonne de date — directement ou par un élément du dictionnaire retrouvé dans l'écran du widget —, le widget est aussi filtré sur le serveur sur cette colonne, sans modifier son SQL.
La période précédente
| Période | Comparée à |
|---|---|
| Commençant au 1er janvier (Cette année, Année dernière) | Les mêmes dates un an plus tôt. |
| Commençant le 1er d'un mois | Le même nombre de mois juste avant — Mois dernier avec le mois d'avant, un trimestre entier avec le trimestre d'avant ; Ce mois-ci le 27 avec le 1er–27 du mois précédent. |
| Autre | Le même nombre de jours juste avant. |
Comparer un indicateur
Avec Comparer avec la période précédente coché, un KPI relance sa requête sur la période précédente et affiche sous le chiffre l'évolution — en pourcentage, en points pour un KPI en pourcentage — en vert ou en rouge, ainsi que la valeur précédente. Rien n'est comparé sur Toutes les dates.
Filtres
Un tableau de bord peut aussi porter des filtres, présentés comme des listes déroulantes dans sa barre. Chaque filtre a un libellé, un élément du dictionnaire, une requête qui fournit ses choix (colonne de valeur et colonne de libellé), et une valeur par défaut facultative. Choisir une valeur recharge chaque widget dont la requête renvoie une colonne portant cet élément — par l'écran du widget, ou directement d'après les colonnes du résultat : une colonne du nom de l'élément, ou de ce nom précédé du préfixe de colonnes du connecteur. Les autres widgets restent tels quels. Une période dont la colonne de date est donnée par un élément du dictionnaire retrouve sa colonne de la même façon.
Dans l'éditeur, chaque filtre indique les widgets qu'il atteint — Atteint : …, avec pas : … pour les autres — ou N'atteint aucun widget quand aucune colonne ne porte l'élément du dictionnaire.
Avec Tous, rien n'est filtré : une requête qui renvoie d'abord une ligne de total, puis une ligne par valeur, affiche les totaux dans ses widgets chiffre et liste.
Actualisation et cache
Quand un tableau de bord est rouvert, chaque widget réutilise son dernier résultat pendant Liberty Next → Administrer → App → Cache des tableaux de bord (secondes, 0 = aucun) — 60 secondes par défaut. Le bouton ↻ de la barre recharge tout, et Mis à jour à 14:05 indique l'heure des données. Le cache est tenu par le navigateur, par utilisateur, jusqu'au rechargement de la page.
Export Excel et PDF
Les boutons Excel et PDF, à côté de ↻, exportent ce que montre la barre : les choix des filtres, la période et sa base de dates, dans le périmètre de données de l'utilisateur. Le serveur relance chaque widget ; rien n'est repris de l'écran.
| Excel | ||
|---|---|---|
| Mise en page | Une feuille par widget ; les KPI réunis sur une feuille Chiffres clés. | Une page de garde avec le tableau de bord, la période et les filtres, puis les widgets à la suite. |
| KPI, chiffre | Une ligne de valeurs. | Une carte, la ligne de détail en petits caractères sous le chiffre. |
| Liste, barres, table | Ses lignes. | Un tableau. |
| Texte, liens | Le texte ; les liens en lignes. | Le texte ; un tableau des liens. |
| Graphique | Son tableau de données. | Le graphique dessiné, avec sa légende et les valeurs sur les barres. |
Un widget dont la requête échoue devient une section d'erreur ; le reste de l'export est produit. Les nombres suivent la langue du lecteur (1 234,5 / 1,234.5). La charte PDF se règle dans Liberty Next → Administrer → App.
Construire un tableau de bord
Dans Liberty Next → Construire → Tableaux de bord, choisir l'application, puis ajouter ou ouvrir un tableau de bord. L'éditeur comprend :
| Partie | Contenu |
|---|---|
| Général | Titre, description. |
| Période | Ajouter une période : S'ouvre sur (un préréglage, ou la valeur de l'application), Colonne de date ou élément du dictionnaire, et des Bases de date facultatives (clé, libellé, colonne de date ou élément du dictionnaire). |
| Filtres | Ajouter un filtre : les listes déroulantes de la barre. |
| Widgets | Ajouter un widget : Graphique, KPI, Table, Chiffre, Liste, Barres, Texte, Liens ou Tâches. Chaque widget a un Sous-titre, et des boutons pour le rendre plus étroit ou plus large, plus bas ou plus haut, et l'avancer ou le reculer dans la grille. |
Un tableau de bord s'affiche dans la langue de l'utilisateur : son titre, sa description, les libellés des filtres et les textes des widgets peuvent porter une version française, et une liste peut lire ses titres dans une colonne française de sa requête.
Pour rendre le tableau de bord accessible, ajouter une entrée dashboard à un menu (Menus) ; sa permission est dashboard:<application>.<id>.
En TOML
[dashboards.sales.overview]
label = "Vue des ventes"
period = { column = "DOC_DATE", default = "thisMonth" }
[[dashboards.sales.overview.widgets]]
type = "kpi"
label = "Chiffre d'affaires"
connector = "sales"
query = "revenue_by_company_get"
column = "REVENUE"
aggregation = "sum"
compare_previous = true
col_span = 4
[[dashboards.sales.overview.widgets]]
type = "chart"
chart = "revenue_by_month"
col_span = 8
row_span = 2
Conseils
- Donner une période au tableau de bord plutôt que des filtres de dates dans chaque requête : un seul contrôle, et la comparaison est fournie.
- Pour une page de synthèse, écrire une petite requête par chiffre ou par liste, et laisser la requête calculer le ton : le tableau de bord se contente de l'afficher.
- Un KPI avec
noneaffiche la valeur de la première ligne : laisser la requête calculer le chiffre quand l'agrégation est complexe. - Garder le cache pour les tableaux de bord souvent ouverts ; ↻ donne toujours des chiffres frais.