Doc: update UI doc

1 files changed, 73 insertions, 17 deletions

diff --git a/docs/fr/source/interface-utilisateur.rst b/docs/fr/source/interface-utilisateur.rst
index d7fd6e5ed..8afae7378 100644
--- a/docs/fr/source/interface-utilisateur.rst
+++ b/docs/fr/source/interface-utilisateur.rst
@@ -98,32 +98,32 @@ Les indexes de recherche permettent de faire des recherches en s'affranchissant
 
 .. note:: Par choix de ne pas intégrer des résultats trop éloignés de la recherche initiale, les fautes de frappes et orthographe ne sont pas pris en charge. Les recherches par orthographe aprroximative sont plus adaptées à des interfaces grand public qu'à des bases de données métier. Concrêtement lorsque l'on cherche avec le terme « amphore », les recherches deviennent peu pertinente si par exemple nous sont renvoyés des résultats parlant de « phare » dans une description.
 
-Il est possible de faire des recherches ouvertes du type : « commence par » en collant une astérisque `*` à la fin du terme de notre recherche.
+Il est possible de faire des recherches ouvertes du type : « commence par » en collant une astérisque ``*`` à la fin du terme de notre recherche.
 
-**Exemple** : une recherche avec le terme « `amp*` » retournera tous les éléments concernant des amphores ou des ampoules.
+**Exemple** : une recherche avec le terme « ``amp*`` » retournera tous les éléments concernant des amphores ou des ampoules.
 
 Adjoindre plusieurs termes correspond à faire une recherche avec l'opérateur logique *ET*.
 
-**Exemple** : une recherche avec le terme « `amphore dressel 1B` » retournera tous les éléments concernant des amphores Dressel de type 1B.
+**Exemple** : une recherche avec le terme « ``amphore dressel 1B`` » retournera tous les éléments concernant des amphores Dressel de type 1B.
 
 ..
  TODO: Une recherche avec l'opérateur OU... pour l'instant cette recherche pose trop de problèmes
 
 
-Préfixer un terme par un « moins » : « - » permet d'exclure des termes de notre recherche.
+Préfixer un terme par un « moins » : « ``-`` » permet d'exclure des termes de notre recherche.
 
-**Exemple** : une recherche avec « `ancre -amphore` » permet d'obtenir la liste des ancres en excluant les lots de mobilier comprenant des amphores.
+**Exemple** : une recherche avec « ``ancre -amphore`` » permet d'obtenir la liste des ancres en excluant les lots de mobilier comprenant des amphores.
 
 Recherche par facette
 +++++++++++++++++++++
 
 En cliquant sur l'icône engrenage, on accède à un formulaire permettant de construire simplement sa recherche par facette. Le formulaire de construction de requête dépand bien entendu du type d'élément recherché. Par ailleurs comme les autres formulaires ce formulaire peut avoir été personnalisé sur votre installation Ishtar, permettant de cacher certains champs inutiles ou ajouter d'autres champs personnalisés.
 
-Après sélection d'une ou plusieurs contraintes dans le formulaire, en cliquer sur ajouter, on les ajoute de manière textuelle sous la forme : « `attribut="valeur"` ». Cette forme permet de facilement retoucher une requête de manière textuelle sans passer par le formulaire.
+Après sélection d'une ou plusieurs contraintes dans le formulaire, en cliquer sur ajouter, on les ajoute de manière textuelle sous la forme : « ``attribut="valeur"`` ». Cette forme permet de facilement retoucher une requête de manière textuelle sans passer par le formulaire.
 
-**Exemple** : « `annee="2018"` » recherchera les éléments de l'année 2018.
+**Exemple** : « ``annee="2018"`` » recherchera les éléments de l'année 2018.
 
-.. warning:: Contrairement à la recherche libre, la justaposition des termes concernant un même attribut sont compris comme un opérateur *OU*. Ainsi « `annee="2018" annee="2017"` » listera les éléments de l'année 2017 ou 2018. Néanmoins pour les attributs différents, cela reste à comprendre comme un opérateur *ET*. Ainsi « `annee="2018" annee="2017" type-objet="Ancre et corps-mort"` » listera le mobilier avec un type d'objet « Ancre et corps-mort » et rattaché à une des années 2017 ou 2018.
+.. warning:: Contrairement à la recherche libre, la justaposition des termes concernant un même attribut est comprise comme un opérateur *OU*. Ainsi « ``annee="2018" annee="2017"`` » listera les éléments de l'année 2017 ou 2018. Néanmoins pour les attributs différents, cela reste à comprendre comme un opérateur *ET*. Ainsi « ``annee="2018" annee="2017" type-objet="Ancre et corps-mort"`` » listera le mobilier avec un type d'objet « Ancre et corps-mort » et rattaché à une des années 2017 ou 2018.
 
 .. _bookmarks:
 
@@ -132,11 +132,11 @@ Marques-pages et alertes
 
 Les marques-pages permettent de stocker une recherche pour la retrouver plus aisément plus tard. Ceux-ci sont alors directement disponible depuis le menu qui s'ouvre lorsque l'on clique sur l'icône marque-page de la barre de recherche.
 
-Techniquement le contenu d'un marque-page correspond à la chaîne de texte utilisé dans la zone de recherche. Ainsi (contrairement aux :ref:`_paniers <basket>`) c'est la requête qui est stockée et donc la liste d'éléments est à même de varier au cours du temps.
+Techniquement le contenu d'un marque-page correspond à la chaîne de texte utilisé dans la zone de recherche. Ainsi (contrairement aux :ref:`paniers <basket>`) c'est la requête qui est stockée et donc la liste d'éléments est à même de varier au cours du temps.
 
 On peut stocker indiférement des requêtes en recherche libre ou en recherche par facette.
 
-Une alerte est un marque-page mis en évidence : il est toujours disponible en haut à gauche de l'interface (à gauche de la zone 4 sur la capture de l'interface générale) avec un badge contenant le nombre d'élements contenu. En cliquant sur cette alerte, on accède directement au tableau de cette recherche.  
+Une alerte est un marque-page mis en évidence : il est toujours disponible en haut à gauche de l'interface (à gauche de la zone 4 sur l'image de l'interface générale) avec un badge contenant le nombre d'élements contenu. En cliquant sur cette alerte, on accède directement au tableau de cette recherche.  
 
 Tableaux
 --------
@@ -198,35 +198,91 @@ Un rappel des fiches ouvertes est disponible sur la droite. En cliquant sur un Ã
 Page d'assistant logiciel (wizard)
 ==================================
 
+Dans Ishtar, pour la plupart des éléments complexes, les pages d'édition se présentent sous la forme d'« assistant logiciel ». Un assitant logiciel, découpe la saisie en plusieurs pages. Ces pages permettent une structuration logique de l'information. Ainsi en fonction des modules activés et des informations renseignées le contenu et l'affichage des panneaux est dynamique.
+
+**Exemple** : les panneaux disponible lors de la saisie d'une opération préventive, d'une opération programmée, d'une saisie judiciaire, les panneaux affichés sont différents.
+
+Les panneaux enchaînent les formulaire jusqu'au dernier panneau de récapitulatif qui demandera confirmation des changements opérés. Tant que la validation finale n'est pas faite aucune donnée n'est enregistrée en base de données.
+
+Jusqu'à la validation finale, les données de formulaire sont enregistrées dans la session de l'utilisateur. L'utilisateur peut tout à fait avoir plusieurs saisies d'éléments de nature différente en parrallèle. Attention à la déconnexion ou à expiration de la session ces données de formulaires sont effacées. 
 
 Fil d'ariane
 ------------
 
+Tout en haut des pages d'assistant logiciel, un fil d'ariane affiché. Celui-ci permet de naviguer rapidement entre les différents panneaux. En modification la navigation est libre. En saisie, certains panneaux requérants des informations obligatoires, ceux-ci ne peuvent pas être passés : le fil d'ariane s'adapte automatiquement et affiche les étapes jusqu'au prochain panneau obligatoire.
+
 Tableau / Zone de formulaire
 ----------------------------
 
+En saisie, en général, deux types de panneau sont disponible : un type « tableau » et un type « zone de formulaire ».
+
+Les types de page « tableau » permettent de sélectionner un élément tout en profitant des possibilités de recherche, filtre, tri évoquées précédemment. Ces types de pages permettent de sélectionner l'élément que l'on souhaite modifier ou l'élément parent de l'élément que l'on souhaite créer.
+
+Les types de page « zone de formulaire » sont des formulaires web classiques. Ils offrent quelques facilitées tel que la saisie de dates en cliquant dans un calendrier, des conversions d'unités dynamiques, etc. Certains contrôles de formulaire sont fait de manière dynamique (par exemple une saisie textuelle dans un champs qui attend un chiffre), d'autres sont fait après envoi au serveur (par exemple, utilisation d'un index déjà utilisé par ailleurs).
+
 Zone de validation
 ------------------
 
+La zone de validation se situe tout en bas de la page.
+Les boutons « Valider » et « Annuler » sont toujours disponible.
+
+« Valider » permet de valider le panneau en cours et de passer au panneau suivant. Si c'est le dernier panneau, le panneau de récapitulatif, la création/modification/suppression est validée. En création/modification, l'utilisateur est redirigé vers la fiche de l'élément qui vient d'être créé/modifié.
+
+« Annuler » permet d'annuler toute la saisie en cours : les données de session seront effacées.
+
+« Valider et confirmer » (qui s'insère entre « Valider » et « Annuler ») permet de valider le panneau actuel et d'aller directement au panneau récapitulatif.
 
 Utilisation avancée
 ===================
 
+.. _basket:
+
+Paniers
+-------
+
+Les paniers sont un autre type de sélection d'éléments. Contrairement aux marques-pages, ils concernent une liste d'élements fixe.
+
+Pour effectuer certaines actions, il est nécessaire de préalablement constituer un panier (notamment pour ce qui concerne les traitements).
+
+Ce regroupement virtuel peut être aussi un outil de travail, par exemple en constituant une liste d'éléments « à traiter ». Un marque-page (voire une alerte) pouvant être faite sur le contenu d'un panier, cela permet de conserver sous la main cette sélection d'éléments.
+
+Pour l'heure les paniers ne concernent que le mobilier.
+
 .. _pinned:
 
 Éléments épinglés
 -----------------
 
-.. _basket:
+Les éléments épinglés constituent les éléments « par défaut » en terme de recherche.
+L'épinglage d'élément est un outil de travail permettant de travailler dans un contexte de travail donné.
 
-Paniers
--------
+**Exemple** : je souhaite travailler sur le mobilier d'une opération précise. En épinglant cette opération, par défaut, toutes les recherches de mobilier se feront sur cette opération.
+
+L'épinglage est disponible directement dans la barre d'outil des fiches.
+L'épinglage est aussi disponible dans le menu de gestion des sélections épinglées (à droite de la zone 4 sur l'image de l'interface générale).
+Un élément créé ou modifié est automatiquement épinglé.
+
+Une gestion hiérarchique des épingles est faites : le fait d'épingler un élément épingle automatiquement ses parents directs.
+
+**Exemple** : le faite d'épingler un mobilier épingle automatique l'Unité d'Enregistrement et l'opération archéologique associée à ce mobilier.
+
+Menu de gestion des sélections épinglées
+++++++++++++++++++++++++++++++++++++++++
+
+Ce menu propose de sélectionner les éléments que l'on souhaite épingler. Différentes versions de ce menu sont disponible : 
+- « simple » : des menus déroulants permettent d'épingler les éléments qui sont directement rattachés à notre compte utilisateur (en particulier les éléments que l'on a créé) ;
+- « avancé - mes éléments » : on épingle ici seulement les éléments rattachés à notre compte utilisateur mais avec des champs fonctionnant en autocompletion ;
+- « avancé - tous les éléments » : on peut épingler tous les éléments avec des champs en autocomplétion.
+
+Sur chaque menu, il est possible d'accéder aux fiches des différents éléments épinglés (icône « i ») et de détacher l'épingle sur ces éléments (croix rouge).
+
+Action rapide
+-------------
 
-Action rapide - édition en groupe
----------------------------------
+Pour les administrateurs, des actions rapides sont directement accessibles depuis les tableaux. Ces actions se situent en haut à droite du tableau. Elles concernent les éléments actuellement sélectionnés dans le tableau. Les icônes d'action rapide ne sont active que lorsque cela est pertinent : si une action n'est applicable qu'à un seul élément, en sélection aucun ou plusieurs désactive l'icône de l'action en question.
 
-Accessible seulement par les administrateurs
+Ces actions rapides permettent notamment de faire de l'édition de groupe, de l'empaquetage, etc.
 
 
 ..
-  TODO: expliciter les droits ?
+  TODO: expliciter les droits ? les notions de propriétés ?