« Forecast/en » : différence entre les versions

De Documentations Patas-monkey
Aller à la navigation Aller à la recherche
Liam (discussion | contributions)
Page créée avec « ==Settings== The module is not configured from the native administration page, but from the forecast definition page in the patas-tools menu. ===Settings Menu=== »
Liam (discussion | contributions)
Page créée avec « {| class="wikitable" |- style="vertical-align:top;" | File:forecast_menu.png | The module is configured via a menu. The choices are as follows: * Forecast - menu title: Allows access to the forecasts as they were configured * New Forecast: Allows you to create a new forecast * List of Forecasts: Displays the list of defined forecasts and allows you to modify them * Import a Forecast: Allows you to retrieve a forecast exported in XML format |} »
Ligne 21 : Ligne 21 :
===Settings Menu===
===Settings Menu===


<div lang="fr" dir="ltr" class="mw-content-ltr">
{| class="wikitable"
{| class="wikitable"  
|- style="vertical-align:top;"
|- style="vertical-align:top;"  
| [[File:forecast_menu.png]]
| [[File:forecast_menu.png]]
| Le paramétrage du module s'effectue au travers d'un menu. Les choix sont les suivants :
| The module is configured via a menu. The choices are as follows:
* Forecast - titre du menu : permet l'accès aux forecast tel qu'ils ont été paramétré
* Forecast - menu title: Allows access to the forecasts as they were configured
* Nouveau Forecast : permet de créer un nouveau forecast
* New Forecast: Allows you to create a new forecast
* Liste des Forecast : Affiche la liste des forecast défini et permet de les modifier
* List of Forecasts: Displays the list of defined forecasts and allows you to modify them
* importer un Forcast : Permet de récupérer un forecast exporté au format XML
* Import a Forecast: Allows you to retrieve a forecast exported in XML format
|}
|}
</div>


<div lang="fr" dir="ltr" class="mw-content-ltr">
<div lang="fr" dir="ltr" class="mw-content-ltr">

Version du 28 mai 2025 à 14:48

This module allows you to define a forecast and track its objectives from Dolibarr.

Once the forecast is defined, you can track its progress using graphs.

Overview

The module allows you to define forecast values ​​over a period and track their evolution.

To do this, we define an SQL query to retrieve the actual values ​​and compare them to the forecast as time progresses.

It is finally possible to make a configurable monitoring page accessible (we select the tables and curves that we wish to display) from the Dolibarr menus.

Settings

The module is not configured from the native administration page, but from the forecast definition page in the patas-tools menu.

Settings Menu

The module is configured via a menu. The choices are as follows:
  • Forecast - menu title: Allows access to the forecasts as they were configured
  • New Forecast: Allows you to create a new forecast
  • List of Forecasts: Displays the list of defined forecasts and allows you to modify them
  • Import a Forecast: Allows you to retrieve a forecast exported in XML format

Fonctionnement

Création d'un nouveau Forecast

L'écran de création d'un nouveau Forecast est en deux parties

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
  • le champ date sur lequel on souhaite réaliser les plages de surveillance
  • le type de période que l'on veut souhaite afficher (jour, semaine, mois, trimestre, année)
  • la plage de date (début et fin) correspondant à la période que l'on souhaite surveiller.

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. L'exemple en dessous permet de suivre la création de nouveaux tiers.

Il le paramétrage de gauche permettra d'afficher le forecast dans le menu des tiers natifs.

La requete SQL sélectionne ici la liste des tiers. Le champs datec correspond ici à la date de création du tiers mais il en existe d'autres exploitable sur la table selon ses besoins (par exemple la mise à jour, ...) La période du 1er janvier au 31 décembre et le regroupement mensuel permettra d'avoir un suivit mensuel de l'avancement des objetif il sera possible d'afficher les valeurs de l'année précédente

Une fois l'écran validé, il est alors possible de générer les périodes selon ce qui a été défini. Il sera possible de sélectionner ou non l'affichage des valeurs de l'année précédente. Le bouton [Modifier les valeurs] en bas du tableau permet de saisir les valeurs que l'on souhaite en terme de prévisionnel

Saisie des valeurs prévisionnelles

Dans notre exemple, le nombre de nouveau tiers sera prévu de 2 chaque mois sauf en juillet aout. Il est aussi possible de saisir des informations complémentaires pour mémoire pour le prévisionnel Au fur et à mesure de l'avancement il sera aussi possible de saisir un commentaire sur la période réalisée.

Paramétrage d'affichage du Forecast

Une fois cette saisie réalisée, il sera possible de sélectionner les tableaux et les graphiques que l'on souhaite visualiser sur la page du forecast