Guide développeur

Matrice des fonctionnalités

• {string} = texte libre

• {code} = doit correspondre à une valeur en base ou une valeur codée

• {0|1} = liste de valeurs autorisées

Configuration / préférences

Au chargement de l’addon, il faut aller chercher la configuration car elle dépend des droits accordées à l’utilisateur (niveau CNIL, communes autorisées).

Fonctionnalité	Responsive	Action	CNIL 0	CNIL 1	CNIL 2	Appel API
Récupérer la configuration		Récupérer la configuration	X	X	X	GET /cadastrapp/services/getConfiguration?
Récupérer le manifest		Récupérer le manifest	X	X	X	GET /mapfishapp/ws/addons/cadastrapp/manifest.json

Rechercher des parcelles

La recherche de parcelles se fait via un formulaire qui propose 4 onglets qui correspondent à 4 façons de rechercher des parcelles :

• par référence

• par identifiant

• par adresse cadastrale

• par lot

Fonctionnalité	Responsive	Action	CNIL 0	CNIL 1	CNIL 2	Appel API
Recherche par référence	X	Sélectionner une commune	X	X	X	GET /cadastrapp/services/getCommune?libcom={string} GET /cadastrapp/services/getCommune?cgocommune={string}
		Sélectionner une section	X	X	X	GET /cadastrapp/services/getSection?cgocommune={code}
		Sélectionner une parcelle	X	X	X	GET /cadastrapp/services/getDnuplaList?cgocommune={code}&ccopre={code}&ccosec={code}
		Afficher le résultat	X	X	X	POST /cadastrapp/services/getParcelle FORM_DATA : cgocommune={code}&dnupla={code}&ccopre={code}&ccosec={code}
Recherche par identifiant		Chercher une parcelle sur la carte	X	X	X	GET /geoserver/wfs?request=getfeature&version=1.0.0&service=wfs &typename={workspace:layer}&outputFormat=application/json &cql_filter=geo_parcelle=”{code}”
		Afficher le résultat	X	X	X	POST /cadastrapp/services/getParcelle FORM_DATA : parcelle={code}
Recherche par adresse cadastrale	X	Sélectionner une commune	X	X	X	GET /cadastrapp/services/getCommune?libcom={string} GET /cadastrapp/services/getCommune?cgocommune={string}
		Sélectionner une voie ou un lieu-dit	X	X	X	GET /cadastrapp/services/getVoie?cgocommune={code}&dvoilib={string}
		Afficher le résultat	X	X	X	POST /cadastrapp/services/getParcelle FORM_DATA : cgocommune={code}&dvoilib={string}&dnvoiri={number}&dindic={string}
Recherche par lot		Afficher le résultat	X	X	X	POST /cadastrapp/services/getParcelle FORM_DATA : parcelle={code}%0{code}…

Rechercher des propriétaires

La recherche de propriétaires se fait via un formulaire qui propose 3 onglets qui correspondent à 3 façons de rechercher des parcelles via la recherche de propriétaires :

• par nom d’usage ou nom de naissance

• par compte propriétaire (identifiant)

• par lot (liste d’identifiants)

Fonctionnalité	Responsive	Action	CNIL 0	CNIL 1	CNIL 2	Appel API
Recherche par nom d’usage ou nom de naissance	X	Sélectionner une commune		X	X	GET /cadastrapp/services/getCommune?libcom={string} GET /cadastrapp/services/getCommune?cgocommune={string}
		Recherche par nom d’usage		X	X	GET /cadastrapp/services/getProprietaire?cgocommune={code} &ddenom={string}&birthsearch=false
		Recherche par nom de naissance		X	X	GET /cadastrapp/services/getProprietaire?cgocommune={code} &ddenom={string}&checkBoxSearchByBirthNames=on&details={integer}&birthsearch=true
		Afficher le résultat		X	X	POST /cadastrapp/services/getParcelle FORM_DATA : comptecommunal={string}
Recherche par compte propriétaire		Sélectionner une commune		X	X	GET /cadastrapp/services/getCommune?libcom={string} GET /cadastrapp/services/getCommune?cgocommune={string}
		Rechercher un compte proprio		X	X	GET /cadastrapp/services/getProprietaire?cgocommune={code} &details={integer}&dnupro={string}
		Afficher le résultat		X	X	POST /cadastrapp/services/getParcelle FORM_DATA : comptecommunal={string}
Recherche par lot		Afficher le résultat		X	X	POST /cadastrapp/services/getParcelle FORM_DATA : comptecommunal={code}&comptecommunal={code}&…

Sélection graphique des parcelles

La sélection de parcelles sur la carte se fait en choisissant l’un des 3 modes de sélection graphique suivant :

• point

• ligne

• polygone

Fonctionnalité	Responsive	Action	CNIL 0	CNIL 1	CNIL 2	Appel API
Par point	X	Sélectionner une parcelle sur la carte	X	X	X	GET /geoserver/wfs?request=getfeature&version=1.0.0&service=wfs &typename={workspace:layer}&outputFormat=application/json &filter=<Filter xmlns:gml= »http://www.opengis.net/gml »><Intersects><PropertyName> geom</PropertyName><gml:Point><gml:coordinates>{coordinates}</gml:coordinates> </gml:Point></Intersects></Filter>
		Afficher le résultat	X	X	X	POST /cadastrapp/services/getParcelle FORM_DATA : parcelle={code}
Par ligne	?	Sélectionner des parcelles sur la carte	X	X	X	GET /geoserver/wfs?request=getfeature&version=1.0.0&service=wfs &typename={workspace:layer}&outputFormat=application/json &filter=<Filter xmlns:gml= »http://www.opengis.net/gml »><Intersects><PropertyName> geom</PropertyName><gml:LineString><gml:coordinates>{coordinates}</gml:coordinates> </gml:LineString></Intersects></Filter>
		Afficher le résultat	X	X	X	POST /cadastrapp/services/getParcelle FORM_DATA : parcelle={code}&parcelle={code}&…
Par polygone	?	Sélectionner des parcelles sur la carte	X	X	X	GET /geoserver/wfs?request=getfeature&version=1.0.0&service=wfs &typename={workspace:layer}&outputFormat=application/json &filter=<Filter xmlns:gml= »http://www.opengis.net/gml »><Intersects><PropertyName> geom</PropertyName><gml:Polygon><gml:outerBoundaryIs><gml:LinearRing> <gml:coordinates>{coordinates}</gml:coordinates> </gml:LinearRing></gml:outerBoundaryIs></gml:Polygon></Intersects></Filter>
		Afficher le résultat	X	X	X	POST /cadastrapp/services/getParcelle FORM_DATA : parcelle={code}&parcelle={code}&…

Fenêtre de sélection de parcelles

Toutes les recherches aboutisse à l’ouverture de la fenêtre de « Sélection de parcelle » qui est la fenêtre la plus importante de Cadastrapp. Elle liste les parcelles qui résultent des différentes méthodes de recherche décrites ci-dessus.

En sur-sélectionnant une ou des parcelles de cette liste, on a accès aux fonctions suivantes :

• zoom sur la parcelle sélectionné / zoom sur toutes les parcelles

• affichage de la fiche d’informations sur une parcelle

• unité foncière de la / des parcelles sélectionnées

• exports :

  • liste de parcelles

  • liste de propriétaires

  • liste de co-propriétaires

  • lots des copropriétés

Fonctionnalité	Responsive	Action	CNIL 0	CNIL 1	CNIL 2	Appel API
Zoom sur…	X	liste des parcelles	X	X	X
		parcelles sélectionnées	X	X	X
Fiche d’info parcelle	X		X	X	X
Fiche unité foncière		Récupérer la géométrie de l’unité foncière	X	X	X	POST /geoserver/wfs? FORM_DATA : <wfs:GetFeature service= »wfs » version= »1.0.0 » outputFormat= »application/json » xmlns:wfs= »http://www.opengis.net/wfs » xmlns:ogc= »http://www.opengis.net/ogc » xmlns:xsi= »http://www.w3.org/2001/XMLSchema- instance » xsi:schemaLocation= »http://www.opengis.net/wfs http://schemas.opengis.net/ wfs/1.0.0/WFS-basic.xsd »><wfs:Query typeName= »app:cadastrapp_uf »><Filter xmlns:gml= « http://www.opengis.net/gml »><Contains><PropertyName>geom</PropertyName> <gml:Polygon><gml:outerBoundaryIs><gml:LinearRing><gml:coordinates>{coordinates} </gml:coordinates></gml:LinearRing></gml:outerBoundaryIs></gml:Polygon></Contains> </Filter></wfs:Query></wfs:GetFeature>
		Ouvrir la fiche	X	X	X
Exporter sélection		Exporter liste de parcelles (CSV)	X	X	X	POST /cadastrapp/services/exportParcellesAsCSV FORM_DATA : parcelles={code1,code2,…}
		Exporter liste de propriétaires (CSV)		X	X	POST /cadastrapp/services/exportProprietaireByParcelles FORM_DATA : parcelles={code1,code2,…}
		Exporter liste de co-propriétaires (CSV)		X	X	POST /cadastrapp/services/exportCoProprietaireByParcelles FORM_DATA : parcelles={code1,code2,…}
		Exporter lots de co-propriétés (PDF)		X	X	POST /cadastrapp/services/exportLotsAsPDF FORM_DATA : parcelles={code1,code2,…}
		Exporter lots de co-propriétés (CSV)		X	X	POST /cadastrapp/services/exportLotsAsCSV FORM_DATA : parcelle={code}&dnubat=+{code}

Fiche information parcelle

Cette fenêtre affiche beaucoup d’information sur les parcelles et les objets associés : propriétaires, co-propriétaires, détails des locaux, subdivisions fiscales, historique de mutation, etc.

Fonctionnalité	Responsive	Action	CNIL 0	CNIL 1	CNIL 2	Appel API
onglet Parcelle	X	Afficher les infos	X	X	X	GET /cadastrapp/services/getFIC?parcelle={code}&onglet=0
		Bordereau parcellaire	X	X	X	GET /cadastrapp/services/createBordereauParcellaire?parcelle={code} &personaldata={0|1}&basemapindex={0|n} &fillcolor=81BEF7&opacity=0.4&strokecolor=111111&strokewidth=3 (3)
onglet Propriétaires	X	Afficher les infos		X	X	GET /cadastrapp/services/getProprietairesByParcelles?parcelles={code}
		Relevé de propriété PDF		X	X	GET /cadastrapp/services/createRelevePropriete? compteCommunal={code}&parcelleId={NULL|code}&exportType=on (4)
		Relevé de propriété CSV		X	X	GET /cadastrapp/services/createReleveProprieteAsCSV? compteCommunal={code}&parcelleId={NULL|code}&exportType=on (4)
onglet Copropriétaires	X	Afficher les infos		X	X	GET /cadastrapp/services/getCoProprietaire?start=0&limit=25&parcelle={code} (1)
		Relevé de propriété PDF		X	X	-> Relevé de propriété de l’onglet Propriétaires
		Relevé de propriété CSV		X	X	-> Relevé de propriété de l’onglet Propriétaires
onglet Bâtiments	X	Afficher les infos			X	GET /cadastrapp/services/getBatiments?dnubat=%20A&parcelle={code} (2)
		Relevé de propriété PDF		?	X	-> Relevé de propriété de l’onglet Propriétaires
		Relevé de propriété CSV		?	X	-> Relevé de propriété de l’onglet Propriétaires
		Descriptif d’habitation			X	GET /cadastrapp/services/getHabitationDetails?invar={code}&annee={integer}
		Lots en PDF		?	X	POST /cadastrapp/services/exportLotsAsPDF FORM_DATA : parcelle={code}&dnubat=+{code}
onglet Subdivisions fiscales	X	Afficher les infos			X	GET /cadastrapp/services/getFIC?parcelle={code}&onglet=3
onglet Historique de mutation	X	Afficher les infos	X	X	X	GET /cadastrapp/services/getFIC?parcelle={code}&onglet=4

Traitement des sélections

Ces fonctionnalités sont accessibles depuis le menu « Avancées » dans la barre d’outils.

Fonctionnalité	Responsive	Action	CNIL 0	CNIL 1	CNIL 2	Appel API
Parcelles		Bordereau parcellaire multipages	X	X	X	GET /cadastrapp/services/createBordereauParcellaire?parcelle={code1,code2,…} &personaldata={0|1}&basemapindex={0|n} &fillcolor=81BEF7&opacity=0.4&strokecolor=111111&strokewidth=3 (3)
		Export liste CSV	X	X	X	POST /cadastrapp/services/exportParcellesAsCSV FORM_DATA : parcelles={code1,code2,…}
Propriétaires et copropriétaires		Export liste CSV		X	X	POST /cadastrapp/services/exportProprietaireByParcelles FORM_DATA : parcelles={code1,code2,…}

Unité foncière

Une unité foncière (UF) est le regroupement des parcelles contiguës et appartenant à un même compte propriétaire.

La fiche d’information sur une unité foncière permet de présenter l’ensemble des informations descriptives de cette unité foncière :

• propriétaire(s)

• contenance DGFiP, surfaces calculées, pourcentage de la surface bâtie

• liste des parcelles composant l’unité foncière

Fonctionnalité	Responsive	Action	CNIL 0	CNIL 1	CNIL 2	Appel API
Carte		Afficher les couches de la carte courante	X	X	X	GET /geowebcache/service/wms?LAYERS={layers}&…
Informations sur l’UF		Infos sur l’UF	X	X	X	GET /cadastrapp/services/getInfoUniteFonciere?parcelle={code}
		Calculer le pourcentage de la surface bâtie	X	X	X
Infos sur le(s) propriétaire(s)		Infos sur le(s) propriétaire(s)		X	X	GET /cadastrapp/services/getProprietaire?details=2&comptecommunal={code}
Infos sur les parcelles		Infos sur les parcelles	X	X	X	GET /cadastrapp/services/getParcelle?unitefonciere={code}

Module de demande d’information foncière

Le module de demande d’information foncière permet de gérer les demandes d’informations tout en respectant la réglementation.

TODO : vérifier les droits niveaux CNIL

Fonctionnalité	Responsive	Action	CNIL 0	CNIL 1	CNIL 2	Appel API
Vérifier si le demandeur est en droit de faire une nouvelle demande		Récupérer infos de contrôle		X	X	GET /cadastrapp/services/checkRequestLimitation?cni={string}&type={A|P1|P2|P3}
Parcelle par référence		Sélectionner une commune		X	X	GET /cadastrapp/services/getCommune?libcom={string} GET /cadastrapp/services/getCommune?cgocommune={string}
		Sélectionner une section		X	X	GET /cadastrapp/services/getSection?cgocommune={code}
		Sélectionner une parcelle		X	X	GET /cadastrapp/services/getDnuplaList?cgocommune={code}&ccopre={code}&ccosec={code}
Parcelle par identifiant
Propriétaire par nom d’usage		Sélectionner une commune		X	X	GET /cadastrapp/services/getCommune?libcom={string} GET /cadastrapp/services/getCommune?cgocommune={string}
		Recherche par nom d’usage		X	X	GET /cadastrapp/services/getProprietaire?cgocommune={code} &ddenom={string}&birthsearch=false
Propriétaire par nom de naissance		Sélectionner une commune		X	X	GET /cadastrapp/services/getCommune?libcom={string} GET /cadastrapp/services/getCommune?cgocommune={string}
		Recherche par nom d’usage		X	X	GET /cadastrapp/services/getProprietaire?cgocommune={code} &ddenom={string}&birthsearch=true
Propriétaire par identifiant
Copropriété
Lot de copropriété		Sélectionner une commune		X	X	GET /cadastrapp/services/getCommune?libcom={string} GET /cadastrapp/services/getCommune?cgocommune={string}
		Sélectionner une section		X	X	GET /cadastrapp/services/getSection?cgocommune={code}
		Sélectionner une parcelle		X	X	GET /cadastrapp/services/getDnuplaList?cgocommune={code}&ccopre={code}&ccosec={code}
		Sélectionner un co-propriétaire		X	X	GET /cadastrapp/services/getProprietairesByInfoParcelles? commune={code}&section={code}&numero={code}&ddenom={string}
Sauvegarder les informa- tions sur la demande		Envoyer au serveur		X	X	GET /cadastrapp/services/getParcelle?/saveInformationRequest?type={A|P1|P2|P3} &cni={string} &lastname={string}&firstname={string}&adress={string} &commune={string}&codepostal={string} &mail={string} &parcelleIds={string} &comptecommunaux={string} &coproprietes={string} &parcelles={string} &proprietaires={string} &proprietaireLots={string} &responseby={1|2|3}&askby={1|2|3}
Imprimer la demande		Récupérer le formulaire PDF		X	X	GET /cadastrapp/services/printPDFRequest?requestid={code}
Récupérer les documents		Récupérer le(s) PDF		X	X	GET /cadastrapp/services/createDemandeFromObj?requestid={code}

Notes

1. pagination

2. par défaut on sélectionne le premier bâtiment, soit le bâtiment A

3. ces informations de style proviennent des préférences

4. parcelleId={NULL} pour un relevé de propriété de toutes les parcelles

Notes de réflexion :

• Rechercher des parcelles > Recherche par identifiant : utilise uniquement les parcelles du plan cadastral. Ce n’est pas logique.

• Rechercher des co-propriétés : accessible uniquement par le menu de recherche avancée : est-ce nécessaire de le maintenir ?

Documentation de l’API

Un fichier WADL est disponible après installation de la webapp :

https://my_sdi/cadastrapp/apidocs/wadl/application.wadl

Télécharger le fichier WADL pour la version courante.

Javadoc

Une documentation Javadoc construite automatiquement est diponible après installation de la webapp :

https://my_sdi/cadastrapp/apidocs/index.html