Résultats de recherche incomplets ou erronés (FTS)

Si les résultats de recherche n'apparaissent pas comme prévu dans votre produit BOC, cela peut être dû à un ensemble de données invalide ou obsolète dans l'index Full-Text Search (FTS).

Ce problème peut survenir si la tâche de nettoyage automatique qui supprime les anciens fichiers échoue, ou si le système ne dispose pas des autorisations de lecture/écriture nécessaires pour le dossier où l'index FTS est stocké. En général, ce dossier est le répertoire temporaire situé à : C:\Windows\TEMP

Une autre cause possible est une réinstallation de votre serveur web (par exemple, Apache Tomcat).
Si le fichier axw.ids n'est pas correctement transféré lors de ce processus, cela peut affecter négativement l'index de recherche. Si vous mettez à jour votre installation du service web tomcat, veuillez vous assurer de suivre notre guide :  Comment migrer la configuration côté Tomcat d'un produit BOC ?

Comment confirmer qu'il y a un problème avec mon index FTS ?

Les problèmes avec l'index FTS peuvent être identifiés dans les journaux du produit BOC.

Voici quelques exemples de ce à quoi ces entrées de journal peuvent ressembler :

[FATAL] [boc.adoxx.fulltext.JNIIndexWriter] Could not open index (C:\windows\TEMP\FTS_4092DF8C-2BA8-4C08-AC6A-1DDD8DC79353\{30961770-dd4b-4c94-b6a5-f892f8a12f67}-998775608189594953\{ab71db7b-a17a-4d10-be36-f33eb745f153}) org.apache.lucene.index.CorruptIndexException: Unexpected file read error while reading index. 
2023-11-24 08:36:38.142 [10484] [WARN] [Index Updater] Error during index update, returned code UnexpectedError 
2023-11-24 08:36:38.126 [10484] [ERROR] [C++Assert] expr: !pDocBuf->IndexClosed() code: NS_ERROR_FAILURE (0x80004005) file: ..\src\applications\fts\index\afts_index_updater.cxx line: 1179 

Pour savoir comment lire vos propres journaux, veuillez consulter notre guide des journaux.

Solution : Reconstruction manuelle de l'index FTS via le webclient

Ce guide s'applique à ADONIS 16, ADOIT 17, et ADOGRC et versions ultérieures. Pour les instructions applicables aux versions antérieures, veuillez cliquer ici.

Important : Sachez que cette option sollicite fortement les ressources du serveur et impactera les performances du déploiement lui-même. Il est fortement recommandé d'effectuer cette tâche en heures creuses.

1.) Connectez-vous à votre vue Administration avec un utilisateur administrateur et cliquez sur Plus d'options (1). 

 

2.) Choisissez l'option Serveur (2)

3.) Choisissez l'option Réinitialiser l'index de recherche (3) et confirmez votre saisie dans la fenêtre contextuelle suivante.

 

Reconstruction manuelle de l'index FTS via le webclient (versions inférieures à ADONIS 16, ADOIT 17 et ADOGRC 13)

1.) Ouvrez le webclient dans le navigateur internet de votre choix et connectez-vous à votre vue admin avec un utilisateur administrateur approprié. Pour plus de détails sur la façon d'accéder à votre vue admin, veuillez consulter la page Admin. Le chemin décrit est le même pour tous les produits BOC. 

2.) Une fois connecté, cliquez sur les 3 points dans le coin supérieur gauche et sélectionnez l'option Serveur

2.) Choisissez l'option Réinitialiser l'index de recherche et confirmez votre saisie dans la fenêtre contextuelle suivante.

Important : Sachez que cette option sollicite fortement les ressources du serveur et impactera les performances du déploiement lui-même. Il est fortement recommandé d'effectuer cette tâche en heures creuses.

Informations supplémentaires (uniquement sur site)

Une autre option pour reconstruire l'index FTS est de déplacer le dossier dans lequel l'index est écrit, notamment si l'accès à l'emplacement actuel est restreint.

Cela peut être réalisé en modifiant [PRODUCT]/conf/adoxx.conf avec un éditeur de votre choix.

Dans l'exemple suivant, l'index FTS est déplacé à l'intérieur du chemin d'installation du produit BOC en supprimant le symbole dièse avant ADOXX_INDEXES_DIR et en remplaçant %temp% par /_FTS

S'il est souhaité de déplacer l'index FTS vers un autre emplacement, le chemin complet est nécessaire. Un redémarrage complet doit être effectué ensuite.