---

La bibliothèque dédiée fournie dans /application/libraries/Elasticsearch.php) permet d'intégrer l'indexation et la recherche avec Elasticsearch à votre application : outre les habituelles fonctions d'indexation par lots (en l'occurence par collections), chora permet également aux utilisateurs disposant de droits de gestion (manage) qui le souhaitent de pouvoir effectuer —ou mettre à jour— l'indexation d'un seul document : qu'il s'agisse d'un contenu autre ou d'un fichier attaché.

Les fichiers PDF, Word ou Excel seront automatiquement convertis en texte lorsque cela est possible et leur contenu pourra ensuite être être l'objet de recherches plein texte, sans qu'il n'y ait besoin d'installer un module particulier pour Elasticsearch.

Pour mémoire et selon ses auteurs,

Elasticsearch est un moteur de recherche et d'analyse RESTful distribué, conçu pour répondre à une multitude de cas d'utilisation. Et leur liste ne cesse de s'enrichir. Véritable clé de voûte de la Suite Elastic, il centralise le stockage de vos données et vous permet d'élargir le champ des possibles. Vos données n'ont plus aucun secret pour vous.

 

Activer la recherche avec Elasticsearch

Pour activer l'indexation et la recherche des contenus de chora avec Elasticsearch, vous devrez commencer par installer ce dernier en version 5.4 ou supérieure, par exemple sur votre hôte http (cela peut être fait à l'aide d'un paquet système ou d'un installateur graphique .msi sous Microsoft Windows). Elasticsearch est disponible gratuitement : veuillez consulter la documentation sur le site https://www.elastic.co/ ou lire le document Installer Elasticsearch.

Dans le cadre d'une utilisation normale, une fois Elasticsearch est installé sur l'hôte http (i.e. votre serveur) qui héberge l'application chora, vous n'avez pas à vous soucier de sa configuration : le service sera automatiquement disponible à l'adresse http(s)://localhost:9200

La configuration de chora se limite ensuite à deux étapes :
—définir (en décommentant sa ligne) la constante de configuration ELASTICSEARCH dans le fichier /application/config/<ENVIRONMENT>/site.php de votre installation : elle active les fonctions de recherche avec ES et inidique quel est l'URL de son serveur (en principe et comme il a déjà été dit, http://localhost:9200).
—si vous souhaitez remplacer entièrement les fonctions de recherche SQL dans l'interface par la recherche avec Elasticsearch, vous pouvez ensuite décommenter la constante SEARCH_ONLY_WITH_ELASTICSEARCH (de préférence après en avoir vérifié le bon fonctionnement).
 

Vérifier que tout fonctionne

Une fois l'activation d'ES effectuée, identiez-vous comme superutilisateur et lancez le test unitaire fourni dans l'interface de gestion (Gérer » Application dans le menu haut, puis dans le menu gauche : Recherche avec Elasticsearch).

Le premier lancement de ce test aura pour effet de configurer un index par défaut pour votre environnement (nommé comme celui-ci).

L'indexation des contenus ou fichiers attachés avec Elasticsearch se fait ensuite en cliquant sur les boutons   Indexer présents dans l'interface : dans une architecture simple, la mise à jour de l'index est immédiate.