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

De Documentations Patas-monkey
Aller à la navigation Aller à la recherche
Liam (discussion | contributions)
Bureaucrates
3 506 modifications
Page créée avec « Forecast »
 
Liam (discussion | contributions)
Bureaucrates
3 506 modifications
Aucun résumé des modifications
 
(41 versions intermédiaires par 2 utilisateurs non affichées)
Ligne 1 : Ligne 1 :
<languages/>
<languages/>
<div lang="fr" dir="ltr" class="mw-content-ltr">
{| class="wikitable"
{| class="wikitable"  
|- style="vertical-align:top;"
|- style="vertical-align:top;"  
| [[File:forecast_250x250.png]]
| [[File:forecast_250x250.png]]
| Ce module permet de définir un prévisionnel et de suivre ses objectifs depuis Dolibarr.
| This module allows you to define a forecast and track its objectives from Dolibarr.
Une fois le prévisionnel défini, il est possible de suivre son avancement grâce à des graphiques.
Once the forecast is defined, you can track its progress using graphs.
</div>


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


<div lang="fr" dir="ltr" class="mw-content-ltr">
==Overview==
==Présentation==
The module allows you to define forecast values ​​over a period and track their evolution.
Le module permet de définir sur une période des valeurs prévisionnelles et de suivre leur évolution.
</div>


<div lang="fr" dir="ltr" class="mw-content-ltr">
[[File:forecast-page_en.png|800px]]
[[File:forecast-page.png|800px]]
</div>


<div lang="fr" dir="ltr" class="mw-content-ltr">
To do this, we define an SQL query to retrieve the actual values ​​and compare them to the forecast as time progresses.
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.
</div>


<div lang="fr" dir="ltr" class="mw-content-ltr">
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.
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.
</div>


<div lang="fr" dir="ltr" class="mw-content-ltr">
==Settings==
==Paramétrage==
The module is not configured from the native administration page, but from the forecast definition page in the patas-tools menu.
Il n'y a pas de configuration du module, depuis la page d'administration native, mais depuis la page de définition du forecast dans le menu patas-tools
===Settings Menu===
===Menu de paramétrage===
</div>


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


<div lang="fr" dir="ltr" class="mw-content-ltr">
==How It Works==
==Fonctionnement==
=== Creating a New Forecast ===
=== Création d'un nouveau Forecast ===
The screen for creating a new Forecast is divided into two parts:
L'écran de création d'un nouveau Forecast est en deux parties
 
[[File:forecast-new.png|900px]]
[[File:forecast-new.png|900px]]
{| class="wikitable"  
{| class="wikitable"
|- style="vertical-align:top;"  
|- style="vertical-align:top;"
|  
|
La première partie (à droite) permet de définir la page de présentation du forecast :
The first section (on the right) allows you to define the forecast's presentation page:
* son titre
* its title
* sa position dans ou non dans un menu
* its position in a menu (or not)
* les droits d'accès...
* access rights...
</div>


<div lang="fr" dir="ltr" class="mw-content-ltr">
|
|  
The second part corresponds to the forecast data elements.
La seconde partie correspond aux éléments de données du forecast
* an SQL query to track the actual targets you wish to monitor.
* une requête SQL permettant de suivre les objectifs réels que l'on souhaite surveiller
* the date field over which you wish to perform the monitoring periods.
* le champ date sur lequel on souhaite réaliser les plages de surveillance
* the type of period you wish to display (day, week, month, quarter, year).
* le type de période que l'on veut souhaite afficher (jour, semaine, mois, trimestre, année)
* the date range (start and end) corresponding to the period you wish to monitor.
* la plage de date (début et fin) correspondant à la période que l'on souhaite surveiller.
</div>


<div lang="fr" dir="ltr" class="mw-content-ltr">
|}
|}
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)
It is therefore necessary to have a good understanding of the structure of Dolibarr tables (or to contact a person or company with this expertise).
</div>


<div lang="fr" dir="ltr" class="mw-content-ltr">
Please note, to bypass SQL injection protection, you should replace the word SELECT in your SQL query with #SEL#
Attention, pour bypasser la protection contre l'injection SQL, il convient de remplacer le mot SELECT dans votre requête SQL par #SEL#
</div>


<div lang="fr" dir="ltr" class="mw-content-ltr">
Once this screen is validated, we arrive at the forecast in draft state
Une fois cet écran validé, on arrive sur le forecast à l'état brouillon
</div>


<div lang="fr" dir="ltr" class="mw-content-ltr">
=== Forecast Edit Screen ===
=== Ecran de modification du Forecast ===
You can modify the values ​​previously entered and specify whether you want to display the values ​​from the previous period. The example below shows the creation of new groups.
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.
</div>


<div lang="fr" dir="ltr" class="mw-content-ltr">
[[File:forecast-edit_en.png|900px]]
[[File:forecast-edit.png|900px]]
{| class="wikitable"
{| class="wikitable"  
|- style="vertical-align:top;"
|- style="vertical-align:top;"  
|
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.
The left-hand setting will display the forecast in the native third-party menu.
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
The SQL query here selects the list of third-party data.
il sera possible d'afficher les valeurs de l'année précédente
The datec field here corresponds to the creation date of the third-party, but there are others that can be used in the table according to needs (e.g., update, etc.).
The period from January 1st to December 31st and the monthly grouping will allow for monthly tracking of the progress of objectives.
It will be possible to display the values ​​from the previous year.
|}
|}
</div>


<div lang="fr" dir="ltr" class="mw-content-ltr">
Once the screen is validated, it is then possible to generate the periods according to the definitions. You will be able to select whether or not to display the previous year's values.
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.
[[File:forecast-generate.png|900px]]
[[File:forecast-generate.png|900px]]
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===
The [Edit Values] button at the bottom of the table allows you to enter the desired forecast values.
Dans notre exemple, le nombre de nouveau tiers sera prévu de 2 chaque mois sauf en juillet aout.
=== Entering Forecast Values ===
Il est aussi possible de saisir des informations complémentaires pour mémoire pour le prévisionnel
In our example, the number of new thirds will be forecasted at 2 each month except July and August.
Au fur et à mesure de l'avancement il sera aussi possible de saisir un commentaire sur la période réalisée.
You can also enter additional information for the forecast as a reminder.
As the forecast progresses, you can also enter a comment on the period covered.
 
[[File:forecast-prevision.png|900px]]
[[File:forecast-prevision.png|900px]]
== Paramétrage d'affichage du Forecast==
</div>


<div lang="fr" dir="ltr" class="mw-content-ltr">
<span id="Exemples_de_forecast"></span>
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
== Forecast Examples ==
</div>
 
=== Billing Tracking ===
#SEL# sum(total_ht) from llx_facture
 
[[File:forecast-suivis-facturation-ex-graph&table_en.png|900px]]
 
<span id="Suivit_des_Encaissements_(et/ou_dépenses)"></span>
=== Tracking Receipts (and/or Expenses) ===
 
#SEL# sum(amount) as tt from llx_bank where amount > 0 and fk_account = 1
 
[[File:forecast-suivis-encaissement-ex-graph&table_en.png|900px]]
 
<span id="Paramétrages_d&#039;affichage_du_Forecast"></span>
== Forecast Display Settings ==
 
Once this entry is made, it will be possible to select the tables and graphs that you wish to view on the forecast page.
 
[[File:forecast-para-affichage-graph&table_en.png|900px]]
 
==Correlation Chart (Optional)==
When creating a Forecast sheet, you will be asked to select an SQL query corresponding to the information you wish to display.
 
A new tab is also available only when editing a forecast sheet: it allows you to define a correlation SQL query.
This secondary query allows you to add an additional curve to the charts, to correlate the data displayed by the main query (SQL query from the list) with the data from this new query.
 
[[File:forecast-sql-correlation_en.png|900px]]
 
[[File:forecast-graph-correlation_en.png|900px]]

Dernière version du 23 juillet 2025 à 16:14

Autres langues :
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

How It Works

Creating a New Forecast

The screen for creating a new Forecast is divided into two parts:

The first section (on the right) allows you to define the forecast's presentation page:

  • its title
  • its position in a menu (or not)
  • access rights...

The second part corresponds to the forecast data elements.

  • an SQL query to track the actual targets you wish to monitor.
  • the date field over which you wish to perform the monitoring periods.
  • the type of period you wish to display (day, week, month, quarter, year).
  • the date range (start and end) corresponding to the period you wish to monitor.

It is therefore necessary to have a good understanding of the structure of Dolibarr tables (or to contact a person or company with this expertise).

Please note, to bypass SQL injection protection, you should replace the word SELECT in your SQL query with #SEL#

Once this screen is validated, we arrive at the forecast in draft state

Forecast Edit Screen

You can modify the values ​​previously entered and specify whether you want to display the values ​​from the previous period. The example below shows the creation of new groups.

The left-hand setting will display the forecast in the native third-party menu.

The SQL query here selects the list of third-party data. The datec field here corresponds to the creation date of the third-party, but there are others that can be used in the table according to needs (e.g., update, etc.). The period from January 1st to December 31st and the monthly grouping will allow for monthly tracking of the progress of objectives. It will be possible to display the values ​​from the previous year.

Once the screen is validated, it is then possible to generate the periods according to the definitions. You will be able to select whether or not to display the previous year's values.

The [Edit Values] button at the bottom of the table allows you to enter the desired forecast values.

Entering Forecast Values

In our example, the number of new thirds will be forecasted at 2 each month except July and August. You can also enter additional information for the forecast as a reminder. As the forecast progresses, you can also enter a comment on the period covered.

Forecast Examples

Billing Tracking

  1. SEL# sum(total_ht) from llx_facture

Tracking Receipts (and/or Expenses)

  1. SEL# sum(amount) as tt from llx_bank where amount > 0 and fk_account = 1

Forecast Display Settings

Once this entry is made, it will be possible to select the tables and graphs that you wish to view on the forecast page.

Correlation Chart (Optional)

When creating a Forecast sheet, you will be asked to select an SQL query corresponding to the information you wish to display.

A new tab is also available only when editing a forecast sheet: it allows you to define a correlation SQL query. This secondary query allows you to add an additional curve to the charts, to correlate the data displayed by the main query (SQL query from the list) with the data from this new query.

Récupérée de « https://wiki.patas-monkey.com/index.php?title=Forecast/en&oldid=6618 »