From c6b3046f3aabcee3ac66c40f7875a7722b98314d Mon Sep 17 00:00:00 2001 From: amandine-sahl Date: Fri, 9 Aug 2024 15:17:52 +0200 Subject: [PATCH] Update manuel-utilisateur --- README.md | 14 ++++----- docs/manuel-utilisateur.md | 58 +++++++++++--------------------------- 2 files changed, 24 insertions(+), 48 deletions(-) diff --git a/README.md b/README.md index 483b168b..01b166cf 100644 --- a/README.md +++ b/README.md @@ -6,7 +6,7 @@ référentiel TAXREF MNHN. Elle permet de gérer la liste des taxons présents dans chaque structure, -d\'y greffer des informations spécifiques, de définir des listes de +d'y greffer des informations spécifiques, de définir des listes de taxons et des filtres en fonction des besoins. Elle est utilisée pour la structuration des taxons dans GeoNature @@ -17,10 +17,10 @@ pour leur affichage dans GeoNature-atlas. # Documentation -La documentation d\'installation de TaxHub est disponible sur -(docs/index.md). +La documentation d'installation de TaxHub est disponible dans le dossier +[docs](docs/index.md). -TaxHub peut aussi être installé à partir du script d\'installation +TaxHub peut aussi être installé à partir du script d'installation globale de GeoNature : . # Principes @@ -37,7 +37,7 @@ qui nous intéressent dans le TAXREF. Il faut ensuite y greffer des informations spécifiques grace à `bib_attributs` (patrimonialité, marqueurs, autres selon les besoins) et -définir des listes de taxons (espèces d\'un protocole, \....) dans +définir des listes de taxons (espèces d'un protocole, ...) dans `bib_listes` en fonction des besoins. ## Technologies @@ -51,9 +51,9 @@ définir des listes de taxons (espèces d\'un protocole, \....) dans ## Gestion des droits -Elle est centralisée dans l\'application +Elle est centralisée dans l'application [UsersHub](https://github.com/PnX-SI/UsersHub). Il faut donc disposer de -l\'application `TaxHub` dans UsersHub et y intégrer des groupes et/ou +l'application `TaxHub` dans UsersHub et y intégrer des groupes et/ou utilisateurs. Niveaux de droits : diff --git a/docs/manuel-utilisateur.md b/docs/manuel-utilisateur.md index 9fbe0726..93f6b404 100644 --- a/docs/manuel-utilisateur.md +++ b/docs/manuel-utilisateur.md @@ -12,68 +12,36 @@ taxons en listes personnalisées etc. 3 onglets principaux structurent l'application : -- TAXREF : Dans cet onglet, tout utilisateur connecté ou non peut +- **TAXREF** : Dans cet onglet, tout utilisateur connecté ou non peut explorer le référentiel taxonomique. Un utilisateur disposant des - droits suffisants pourra également ajouter un taxon à son instance - depuis cet onglet. -- TAXONS : Cet onglet permet d'explorer l'ensemble des taxons - disponibles dans votre propre instance de GeoNature et de consulter - leurs informations (attributs, médias, listes etc) -- LISTES : Cet onglet recense les listes disponibles et permet d'en + droits suffisants pourra également ajouter des attributs ou médias à un taxon. +- **LISTES** : Cet onglet recense les listes disponibles et permet d'en créer des nouvelles, de les peupler, les modifier et les exporter. +- **ATTRIBUTS** : Cet onglet recense les attributs disponibles et permet d'en + créer de nouveaux. ## Exploration du Taxref Dans l'onglet Taxref, vous pouvez explorer le référentiel national -complet. Vous pouvez ainsi requêter selon différents champs, afficher ou -masquer les colonnes qui vous intéressent et filtrer les résultats sur +complet. Vous pouvez ainsi requêter selon différents champs et filtrer les résultats sur ces différentes colonnes, ou encore consulter les fiches espèces sur le site de l'INPN. Pour ces fonctions, il n'est pas nécessaire d'être connecté. ![image](images/explore_taxref.gif) -Cet onglet ne comporte donc aucune information propre à votre instance, -et ne fait que lire le référentiel taxonomique national tel qu'il est -diffusé par le Muséum National d'Histoire Naturelle. +Cet onglet permet d'explorer le référentiel taxonomique national et de consultrer pour chaque taxon les attributs et médias propre à votre instance. -## Ajouter une espèce à la liste de ses taxons +![image](images/detail_taxon.gif) -Les outils GeoNature s'appuient sur le référentiel taxonomique national -TAXREF. Cependant pour davantage d'efficacité, les outils n'intègrent -pas d'office tout le référentiel, mais comportent seulement un -"extrait" géré par l'administrateur de l'instance (extrait visible -dans l'onglet "Taxons"). Cela permet également à l'administrateur de -GeoNature d'ajouter des informations qu'il souhaite attribuer à chacun -des taxons. - -Pour ajouter une espèce à la liste des taxons disponibles dans votre -instance, vous devez vous connecter avec les droits nécessaires et -rechercher l'entité que vous souhaitez dans l'onglet Taxref. Vous -devez ensuite l'ajouter à vos taxons (bouton +). - -Vous serez alors invité à renseigner ses informations qui sont propre à -votre contexte : attributs, listes auxquelles appartient l'espèce, -médias. Ces informations sont consultables et modifiables par la suite. - -Le taxon ainsi ajouté sera désormais visible, avec les informations que -vous lui avez attribuées, dans l'onlet "taxons" de votre taxhub. ## Mettre à jour les informations d'un taxon -L'une des raisons qui a poussé à utiliser les "taxons" et ne pas -s'appuyer directement sur le Taxref est de pouvoir "surcoucher" le -référentiel national avec des informations taxonomiques propres aux -contextes des différents utilisateurs, et propres à leurs besoins -respectifs. - Ainsi, les taxons peuvent se voir attribuer un certain nombre d'informations, nommées "attributs", et être classés dans des listes personnalisées, sans lien obligatoire avec la taxonomie. -Afin d'attribuer des informations à un taxon, celui-ci doit être ajouté -à la liste des "taxons" de votre instance, comme expliqué -précédemment. Vous pourrez alors l'éditer (bouton "crayon" depuis +Afin d'attribuer des informations à un taxon, il faut l'éditer (bouton "crayon" depuis l'onglet Taxons ou directement depuis l'onglet Taxref), et renseigner les différents attributs qui concernent l'espèce. @@ -83,6 +51,7 @@ pourrez associer un ou plusieurs médias à un taxon. Ces médias peuvent être des images, des vidéos, des enregistrements sonores, des fichiers pdf etc. + ## Créer et gérer des listes personnalisées TaxHub permet d'organiser les taxons au sein de listes personnalisées. @@ -113,6 +82,8 @@ insectes. Une fois la liste créée, vous pourrez la peupler ou l'exporter comme vu précédemment. +![image](images/create_use_lists.gif) + ## Créer et gérer des thèmes et attributs personnalisés Afin de mieux répondre à vos besoins et attacher les informations dont @@ -131,6 +102,8 @@ entrée dans la table `bib_themes` du schéma `taxonomie`. En créant cette entité, un rang peut être donné au nouveau thème afin de les ordonner dans l'interface. +![image](images/create_theme.gif) + De la même manière, pour créer un attribut, il faut créer une nouvelle entrée dans la table `bib_attributs`, également dans le schéma `taxonomie`. Il est alors possible de définir ses modalités possibles @@ -140,6 +113,9 @@ pour les listes, les attributs peuvent ou non être limités à un règne ou Votre application TaxHub est désormais dotée de nouveaux attributs ! +![image](images/create_attribut.gif) + + ## Gérer le contenu de GeoNature-atlas Les informations "statiques" diffusées sur les fiches espèces sont les