204
edits
Changes
Jump to navigation
Jump to search
Line 17:
Line 17: − + Line 43:
Line 43: − + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
no edit summary
=Prérequis=
=Prérequis=
Dolibarr 10.0.x
Dolibarr 10.0.x
=Résumé =
=Résumé=
Le module de paramétrage est le point d'arrivée de tous les modules paramétrables de Dolipar.org que sont les modules Cashdeskpar et Menupar. Les modules Facturepar et Corepar ont disparu au profit de ce module qui permet de créer à la volée toutes leurs fonctionnalités et plus.
Le module de paramétrage est le point d'arrivée de tous les modules paramétrables de Dolipar.org que sont les modules Cashdeskpar et Menupar. Les modules Facturepar et Corepar ont disparu au profit de ce module qui permet de créer à la volée toutes leurs fonctionnalités et plus.
=Installation=
=Installation=
##Le bouton de sauvegarde de configurations : Permet de sauvegarder la configuration actuelle dans un fichier. Il faut fournir un nom de fichier avant d'appuyer sur le bouton '''enregistrer'''.
##Le bouton de sauvegarde de configurations : Permet de sauvegarder la configuration actuelle dans un fichier. Il faut fournir un nom de fichier avant d'appuyer sur le bouton '''enregistrer'''.
##Le bouton de suppression de configurations : Permet de supprimer des fichiers de configuration préalablement enregistrés.
##Le bouton de suppression de configurations : Permet de supprimer des fichiers de configuration préalablement enregistrés.
#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.
#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 : ==
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 types de paramètres du logiciel: ====
Par convention dans les solutions logicielles web, on utilise trois types de paramètres :
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.
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.
==== 2 - 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 ».
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.
==== 3 - 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.
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.
==== 4 - 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:
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.
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.
Il existe toutefois quelques inconvénients mineurs :
1. Les requêtes SQL sont très utiles pour faire des consultations complexes. Un effort de programmation plus important est nécessaire pour faire des recherches complexes dans des fichiers texte.
== 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.
===== 1- 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 :
1. Tous les paramètres de ces modules sont stockés sur des fichiers.
2. Ils sont consultables et modifiables dans la configuration du module.
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.
4. On définit 3 type de paramètres : chaîne,intervalle et booléen
5. 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.
===== 2 - Le module de paramétrage : =====
Ses tâches essentielles sont :
1. La recomposition de la configuration actuelle par chargement de paramètres de la base de données et de fichiers de configuration de modules paramétrables.
2. La modification des valeurs des paramètres actuels.
3. La sauvegarde et restauration de configurations.
4. L’inclusion de sections de paramétrage adaptées à des pages spécifiques.
== La composition de configurations : ==
<br />