openMairie Framework 4.2 documentation¶
Note
Cette création est mise à disposition selon le Contrat Paternité-Partage des Conditions Initiales à l’Identique 2.0 France disponible en ligne http://creativecommons.org/licenses/by-sa/2.0/fr/ ou par courrier postal à Creative Commons, 171 Second Street, Suite 300, San Francisco, California 94105, USA.
Ce document a pour but de guider les développeurs dans la mise en œuvre d’un projet openMairie.
Avec plus de 30 applications développées pour les collectivités locales accessibles sur le site http://openmairie.org, nous souhaitons au travers de ce guide , diffuser notre expérience auprès des collectivités et des acteurs économiques du libre qui les accompagnent.
C’est donc une méthode conçue au fur à mesure de nos développements que nous vous proposons de partager et toutes remarques sont les bienvenues, alors n’hésitez pas à nous en faire part à l’adresse mail suivante : contact@openmairie.org
Nous avons conçu openMairie pour fabriquer une maquette le plus en amont possible en s’appuyant sur le modèle de données créé dans la base de données et en intégrant les composants standards du « monde libre ».
Cette maquette permet très rapidement d’engager un dialogue participatif avec les utilisateurs, de concentrer le développeur uniquement sur le « métier » et de faire valider par l’utilisateur les évolutions successives.
Si vous débutez, il est préférable de commencer par le chapitre « créer une application » qui permet de prendre en main facilement le générateur et le framework openMairie en vous guidant pas à pas dans le mise en place d’une gestion de courrier.
Le chapitre sur le « framework » complète l’exemple ci dessus en vous décrivant le paramètrage, les classes formulaires et éditions du framework. Il a pour but de vous informer de manière complète sur le fonctionnement du framework
Le chapitre consacré au « générateur » décrit dans le détail le fonctionnement de cet outil et de ses assistants. Cet outil permet de fabriquer la maquette.
La version 4.1.0 permet de construire des applications composites (ou mash up) en intégrant des contenus venant d’application externes. Cela permet de construire rapidemment une application à faible coût grâce à la fusion de multiple service internet
Le chapitre consacré a l” « information geographique » décrit dans le détail le fonctionnement SIG interne d’openMairie combinant les API d’internet avec le framework. (La version 4.2.0 améliore l’interface avec l’intégration de web service)
Le chapitre sur les widgets décrit le tableau de bord paramétrable et individualisé par l’utilisateur permettant l’accès à tout type de fonctions internes ou externes.
Enfin ce document rassemble toutes les règles de codage du projet openMairie, ainsi que des outils pour aider et guider les développeurs de la communauté.
Les règles indiquées doivent être appliquées pour qu’un projet puisse intégrer la distribution openMairie car l’objectif est de faciliter la lisibilité et la maintenance du code ainsi que la prise en main par les collectivités.
Bonne lecture !
Créer une application¶
Le framework¶
- Paramétrage du framework
- La connexion de la base de donnees
- Le menu principal
- Le menu haut
- Le tableau de bord
- Les variables locales et la langue
- Le paramétrage de l application metier
- Le Parametrage des librairies
- Le mode debug
- La version de votre application
- Les informations generales
- L’installation automatique
- Les paramétres des combos
- Les paramétres éditions
- Les paramétres om_sig
- Afficher les tables
- Les formulaires
- La méthode
- Les éditions
- Les requêtes memorisées
- La gestion des accès
- L’ergonomie
- Les scripts specifiques de l’application
- Importer des données en csv
Le générateur¶
L’information geographique¶
Le tableau de bord et les widgets¶
Règles et outils¶
- Les règles de codage
- Le versionning du code et la version des applications
- Les outils du développeur