Skip to content

Commit

Permalink
Update manuel-utilisateur
Browse files Browse the repository at this point in the history
  • Loading branch information
amandine-sahl committed Aug 9, 2024
1 parent cab2c62 commit c6b3046
Show file tree
Hide file tree
Showing 2 changed files with 24 additions and 48 deletions.
14 changes: 7 additions & 7 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand All @@ -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 : <http://docs.geonature.fr/installation-all.html>.

# Principes
Expand All @@ -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
Expand All @@ -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 :
Expand Down
58 changes: 17 additions & 41 deletions docs/manuel-utilisateur.md
Original file line number Diff line number Diff line change
Expand Up @@ -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.

Expand All @@ -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.
Expand Down Expand Up @@ -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
Expand All @@ -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
Expand All @@ -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
Expand Down

0 comments on commit c6b3046

Please sign in to comment.