openMairie Framework 4.9 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 50 applications développées pour les collectivités locales accessibles sur le site http://www.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 sur le forum du framework : https://communaute.openmairie.org/c/framework .
Nous avons conçu openMairie pour fabriquer une maquette grâce au générateur le plus en amont possible en s’appuyant sur le modèle de données et en intégrant des 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 tutoriel « 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 manuel d’usage complète l’exemple ci-dessus en vous décrivant le fonctionnement du framework : ergonomie, administration, génération, intégration, …
Le manuel de référence s’adresse plus aux utilisateurs confirmés en 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.
Un chapitre particulier est dédié aux tests et à l’intégration continue. Le framework openMairie possède des tests unitaires et fonctionnels joués intégralement à chaque modification du code source afin d’assurer sa stabilité et sa pérennité.
Un chapitre est consacré à l’historique des versions du framework et aux conseils pour les mises à niveau.
Ce document rassemble enfin 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.
Toutes les dernières infos sur le framework sont disponibles ici : http://www.openmairie.org/framework. Bonne lecture !
- Manuel d’usage
- 1. Ergonomie
- 1.1. Connexion, déconnexion
- 1.2. Ergonomie générale
- 1.3. Listings et Formulaires
- 1.4. Usage du module om_sig
- 1.4.1. Ergonomie de l’interface SIG interne:
- 1.4.2. les fonds :
- 1.4.3. les couches :
- 1.4.4. Information:
- 1.4.5. Boite à outils :
- 1.4.6. Mode édition :
- 1.4.7. Edition d’un point:
- 1.4.8. Edition d’un polygone:
- 1.4.8.1. Utilisation du panier pour construire une géométrie
- 1.4.8.2. Créer un polygone
- 1.4.8.3. Modifier un polygone sélectionné :
- 1.4.8.4. (Dé)selectionner une géométrie :
- 1.4.8.5. Supprimer un polygone selectionné :
- 1.4.8.6. Vérifier avant enregistrement d’un polygone:
- 1.4.8.7. Enregistrer un polygone :
- 1.4.9. Modification d’un ligne :
- 1.4.9.1. Utilisation du panier pour construire une géométrie
- 1.4.9.2. Créer une ligne :
- 1.4.9.3. Modifier une ligne sélectionnée :
- 1.4.9.4. (Dé)selectionner une géométrie :
- 1.4.9.5. Supprimer une ligne selectionnée :
- 1.4.9.6. Vérifier avant enregistrement d’une ligne:
- 1.4.9.7. Enregistrer une ligne :
- 2. Administration
- 3. Génération
- 3.1. Introduction
- 3.2. L’interface
- 3.3. Conditions de génération
- 3.4. Définition des modèles de données
- 3.5. Fonctionnalités avancées
- 3.6. L’analyse de la base
- 3.7. Les fichiers générés
- 3.8. Paramétrage générateur
- 4. Intégration
- 5. Pour aller plus loin…
- 1. Ergonomie
- Manuel de référence
- 1. Arborescence
- 2. Initialisation de la base de données
- 3. Paramétrage du framework
- 3.1. Introduction
- 3.2. Les scripts de paramétrage
- 3.3. Le serveur d’envoi de mail
- 3.4. L’annuaire LDAP
- 3.5. Les zones de navigation
- 3.6. Les variables locales et la langue
- 3.7. Le paramétrage de l application metier
- 3.7.1. Le nom de l’application
- 3.7.2. Le titre HTML de l’application
- 3.7.3. Le nom de la session
- 3.7.4. Le mode démonstration
- 3.7.5. La redéfinition du mot de passe oublié par l’utilisateur
- 3.7.6. Le nombre de colonnes du tableau de bord
- 3.7.7. Le favicon de l’application
- 3.7.8. Le mode de gestion des permissions
- 3.7.9. La valeur par défaut lorsqu’une permission n’existe pas
- 3.7.10. Les extensions de fichiers autorisées
- 3.7.11. La taille maximale de fichiers autorisée
- 3.8. Le Parametrage des librairies
- 3.9. Le mode DEBUG
- 3.10. La version de votre application
- 3.11. Les informations generales
- 3.12. L’installation automatique
- 3.13. Les paramétres des combos
- 3.14. Les paramétres éditions
- 3.15. Les paramétres om_sig
- 4. La gestion des accès
- 5. Le tableau de bord
- 6. Les listings
- 7. Les formulaires
- 7.1. Introduction
- 7.2. Les éléments form et sousform
- 7.3. Configuration via le script
sql/pgsql/<OBJ>.inc.php
- 7.4. Configuration via le script
sql/pgsql/<OBJ>.form.inc.php
- 7.5. Les fonctions
- 7.6. Actions du menu contextuel de la consultation
- 7.7. Description de la classe
dbform
- 7.8. Description de la classe formulaire
- 7.9. Custom de l’application
- 7.10. Les composants
- 8. Module “Édition”
- 8.1. Introduction
- 8.2. Les états et lettres types
- 8.2.1. Paramétrer des états
- 8.2.2. Paramétrer des lettres-type
- 8.2.3. Actif, non actif
- 8.2.4. Les requêtes
- 8.2.5. Les sous-états
- 8.2.6. Les champs de fusion
- 8.2.7. Les variables de remplacement
- 8.2.8. Les logos
- 8.2.9. L’éditeur WYSIWYG
- 8.2.10. Les anciens fichiers de paramétrage
- 8.2.11. La prévisualisation
- 8.3. Les listings
- 8.4. Les étiquettes
- 8.5. Composants
- 9. Module “Import”
- 10. Module “Reqmo”
- 11. Module “MAP”/”SIG”
- 12. Abstraction du “layout” (ergonomie)
- 13. Abstraction du “filestorage” (stockage des fichiers)
- 13.1. Principe général
- 13.2. Fonctionnement
- 13.2.1. Description de l’abstracteur
- 13.2.2. Description du fichier de configuration
- 13.2.3. Description des méthodes de la classe filestorage
- 13.2.4. Description du connecteur depredacted
- 13.2.5. Description du connecteur filesystem
- 13.2.6. Description du connecteur filetransferprotocol
- 13.2.7. Description du connecteur alfresco
- 13.3. Utilisation
- Tests et Intégration Continue
- Tests
- Pré-requis
- Installation
- arborescence du répertoire tests
- tests/config.xml
- tests/pip-requirements.txt
- tests/000_generation.robot
- tests/000_test_unitaire.php
- tests/doc/
- tests/results/
- tests/binary_files/
- tests/resources/
- tests/resources/resources.robot
- tests/resources/om-tests.cfg
- tests/resources/app/
- tests/resources/app/gen/
- tests/resources/app/keywords.robot
- Fonctionnement et Utilisation
- Développement et bonnes pratiques
- Intégration continue
- Tests
Contributeurs¶
(par ordre alphabétique)
- APITUX
- atReal
- Alain Baldachino
- Jean Christophe Becquet
- Thierry Benita
- Romain Beylerian
- Matthias Broquet
- Laurent Groleau
- Victor Grousset
- Nicolas Haye
- Jean-Yves Madier de Champvermeil
- Nicolas Meucci
- Florent Michon
- Virginie Pihour
- Francois Raynaud
- Sofien Timezouaght