La recherche full-text est accessible dans le bandeau supérieur de l'application.
La disponibilité de la recherche full-text dépend de votre installation.
Elle ne peut être accessible que si un cluster Elasticsearch® a été déployé dans votre environnement.
Consultation
La recherche full-text :
- est accessible à partir de toutes les fonctionnalités de l'application,
- s'active à partir de 3 caractères saisis,
- permet d'effectuer des recherches sur les entités et les fonctionnalités disponibles dans l'application,
- se réalise sur les codes (pour les entités) et libellés (pour les fonctionnalités et les entités).
Lorsque la recherche est exécutée, les résultats apparaissent dans une liste de suggestions contenant les informations suivantes :
Résultat de type fonctionnalité
: icône définissant un résultat de recherche de type fonctionnalité.- Nom de la fonctionnalité : contenant les caractères de recherche saisis.
→ Le clic sur une ligne dans la liste de suggestions ouvre le résultat de recherche de la fonctionnalité.
Résultat de type entité
: icône définissant un résultat de recherche de type entité.- Code de l'entité : contenant les caractères de recherche saisis. Les caractères saisis correspondent uniquement au préfixe du code.
- Libellé de l'entité : contenant les caractères de recherche saisis.
- Type de l'entité.
→ Le clic sur une ligne dans la liste de suggestions ouvre le détail de l'entité.
Configuration
Par défaut, l'ensemble des entités déclarées dans le fichier elasticIndexing.xml sont indexées sur le code et le libellé. Il s'agit des entités contenant un écran de détail associé.
Il est possible d'indexer d'autres attributs à partir de la configuration du dictionnaire.
Il arrive que les données d'un objet ne soient pas retournées par la recherche full-text alors que l'objet est pourtant bien spécifié comme "Indexé".
Via quelques manipulations, il est possible de vérifier qu'une table est bien indexée et de relancer l'indexation le cas échéant.
Prérequis
- Sur le serveur hébergeant Elasticsearch®, l'outil en ligne de commande cURL doit être disponible.
- Dans CARL Source, un traitement automatique utilisant la classe CSJOBINDEXER doit être présent.
Opérations
Se connecter à un serveur hébergeant l'un des nœuds du cluster Elasticsearch® de votre environnement.
- Pour consulter la liste des index déjà référencés, consultez dans un navigateur l'URL : http://localhost:port/_cat/indices
→ Remplacer port par le port utilisé par Elasticsearch® (par défaut il s'agit du port 9200, mais vérifiez la configuration au niveau de la déclaration dans CARL Source Admin).
- Si la table recherchée apparait bien dans cette liste, vous pouvez nettoyer la totalité des index en exécutant la commande suivante dans un terminal : curl -X DELETE http://localhost:port/_all
→ A nouveau, veillez à adapter la valeur correspondant à port.
- Dans CARL Source, exécutez alors le traitement automatique utilisant la classe CSJOBINDEXER.
→ Si le traitement s'exécute correctement, l'indexation doit prendre en compte les données qui n'étaient jusque-là pas retournées par la recherche.