From 82b07b55314845075cc223d1e543dcc5d0a4c3d7 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 | 8 -------- docs/CHANGELOG.md | 8 +++++++- docs/admin-manual.rst | 25 ++++++++----------------- 3 files changed, 15 insertions(+), 26 deletions(-) diff --git a/config/default_config.toml.example b/config/default_config.toml.example index 9e14b921a3..25669f0a23 100644 --- a/config/default_config.toml.example +++ b/config/default_config.toml.example @@ -325,14 +325,6 @@ 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"] diff --git a/docs/CHANGELOG.md b/docs/CHANGELOG.md index 7d6e0cc586..484d7a2ded 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 `ADDITIONAL_COLUMNS_FRONTEND` (#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 depréciés ( `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é d'utiliser ce paramètre et de se créer des vues 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..6a95890390 100644 --- a/docs/admin-manual.rst +++ b/docs/admin-manual.rst @@ -2194,26 +2194,17 @@ 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 des vues personnalisée et en remplissant le paramètre suivant : -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``). +:: -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). + [SYNTHESE] + ... + EXPORT_OBSERVATIONS_CUSTOM_VIEWS = [ + {"label" : "export customisé ", "view_name"= "gn_synthese.ma_vue_personnalisee"} + ] -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`. **Export des métadonnées**