Tableaux de bord

Tableau de bord

Créer un tableau de bord qui regroupe des graphiques et des cartes statistiques, puis l'afficher et le partager.

Tableau de bord

Un Tableau de bord regroupe sur une page des graphiques et des cartes statistiques. Il donne une vue d'ensemble des indicateurs d'une activité, par exemple les ventes ou le support.

Prérequis

  • Avoir le rôle Responsable système ou Gestionnaire de tableau de bord pour créer un tableau de bord. Les autres utilisateurs du bureau peuvent l'afficher.
  • Avoir créé les graphiques et les cartes à afficher, avec la case Public cochée. Le formulaire ne propose que les graphiques et les cartes publics.

Créer un tableau de bord

  1. Ouvrez la recherche (Ctrl+K) et saisissez Tableau de bord.
  2. Cliquez sur Créer.
  3. Saisissez le Nom du tableau de bord. Il devient le nom du document.
  4. Dans la table Graphiques, ajoutez une ligne par graphique. Pour chaque ligne, choisissez le Graphique et sa Largeur : Demi (par défaut) ou Complet. Cette table n'est pas obligatoire : un tableau de bord affiché par une application, par exemple Insights, peut ne contenir aucun graphique.
  5. Dans la table Cartes, ajoutez les cartes statistiques.
  6. Enregistrez, puis cliquez sur Voir le tableau de bord.

Le champ Options du graphique accepte des options d'affichage au format JSON, appliquées à tous les graphiques. Un JSON non valide bloque l'enregistrement.

Afficher un tableau de bord

La page du tableau de bord a l'adresse /desk/dashboard-view/<nom>. Vous pouvez aussi l'ouvrir depuis la liste Tableau de bord. Sans nom dans l'adresse, Dokos ouvre la liste Tableau de bord. Si le nom n'existe pas, la page affiche l'état « No dashboard named {0} » (libellé non traduit) avec un bouton Dashboard List (libellé non traduit) qui ramène à la liste.

Le menu de la page propose :

  • Modifier : ouvre le document du tableau de bord.
  • Nouveau : crée un tableau de bord.
  • Tout rafraîchir : recalcule tous les graphiques et toutes les cartes.
  • le nom des autres tableaux de bord, pour passer de l'un à l'autre.

Chaque utilisateur ne voit que les graphiques et les cartes auxquels il a accès. Si aucun graphique ne lui est permis, la page affiche « Aucun graphique autorisé sur ce tableau de bord ». Si le tableau de bord contient des graphiques ou des cartes mais que l'utilisateur n'a accès à aucun d'entre eux, la page affiche en plus l'état « You don't have access to anything on this dashboard » (libellé non traduit), et le menu Tout rafraîchir est masqué.

Un tableau de bord Est un formulaire standard appartient à un module d'une application. Il ne se modifie qu'en mode développeur.

Ouvrir la version Insights ou la version classique

Une application installée, par exemple Insights, peut proposer sa propre version d'un tableau de bord standard. Dans ce cas, la page du tableau de bord affiche la version de l'application à la place des graphiques et des cartes du document. Sans application qui le propose, un tableau de bord s'ouvre toujours en version classique, telle que décrite plus haut.

Seule la branche de développement d'Insights (develop, version 3.50.0-dev à ce jour) propose sa version d'un tableau de bord. Insights 3 (branche version-3), que les sites Dokos utilisent, ne le fait pas : avec Insights 3, tous les tableaux de bord s'ouvrent en version classique, quel que soit le réglage.

Tableaux de bord standard de Dokos qui ont une version Insights

Six tableaux de bord standard des modules de gestion de Dokos v5 déclarent une version Insights :

Tableau de bordModuleClasseur InsightsFiltres du classeurContenu
AccountsComptabilité (Accounts)Business OverviewSociétéTrésorerie (solde et évolution mensuelle), chiffre d'affaires, marge brute, résultat net, dettes fournisseurs et échéances par semaine, créances clients, clients en retard, charges par compte
PaymentsComptabilité (Accounts)ReceivablesSociétéFacturé et encaissé par mois, paiements reçus, montants dus dans les 30 jours, montants en retard, balance âgée des créances, clients en retard
AssetImmobilisations (Assets)AssetsSociétéValeur des immobilisations (totale et par catégorie), nouvelles immobilisations, cessions, amortissements (par mois, cumulés, non comptabilisés), immobilisations totalement amorties
BuyingAchats (Buying)BuyingSociétéMontant des achats (par mois, par groupe d'articles, par fournisseur), livraisons à l'heure (globales et par fournisseur), commandes et lignes en retard, demandes de matériel à commander, commandes à recevoir
SellingVentes (Selling)SellingSociété, TerritoireValeur des commandes (par mois, par groupe d'articles), meilleurs clients, commandes en retard ou à livrer, devis ouverts ou qui expirent, taux de transformation des devis
StockStockStockSociété, EntrepôtValeur du stock (par mois, par groupe d'articles, par entrepôt), articles en rupture ou à réapprovisionner, réceptions et livraisons par mois

Le filtre Société de chaque classeur prend par défaut la société par défaut de l'utilisateur. Les montants sont affichés dans la devise par défaut de chaque société. Les titres des classeurs et des graphiques sont en anglais.

Tableaux de bord standard de l'application RH qui ont une version Insights

Quatre tableaux de bord standard de l'application RH (HRMS) déclarent aussi une version Insights. Chaque classeur est visible seulement par les rôles indiqués dans le tableau :

Tableau de bordModuleClasseur InsightsFiltres du classeurRôlesContenu
Human ResourceRH (HR)Human ResourceSociétéUtilisateur RH, Responsable RHEmployés actifs, embauches et départs (nombres, tableau de l'exercice, départs par département), employés par département et par fonction, évolution mensuelle des employés actifs, des embauches et des départs sur douze mois
Expense ClaimsRH (HR)Expense ClaimsSociété, DépartementApprobateur de notes de frais, Utilisateur RH, Responsable RHMontant approuvé (total, par département et par type de dépense sur l'exercice, par mois), notes de frais en attente d'approbation, notes de frais impayées (nombre et liste)
PayrollPaie (Payroll)PayrollSociétéUtilisateur RH, Responsable RHSalaire brut, salaire net et salaire brut mensuel moyen par employé sur l'exercice, employés payés le mois dernier, salaire net et retenues par mois, employés payés par mois, salaire brut par département, gains et retenues par composant de salaire
AttendanceRH (HR)AttendanceSociétéUtilisateur RH, Responsable RHJours d'absence et jours de congé de l'exercice, personnes en congé aujourd'hui, absences et congés par mois, absences par département, jours de congé par type de congé

Le filtre Société prend par défaut la société par défaut de l'utilisateur. Dans les classeurs Expense Claims et Payroll, les montants sont affichés dans la devise par défaut de chaque société. Le classeur Expense Claims ne lit que les notes de frais : il n'affiche pas les avances aux employés. Les titres des classeurs et des graphiques sont en anglais.

Chaque rôle auquel un classeur est destiné peut lire les types de document que ce classeur interroge : par exemple, le rôle Approbateur de notes de frais peut lire les notes de frais. Un test de l'application RH contrôle cette règle pour chaque classeur livré.

Ces classeurs sont des fichiers livrés dans les modules de Dokos et de l'application RH (dossier insights_workbook de chaque module). Seule la branche develop d'Insights les importe : à chaque migration du site, et quand une application est installée sur un site qui a déjà Insights. Insights 3 (branche version-3) ne les importe pas. Le réglage insights_workbooks de Dokos ne les concerne pas : il ne donne à Insights 3 que des modèles de classeur, qu'un utilisateur qui a le rôle Insights Admin crée lui-même depuis la bibliothèque de modèles.

Les autres tableaux de bord standard, comme CRM, Manufacturing et Project, n'ont pas de version Insights et s'ouvrent toujours en version classique.

Le tableau de bord Stock reste le tableau de bord par défaut du site. Achats n'est pas un tableau de bord par défaut : l'ajout de la version Insights ne change pas ce réglage. Le tableau de bord Paie est le tableau de bord par défaut déclaré par son fichier ; sa version Insights ne change pas ce réglage.

Choisir la version pour tout le site

Le choix s'applique à tous les utilisateurs du site.

  1. Ouvrez les Paramètres Système, onglet App.
  2. Dans le champ Tableaux de bord, choisissez Insights ou Classic (libellés non traduits).
  3. Enregistrez.
ChoixEffet
InsightsUn tableau de bord standard qui a une version Insights s'ouvre dans cette version.
ClassicTous les tableaux de bord s'ouvrent en version classique.

Un nouveau site est réglé sur Insights. Sur un site existant, la mise à jour règle le champ sur Classic : rien ne change tant qu'un responsable système n'a pas basculé. Un site dont l'assistant d'installation n'est pas terminé reçoit Insights, comme une installation neuve.

Le message proposé aux responsables système

Quand un tableau de bord standard a une version Insights et qu'il s'ouvre en version classique, les utilisateurs qui ont le rôle Responsable système voient une ligne au-dessus du tableau de bord : « ERPNext and Frappe HR dashboards have new versions built with Insights » (libellé non traduit). Elle n'apparaît pas pour les autres utilisateurs, et pas pour un tableau de bord qu'Insights n'a pas encore créé.

Situation du siteBouton proposéEffet
Insights affiche ce tableau de bord (branche develop), le champ est sur ClassicSwitch to Insights dashboards (libellé non traduit)Après confirmation (Switch for everyone, libellé non traduit), règle le champ Tableaux de bord sur Insights pour tout le site, puis recharge la page.
Insights n'affiche pas ce tableau de bord (Insights n'est pas installé, ou c'est Insights 3)Install Insights (libellé non traduit)Ouvre la documentation d'installation d'Insights dans un nouvel onglet.

Le bouton de fermeture (croix) garde la version classique. Le message ne s'affiche plus pour aucun responsable système du site, qu'ils aient basculé ou fermé. Vous pouvez changer le choix à tout moment dans les Paramètres Système. Un site qui a fermé le message « Install Insights » puis installe Insights plus tard ne revoit pas le message : changez alors le champ dans les Paramètres Système.

Exemple fictif. Votre site a été mis à jour et le champ Tableaux de bord est sur Classic. Insights (branche develop) est installé. Marc, responsable système, ouvre le tableau de bord « Selling ». Il voit la ligne de proposition, clique sur Switch to Insights dashboards et confirme. Le tableau de bord s'affiche dans sa version Insights, pour lui et pour tous les utilisateurs. Plus tard, Claire règle le champ sur Classic dans les Paramètres Système : « Selling » s'ouvre de nouveau en version classique.

Exemple

Exemple fictif. Vous créez le tableau de bord « Direction commerciale » avec :

TableÉlémentLargeur
GraphiquesCA facturé par moisComplet
GraphiquesDevis par statutDemi
GraphiquesCommandes par client (10 premiers)Demi
CartesDevis ouverts–
CartesFactures en retard–

Les deux cartes s'affichent en haut de la page. Le graphique « CA facturé par mois » prend toute la largeur, les deux autres se partagent la ligne suivante.