.. _installation_nouvel_analyseur_elasticsearch:

Recherche exacte sur des champs texte
#####################################

Pour pouvoir effectuer une recherche exacte sur un champ donné de type texte, il faudra un analyseur moins permissif que celui installé par défaut, il est possible d'avoir un second analyseur sur le même champ, pour cela il faudra suivre cette procédure:

.. caution:: il est important d'arrêter les ``services externals`` et ``scheduler`` et s'assurer qu'aucun workflow n'est en cours avant de démarrer cette procédure.

Prenant comme exemple le champ ``Title``.

Ajout du nouvel analyseur
=========================

Pour cela, il faudra ajouter la déclaration du nouvel analyseur dans le fichier de configuration d'elasticsearch qui se trouve ici :

``deployment/ansible-vitam/roles/vitam/files/elasticsearch-settings/elasticsearch-configuration.json``

dans le bloc ``analyzer`` , nous ajoutons un nouvel analyseur nommé par exemple strict_title_analyzer, avec uniquement quelques filtres tels que:
 - lowercase
 - asciifolding
 - html_strip

nous pouvons enréchir l'analyseur avec un stemmer, par exemple pour le français, il existe 3 stemmers:
 - light_french
 - french
 - minimal_french

Dans la configuration par défaut de Vitam, nous utilisons le stemmer ``french`` qui est riche mais très permissif, il est recommandé de tester la configuration de l'analyseur en incluant d'autres filtres, ou stemmers, pour le cas de recherche strict, on peut tester ``minimal_french``

Voici un exemple de configuration d'un analyseur à ajouter dans les paramètres dans le bloc ``analyzer`` du fichier de configuration d'elasticsearch :

.. code-block:: json

    "strict_title_analyzer": {
        "type": "custom",
        "tokenizer": "standard",
        "char_filter": [
            "html_strip"
        ],
        "filter": [
            "lowercase",
            "asciifolding"
        ]
    }

Par convention Vitam, si l'analyseur de recherche exacte est positionné sur un champ nommé **NomDuChamps**:

- la recherche classique se fait sur le critère de recherche "NomDuChamps"
- la recherche exacte se fait sur le critère de recherche "NomDuChamps.Strict"


Voici un autre example d'un analyseur un peu plus permissif que le précédent et moins permissif que celui installé par défaut, celui-ci utilise le stemmer ``minimal_french``:

.. code-block:: json

    "strict_title_analyzer": {
        "type": "custom",
        "tokenizer": "standard",
        "char_filter": [
            "html_strip"
        ],
        "filter": [
            "lowercase",
            "asciifolding",
            "minimal_french"
        ]
    }

Modification du mapping
=======================

Après l'ajout du nouvel analyseur, pour pouvoir l'utiliser, il faudra le référencer dans le mapping elasticsearch.

Pour l'exemple du champ ``Title`` de la collection ``Unit``, il faudra mettre à jour le mapping à travers le fichier

``deployment/ansible-vitam/roles/elasticsearch-mapping/files/unit-es-mapping.json``

.. code-block:: json

    "Title": {
        "type": "text",
        "analyzer": "default",
        "fields": {
            "Strict": {
            "type": "text",
            "analyzer": "strict_title_analyzer"
            }
        }
    }

A l'issue, il faut lancer le playbook de déploiement de :term:`VITAM` (et, si déployé, les extras) avec l'option supplémentaire ``--tags update_vitam_configuration``.

Exemple
-------

.. code-block:: console

      ansible-playbook ansible-vitam/vitam.yml -i environments/hosts.<environnement> --ask-vault-pass --tags update_vitam_configuration
      ansible-playbook ansible-vitam-extra/extra.yml -i environments/hosts.<environnement> --ask-vault-pass --tags update_vitam_configuration

Cette procédure permettra d'appliquer la configuration sur une nouvelle installation, par contre, si on veut appliquer les modifications sur des tenants existants, il faudra une re-indexation à travers la procédure suivante.

Réindexation des indexes liés aux tenants
=========================================

Pour pouvoir appliquer le nouvel analyseur et le nouveau mapping sur un tenant donné, il faudra re-indexer le contenu de l'index du tenant(s) en question.

Voir la documentation associée dans la rubrique : :ref:`reindexation_es`

Exemple
-------

.. code-block:: console

      ansible-playbook ansible-vitam-exploitation/reindex_es_data.yml -i environments/hosts.<environnement> --ask-vault-pass --tags unit -e "vitam_tenant_ids=<tenantsList>"

.. caution:: La purge des anciens index n'est pas réalisée par cette procédure scriptée et est laissée à la charge de l'exploitant.

.. caution:: Si un tenant fait partie d'un groupe de tenant, il faudra re-indexer l'ensemble des tenants

.. caution:: Si à un moment donné on ne souhaite appliquer la réindexation qu'à une sous partie de tenants, lors de certaines MDV on fait des full réindexation (et donc le mapping sera finalement appliqué à l'ensemble).