# Configurazione

Dalla versione 2.5 del modulo ElasticSearch è presente una interfaccia di configurazione, accessibile da Impostazioni ->ElasticSearch:

[![image.png](https://usermanual.vtenext.com/uploads/images/gallery/2026-05/scaled-1680-/image.png)](https://usermanual.vtenext.com/uploads/images/gallery/2026-05/image.png)

Sono presenti 2 sezioni, **Configurazione**, per impostare i parametri di connessione e attivare l'integrazione per singoli moduli, e **Manutenzione**, per eseguire operazioni di pulizia e re-indicizzazione.

#### Configurazione

[![image.png](https://usermanual.vtenext.com/uploads/images/gallery/2026-05/scaled-1680-/alyimage.png)](https://usermanual.vtenext.com/uploads/images/gallery/2026-05/alyimage.png)

I primi campi servono per configurare la connesione al server ElasticSearch, tramite url e autenticazione. Dopodichè si hanno:

<table border="1" id="bkmrk-campo-utilizzo-integ" style="border-collapse: collapse; width: 100%; height: 565.359px;"><colgroup><col style="width: 25.6257%;"></col><col style="width: 74.3743%;"></col></colgroup><thead><tr style="height: 29.7969px;"><td style="height: 29.7969px;">**Campo**</td><td style="height: 29.7969px;">**Utilizzo**</td></tr></thead><tbody><tr style="height: 46.5938px;"><td style="height: 46.5938px;">Integrazione attiva</td><td style="height: 46.5938px;">Si può attivare o disattivare globalmente il modulo ElasticSearch. Se non attivo, nessuna richiesta verrà fatta al server ElasticSearch</td></tr><tr style="height: 46.5938px;"><td style="height: 46.5938px;">Moduli abilitati</td><td style="height: 46.5938px;">Qui si vedono i moduli che sono abilitati all'utilizzo di ElasticSearch con lo stato dell'indicizzazione, il numero di record indicizzati e il tipo di accesso (si veda la descrizione a lato per i vari valori)</td></tr><tr style="height: 412.578px;"><td style="height: 412.578px;">Aggiungi modulo</td><td style="height: 412.578px;">Permette di aggiungere un modulo all'integrazione. Una volta cliccato appare un popup per scegliere un modulo:

[![image.png](https://usermanual.vtenext.com/uploads/images/gallery/2026-05/scaled-1680-/i3cimage.png)](https://usermanual.vtenext.com/uploads/images/gallery/2026-05/i3cimage.png)

Una votla scelto, il modulo non è subito utilizzabile, è necessario attendere che tutti i suoi record vengano indicizzati, operazione che avviene in background, la cui durata dipende dal numero di record (può durare dai 10 minuti anche a svariate ore).

</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">Versione ElasticSearch</td><td style="height: 29.7969px;">Se la connessione verso il server ElasticSearch ha esito positivo, mostra la versione

</td></tr></tbody></table>

#### Manutenzione

Da questa sezione si possono eseguire operazioni di manutenzione degli indici, per i moduli indicizzati:

[![image.png](https://usermanual.vtenext.com/uploads/images/gallery/2026-05/scaled-1680-/tYvimage.png)](https://usermanual.vtenext.com/uploads/images/gallery/2026-05/tYvimage.png)

<table border="1" id="bkmrk-azione-significato-e" style="border-collapse: collapse; width: 100%;"><colgroup><col style="width: 28.2533%;"></col><col style="width: 71.7467%;"></col></colgroup><thead><tr><td>**Azione**</td><td>**Significato**</td></tr></thead><tbody><tr><td>Elimina</td><td>Disattiva l'integrazione di questo modulo con ElasticSearch e rimuove l'indice.</td></tr><tr><td>Reindicizza</td><td>Rigenera l'indice con tutti i record del modulo su ElasticSearch. Durante la reindicizzazione è possibile utilizzare normalmente il modulo in quanto viene creato un indice parallelo e solo al termine sostituito con quello effettivo.

Va eseguita in caso di disallineamenti dell'indice con il database mysql, tra le cause ci possono essere:

- modifiche dei record manuali da database
- modifiche dei record tramite query dirette come UPDATE o INSERT (si deve invece usare la funzione `->save()` per garantire la corretta sincronizzazione)
- interruzioni durante procedure di salvataggio che hanno modificato il record in vte, ma non hanno scatenato l'aggiornamento su ElasticSearch

</td></tr><tr><td>Reindicizza con filtro</td><td>Come il precedente, ma permette di sincronizzare solo un filtro specifico:

[![image.png](https://usermanual.vtenext.com/uploads/images/gallery/2026-05/scaled-1680-/BVqimage.png)](https://usermanual.vtenext.com/uploads/images/gallery/2026-05/BVqimage.png)

</td></tr></tbody></table>