Gestion des Sources de données
Le control Pivot a besoin de données pour fonctionner.
Dans la version actuel du module Pivot Reports, les données ne peuvent provenir que de requêtes SQL sur la base Dolibarr en cours d'utilisation.
On peut ajouter autant de requêtes SQL qu'on veut dans la page de config du module.
Chaque requêtes SQL est traitée comme une source de données indépendante et son nom est affiché dans l'interface principal du module comme menu gauche.
Chaque requête SQL déjà créée peut être désactivée ou supprimée, elle n'apparaitra plus alors dans le menu gauche du module.
Liste des Sources de données
La liste des Sources de données est disponibles dans la page de config du module, onglet "Sources de données".
Le module Pivot Reports est fourni avec 17 sources de données prédéfinies couvrant la majorité des éléments Dolibarr (Devis, Commandes, ...).
Ajouter une Source de données
IMPORTANT :Pour ajouter une nouvelle Source de données par vous même, les éléments suivants sont nécessaires :
- savoir créer une requête SELECT du langage SQL
- connaître la structure de la base de données de votre version Dolibarr
- comprendre la représentation Pivot en général Si vous n'êtes pas dans ce cas, demandez à un expert de vous aider ou contactez-nous.
Au dessus de la liste des sources de données, le bouton "Nouvelle Source de données" permet d'ouvrir le dialogue de création de la nouvelle requête SQL.
Le nom de la source de données est obligatoire ainsi que la requêtes SQL (Source de données) elle même.
Nous recommandons d'utiliser des alias pour les noms des champs dans la requête SELECT parce que ce sont ces alias qui vont être affichés par le control Pivot, et il est préférable de les choisir soignesement pour refléter les données qu'ils représentent.
Il est préférable aussi que l'alias ne contienne qu'un seul mot, mais s'il en contient plusieurs, les entourer par des apostrophes.
Les Sources de données fournies en standard par le module Pivot Reports couvrent la majorité des entités Dolibarr, vous pouvez vous en inspirer pour créer votre propre requête.
Le module Pivot Reports vérifie la syntax de la requête SQL, si elle n'est pas valide un message est affiché avec l'erreur trouvée.
Le mot SELECT n'est pas obligatoire, s'il n'est pas présent, il sera ajouté par le module avant de soumettre la requête au serveur de base de données.
Lorsque la Source de données est créée avec succès, un rapport par défaut est créé également.
Ce rapport s'appelle "Default" :
Vous pouvez alors le renommer et le paramétrer dans l'interface principale du module. \
Exemple de rapport par défault créé par une nouvelle Sources de données :
Modifier / Supprimer une Source de données
Dans la liste des Sources de données, un click sur le nom de la source de données fait apparaître la fiche de celle-ci en mode consultation.
Vous pouvez-alors la modifer en clickant sur le bouton "MODIFIER" ou la supprimer en clickant sur le bouton "SUPPRIMER"
Conventions de nommage des champs temporels dans la Source de données
Le module possède une fonctionnalité de traitement spécifique pour les valeurs des champs temporels représentant les jours, les mois, les trimestres ou les semestres. Ce traitement consiste à :
- les ordonner par ordre croissant (exemple pour les mois : Jan, Fèv, ...)
- ajouter les valeurs manquantes (par exemple : si vous n'avez pas fait de ventes durant le mois d'Août, ce mois sera absent de la source de données, et il sera absent également dans les libellés de l'axe X des graphiques.
Pour éviter ce comportement, le module ajoute les mois manquants pour avoir un graphique plus cohérent) - les mois peuvent commencer par le début de l'année fiscale ou civile (suivant le paramétrage du module) Toutes ces fonctionnalités ne sont possibles que si vous respectez les conventions de nommage suivantes des champs temporels :
- Les jours : Le champ doit s'appeler "Jour" et les valeurs possibles doivent s'appeler : 'Lun', 'Mar', 'Mer', 'Jeu', 'Ven', 'Sam', 'Dim'
- Les mois : Le champ doit s'appeler "Mois" et les valeurs possibles doivent s'appeler : 'Jan', 'Fév', 'Mar', 'Avr', 'Mai', 'Jui', 'Juil', 'Aoû', 'Sep', 'Oct', 'Nov', 'Déc'
- Les trimestres : Le champ doit s'appeler "Trimestre" et les valeurs possibles doivent s'appeler : '1er Trim', '2e Trim', '3e Trim', '4e Trim'
- Les semestres : Le champ doit s'appeler "Semestre" et les valeurs possibles doivent s'appeler : '1er Sem', '2e Sem'
Exemple : extrait de la requête de la source de données "Commandes clients" concernant le champ "Mois" :
SELECT
t.date_commande AS date_commande,
(CASE MONTH(t.date_commande)
WHEN 1 THEN 'Jan'
WHEN 2 THEN 'Fév'
WHEN 3 THEN 'Mar'
WHEN 4 THEN 'Avr'
WHEN 5 THEN 'Mai'
WHEN 6 THEN 'Jui'
WHEN 7 THEN 'Juil'
WHEN 8 THEN 'Aoû'
WHEN 9 THEN 'Sep'
WHEN 10 THEN 'Oct'
WHEN 11 THEN 'Nov'
WHEN 12 THEN 'Déc'
ELSE '' END) AS Mois,
...
Modifier l'ordre des sources de données dans le menu gauche
Les Sources de données sont affichées comme menu gauche dans l'écran principal du module.
Pour réordonner ces entrées de menu, il faudra utiliser le gestionnaire de menu Dolibarr.
Pour cela, il faut :
- aller à Accueil > Configuration > Menus
- choisir l'onglet "Edition menu"
- sélectionner "Tous" dans le combo "Gestionnaire de menu" et clicker sur Rafraichir
- Les entrées du menu gauche du module Pivot Reports sont alors visibles. Vous pouvez les réordonner en utilisant les petites flèches en fin de ligne de chaque entrée.