# Migrare dalla 20.04.xx alla 24.08 o 26.04
Il passaggio dalla 20.04.xx alla 24.08 o alla 26.04 richiede una procedura speciale perché Exchange Connector deve essere trasformato dalla vecchia installazione in un modulo vtenext registrato.
## 1. Eseguire il backup
**Attenzione**
Prima di iniziare eseguire un backup completo di database e file dell'istanza vtenext e annotare utenti, cartelle e mappature personalizzate.
## 2. Portare l'istanza alla versione vtenext di destinazione
Aggiornare l'istanza vtenext alla versione di destinazione prevista:
- **24.08.xx**
- **25.xx**
- **26.xx**
Utilizzare il pacchetto Exchange Connector previsto per la stessa generazione di vtenext.
## 3. Registrare Exchange Connector come modulo vtenext
Sulle installazioni provenienti dalla 20.04.xx deve essere eseguito una sola volta lo script di registrazione del modulo Exchange.
Lo script previsto è:
`register_exchange_module.php`
Lo script va copiato in `../plugins/script/` ed eseguito via web, ad esempio `https://miocrm.ch/plugins/script/register_exchange_module.php`.
**Operazione critica**
Rimuovere il file `register_exchange_module.php` dalla cartella immediatamente dopo l'esecuzione. Lo script deve essere eseguito una sola volta.
La sua funzione è registrare l'Exchange Connector già presente come modulo/estensione vtlib di vtenext.
Lo script:
- verifica che l'installazione Exchange precedente sia presente;
- registra Exchange Connector nel sistema dei moduli vtenext;
- non ricrea le tabelle Exchange già esistenti;
- non ricrea cron, impostazioni o campi già presenti;
- permette al modulo di comparire nel Module Manager e di essere aggiornato normalmente in futuro.
Per verificare che il plugin sia stato correttamente promosso a modulo, aprire la gestione moduli, sezione **Personalizzati**, e verificare che Exchange Connector sia presente.
[](https://manual.vtenext.ch/uploads/images/gallery/2026-09/PwpDSGkpmYUdqrFQ-immagine.png)
**Verifica**
Se Exchange Connector compare correttamente nel Module Manager, la registrazione del modulo è avvenuta.
## 4. Aggiornare il modulo alla versione di destinazione
Dopo la registrazione, installare/aggiornare Exchange Connector con il pacchetto ZIP previsto per la versione di destinazione.
A questo punto il connettore viene gestito come un normale modulo vtenext.
[](https://manual.vtenext.ch/uploads/images/gallery/2026-09/RADb41uWTc1WTlpd-immagine.png)
[](https://manual.vtenext.ch/uploads/images/gallery/2026-09/wOhg3K7ns0gewS2a-immagine.png)
## 5. Se si utilizza Microsoft 365
Con Microsoft 365 / Exchange Online la nuova versione utilizza Microsoft Graph.
Dopo la migrazione:
1. aprire **Impostazioni > Exchange Connector**;
2. verificare che il tipo di server sia **Office365**;
3. scegliere tra **Proxy vtenext** e **App Microsoft personalizzata**;
4. se si usa una App personalizzata, reinserire i relativi dati di configurazione;
5. salvare;
6. verificare il collegamento degli utenti tramite **Connect**;
7. controllare le cartelle selezionate;
8. eseguire un test di sincronizzazione.
**Vecchie configurazioni Office365**
Nel passaggio alla nuova struttura la configurazione Office365 viene portata verso la modalità Proxy vtenext. Se il cliente vuole utilizzare una propria App Microsoft, Tenant ID, Client ID e Client Secret devono essere riconfigurati dopo la migrazione.
## 6. Se si utilizza Exchange Server
Per Exchange Server on-premise la migrazione strutturale del modulo è la stessa, ma il collegamento continua a utilizzare EWS.
Dopo l'aggiornamento verificare versione Exchange, Mail Server, credenziali utenti, cartelle e sincronizzazione nei due sensi.
## 7. Verifica finale
La migrazione è conclusa quando il modulo compare correttamente nel Module Manager, la versione è quella prevista, utenti e cartelle sono corretti e i test di sincronizzazione nei due sensi hanno esito positivo.