From 1666553df1303e9cb4ef6f9e0748083e6472f27b Mon Sep 17 00:00:00 2001 From: TheoLechemia Date: Mon, 18 Mar 2024 16:10:29 +0100 Subject: [PATCH] add changelog + doc --- config/default_config.toml.example | 13 ++++--------- docs/CHANGELOG.md | 8 +++++++- docs/admin-manual.rst | 28 ++++++++++++---------------- 3 files changed, 23 insertions(+), 26 deletions(-) diff --git a/config/default_config.toml.example b/config/default_config.toml.example index 9e14b921a3..f9042684b9 100644 --- a/config/default_config.toml.example +++ b/config/default_config.toml.example @@ -325,20 +325,15 @@ MEDIA_CLEAN_CRONTAB = "0 1 * * *" # Nombre max d'observations dans les exports NB_MAX_OBS_EXPORT = 50000 - # Noms des colonnes obligatoires de la vue ``gn_synthese.v_synthese_for_export`` - EXPORT_ID_SYNTHESE_COL = "id_synthese" - EXPORT_ID_DATASET_COL = "jdd_id" - EXPORT_ID_DIGITISER_COL = "id_digitiser" - EXPORT_OBSERVERS_COL = "observateurs" - EXPORT_GEOJSON_4326_COL = "geojson_4326" - EXPORT_GEOJSON_LOCAL_COL = "geojson_local" - # Formats d'export disponibles ["csv", "geojson", "shapefile", "gpkg"] EXPORT_FORMAT = ["csv", "geojson", "shapefile"] # Vues d'export personnalisées EXPORT_OBSERVATIONS_CUSTOM_VIEWS = [ - {"label" : "export customisé", "view_name"= "gn_synthese.ma_vue_personnalisee"} + { + label = "format personnalisé", + view_name = "schema_name.view_name" + } ] # Noms des colonnes obligatoires de la vue ``gn_synthese.v_metadata_for_export`` EXPORT_METADATA_ID_DATASET_COL = "jdd_id" diff --git a/docs/CHANGELOG.md b/docs/CHANGELOG.md index 7d6e0cc586..090da49721 100644 --- a/docs/CHANGELOG.md +++ b/docs/CHANGELOG.md @@ -7,7 +7,13 @@ CHANGELOG - [Synthèse] Possibilité d'ajouter des champs supplémentaires à la liste de résultats via le paramètre `ADDITIONAL_COLUMNS_FRONTEND`. Ces champs sont masqués par défaut et controlables depuis l'interface (#2946) -- [Synthèse] Possibilité d'ajouter des exports customisés basé sur des vues SQL via le paramètre `EXPORT_OBSERVATIONS_CUSTOM_VIEWS` +- [Synthèse] Possiblité d'ajouter des exports personnalisés basé sur des vues SQL via le paramètre `EXPORT_OBSERVATIONS_CUSTOM_VIEWS` (#2955) + +**⚠️ Notes de version** + +- Les paramètres de la synthèse permettant de spécifier le nom de certaines colonnes de la vue d'export sont déprécies (`EXPORT_ID_SYNTHESE_COL`, `EXPORT_ID_DIGITISER_COL`, `EXPORT_OBSERVERS_COL`, `EXPORT_GEOJSON_4326_COL`, `EXPORT_GEOJSON_LOCAL_COL`). Si vous aviez surcoucher la vue `gn_synthese.v_synthese_for_export`, il est recommandé de ne plus le faire et de plutôt utiliser le nouveau paramètre `EXPORT_OBSERVATIONS_CUSTOM_VIEWS` permettant de se créer ses propres vues d'export personnalisées. + + 2.14.0 - Talpa europaea 👓 (2024-02-28) 2.14.0 - Talpa europaea 👓 (2024-02-28) --------------------------------------- diff --git a/docs/admin-manual.rst b/docs/admin-manual.rst index be9d6768ba..a139848281 100644 --- a/docs/admin-manual.rst +++ b/docs/admin-manual.rst @@ -2194,26 +2194,22 @@ Enlevez la ligne de la colonne que vous souhaitez désactiver. Les noms de colon L'entête ``[SYNTHESE]`` au dessus ``EXPORT_COLUMNS`` indique simplement que cette variable appartient au bloc de configuration de la synthese. Ne pas rajouter l'entête à chaque paramètre de la synthese mais une seule fois au dessus de toutes les variables de configuration du module. -Il est également possible de personnaliser ses exports en éditant le SQL de la vue ``gn_synthese.v_synthese_for_export`` (niveau SQL et administration GeoNature avancé). +Il est également possible de personnaliser ses exports en créant vos propres vues personnalisées et en remplissant le paramètre suivant avec une ou plusieurs vues d'export spécifiques : -Attention, certains champs sont cependant obligatoires pour assurer la réalisation des fichiers d'export (csv, geojson et shapefile) et des filtres CRUVED. - -La vue doit OBLIGATOIREMENT contenir les champs : - -- geojson_4326 -- geojson_local -- id_synthese, -- jdd_id (l'ID du jeu de données) -- id_digitiser -- observateurs - -Ces champs doivent impérativement être présents dans la vue, mais ne seront pas nécessairement dans le fichier d'export si ils ne figurent pas dans la variable ``EXPORT_COLUMNS``. De manière générale, préférez rajouter des champs plutôt que d'en enlever ! +:: -Le nom de ces champs peut cependant être modifié. Dans ce cas, modifiez le fichier ``geonature_config.toml``, section ``SYNTHESE`` parmis les variables suivantes (``EXPORT_ID_SYNTHESE_COL, EXPORT_ID_DATASET_COL, EXPORT_ID_DIGITISER_COL, EXPORT_OBSERVERS_COL, EXPORT_GEOJSON_4326_COL, EXPORT_GEOJSON_LOCAL_COL``). + [SYNTHESE] + ... + EXPORT_OBSERVATIONS_CUSTOM_VIEWS = [ + { + label = "format personnalisé", + view_name = "gn_synthese.v_synthese_for_web_app", + } + ] -NB : Lorsqu'on effectue une recherche dans la synthèse, on interroge la vue ``gn_synthese.v_synthese_for_web_app``. L'interface web passe ensuite une liste d'``id_synthese`` à la vue ``gn_synthese.v_synthese_for_export`` correspondant à la recherche précedemment effectuée (ce qui permet à cette seconde vue d'être totalement modifiable). -La vue ``gn_synthese.v_synthese_for_web_app`` est taillée pour l'interface web, il ne faut donc PAS la modifier. +Ces vues doivent obligatoirement avoir une colonne `id_synthese`, une colonne `geojson_local` représentant le geojson de la géometrie en projection locale (pour la génération du shapefile) et une colonne `geojson_4326` représentant le geojson de la géométrie en projection 4326 (pour la génération du geojson) (utilisez la fonction `st_asgeojson` - voir la vue par défaut `gn_synthese.v_synthese_for_export`). +Le floutage s'appliquera automatiquement à la vue d'export sur les même champs géométriques que la vue `gn_synthese.v_synthese_for_export`, à savoir `geometrie_wkt_4326`, `x_centroid_4326`, `y_centroid_4326`, `geojson_local` et `geojson_4326`. Si vous ajoutez des champs représentant la géométrie de l'observation portant des noms différents que les 4 noms précités, ceux-ci ne seront pas floutés. **Export des métadonnées**