openTaxePub 1.0 Documentation¶
Créé dans le cadre de la mise en oeuvre du SIG communautaire de l’ACCM (Arles camargue crau montagnette) openTaxePub a pour but de gérer les taxes sur la publicité http://www.openmairie.org/catalogue/opentaxepub
Ce document a pour but de guider les développeurs et les utilisateurs dans la prise en main du projet.
Il est proposé un premier chapitre permettant la prise en main d’openTaxePub.
Dans un deuxieme chapitre, il est proposé de décrire le paramètrage de l’application afin de personnaliser votre application openTaxePub et l’adapter à votre organisation.
Le troisième chapitre décrit les traitements spécifiques à openTaxePub.
Enfin le quatriéme chapître est consacré aux principes d’intégration avec d’autres applications afin de constituer des applications composites (mashup) :
- intégration dans le SIG en utilisant les API google, API bing, API osm,
- integration par l’intermédiaire de vue depuis le SIG
- intégration avec le logiciel de comptabilité sédit
Bonne lecture et n’hésitez pas à venir discuter du projet avec la communauté à l’adresse suivante : https://communaute.openmairie.org/c/autres-applications-openmairie/opentaxepub
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.
Utilisation¶
Nous vous proposons dans ce chapitre d’utiliser openTaxePub après avoir décrit les principes de l’application.
Les principes¶
openTaxePub a pour but de gérer les taxes sur les publicités d’une collectivité.
Les principes sont les suivants :
- les entreprises sont gérées dans la table « entreprise »
- les sites sont gérés dans la table « site »
- les dispositifs publicitaires sont gérés dans la table « dispositif »
- il peut être saisi un ou plusieurs sites pour une entreprise (lien relationnel)
- il peut être saisi un ou plusieurs dispositifs publicitaires pour un site (lien relationnel)
Les tables contenant des objets graphiques peuvent être remplacés par des vues (voir integration) sur un sig.
Pour calculer les taxes sur la publicité il faut donc ajouter des dispositifs qui sont crée dans des sites qui appartiennent a une entreprise.
Nous vous proposons maintenant d’utiliser openTaxePub :
- de saisir une entreprise, un site et un dispositif
- géolocaliser : l’entreprise et le site
- associer des photos a un site et/ou a un dispositif
Saisir une entreprise¶
Il est proposé de décrire dans ce paragraphe la saisie de l’entreprise :
Les entreprises sont listées dans « application -> entreprise »
Il est possible de creer ou modifier une entreprise dans le formulaire ci dessous
Il est saisie :
- la raison sociale (obligatoire)
- Un N° Siret
- Un code tiers (obligatoire pour envoyer sur sédit)
- l’adresse de l’entreprise (seul le numéro de rue et la voie sont nécéssaire a la géolocalisation -> voir paragraphe intégration/géolocalisation)
- une adresse de contact (mail,téléphone,fax)
- l’exploitant (civilité, nom, prénom)
- le statut de l’entreprise (Annonceur, Operateur, Enseigne, Préenseigne)
et les onglets d’entreprise
onglet site (voir paragraphe utilisation/site)
onglet dispositif en lecture seule(voir paragraphe utilisation/dispositif)
onglet facture (voir paragraphe traitement/facture)
La géolocalisation des entreprises, on y accède en cliquant sur le « globe terrestre » depuis la liste des entreprises
Saisir un site¶
Il est proposé de décrire dans ce paragraphe la saisie de site dans l’onglet « site » :
Il est possible de creer ou modifier un site dans le formulaire ci dessous
Il est saisie :
- la raison sociale de l’entreprise a laquelle le site appartient (l’entreprise doit avoir été insérée précédemment). On peut choisir l’entreprise soit dans la liste déroulante, soit en rentrant le nom ou une partie du nom de l’entreprise dans le champ juste dessous puis de cliquer sur la flèche
- des observations sur le site
- l’adresse du site pour pouvoir le géolocaliser (voir paragraphe intégration/géolocalisation)
- une photo du site
et l’onglet dispositif (voir paragraphe utilisation/dispositif)
La géolocalisation des sites, on y accède en cliquant sur le « globe terrestre » depuis la liste des sites
Saisir un dispositif¶
Il est proposé de décrire dans ce paragraphe la saisie d’un dispositif.
Les dispositifs sont accessibles en création/modification dans l’onglet « dispositif » de « site » :
Il est possible de creer ou modifier un dispositif dans le formulaire ci dessous
Il est saisie :
- la catégorie du dispositif (obligatoire)
- le modèle
- le type de dispositif
- une case a cocher qui définit si le dispositif est numérique (ce qui se répercutera sur la taxe)
- les dimensions horizontales et verticales en cm
- le nombre de panneau publicitaire
- la surface en m² qui est calculée automatiquement
- une photo du dispositif
- une date de début et de fin
- le nombre de mois ou le dispositif est affiché si le dispositif est temporaire
Parametrage¶
Nous vous proposons dans ce chapitre de modifier le parametrage par défaut.
Le paramétrage de base est disponnible dans data/pgsql/parametrage.sql
Saisir une catégorie¶
Il est proposé de décrire dans ce paragraphe la saisie d’une catégorie.
Une catégorie est composé d’une abréviation et d’un libellé.
Il existe par défaut 3 catégorie :
- enseigne
- pré-enseigne
- publicité
Ces catégorie sont utilisés pour décrire un dispositif ce qui permet de lui appliquer la taxe correspondante.
Les catégories sont listées dans l’option catégorie du menu paramétrage
Il est possible de creer ou modifier une catégorie dans le formulaire ci dessous
Les onglets site et type_dispositif listent les sites et type de dispositif se rapportant a la catégorie selectionnée
Saisir un modèle¶
Il est proposé de décrire dans ce paragraphe la saisie d’un modèle dans le menu paramétrage.
Les modèles sont listées dans l’option modèle du menu paramétrage
Il est possible de creer ou modifier un modèle dans le formulaire ci dessous
Il est saisie :
- l’abréviation du modèle
- le libellé
- un coefficient (inutile pour le moment)
L’onglet dispositif permet de visualiser les dispositifs publicitaires correspondants au modèle selectioné.
Saisir une règle¶
Il est proposé de décrire dans ce paragraphe la saisie d’une règle dans le menu paramétrage.
Les règles sont utilisées lors du calcul des factures.En effet en fonction de la surface totale des dispositifs le montant des taxes varie.
Les règles sont listées dans l’option règle du menu paramétrage
Il est possible de creer ou modifier une règle dans le formulaire ci dessous
Il est saisie :
- le libellé de la règle
- la catégorie de dispositif a laquelle s’applique la règle
- l’encadrement de la surface maximum et minimum pour laquelle la règle s’applique
- le tarif appliqué
- une case a cocher si le dispositif est numérique
Saisir un type de dispositif¶
Il est proposé de décrire dans ce paragraphe la saisie d’un type de dispositif dans le menu paramétrage.
Les types de dispositif sont listés dans l’option « type de dispositif » du menu paramétrage
Il est possible de creer ou modifier un type de dispositif dans le formulaire ci dessous
Il est saisie :
- l’abréviation du type
- le libellé du type
L’onglet dispositif permet de visualiser les dispositifs correspondants au type de dispositif choisi.
Créer des adresses postales¶
Il est proposé de décrire dans ce paragraphe la saisie d’une adresse postale.
Les adresses postales sont listées dans l onglet « adresse_postale »
Il est possible de creer ou modifier une adresse postale dans le formulaire ci dessous
Il est saisie :
- le numero (dans la voie)
- le complement de numero (bis, ter …)
- le libellé
Avec l’interface openLayers, il est saisi le ponctuel représentant le point d’adresse.
Règlement¶
Il est proposé de décrire dans ce paragraphe la saisie d’un règlement.
Les règlements sont listés dans l onglet « règlement »
Il est possible de creer ou modifier un règlement dans le formulaire ci dessous
Il est saisie :
- le libellé
- le n° insee
Avec l’interface openLayers, il est saisi le polygone représentant la surface du règlement.
Traitement¶
Nous vous proposons dans ce chapitre de mettre en oeuvre les traitements
Calculer les factures¶
Ce traitement permet de calculer pour l’année en cours les factures pour toutes les entreprises insérées dans la base. Si le traitement a déja été exécuté pour l’année en cours, les factures précédentes seront supprimées.
Les factures des années précédentes ne seront pas détruites.
Les factures calculées se retrouvent ensuite dans l’onglet traitement/facture (voir chapitre traitement/facture)
La formule des calculs de taxe est celle ci:
:: surface totale du dispositif x tarif de la somme totale de touts les dispositifs x nombre de mois ou le dispositif est utilisé/12
traitement :
validation :
Attention le traitement peut durer quelques minutes.
Parametrage du calcul en dyn/var.inc
// precision pour le calcul de surface : nombre de chiffre apres la virgule pour la surface calculee : 1 ou 2
$surface_precision =1;
Factures¶
Les factures sont listés dans l’onglet Facture
Il sont créés automatiquement par le traitement calculer facture (voir chapitre traitement/Calculer une facture)
La table contient :
- la raison sociale de l’entreprise pour laquelle la facture a été calculé
- la surface totale de tout les dispositifs en m²
- le montant total a payer
- l’année de création de la facture
- le solde (En Cours ou Terminé)
et l’onglet titre ligne qui contient une ligne pour chaque dispositif de l’entreprise
Editer Factures¶
Cet onglet permet de sortir toutes les factures pour l’année en cours de toutes les entreprises au sein d’un même PDF pour faire une impression globale.
Lien finances¶
Cet onglet permet d’exporter les montants des taxes publicitaires de chaque entreprises vers le logiciel de comptabilité sédit. Ce traitement doît être éffectué après avoir calculer les factures. Si l’entreprise n’a pas de code tiers elle sera omise.
Le résultat est un fichier texte a importer dans sédit (suivant la procédure filien).
Il pourra être constitué d’autres traitements pour d’autres logiciels de comptabilité municipal.
Redimensionner¶
Pour améliorer la rapidité de l’affichage des photos de sites ou de dispositifs ainsi que pour qu’elles soient plus visibles, il peut être utile de les redimmensionner. Ce traitement se propose de les redimensionner en fonction de la largeur, la hauteur étant calculée ensuite automatiquement. Par défaut la largeur est de 600 pixels pour permettre un affichage optimal.
traitement :
validation :
Integration¶
Nous vous proposons dans ce chapître de décrire l’intégration d’openTaxePub dans le système d’information
- principes d’une application composite (mashup)
- integration avec des vues (adressage, emprise, filaire)
- les fonds de cartes internet
- le tableau de bord parametrable (widget)
Les principes d’une application composite¶
openTaxePub permet de construire une application composite en intégrant des contenus venant d’applications externes.
C’est ainsi que les adresses postales de voie peuvent s” afficher sur des fonds de carte internet.
Suivant wikipedia : « Une application composite (ou mashup ou encore mash-up) est une application qui combine du contenu ou du service provenant de plusieurs applications plus ou moins hétérogènes. »
http://fr.wikipedia.org/wiki/Application_composite
Les applications composites permettent de construire une application rapidement a un faible coût grace à la fusion de multiples services internet. Les composants sont facilement ré utilisables
openTaxePub respecte les formats interopérables définies pour les bases de données par l’OGC.
« L’Open Geospatial Consortium, ou OGC, est un consortium international pour développer et promouvoir des standards ouverts, les spécifications OpenGIS®, afin de garantir l’interopérabilité des contenus, des services et des échanges dans les domaines de la géomatique et de l’information géographique ».
http://fr.wikipedia.org/wiki/Open_Geospatial_Consortium
C’est ainsi que les données peuvent être consultés par tous les outils acceptant les formats postgis, wms, wfs, kml, gml, json … et notament QGIS (outil client lourd).
Il est décrit ici les principes d’integration d’openTaxePub dans le domaine de l’information géographique.
- la géolocalisation de l’emplacement
- l’utilisation de vues pour se connecter sur des bases externes
Il est decrit ensuite l’intégration au travers de tableau de bord personnalisé.
La géolocalisation¶
Il est décrit ici les principes d’integration dans un SIG :
- l’utilisation de vues pour se connecter sur des bases externes
- la géolocalisation des entreprises et sites
Les vues sur des bases internes ou externes¶
Il est possible avec postgresql et dblink d’utiliser une base de données externe ( voir installation et utilisation de dblink dans le guide du développeur openMairie)
Il est possible aussi de mettre openTaxePub dans un schéma et de faire une simple vue sur le schéma du SIG
Ces vues se substitue alors aux tables de base et elles ne sont pas modifiables.
Les vues proposées sont dans init_metier_vue.sql et concerne :
- adresse_postale
- reglement
Le dessin de site openTaxePub¶
Il est possible de déssiner un point sur une carte représentant la localisation d’une entreprise ou d’un site avec le point d’une adresse postale.
les widgets¶
openTaxePub permet de construire une application composite en integrant des widgets dans le tableau de bord.
Le mode de fonctionnement des widget est décrit dans le guide du développeur openMairie.
Il est decrit ensuite l’integration au travers de tableau de bord personnalisés.
Il est donc possible de créer tout type de widget et de les intégrer dans un tableau de bord personnalisé :
Dans notre cas ci dessus, l’utilisateur « demo » a accès :
- à des applications externes
- à des applications internes