Page History

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Pour indexer définir cette nouvelle métadonnée il suffit de remplir le fichier liusConfig.xml du dossier [ORI_HOME]/src/dans le module ORI-OAI-indexing, il est nécessaire

Note
titleRecopie des fichiers de configuration

Pour définir cette nouvelle métadonnée dans le module ORI-OAI-indexing, il est nécessaire de modifier ces fichiers :

  • [PATH_CUSTOM_CONFIG]/ori-oai-indexing/config/fieldsConfig.xml
  • [PATH_CUSTOM_CONFIG]/ori-oai-indexing

...

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.

  • /config/solr_home/prod-public/conf/schema.xml

Par défaut, lors de l'initialisation de la configuration, ces fichiers ne sont pas présents. Ils doivent être recopiés manuellement depuis les sources du module vers le dossier cité ci-dessus.
Une fois le fichier recopié, vous pourrez le modifier et redéployer le module. Le fichier présent dans [PATH_CUSTOM_CONFIG]/ori-oai-indexing sera alors prioritaire sur celui fourni par défaut et votre configuration tiendra compte de vos modifications.

Les fichiers sont à recopier à partir des dossiers suivants en fonction du fichier :

  • fieldsConfig.xml : [ORI_HOME]/src/ori-oai-indexing-svn/indexingCore/src/main/resources/fieldsConfig.xml
  • schema.xml : [ORI_HOME]/src/ori-oai-indexing-svn/indexingCore/src/main/resources/solr_home/prod-public/conf/schema.xml

Fichier fieldsConfig.xml

Définir le Xpath où aller lire la donnée

...

Cette partie est délimitée par la balise <xmlFile ns="http://ltsc.ieee.org/xsd/LOM" prefix="lom" ....>.

<index>. A l'intérieur de celle-ci se trouvent divers formats trouve le format de métadonnées indexables dont celui indexable 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 :

Code Block
xml
xml

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

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

xpathSelect

Correspond

...

au xpath permettant de retrouver la métadonnée à indexer

...

...

name

Donne un nom à cette métadonnée. Ce nom est

...

obligatoirement le même que celui qui sera défini dans le fichier schema.xml.

Pour permettre de donner un libellé plus lisible à cette donnée dans l'affichage du moteur de recherche, il est possible de donner une correspondance avec un libellé trouvé dans un vocabulaire donné.
Pour cela, il faut s'intéresser au bloc <transformations>.

Ajoutez dans ce bloc ceci

...

  • 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 :

Code Block
xml
xml

,%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 :
Image Removed

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

<metadata format="vocabulary:common_lom_educ_semantic_density" xpathSelect="//lom:educational/lom:semanticDensity/lom:value"/>

Ceci ajoutera des attributs dans la version "traduite" de la fiche, notamment le libellé associé à la valeur présente dans la fiche.

Fichier schema.xml

Ce fichier définit le schéma d'indexation et de recherche du moteur Solr.

Pour que notre nouvelle métadonnée soit prise en compte par Solr, il faut obligatoirement la définir ici en s'inspirant de la définition des autres métadonnées 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 :

Code Block
xml
xml

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

Vous devriez obtenir l'affichage suivant :
Image Removed

...

<field name="lom.educational.semanticDensity" type="string" indexed="true" stored="true" multiValued="true" />

name

Nom de la métadonnée. Doit obligatoirement être le même que celui défini dans fieldsConfig.xml

type

Type de la métadonnée. Comme ici, la métadonnée est une valeur dans une liste fermée de choix, elle doit être traitée en tant que token en dehors de toute langue. Dans ce cas, c'est le type string qui correspond dans Solr.

indexed

Dit si oui ou non on indexe la valeur pour pouvoir rechercher dessus.

stored

Dit si oui ou non on stocke la valeur pour pouvoir l'afficher depuis le moteur de recherche dans les résultats.

multiValued

Indique si cette métadonnée est multivaluée ou non.

Prise en compte des modifications

...

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

...