Ajout protocoles MhéO

README.md

@@ -1,2 +1,72 @@
-# pr_mheo
-Configuration Monitoring des protocoles MhéO 
+**Implémentation des protocoles MhéO pour GeoNature Monitoring** 
+
+Implémentations de cinq protocoles de la boîte à outil MhéO pour le module monitoring de GeoNature. Les fichiers `README.md` donnent quelques informations sur comment ont été traduits les concepts MhéO dans GeoNature. Pour une compréhension du formatage des fichiers se référer à [la documentation technique de gn-monitoring](https://github.com/PnX-SI/gn_module_monitoring/blob/main/README.md) et en particulier à [la configuration des attributs](https://github.com/PnX-SI/gn_module_monitoring/blob/main/docs/sous_module.md#configuration-des-objets).
+
+Ce travail est basé sur [le document de référence de la BàO Rhoméo](https://rhomeo-bao.fr/sites/all/themes/corporateclean/pdf/ZH_Boite-outils-complete.pdf) pour la spécification des protocoles et sur les documents spécifiant les formats d'échange SANDRE pour les champs de chacun des protocoles. 
+
+Contacts :
+
+- Honorine BALDENWECK-RUFFENACH (PatriNat)
+- Robin VIGNAUD (PatriNat)
+
+Protocoles implémentés et testés avec **gn-monitoring v1.0.0**
+
+Le reste de ce document donne quelques éléments ayant guidé l'implémentation des protocoles pour gn-monitoring. Les informations concernant spécifiquement un protocole se trouve dans le fichier `README.md` de ce protocole.
+
+
+# Propriété d'attribut `code_sandre`
+
+La plupart des attributs configurés ont une propriété `code_sandre`. Par exemple :
+
+```json
+{
+  "attribut_label": "Identifiant SINP",
+  "type_widget": "text", 
+  "code_sandre": "IdStNP"
+}
+```
+
+La propriété `code_sandre` fait référence au code du champ dans les documents décrivant le format d'échange pour les protocoles MhéO. Cette propriété est purement indicative et n'a pas d'incidence sur le fonctionnement de gn-monitoring.
+
+# Ordre des attributs spécifiques dans la configuration
+
+L'ordre suivant est généralement respecté pour les définitions des attributs dans les fichiers JSON :
+
+- attributs spécifiques dans l'ordre des champs du format d'échange SANDRE
+- attributs génériques renommés
+- attributs génériques cachés
+
+# Choix du type de champ pour les listes de valeurs
+
+Pour de nombreux champs les valeurs possibles sont définies par des listes pré-établies par des référentiels. Deux types de champ peuvent proposer des listes de valeurs dans GeoNature : les champs « select » et les champs « nomenclature ». Les deux se présente sous la forme d'une liste déroulante. Voici les critéres qui ont permis de décider quel type utiliser pour chaque champ des protocoles MhéO :
+
+(les deux types de champ permettent de différencier le libellé affiché sur le formulaire et la valeur effective enregistrée en base de données)
+
+## Type de champ « select »
+
+- permet d'ordonner les valeurs présentées dans la liste déroulante
+- les libellés et valeurs ne peuvent pas être mutualisés, il faut les saisir pour chaque champ.
+- seules les valeurs sont utilisables pour d'éventuels exports
+
+Dans le cadre des protocoles MhéO des champ de type « select » sont utilisés pour :
+
+- les listes spécifiques et/ou courtes : Oui/Non, Faible/Moyen/Important, etc.
+- les listes de valeurs devant être présentées ordonnées : par exemple les niveaux de précision des coordonnées.
+
+Concrètement toutes les listes provenant de l'onglet « Référentiels » dans les documents décrivant les formats d'échange ont ce type de champ.
+
+## Type de champ « nomenclature »
+
+- permet d'ajouter une définition à chaque valeur. Sur le formulaire la définition d'une valeur s'affiche au survol de la valeur dans la liste.
+- ne permet pas (pas encore ?) d'ordonner les valeurs présentées dans la liste déroulante. L'ordre est alphabétique par rapport aux libellés.
+- permet de partager l'ensemble des libellés/valeurs/définitions (c-à-d une nomenclature) entre plusieurs champs.
+- toutes les informations sont utilisables pour d'éventuels exports
+
+Dans le cadre des protocoles MhéO des champ de type « nomenclature » sont utilisés pour :
+
+- les listes de valeurs issues d'une nomenclature du SANDRE (par exemple : https://id.eaufrance.fr/nsa/957)
+- quand la liste de valeurs correspond à une nomenclature déjà présente par défaut dans GeoNature.
+
+## Cas particulier de la nomenclature pour la précision de la localisation
+
+C'est une nomenclature du SANDRE (avec descriptions de chaque valeur) dont les valeurs sont manifestement ordonnées (ce que ne permet pas encore le type de champ `nomenclature`) : le code de chaque valeur a été ajouté devant son libellé pour que l'ordre d'affichage soit respecté (par exemple « 16 - Précision décamétrique supérieure à 50 mètres »).

mheo_amphibiens/README.md

@@ -0,0 +1,24 @@
+# Personnalisation des libellés pour les concepts GeoNature
+
+- Groupe de sites => « Zone humide »
+- Site => « Point »
+- Visite (inchangé)
+- Observation (inchangé)
+
+
+## Site => « Point »
+
+- du PDF Rhoméo : on parle de « point d'observation » ou de « point d'échantillonnage ».
+- le renommage est important car le terme « site » est également utilisé dans le document mais pour parler de la zone humide ou de la zone de prospection. 
+
+
+# Type(s) de géométrie autorisé(s) pour les Sites
+
+Géométrie ponctuelle désignant le plan d'eau.
+
+
+# Source de l'image de la vignette du module
+
+Femelle grenouille rousse
+
+Par Simon Eugster -- Simon 16:10, 15 July 2006 (UTC) — Travail personnel, CC BY-SA 3.0, https://commons.wikimedia.org/w/index.php?curid=950343

mheo_amphibiens/config.json

@@ -0,0 +1,13 @@
+{
+  "tree": {
+    "module": {
+      "sites_group": {
+        "site": {
+          "visit": {
+            "observation": {}
+          }
+        }
+      }
+    }
+  }
+}

mheo_amphibiens/module.json

@@ -0,0 +1,4 @@
+{
+  "module_label": "MhéO Amphibiens",
+  "module_desc": "Le protocole de suivi Amphibiens de la BàO MhéO"
+}

mheo_amphibiens/nomenclature.json

@@ -0,0 +1,79 @@
+{
+  "types": [
+    {
+      "mnemonique": "TYPE_SITE",
+      "label_default": "Type de sites",
+      "definition_default": "Nomenclature des types de sites suivi dans gn_monitoring."
+    },
+    {
+      "mnemonique": "PRECISION_GEO",
+      "label_default": "Précision des coordonnées géographiques",
+      "definition_default": "La précision des coordonnées précise à l'aide de l'une des valeurs de la nomenclature, le niveau d'exactitude des coordonnées du point d'eau."
+    }
+  ],
+  "nomenclatures": [
+    {
+      "type": "TYPE_SITE",
+      "cd_nomenclature": "MHEO_AMPHIBIENS",
+      "mnemonique": "Point observation amphibiens",
+      "label_default": "Point observation amphibiens",
+      "definition_default": "Masse d'eau pour observation amphibiens"
+    },
+    {
+      "type": "PRECISION_GEO",
+      "cd_nomenclature": "0",
+      "mnemonique": "Inconnue",
+      "label_default": "0 - Précision inconnue",
+      "definition_default": "La précision est inconnue quand aucune information n'est disponible sur le niveau d'exactitude des coordonnée"
+    },
+    {
+      "type": "PRECISION_GEO",
+      "cd_nomenclature": "11",
+      "mnemonique": "Centimétrique",
+      "label_default": "11 - Précision centimétrique",
+      "definition_default": "Précision inférieure à 10 centimètres"
+    },
+    {
+      "type": "PRECISION_GEO",
+      "cd_nomenclature": "12",
+      "mnemonique": "Décimétrique",
+      "label_default": "12 - Précision décimétrique",
+      "definition_default": "Précision inférieure à 1 mètre"
+    },
+    {
+      "type": "PRECISION_GEO",
+      "cd_nomenclature": "13",
+      "mnemonique": "Métrique 1",
+      "label_default": "13 - Précision métrique inférieure à 5 mètres",
+      "definition_default": "Précision inférieure à 5 mètres"
+    },
+    {
+      "type": "PRECISION_GEO",
+      "cd_nomenclature": "14",
+      "mnemonique": "Métrique 2",
+      "label_default": "14 - Précision métrique inférieure à 10 mètres\n",
+      "definition_default": "Précision inférieure à 10 mètres"
+    },
+    {
+      "type": "PRECISION_GEO",
+      "cd_nomenclature": "15",
+      "mnemonique": "Décamétrique 1",
+      "label_default": "15 - Précision décamétrique inférieure à 50 mètres",
+      "definition_default": "Précision inférieure à 50 mètres"
+    },
+    {
+      "type": "PRECISION_GEO",
+      "cd_nomenclature": "16",
+      "mnemonique": "Décamétrique 2",
+      "label_default": "16 - Précision décamétrique supérieure à 50 mètres",
+      "definition_default": "Précision supérieure à 50 mètres"
+    },
+    {
+      "type": "PRECISION_GEO",
+      "cd_nomenclature": "17",
+      "mnemonique": "CoordCentroïdeCommune",
+      "label_default": "17 - Coordonnées du centroïde de la commune",
+      "definition_default": "Coordonnées calculées à partir du barycentre de la commune où est situé l’objet ; commune du dernier référentiel publié par l’INSEE. Dans le cas ou le barycentre est hors de la commune il est corrigé pour être dans la commune"
+    }
+  ]
+}

mheo_amphibiens/observation.json

@@ -0,0 +1,54 @@
+{
+  "display_properties": [
+    "cd_nom",
+    "nb_individus_adultes",
+    "nb_larves",
+    "nb_pontes",
+    "nb_mâles",
+    "méthodes_observation"
+  ],
+  "display_list": [
+    "cd_nom",
+    "nb_individus_adultes",
+    "méthodes_observation"
+  ],
+  "specific": {
+    "nb_individus_adultes": {
+      "attribut_label": "Nombre d'individus vivants adultes",
+      "type_widget": "number",
+      "code_sandre": "Par7790"
+    },
+    "nb_larves": {
+      "attribut_label": "Nombre de larves de stade non précisé",
+      "type_widget": "number",
+      "code_sandre": "Par3139"
+    },
+    "nb_pontes": {
+      "attribut_label": "Nombre de pontes",
+      "type_widget": "number",
+      "code_sandre": "Par8914"
+    },
+    "nb_mâles": {
+      "attribut_label": "Nombre de mâles",
+      "type_widget": "number",
+      "code_sandre": "Par8915"
+    },
+    "méthodes_observation": {
+      "attribut_label": "Méthodes d'observation",
+      "type_widget": "select",
+      "multiple": true,
+      "values": [
+        "Pêche",
+        "Détection visuelle",
+        "Détection chant"
+      ]
+    },
+    "cd_nom": {
+      "attribut_label": "Taxon",
+      "code_sandre": "CdAppelTaxon"
+    },
+    "comments": {
+      "hidden": true
+    }
+  }
+}

mheo_amphibiens/site.json

@@ -0,0 +1,75 @@
+{
+  "genre": "M",
+  "label": "Point",
+  "label_list": "Points",
+  "geometry_type": "Point",
+  "display_properties": [
+    "base_site_name",
+    "id_inventor",
+    "first_use_date",
+    "last_visit",
+    "nb_visits",
+    "types_site",
+    "code_milieu_humide",
+    "identifiant_station_sinp",
+    "origine_données_station_sinp",
+    "nature_géographique_station_sinp",
+    "précision_localisation_station_sinp"
+  ],
+  "display_list": [
+    "base_site_name",
+    "last_visit",
+    "id_inventor",
+    "nb_visits",
+    "types_site"
+  ],
+  "specific": {
+    "code_milieu_humide": {
+      "attribut_label": "Code du milieu humide effectif",
+      "type_widget": "text",
+      "code_sandre": "CdMhi"
+    },
+    "identifiant_station_sinp": {
+      "attribut_label": "Identifiant SINP",
+      "type_widget": "text",
+      "code_sandre": "IdStNP"
+    },
+    "origine_données_station_sinp": {
+      "attribut_label": "Origine de la donnée",
+      "type_widget": "nomenclature",
+      "type_util": "nomenclature",
+      "code_nomenclature_type": "STATUT_SOURCE",
+      "code_sandre": "OrigineStNP"
+    },
+    "nature_géographique_station_sinp": {
+      "attribut_label": "Nature géographique",
+      "type_widget": "nomenclature",
+      "type_util": "nomenclature",
+      "code_nomenclature_type": "NAT_OBJ_GEO",
+      "code_sandre": "NatGeoStNP"
+    },
+    "précision_localisation_station_sinp": {
+      "attribut_label": "Précision de la localisation",
+      "type_widget": "nomenclature",
+      "type_util": "nomenclature",
+      "code_nomenclature_type": "PRECISION_GEO",
+      "code_sandre": "PreStSINP"
+    },
+    "base_site_name": {
+      "attribut_label": "Nom",
+      "type_widget": "text",
+      "code_sandre": "NomStNP"
+    },
+    "base_site_code": {
+      "required": false,
+      "hidden": true
+    },
+    "base_site_description": {
+      "hidden": true
+    },
+    "id_sites_group": {
+      "required": false,
+      "hidden": true
+    }
+  }
+}

mheo_amphibiens/sites_group.json

@@ -0,0 +1,34 @@
+{
+  "genre": "F",
+  "label": "Zone humide",
+  "label_list": "Zones humides",
+  "display_properties": [
+    "sites_group_name",
+    "sites_group_code",
+    "nb_sites",
+    "nb_visits"
+  ],
+  "specific": {
+    "nb_sites": {
+      "attribut_label": "Nombre de points de suivi"
+    },
+    "sites_group_description": {
+      "hidden": true
+    },
+    "comments": {
+      "hidden": true
+    },
+    "medias": {
+      "hidden": true
+    },
+    "altitude_min": {
+      "hidden": true
+    },
+    "altitude_max": {
+      "hidden": true
+    },
+    "modules": {
+      "hidden": true
+    }
+  }
+}