Changes

#La section de paramétrage du module de paramétrage : Cette section affiche tous les paramètres du module obtenus à travers la fonction de composition. Le bouton '''RAFRAICHIR LA PAGE''' commun à tous les modules paramétrables, permet de rafraîchir la page sans s'y déplacer pour visualiser immédiatement les effets de modification d'un paramètre

#La section de paramétrage du module de paramétrage : Cette section affiche tous les paramètres du module obtenus à travers la fonction de composition. Le bouton '''RAFRAICHIR LA PAGE''' commun à tous les modules paramétrables, permet de rafraîchir la page sans s'y déplacer pour visualiser immédiatement les effets de modification d'un paramètre

=Théorie du paramétrage du logiciel :=

=Analyse du paramétrage logiciel dans Dolibarr :=

Pour bien comprendre les fonctions du module, il est nécessaire de connaitre quelques notions sur le paramétrage de logiciel en général, puis pourquoi et comment on a implémenté toute une méthodologie de paramétrage dans Dolibarr avec les bénéfices qu'elle apporte.

Pour bien comprendre les fonctions du module, il est nécessaire de connaitre quelques notions sur le paramétrage de logiciel en général, puis pourquoi et comment on a implémenté toute une méthodologie de paramétrage dans Dolibarr avec les bénéfices qu'elle apporte.

    1. Les paramètres base de données ( En majorité ) : Ce sont des paramètres  stockés dans la base de données dans le but de pouvoir être gérés comme n’importe quel autre type de données.  

    1. Les paramètres base de données ( En majorité ) : Ce sont des paramètres  stockés dans la base de données dans le but de pouvoir être gérés comme n’importe quel autre type de données.  

    2. Les paramètres fichiers : Il sont utilisés pour définir des paramètres qui dépendent de la plateforme ou qui définissent les paramètres d’accès à la base de données et ne peuvent donc pas être stockés en base de données.

    2. Les paramètres fichiers : Utilisés pour définir des paramètres qui dépendent de la plateforme ou qui définissent les paramètres d’accès à la base de données et ne peuvent donc pas être stockés en base de données.

    3. Les paramètres utilisateurs : Ce troisième type de paramètres concerne ceux qui sont spécifiques aux utilisateurs. Dans la plupart des applications, ces paramètres sont stockés au niveau du navigateur, dans les cookies ou dans sa base de données locale.

    3. Les paramètres utilisateurs : Ce troisième type de paramètres concerne ceux qui sont spécifiques aux utilisateurs. Dans la plupart des applications, ces paramètres sont stockés au niveau du navigateur, dans les cookies ou dans sa base de données locale.

====Les types de paramètres dans Dolibarr :====

====Les types de paramètres dans Dolibarr :====

Dans Dolibarr comme dans la plupart des applications web, les constantes base de données sont utilisées pour configurer les différentes options de l’application qui sont appelées à être modifiées au cours du sa mise en œuvre et sont stockées dans la table « llx_const ».

Dans Dolibarr, comme dans la plupart des applications web, les constantes base de données sont utilisées pour configurer les différentes options de l’application qui sont appelées à être modifiées au cours du sa mise en œuvre et sont stockées dans la table « llx_const ».

En plus de stocker les paramètres d’accès à la base de données, les constantes fichier sont utilisées pour référencer les chemins des différents sous-ensembles de l’application ainsi que le mode de fonctionnement (développement ou production). En un sens, les constantes fichiers concernent les paramètres à qui on affecte des valeurs une seule fois et ne sont pas destinés à être changés dans une installation.  

En plus de stocker les paramètres d’accès à la base de données, les constantes fichier sont utilisées pour référencer les chemins des différents sous-ensembles de l’application ainsi que le mode de fonctionnement (développement ou production). En un sens, les constantes fichiers concernent les paramètres à qui on affecte des valeurs une seule fois et ne sont pas destinés à être changés dans une installation.  

Pour les paramètres utilisateurs , Dolibarr on utilise une table spéciale « llx_user_param » pour enregistrer les données de l’utilisateur. Les cookies sont seulement utilisées pour identifier la session.

Pour les paramètres utilisateurs , on utilise dans Dolibarr une table spéciale « llx_user_param » pour enregistrer les données de l’utilisateur. Les cookies sont seulement utilisées pour identifier la session.

====Le concept de configuration au sens large :====

====Le concept de configuration au sens large :====

On désigne comme configuration au sens large, l’ensemble de tous les paramètres d’une application adaptés à une entreprise ou une activité determinée. Un ERP tel que Dolibarr pourrait par exemple être utilisé par une entreprise de commerce de détail ou par une entreprise de production avec deux configurations complètement différentes. Les deux entreprises peuvent utiliser des modules communs avec des paramètres communs ou de modules, spécifiques au type d’entreprise.  

On désigne comme configuration au sens large, l’ensemble de tous les paramètres d’une application adaptés à une entreprise ou une activité déterminée. Un ERP tel que Dolibarr pourrait par exemple être utilisé par une entreprise de commerce de détail ou par une entreprise de production avec deux configurations complètement différentes. Les deux entreprises peuvent utiliser des modules communs avec des paramètres communs ou de modules, spécifiques au type d’entreprise.  

De la on peut définir une configuration comme un ensembles de valeurs affectées à des paramètres. On peut utiliser une configuration pour enregistrer l’ensemble de valeurs de paramètres associés à chacun des deux types d’entreprises. Ceci inclut les modules activés, les valeurs de paramètres associés à chacun de ces modules ainsi que des valeurs associées à des paramètres de Dolibarr.

De la, on peut définir une configuration comme un ensemble de valeurs affectées à des paramètres. On peut utiliser une configuration pour enregistrer l’ensemble de valeurs de paramètres associés à chacun des deux types d’entreprises. Ceci inclut les modules activés, les valeurs de paramètres associés à chacun de ces modules ainsi que des valeurs associées à des paramètres de Dolibarr.

====Considérations pour le stockage des paramètres de configurations :====

====Considérations pour le stockage des paramètres de configurations :====

On peut stocker les paramètres qui définissent une configuration dans une table de la base de données ou bien dans un fichier. Bien que traditionnellement on préfère utiliser les constantes base de données pour stocker les paramètres de l’application, on distingue plusieurs avantages pour l’utilisation de fichiers à la place:  

On peut stocker les paramètres qui définissent une configuration dans une table de la base de données ou bien dans un fichier. Bien que traditionnellement on préfère utiliser les constantes base de données pour stocker les paramètres de l’application, on distingue plusieurs avantages pour l’utilisation de fichiers à la place:  

    1. Un fichier est plus facilement consultable qu’une table de base de données. Il peut même être consulté sans installation de Dolibarr.

# Un fichier est plus facilement consultable qu’une table de base de données. Il peut même être consulté sans installation de Dolibarr.

 

# Les modifications dans un fichier peuvent être gérées par un gestionnaire de versions tel que GIT. Dans le cas d’une table, Il faudra créer une table spéciale pour gérer l’historique avec le traitement qui s’ensuit.

   2. Les modifications dans un fichier peuvent être gérées par un gestionnaire de versions tel que GIT. Dans le cas d’une table, Il faudra créer une table spéciale pour gérer l’historique avec le traitement qui s’ensuit.

# Dans le cas de Dolibarr, il existe encore un troisième avantage, qui est celui de pouvoir définir des métadonnées en commentaires sur les paramètres au lieu d'utiliser les champs limités de la table llx_const. C'est ce qui a permis de définir plusieurs types de données  dans les fichiers de configurations de modules paramétrable (Voir ci dessous).

Il existe toutefois quelques inconvénients mineurs :

Il existe toutefois quelques inconvénients mineurs :

=Définition d’une solution de gestion de configurations dans Dolibarr :=

=Définition d’une solution de gestion de configurations dans Dolibarr :=

Dans le cas de Dolibarr, une configuration est un simple fichier php avec des directives define pour chaque paramètre. C’est l’exécution de ce fichier qui installe la configuration choisie. Ces paramètres peuvent être modifiés pour ajuster la configuration. On peut aussi créer de nouvelles configurations par modification de configurations préexistantes.

Dans le cas de Dolibarr, une configuration est un simple fichier php avec des directives '''define''' pour chaque paramètre de module paramétrable et une instruction du type $conf->global->XX=YY pour les paramètres base de données. C’est l’exécution de ce fichier qui définit la configuration choisie. Ces paramètres peuvent être modifiés pour ajuster la configuration. On peut aussi créer de nouvelles configurations par modification de configurations préexistantes.

=====Les modules paramétrables :=====

===Les modules paramétrables :===

Les modules paramétrables sont des modules conçus pour interagir efficacement avec le module de paramétrage. Leurs caractéristiques sont :

Les modules paramétrables sont des modules conçus pour interagir efficacement avec le module de paramétrage. Leurs caractéristiques sont :

    1. Tous les paramètres de ces modules sont stockés sur des fichiers.  

# Tous les paramètres de ces modules sont stockés sur un fichier de configuration.  

 

# Les paramètres sont consultables et modifiables dans la configuration du module.  

    2. Ils sont consultables et modifiables dans la configuration du module.

# On définit 3 types de paramètres : chaîne,intervalle et booléens.  

 

# Dans la page de configuration du module, on peut définir une ou plusieurs pages qui affichent une section de paramétrage pour changer les valeurs de paramètres à la volée.

    3. Dans la page de configuration du module, on peut définir une ou plusieurs pages qui afficheront une section de paramétrage pour changer les valeurs de paramètres à la volée.

# Chaque paramètre peut être configuré pour apparaître ou non dans les sections de paramétrage autres que la page de configuration du module.  

    4. On définit 3 type de paramètres : chaîne,intervalle et booléen

==== Exemple de contenu fichier de configuration ( Contenu du fichier de paramétrage du module Menupar ) : ====

=====Le module de paramétrage :=====

=====Le module de paramétrage :=====