Création ou modification d'un fichier XML de thésaurus

Le thésaurus de CES (Coveo Enterprise Search) est une liste de mots liés ou équivalents, utilisés afin d'agrandir les requêtes. Il fonctionne de manière transparente par l'ajout d'expressions à la recherche.

Si vous connaissez la structure des documents XML, la modification manuelle du fichier correspondant est une façon effective de remplir le thésaurus. Vous pouvez également ajouter des synonymes à l'aide de l'Outil d'administration (voir Ajout d'entrées de thésaurus à partir de l'Outil d'administration).

Important : Les erreurs de syntaxe XML désactivent le fichier du thésaurus et affiche le message suivant dans la page Thésaurus (Index > Thésaurus) : Object reference not set to an instance of an object.

Le tableau suivant décrit les balises et attributs valides qu'un fichier XML de thésaurus renferme.

Balise	Attribut	Description
mappings		Balise ouverture/fermeture du fichier de thésaurus.
mapping	keyword=	Identifie le mot auquel des synonymes sont ajoutés. Exemple : Pour ajouter Coveo à la requête CES, tapez : <mapping keyword="CES">. Ne tapez qu'un mot clé par balise mapping. Vous pouvez toutefois tapez une phrase exacte en guise du mot clé. Exemple : <mapping keyword="Coveo Enterprise Search">.
	type=	Indique l'opérateur ( or ou replace) qui est utilisé pour ajouter des synonymes à la requête. Exemple : robert devenant un synonyme de bob, si vous utilisez or, une requête pour bob devient bob OR robert. Si vous utilisez replace, la même requête devient robert. Note : Pour utiliser l'opérateur replace, le mot clé ne doit avoir qu'un seul synonyme. L'opérateur replace est incompatible avec l'attribut bidirectional=true.
	bidirectional=	Indique si la synonymie est réciproque ou non. Exemple : robert devenant un synonyme de bob, si vous utilisez true, une requête pour bob devient bob OR robert et une requête pour robert devient robert OR bob. Si vous utilisez false, une requête pour robert demeure robert. Note : L'attribut bidirectional=true est incompatible avec l'attribut type=replace.
synonyms		Encadre toutes les occurrences des balises synonym.
synonym	value=	Identifie l'expression à ajouter comme synonyme du mot clé. Exemple : Pour ajouter robert à la requête bob, tapez robert comme synonyme : <synonym value="robert"/>. Vous pouvez taper plus d'un synonyme pour un certain mot clé.

Création d'un fichier de thésaurus XML

1. À l'aide d'un éditeur de texte, créez un nouveau fichier vide.

2. Démarrez le contenu du fichier de thésaurus avec la balise d'ouverture <mappings>.

3. Tapez chaque association mot clé-synonyme dans le format illustré dans l'exemple suivant.

   <mapping keyword="bob" type="or" bidirectional="false">
     <synonyms>
       <synonym value="robert"/>
     </synonyms>
   </mapping>

4. Fermez le thésaurus avec la balise de fermeture </mappings>.

5. Sauvegardez le fichier avec un nom de votre choix et l'extension xml. Le dossier recommandé est [Index_Path]\Config.

   Exemple : C:\CES7\Config\MyThesaurus.xml

6. Importez le nouveau fichier de thésaurus dans CES pour l'activer (voir Importation d'un fichier de thésaurus XML dans CES).

Modification d'un fichier de thésaurus XML existant :

1. À l'aide d'un éditeur de texte, ouvrez le fichier de thésaurus existant.

   Exemple : C:\CES7\Config\DefaultThesaurus.xml

2. Tapez chaque association mot clé-synonyme dans le format suivant.

   <mapping keyword="bob" type="or" bidirectional="false">
     <synonyms>
       <synonym value="robert"/>
     </synonyms>
   </mapping>

3. Enregistrez le fichier.

4. Actualisez le thésaurus (voir Actualisation du thésaurus).