1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
|
.. -*- coding: utf-8 -*-
=====================
Interface utilisateur
=====================
:Auteur: Étienne Loks
:Date: 2018-10-02
:Copyright: CC-BY 3.0
Interface générale
==================
L'interface générale se découpe en 4 zones :
1. zone de profil
2. menu d'actions
3. zone centrale
4. zone d'alerte et de sélection épinglée
.. image:: _static/interface-generale.png
La capture d'écran ci-dessous reprend l'interface « bureau ». L'interface mobile reprend les mêmes éléments dans une version compacte : la zone de profil est accessible via l'icône « hamburger » à droite, le menu d'action est repris en haut en position centrale.
Zone de profil
--------------
La zone de profil reprend, dans l'ordre :
- le nom de l'instance Ishtar (ici « Démo »),
- le nom de l'utilisateur et le nom du profil en cours d'utilisation - en cliquant sur ces noms, on accède à un sous-menu permettant de modifier son profil, changer son mot de passe et se déconnecter,
- si plusieurs langues sont disponibles, une icône drapeau qui permet de changer la langue,
- si on a les droits administrateur, une icône engrenage qui permet à accéder aux pages spécifiques d'administration (cf. documentation administrateur).
Menu d'actions
--------------
Ce menu reprend les différentes pages disponibles en fonction des droits dont dispose l'utilisateur et des modules activés dans Ishtar.
Visible à tout moment il permet visuellement d'identifier immédiatement le contexte.
Ce menu est organisé de manière hiérarchique :
- le premier niveau reprend les éléments généraux : Opération, Unité d'Enregistrement, Mobilier, etc. ainsi que des sections génériques telles que Imports ou Annuaire.
- le second niveau fourni le détail des actions disponibles en fonction du premier niveau sélectionné. Classiquement pour les éléments généraux (si l'on dispose des droits adéquats), il y des actions de « Recherche », « Ajout », « Modification » et « Suppression ». Si des sous-élements sont disponibles (les « Contenants » dans le menu « Lieu de conservation »), ils sont accessibles après ces actions de base.
- le troisième niveau rend disponible les actions des sous-éléments.
La sélection d'un élément du premier niveau charge automatiquement la page de la première action du second niveau. De même la sélection d'un sous-menu dans le second niveau, charge automatiquement la première action du troisième niveau correspondant.
Zone centrale
-------------
La zone centrale est totalement contextuelle. Néanmoins si certaines pages d'action ont une logique particulière, la plupart des pages d'action sur les éléments généraux s'ouvrent sur une « :ref:`page de recherche <page-de-recherche>` » et les actions d'ajout, modification et suppression suivent ensuite une logique de « :ref:`page de wizard <wizard>` » (ou assistant logiciel). Le détail des ces pages est décrit dans les sections suivantes de cette documentation.
Zone d'alerte et de sélection épinglée
--------------------------------------
Cette zone reprend les éventuelles alertes (cf. :ref:`Page de recherche > Marques-pages et alertes <bookmarks>`), mise en place par l'utilisateur ainsi que les éléments actuellement épinglés (cf. :ref:`Utilisation avancée > Éléments épinglés <pinned>`).
.. _page-de-recherche:
Page de recherche
=================
La page de recherche comporte une barre de recherche et d'un tableau de résultat.
Recherche textuelle et par critères
-----------------------------------
La barre de recherche est composée d'une zone de saisie et d'une série d'icônes d'outils de recherche. Dans l'ordre ces icônes permettent de :
- icône loupe : lancer la recherche,
- icône engrenage : accéder à la recherche par facette,
- icône croix : vider la zone de recherche,
- icône étoile : enregistrer une alerte, un marque-page,
- icône marque-page : accéder aux marques-pages (les supprimer).
Lorsqu'aucune recherche n'est active par défaut et que la zone de saisie est vide tous les éléments de la base de données sont listés.
La zone de recherche permet deux types de recherches distinctes une recherche libre et une recherche par facette.
Recherche libre
+++++++++++++++
Chaque élément de la base de données est indexé afin de pouvoir permettre ce type de recherche de manière performante. Propriétés et descriptions rattachées aux éléments sont indexés. De même chaque élément parent est compris dans l'index de l'élement enfant.
Plus précisément :
- l'index de recherche d'une opération comprend les propriétés des sites/entités archéologiques liés ;
- l'index de recherche d'un site/entité archéologique comprend les propriétés des opérations liées ;
- l'index de recherche d'une Unité d'Enregistrement comprend les propriétés des opérations et des sites/entités archéologiques liés ;
- l'index de recherche du mobilier comprend les propriétés des opérations, des sites/entités archéologiques et Unité d'Enregistrement liés.
Les indexes de recherche permettent de faire des recherches en s'affranchissant des pluriels et de la casse.
**Exemple** : des recherches sur les termes « AMPHORE », « AMPHORES » et « amphores » renverront bien tous les éléments concernant des amphores.
.. 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.
**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.
..
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.
**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.
**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.
.. _bookmarks:
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.
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.
Tableaux
--------
Les tableaux se présentent de la même manière que les tableaux web « classiques » avec possibilité d'afficher plus ou moins de lignes de tableaux (entre 10 et 100), possibilité de tri par colonne et une pagination.
Dans Ishtar, la première colonne est systématiquement une icône permettant d'accéder à la :ref:`fiche <sheet>` associé à l'élement de cette ligne du tableau.
En tant qu'administrateur, sur certains tableaux, des actions rapides en haut à droite permettant des actions sur les éléments actuellement sélectionnés.
En bas du tableau, sur la gauche un bouton permet d'afficher le tableau en pleine page pour une meilleure lisibilité.
À la suite de ce bouton différents boutons d'export en CSV du tableau courant sont disponibles. Ces exports peuvent être configurés en administration.
.. _sheet:
Fiches
------
En s'ouvrant, les fiches se placent au dessus de la page courante (généralement au dessus d'un tableau).
Entête
++++++
Une fiche se compose tout d'abord d'une entête. Cette entête est composé de :
- un titre : ce titre reprend la dénomination précise de l'élément. En cliquant sur ce titre, la fiche se replie.
- de flêches de navigations (si pertinent) : dans le cadre d'une fiche ouverte depuis un tableau, ces flêches permettent de naviger entre éléments du tableau. Il n'est possible pour l'instant que de naviguer parmi les éléments actuellement affichés dans le tableau.
- d'une flèche de fermeture de la fiche.
Barre d'outil
+++++++++++++
Juste en dessous de l'entête une barre d'outil est présente.
Tout à gauche, lorsque plusieurs versions d'une même fiche sont disponible, il est possible de naviguer parmi les différentes versions de cette fiche.
Ensuite sur la droite, différentes action sont disponibles. Ces actions dépendent du type d'élément sélectionné. Généralement on y trouve :
- une icône « épingle » : elle permet d'épingler l'élément de la fiche (cf. :ref:`épinglage <pinned>`).
- une icône « crayon » : si l'on dispose des droits adéquats, elle permet d'éditer cette fiche. On accède au premier volet des pages d'assistants dédié à l'édition de ce type d'élément.
- des icônes « + » : ces icônes permettent d'associer facilement un type particulier d'élément à l'élément de la fiche courrante. Par exemple « + doc./image » permet d'associer un document/une image à l'élément de la fiche.
- les icônes « ODT », « PDF » : ces icônes permettent un export ODT ou PDF de la fiche actuelle.
Contenu de la fiche
+++++++++++++++++++
Les fiches présentent globalement les informations relatives à un élément.
Lorsque ces informations sont en relations avec d'autres éléments qui disposent eux aussi des fiches une icône « i » d'information est affiché à côté permettant ainsi de sauter de fiche en fiche.
Navigation entre fiches
+++++++++++++++++++++++
Un rappel des fiches ouvertes est disponible sur la droite. En cliquant sur un élément de cette liste, la page scrolle jusque la fiche correspondante.
.. _wizard:
Page d'assistant logiciel (wizard)
==================================
Fil d'ariane
------------
Tableau / Zone de formulaire
----------------------------
Zone de validation
------------------
Utilisation avancée
===================
.. _pinned:
Éléments épinglés
-----------------
.. _basket:
Paniers
-------
Action rapide - édition en groupe
---------------------------------
Accessible seulement par les administrateurs
..
TODO: expliciter les droits ?
|
