Gestion des écrans de recherche

Modifié par Gwladys DUMAS le 2022/02/01 13:55

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.

Sommaire

Zones paramétrables
Fichier de paramétrage
Détail des paramètres
Paramétrage par défaut
Prise en compte de la gestion des champs sensibles

Zones paramétrables

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.

Sur l'écran de recherche simple, il est alors pertinent de pouvoir exploiter les index et thésaurus couramment utilisés.

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.

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.

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").

Elle vient s'insérer dans la zone "Termes" :

Fichier de paramétrage

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

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).

Ce fichier est spécifique à chaque institution et permet donc de garder facilement les configurations personnalisées lors des montées de version.

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.

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).

Détail des paramètres

1/ Liste d'index de recherche

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).

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.

<param name=\"filterAll_indexList\">MUS_DESIGNATION,MUS_LIEU_TOUS,[...],MUS_MATIERE_TECHNIQUE,MUS_REPRESENTATION</param>

2/ Opérateur intra-champ de recherche

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.

3/ Index principal de recherche

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).

<param name=\"filter_indexPrincipal\">MUS_NUM_INVENTAIRE</param>

4/ Champ principal de recherche avec modèle

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é.

<param name=\"filter_indexPrincipal_exemple\">ex: 2021.3.4 2016.2.34 "A 90" "sans numéro"</param>

5/ Filtre automatique sur présence d'un visuel

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.

6/ Filtre automatique sur le musée de l'utilisateur

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.

Elle apparaît si le paramètre filter-my-musee du groupe museum-context est activé (valeur "true") dans le fichier de paramétrage.

    <param-group name=\"museum-context\">
       <param name=\"show-filter-my-musee\">true</param>
   </param-group>

Elle est présente dans les recherches simples et expertes des tables biens, entrées, photo, biblio et vidéo.

7/ Index permettant de limiter ou d'exclure des éléments des recherches

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".

8/ Index complémentaire pour limiter les recherches selon les valeurs sélectionnées dans une liste

Équivalent à la première option du groupe de champ précédent, il permet de limiter sa recherche selon certaines valeurs.

Il fait appel à trois paramètre :

filter_byList qui détermine la liste de valeurs à proposer.
filter_byList_index donne l'index à appeler.
filter_byList_label, texte libre, qui sera affiché sur l'écran de recherche, à droite du "Par ".

<param name=\"filter_byList\">MUS_PREFIXENUMINV.lst</param>
<param name=\"filter_byList_index\">MUS_MUSEE</param>
<param name=\"filter_byList_label\">musée</param>

9/ Filtrer selon certaines listes d'index

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.

<param name=\"filter_indexList\">MUS_DISCIPLINE,MUS_DOMAINES,MUS_MUSEE,[...],MUS_ETAT_AVANCE_SAISIE,MUS_ETAT_VISA</param>

10/ Filtrer selon les thésaurus liés

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.

<param name=\"filterThesaurus_indexList\">MUS_TH_DOMAINE,MUS_TH_NOM_SCIENT,[...],MUS_TH_LIEU,MUS_TH_UTILISATION,MUS_TH_EMPLACEMENT</param>

11/ Filtrer sur des index de date

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.

<param name=\"filter_Dates\">MUS_DATATIONS,MUS_DATE_COLLECTE_DEBUT,MUS_DATE_DECOUVERTE_DEBUT</param>

12/ Recherche texte intégral

Le paramètre filter_indexFullText permet de donner le nom de l'index (généralement FULLTEXT) sur la table.

<param name=\"filter_indexFullText\">FULLTEXT</param>

Paramétrage par défaut

Exemple pour la table des biens (MUS_BIENS).

<param-group name=\"museum-context\">
       
       <param name=\"show-filter-my-musee\">true</param>
   </param-group>

   <param-group name=\"list_index_MUS_BIEN\">
       <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>
       <param name=\"filter_includeIndex\">MUS_TYPE_BIEN</param>
       <param name=\"filter_includeList\">MUS_TYPE_BIEN.lst</param>
       <param name=\"filter_indexPrincipal\">MUS_NUM_INVENTAIRE</param>
       <param name=\"filter_indexPrincipal_exemple\">ex: 2021.3.4 2016.2.34 "A 90" "sans numéro"</param>
       <param name=\"filter_byList\">MUS_PREFIXENUMINV.lst</param>
       <param name=\"filter_byList_index\">MUS_MUSEE</param>
       <param name=\"filter_byList_label\">musée</param>
       <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>
       <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>
       <param name=\"filterPhoto\">true</param>
       <param name=\"filter_Dates\">MUS_DATATIONS,MUS_DATE_COLLECTE_DEBUT,MUS_DATE_DECOUVERTE_DEBUT</param>
   </param-group>

Prise en compte de la gestion des champs sensibles

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).

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 !

Pour cela chaque groupe de paramètre peut être doublé, l'un étant précédé du prefixe "secure."

<param-group name=\"secure.list_index_MUS_BIEN\">

Ce groupe contiendra les index sur les champs sensibles du musée et l'autre ne les présentera pas.

Tags :

Créé par XWikiGuest le 2021/07/15 10:10