Skip to Content
Modifié par admin admin le 2025/05/26 16:12
Masquer les derniers auteurs
admin admin 1.1 1 Chaque table de Flora peut être interrogée à minima au moyen d'un écran de recherche simplifié. C'est le plus couramment utilisé et son contenu peut être adapté aux besoins spécifiques de chaque institution.
2
3 {{box title="**Sommaire**"}}
4 {{toc/}}
5 {{/box}}
6
7 = Zones paramétrables =
8
9 Chaque écran de recherche a un gabarit adapté aux données à interroger et s'appuie notamment sur les index de données ou, le cas échéant, sur les capacités de Flora d'exploiter l'autopostage des thésaurus.
10
11 Sur l'écran de recherche simple, il est alors pertinent de pouvoir exploiter les index et thésaurus couramment utilisés.
12
13 Certaines zones de l'écran donné en exemple ci-dessous (recherche simple sur les biens) vont être présents automatiquement selon les informations présentent dans la base de donnée. Ainsi, la listes de filtrage selon les préfixes musée n'apparaît que lorsque le fichier de contrôle MUS_PREFIXENUMINV.lst contient au moins deux valeurs.
14
15 Chaque institution présente des données de type différent et il faut donc pouvoir paramétrer les écrans de Flora en conséquence.
16
17 [[image:2021-08-09_16h03_03.png]]
18
19 Une zone supplémentaire de recherche en texte intégrale vient s'ajouter à celles mentionnées ici et ne concerne que certaines tables gérant les documents joint ("Autres documents", "Catalogue Unimarc", "Pièce d'archive" et "Constats d'état").
20
21 Elle vient s'insérer dans la zone "Termes" :
22
23 [[image:2021-08-09_16h04_36.png]]
24
25 = Fichier de paramétrage =
26
27 En attendant la version 5 de Flora, le paramétrage des écrans de recherche se fait dans un fichier xml dédié : /conf/local/musee/musee_specific/app.xml
28
29 Les paramètres décrits ici sont regroupés au sein de **param-group** généraux à l'application (//museum-context//) ou spécifiques à certaines zones (//list_index_MUS_BIEN// par exemple).
30
31 Ce fichier est spécifique à chaque institution et permet donc de garder facilement les configurations personnalisées lors des montées de version.
32
33 Note : L'ordre de saisie des valeurs dans ces paramètres à une influence sur leur ordre d'affichage dans les différents éléments concernés (séries de case à cocher, listes déroulantes...). Il est ainsi possible d'effectuer des regroupements par thèmes ou par ordre d'intérêt en fonction des données présentent dans la base.
34
35 Les changements effectués dans ce fichier ne nécessite pas de redémarrage mais un simple //rechargement des paramètres// (menu administration - Système).
36
37
38 = Détail des paramètres =
39
40 == 1/ Liste d'index de recherche ==
41
42 Par défaut et praticité, L'index sélectionné à positionner en premier dans le paramétrage est l'index "Tous les champs" (Ex. MUS_ALL_FIELDS).
43
44 La liste des index présentés se définit au sein du paramètre //filterAll_indexList //du groupe dédié au listes d'index de chaque table (//list_index_MUS_BIEN //pour la recherche sur les biens) ou cette fonctionnalité est présente sur l'écran de recherche.
45
46 {{code}}
47 <param name=\"filterAll_indexList\">MUS_DESIGNATION,MUS_LIEU_TOUS,[...],MUS_MATIERE_TECHNIQUE,MUS_REPRESENTATION</param>
48 {{/code}}
49
50 == 2/ Opérateur intra-champ de recherche ==
51
52 Cet opérateur, équivalent au ET/OU des versions précédentes permet de déterminer si tous les termes doivent être présents dans chaque occurrences de la réponse ou si un seul des terme suffit.
53
54 == 3/ Index principal de recherche ==
55
56 Sélectionner ici l'index sur le champ le plus couramment utilisé en recherche sur la table concernée (numéro d'inventaire par exemple pour les biens).
57
58 {{code}}
59 <param name=\"filter_indexPrincipal\">MUS_NUM_INVENTAIRE</param>
60 {{/code}}
61
62 == 4/ Champ principal de recherche avec modèle ==
63
64 Le contenu de ce champ peut présenter en grisé un texte d'explication. Chaque musée peut l'adapter via le paramètre //filter_indexPrincipal_exemple//. Si le paramètre est absent ou vide, rien ne sera affiché.
65
66 {{code}}
67 <param name=\"filter_indexPrincipal_exemple\">ex: 2021.3.4 2016.2.34 &quot;A 90&quot; &quot;sans numéro&quot;</param>
68 {{/code}}
69
70 == 5/ Filtre automatique sur présence d'un visuel ==
71
72 L'activation de se paramètre (avec la valeur "true") sur une table permet l'apparition d'une case à cocher qui permet de n'avoir en résultat que des enregistrements liés à une image.
73
74 {{code}}
75 <param name=\"filterPhoto\">true</param>
76 {{/code}}
77
78 == 6/ Filtre automatique sur le musée de l'utilisateur ==
79
80 Cette case est cochée par défaut et permet de limiter la recherche aux notices du musée paramétré au niveau du compte de l'utilisateur.
81
82 Elle apparaît si le paramètre //filter-my-musee //du groupe //museum-context// est activé (valeur "true") dans le fichier de paramétrage.
83
84 {{code}}
85 <param-group name=\"museum-context\">
86 <param name=\"show-filter-my-musee\">true</param>
87 </param-group>
88 {{/code}}
89
90 Elle est présente dans les recherches simples et expertes des tables biens, entrées, photo, biblio et vidéo.
91
92 == 7/ Index permettant de limiter ou d'exclure des éléments des recherches ==
93
94 Ces deux champs sont automatiquement reliés au même index via le paramètre //filter_includeList//. Celui ci permet de déterminer quelle liste de valeur va permettre de limiter la recherche soit sous la forme "uniquement les résultats de type..." soit sous la forme "tous les résultats, sauf ceux de type".
95
96 {{code}}
97 <param name=\"filter_includeList\">MUS_TYPE_BIEN.lst</param>
98 {{/code}}
99
100 == 8/ Index complémentaire pour limiter les recherches selon les valeurs sélectionnées dans une liste ==
101
102 Équivalent à la première option du groupe de champ précédent, il permet de limiter sa recherche selon certaines valeurs.
103
104 Il fait appel à trois paramètre :
105
106 * //filter_byList //qui détermine la liste de valeurs à proposer.
107 * //filter_byList_index// donne l'index à appeler.
108 * //filter_byList_label//, texte libre, qui sera affiché sur l'écran de recherche, à droite du "Par ".
109
110 {{code}}
111 <param name=\"filter_byList\">MUS_PREFIXENUMINV.lst</param>
112 <param name=\"filter_byList_index\">MUS_MUSEE</param>
113 <param name=\"filter_byList_label\">musée</param>
114 {{/code}}
115
116 == 9/ Filtrer selon certaines listes d'index ==
117
118 La liste des index proposée est paramétrable via le paramètre //filter_indexList //du groupe dédié au listes d'index de chaque table.
119
120 {{code}}
121 <param name=\"filter_indexList\">MUS_DISCIPLINE,MUS_DOMAINES,MUS_MUSEE,[...],MUS_ETAT_AVANCE_SAISIE,MUS_ETAT_VISA</param>
122 {{/code}}
123
124 == 10/ Filtrer selon les thésaurus liés ==
125
126 Les thésaurus présentés sont paramétrés quant à eux, via le paramètre //filterThesaurus_indexList //du groupe dédié au listes d'index de chaque table.
127
128 {{code}}
129 <param name=\"filterThesaurus_indexList\">MUS_TH_DOMAINE,MUS_TH_NOM_SCIENT,[...],MUS_TH_LIEU,MUS_TH_UTILISATION,MUS_TH_EMPLACEMENT</param>
130 {{/code}}
131
132 == 11/ Filtrer sur des index de date ==
133
134 Le paramètre //filter_Dates //permet de lister les index liés aux dates de la tables. Ces index peuvent être composites (plusieurs champs) ou non. L'écran donnent deux champs de bornes. Le premier (11a) permet de retourner toutes les dates supérieures ou égales à la date saisie, le second (11b), les dates inférieures ou égales.
135
136 {{code}}
137 <param name=\"filter_Dates\">MUS_DATATIONS,MUS_DATE_COLLECTE_DEBUT,MUS_DATE_DECOUVERTE_DEBUT</param>
138 {{/code}}
139
140 == 12/ Recherche texte intégral ==
141
142 Le paramètre //filter_indexFullText //permet de donner le nom de l'index (généralement FULLTEXT) sur la table.
143
144 {{code}}
145 <param name=\"filter_indexFullText\">FULLTEXT</param>
146 {{/code}}
147
148 = Paramétrage par défaut =
149
150 Exemple pour la table des biens (MUS_BIENS).
151
152 {{code}}
153 <param-group name=\"museum-context\">
154 <!-- show-filter-my-musee : quand il est à true. ce paramétre fait apparaitre une case à cocher \"uniquement les notices de mon musée\" dans les recherches
155 simples et expertes des tables biens, entrées,photo,biblio,video -->
156 <param name=\"show-filter-my-musee\">true</param>
157 </param-group>
158
159 <param-group name=\"list_index_MUS_BIEN\">
160 <param name=\"filterAll_indexList\">MUS_ALL_FIELDS,MUS_PERSONNE_AUTEUR_TEXTE,MUS_NUM_INVENTAIRE,MUS_NIVEAU_INTERET,MUS_DESIGNATION,MUS_APPELLATION,MUS_TYPOLOGIE,MUS_IDENTIFICATION_SN,MUS_DATATIONS,MUS_BIEN_MATIERE,MUS_LIEU_TOUS,MUS_MATIERE_TECHNIQUE,MUS_REPRESENTATION,MUS_EMPLACEMENT,MUS_UTILISATION_UTILISATION,MUS_ROLE_AUTEUR</param>
161 <param name=\"filter_includeIndex\">MUS_TYPE_BIEN</param>
162 <param name=\"filter_includeList\">MUS_TYPE_BIEN.lst</param>
163 <param name=\"filter_indexPrincipal\">MUS_NUM_INVENTAIRE</param>
164 <param name=\"filter_indexPrincipal_exemple\">ex: 2021.3.4 2016.2.34 &quot;A 90&quot; &quot;sans numéro&quot;</param>
165 <param name=\"filter_byList\">MUS_PREFIXENUMINV.lst</param>
166 <param name=\"filter_byList_index\">MUS_MUSEE</param>
167 <param name=\"filter_byList_label\">musée</param>
168 <param name=\"filter_indexList\">MUS_DISCIPLINE,MUS_DOMAINES,MUS_ENSEMBLES,MUS_COLLECTION,MUS_STATUT_BIEN,MUS_EVENEMENT_ASSOCIE,MUS_MUSEE,MUS_ETAT_AVANCE_SAISIE,MUS_ETAT_VISA</param>
169 <param name=\"filterThesaurus_indexList\">MUS_TH_DOMAINE,MUS_TH_NOM_SCIENT,MUS_TH_NATURE,MUS_TH_TECH,MUS_TH_GARNIER,MUS_TH_LIEU,MUS_TH_UTILISATION,MUS_TH_EMPLACEMENT,MUS_TH_PARCOURS</param>
170 <param name=\"filterPhoto\">true</param>
171 <param name=\"filter_Dates\">MUS_DATATIONS,MUS_DATE_COLLECTE_DEBUT,MUS_DATE_DECOUVERTE_DEBUT</param>
172 </param-group>
173 {{/code}}
174
175 = Prise en compte de la gestion des champs sensibles =
176
177 Dans Decalog Flora, il est possible de définir des champs dits sensibles qui seront masqués par l'attribution d'un rôle particulier (//musee_view_confid_fields//).
178
179 Par exemple, l'emplacement dans le musée des biens est masqué à certaines personnes ayant accès en consultation au données. Il apparaît donc nécessaire de ne pas offrir la possibilité de faire des recherches sur cette information !
180
181 Pour cela chaque groupe de paramètre peut être doublé, l'un étant précédé du prefixe "//secure.//"
182
183 {{code}}
184 <param-group name=\"secure.list_index_MUS_BIEN\">
185 {{/code}}
186
187 Ce groupe contiendra les index sur les champs sensibles du musée et l'autre ne les présentera pas.