Forecast : Différence entre versions

De Documentations Patas-monkey
Sauter à la navigation Sauter à la recherche
(Page créée avec « {| class="wikitable" |- style="vertical-align:top;" | File:customtooltip_250x250.png | Ce module customTooltip permet de personnaliser le contenu des tooltips de Dol… »)
 
 
(6 révisions intermédiaires par le même utilisateur non affichées)
Ligne 1 : Ligne 1 :
 
{| class="wikitable"  
 
{| class="wikitable"  
 
|- style="vertical-align:top;"  
 
|- style="vertical-align:top;"  
| [[File:customtooltip_250x250.png]]
+
| [[File:forecast_250x250.png]]
| Ce module customTooltip permet de personnaliser le contenu des tooltips de Dolibarr.
+
| Ce module permet de définir un prévisionnel et de suivre ses objectifs depuis Dolibarr.
 +
Une fois le prévisionnel défini, il est possible de suivre son avancement grâce à des graphiques.
  
La durée d'affichage donne le temps de cliquer sur les liens contenus dans les customTooltips.
 
 
|}
 
|}
  
 
==Présentation==
 
==Présentation==
Le module permets ma personnalisation du contenu des Tootltips et de leur durée d'affichage
+
Le module permet de définir sur une période des valeurs prévisionnelles et de suivre leur évolution.
  
Les customTooltips sont actifs sur les liens vers :
+
Pour cela on défini une requête SQL permettant de récupérer les valeurs réelles et les comparer au prévisionnel au fur et à mesure de l'avancement du temps.
*les tiers
 
*les contacts
 
*les adhérents
 
*les produits et les services
 
*les événements de l'agenda
 
  
[[file:customtooltip_Resultat.png|600px]]
+
Il est enfin possible de rendre accessible une page de suivi paramétrable (on sélectionne les tableaux et les courbes que l'on souhaite afficher) depuis les menus de Dolibarr.
  
Les customTooltips peuvent afficher différentes informations selon les paramétrages appliqués :
+
[[file:forecast-page.png| 600px]]
*Champs supplémentaires des fiches
 
*État des stocks pour les produits
 
*En-cours et limite de facturation des tiers
 
  
 
==Paramétrage==
 
==Paramétrage==
 
===Configuration des fonctionnalités du module===
 
===Configuration des fonctionnalités du module===
La configuration du module s'effectue depuis la page d'administration des modules accessible par les menus '''Accueil > Configuration > Modules''' en cliquant sur l'icône [[file:doli-setup.png]] ou [[file:doli-setup-old.png]] en bout de ligne.
+
Il n'y a pas de configuration du module, depuis la page d'administration native, mais depuis la page de définition du forecast
 
 
[[file:customtooltip_Configuration.png|600px]]
 
 
 
Les lignes du tableau vous permettent d'activer ou non, dans les customTooltips, l'affichage des données présentes dans les champs supplémentaires créés dans les modules relatifs à l'élément source des customTooltips, l'état des stocks pour les produits et l'en-cours de facturation des tiers.
 
===Permissions===
 
CustomTooltip n'ajoute pas de permissions aux utilisateurs. Les données qui leur sont visibles sont gérées par les permissions utilisateurs et groupes des autres modules.
 
  
 
==Fonctionnement==
 
==Fonctionnement==
===Persistance d'affichage===
+
=== Création d'un nouveau Forecast ===
Une fois la durée de l'affichage des customTooltips enregistrée, au passage de votre pointeur sur les noms ou libellés des tiers, contacts, adhérents, produits/services et événements de l'agenda, vous obtiendriez :
+
L'écran de création d'un nouveau Forecast est en deux partie
 
+
La première partie (à droite) permet de définir la page de présentation du forecast :
[[file:customtooltip_Resultat.png|600px]]
+
* son titre
 
+
* sa position dans ou non dans un menu
{{Note|Contrairement aux tooltips natifs, la durée de persistance des customTooltips vous laisse le temps de cliquer sur les liens}}
+
* les droits d'accès...
 
 
Au lieu de :
 
 
 
[[file:customtooltip_Tootip_natif.png|600px]]
 
 
 
{{Note|Le tootlip disparaît dès que votre pointeur quitte le lien de l'élément}}
 
  
===Affichage des champs supplémentaires===
+
La seconde partie correspond aux éléments de données du forecast
Les champs supplémentaires créés sur les fiches de vos éléments s'affichent sur les customTooltips :
+
* une requête SQL permettant de suivre les objectifs réels que l'on souhaite surveiller
[[file:Customtooltip_champ_supp.png|600px]]
+
* une plage de date (début et fin) correspondant à la période que l'on souhaite surveiller
 +
* le champ de type date sur lequel on souhaite réaliser la surveillance
 +
* le type de période que l'on veut souhaite afficher (jour, semaine, mois, trimestre, année)
  
===Affichage des stocks des produits===
+
Il est donc nécessaire d'avoir une bonne connaissance de la structure des tables de Dolibarr (ou de se rapprocher d'une personne ou société ayant cette expertise)
Le customTooltip affichera la liste des entrepôts qui contiennent le produits et la quantités présentes pour chacun. Si un produit est en quantité nulle dans un entrepôt, ce dernier ne sera pas affiché.
 
  
[[file:Customtooltip_produit.png|600px]]
+
Attention, pour bypasser la protection contre l'injection SQL, il convient de remplacer le mot SELECT dans votre requête SQL par #SEL#
  
{{Note|La durée de persistance des customTooltips vous laisse le temps de cliquer sur les liens. Dans le cas des tooltips de produits, vous pourrez accéder à la fiche des entrepôts contenant le produit}}
+
Une fois cet écran validé, on arrive sur le forecast à l'état brouillon
  
===Affichage de l'en-cours de facturation des tiers===
+
=== Ecran de modification du Forecast ===
L'en-cours de facturation et la limité saisie sur la fiche du tiers peuvent apparaître sur les customTooltip des tiers :
+
Il est possible de modifier les valeurs saisies précédemment et préciser si l'on souhaite afficher les valeurs  de la période précédente
  
[[file:Customtooltip_encours_facturation.png|600px]]
+
Par exemple sur une plage du 1er janvier au 31 décembre de l'année en cours, on affichera aussi les données de l'année précédence

Version actuelle datée du 12 novembre 2023 à 17:51

Forecast 250x250.png Ce module permet de définir un prévisionnel et de suivre ses objectifs depuis Dolibarr.

Une fois le prévisionnel défini, il est possible de suivre son avancement grâce à des graphiques.

Présentation

Le module permet de définir sur une période des valeurs prévisionnelles et de suivre leur évolution.

Pour cela on défini une requête SQL permettant de récupérer les valeurs réelles et les comparer au prévisionnel au fur et à mesure de l'avancement du temps.

Il est enfin possible de rendre accessible une page de suivi paramétrable (on sélectionne les tableaux et les courbes que l'on souhaite afficher) depuis les menus de Dolibarr.

Forecast-page.png

Paramétrage

Configuration des fonctionnalités du module

Il n'y a pas de configuration du module, depuis la page d'administration native, mais depuis la page de définition du forecast

Fonctionnement

Création d'un nouveau Forecast

L'écran de création d'un nouveau Forecast est en deux partie La première partie (à droite) permet de définir la page de présentation du forecast :

  • son titre
  • sa position dans ou non dans un menu
  • les droits d'accès...

La seconde partie correspond aux éléments de données du forecast

  • une requête SQL permettant de suivre les objectifs réels que l'on souhaite surveiller
  • une plage de date (début et fin) correspondant à la période que l'on souhaite surveiller
  • le champ de type date sur lequel on souhaite réaliser la surveillance
  • le type de période que l'on veut souhaite afficher (jour, semaine, mois, trimestre, année)

Il est donc nécessaire d'avoir une bonne connaissance de la structure des tables de Dolibarr (ou de se rapprocher d'une personne ou société ayant cette expertise)

Attention, pour bypasser la protection contre l'injection SQL, il convient de remplacer le mot SELECT dans votre requête SQL par #SEL#

Une fois cet écran validé, on arrive sur le forecast à l'état brouillon

Ecran de modification du Forecast

Il est possible de modifier les valeurs saisies précédemment et préciser si l'on souhaite afficher les valeurs de la période précédente

Par exemple sur une plage du 1er janvier au 31 décembre de l'année en cours, on affichera aussi les données de l'année précédence