04 - Indexation et recherche dans ori-oai-indexing

Pour indexer cette métadonnée il suffit de remplir le fichier liusConfig.xml du dossier [ORI_HOME]/src/ori-oai-indexing-svn/properties. Ce fichier est décomposé en trois parties.

La première concerne l'indexation. Toutes les métadonnées à indexer sont représentées sous forme de Xpath. La seconde permet d'indiquer les métadonnées sur lesquelles on souhaite faire des recherches. La troisième indique quelles métadonnées on souhaite pouvoir récupérer pour l'affichage des résultats.

Pour que cette métadonnée soit correctement indexée et que l'on puisse effectuer des requêtes sur celle-ci, les trois parties doivent être renseignées.

Ajout de la métadonnée dans la partie indexation

Cette partie est délimitée par la balise <index>. A l'intérieur de celle-ci se trouvent divers formats de métadonnées indexables dont celui qui nous intéresse : le format LOM. On peut le reconnaître grâce au commentaire <!-- LOM -->. Il existe beaucoup de métadonnées à indexer dans ce format. Pour plus de clarté ces dernières ont été triées par type (général, cycle de vie, méta-métadonnées, technique ...). La métadonnée que nous souhaitons ajouter se trouve dans la partie « Pédagogie ». A l'intérieur de cette partie, ajoutez la ligne suivante :

<luceneField name="%2F%2Flom%3Aeducational%2Flom%3AsemanticDensity%2Flom%3Avalue" xpathSelect="//lom:educational/lom:semanticDensity/lom:value" type="Text"/>

En consultant le fichier, vous devriez donc obtenir l'affichage suivant :

  • L'attribut « xpathSelect » correspond au xpath permettant de retrouver la métadonnée à indexer.
  • L'attribut « name » donne un nom à cette métadonnée. Ce nom est en réalité l'encodage UTF-8 du xpath. Pour plus de facilité d'administration, il aurait été plus pratique d'utiliser le xpath tel quel comme nom de métadonnée. Mais ceci s'avère impossible car le xpath contient le caractère ":", caractère utilisé dans une requête Lucene. Par convention le groupe ORI-OAI a donc choisi d'encoder ce xpath en UTF-8, qui évite l'utilisation du caractère ":" tout en conservant dans le nom le chemin vers la métadonnée.
    Depuis la version 1.5, vous pouvez facilement encoder un xpath grâce à l'onglet "Métadonnées et UTF-8" de la partie Visualisation du module.
  • L'attribut « type » définit le type de métadonnée. Trois types sont possibles : Text, ConcatDate et Vcard.
    • ConcatDate sera utilisé pour indexer une date.
    • Vcard sera utilisé si le champ à indexer contient une vCard.
    • Text sera choisi dans tous les autres cas.

Ajout de la métadonnée dans la partie recherche

Cette partie est délimitée par la balise <search>. A l'intérieur de celle-ci se trouve la balise <searchFields> qui contient tous les noms de métadonnées séparés par une virgule. Pour permettre d'effectuer des requêtes sur cette métadonnée, ajoutez la ligne suivante en n'oubliant pas la virgule au début :

,%2F%2Flom%3Aeducational%2Flom%3AsemanticDensity%2Flom%3Avalue

Il s'agit du nom de métadonnée défini dans la partie indexation. Vous devriez obtenir l'affichage suivant en consultant le fichier liusConfig.xml :

Ajout de la métadonnée dans la partie affichage des résultats

Cette partie est délimitée par la balise <searchResults>. A l'intérieur de celle-ci se trouve la balise <fieldsToDisplay> qui contient les métadonnées à afficher. Ajoutez la ligne suivante :

<luceneField name="%2F%2Flom%3Aeducational%2Flom%3AsemanticDensity%2Flom%3Avalue" label="//lom:educational/lom:semanticDensity/lom:value"/>

Vous devriez obtenir l'affichage suivant :

  • L'attribut « name » correspond au nom donné à la métadonnée dans la partie indexation.
  • L'attribut « label » est le nom qui sera transmis au module effectuant la recherche. Le nom est en réalité le xpath permettant d'accéder à la métadonnée.

Sauvegardez ensuite ce fichier. Il vous reste alors à redéployer le module d'indexation. Cette opération se déroule en trois étapes :

  • Lancez : [ORI_HOME]/tomcat-indexing/bin/shutdown.sh pour stopper le serveur tomcat dédié au module d'indexation.
  • Placez-vous dans le répertoire « [ORI_HOME]/src/ori-oai-quick-install-svn » et tapez : ant all-indexing pour redéployer le module.
  • Lancez [ORI_HOME]/tomcat-indexing/bin/startup.sh pour démarrer le serveur tomcat dédié au module d'indexation.

Le module d'indexation est maintenant prêt à être utilisé.

  • No labels