Aller au contenu principal

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​

Vue des ventesChiffre d'affaires et commandes par sociétéPériodeCe mois-ci · 01/10 – 27/10 ▾SociétéToutes ▾↻Mis à jour à 14:05CHIFFRE D'AFFAIRES1 284 500▲ +12,4 %précédent : 1 142 700COMMANDES3 412▼ -3,1 %précédent : 3 521TAUX DE MARGE31,2 %▲ +1,4 ptsprécédent : 29,8 %Chiffre d'affaires par mois050607080910Meilleurs clientsACME212 400Beta SARL184 900Gamma SA97 300Delta65 100Périodepréréglages, calendrier, baseComparerévolution / période précédenteWidget graphiqueun graphique enregistré ou intégréFiltresune liste par élémentActualiserignore le cache · heureWidget tablecolonnes choisies, plafond

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.

WidgetAfficheRéglages
KPIUn 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.
ChiffreUne 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.
ListeUne 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.
BarresUn 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.
GraphiqueUn 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.
TableLes lignes d'une requête.Connecteur, requête, colonnes à afficher (toutes si vide), nombre maximal de lignes.
TexteUn bloc de Markdown : à quoi sert la page, comment la lire. Titres, listes et liens sont acceptés.Texte (Markdown).
TâchesLes 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).
LiensUne 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.

Synthèse des ventesLes périodes chargées, les quantités et le chiffre d'affaires en un coup d'œilPÉRIODE12 derniers mois ▾BUSINESS UNITTous ▾ExcelPDF↻Mis à jour à 08:02Chiffre d'affairesFacturé sur la période1 284 350 €12 sociétés · 4 business unitsLignes de factureLignes chargées48 9205 périodes · 2 clôturéesClientsAvec au moins une vente1 13538 nouveaux ce mois-ciPériodes à examinerStatut de chaque période chargée2026-02validée9 8122026-03ouverte — lignes encore attendues4 2062026-01clôturée — un rechargement refuséclôturée10 4402025-12validée8 965Quantités par famillePart de la plus grande familleBoissons18 400Épicerie12 950Produits frais9 310Entretien4 120Chiffreune valeur, une ligne modèleListepastille, sous-titre, chiffre, étiquetteExportce que montre la barre, en Excel ou PDFSous-titresur chaque widgetBarrespart du total ou du plus grand

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és donne 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, error ou info colore 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.

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ètreValeur
:PERIOD_FROM, :PERIOD_TOLa période choisie, sous forme de dates. Toutes les dates lie 0001-01-01 à 9999-12-31.
:PREV_FROM, :PREV_TOLa période précédente (voir ci-dessous).
:PERIOD_BASISLa 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ériodeComparé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 moisLe 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.
AutreLe 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.

ExcelPDF
Mise en pageUne 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, chiffreUne ligne de valeurs.Une carte, la ligne de détail en petits caractères sous le chiffre.
Liste, barres, tableSes lignes.Un tableau.
Texte, liensLe texte ; les liens en lignes.Le texte ; un tableau des liens.
GraphiqueSon 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 :

PartieContenu
GénéralTitre, description.
PériodeAjouter 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).
FiltresAjouter un filtre : les listes déroulantes de la barre.
WidgetsAjouter 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.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 none affiche 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.