# 1. Introduzione

A cosa serve il connettore, ambienti supportati e cosa cambia nella versione 24.08.

# A cosa serve il connettore

Il connettore Exchange permette di mantenere allineati alcuni dati di vtenext con Microsoft 365 o Microsoft Exchange.

Può essere utilizzato per sincronizzare:

- **Calendario / Eventi**;
- **Attività / Task**;
- **Contatti**;
- **Aziende**

La sincronizzazione può avvenire in entrambe le direzioni: una modifica fatta in vtenext può essere riportata in Exchange e una modifica fatta in Exchange può essere riportata in vtenext, in base alle funzioni abilitate.

## Due modalità di collegamento

La versione 24.08 distingue due casi:

- **Microsoft 365 / Exchange Online**: utilizza Microsoft Graph;
- **Exchange Server installato presso il cliente**: utilizza EWS.

Per l'utente finale questa distinzione incide soprattutto sul modo in cui viene configurato l'account:

- con Microsoft 365 l'utente autorizza il collegamento tramite login Microsoft;
- con Exchange Server vengono utilizzate le credenziali Exchange e le cartelle configurate.

## Chi configura cosa

L'amministratore vtenext configura il connettore, sceglie cosa sincronizzare e imposta la mappatura dei campi.

Ogni utente deve poi completare il collegamento del proprio account e scegliere le cartelle da utilizzare, quando previsto.

Una volta completata la configurazione, il connettore lavora automaticamente in background.

# Cosa cambia dalla 20.04.xx alle versioni 24.08 e 26.04

La differenza più importante rispetto alla versione 20.04 non riguarda soltanto Microsoft Graph: cambia anche il modo in cui il connettore è integrato in vtenext.

## Dalla 20.04 alla nuova struttura

Nella versione 20.04 il connettore Exchange era installato con la vecchia procedura dedicata e non era registrato come un normale modulo vtlib di vtenext.

Con le versioni 24.08 e 26.04 il connettore viene invece gestito come un vero modulo/estensione vtenext. Questo permette, dopo il primo passaggio, di gestire gli aggiornamenti successivi con la normale procedura di aggiornamento del modulo.

Per questo motivo il passaggio dalla 20.04 alla 24.08 o alla 26.04 richiede una procedura di migrazione specifica e l'esecuzione una sola volta dello script di registrazione del modulo.

## Se si utilizza Microsoft 365

Con la nuova generazione del connettore Microsoft 365 / Exchange Online utilizza Microsoft Graph.

Dopo la migrazione è quindi necessario verificare la configurazione Office365 e il collegamento degli utenti.

Il connettore può essere configurato tramite:

- **Proxy vtenext**;
- **App Microsoft personalizzata**.

## Se si utilizza Exchange Server

Per Exchange Server installato presso il cliente continua a essere utilizzato EWS.

Sono previste le configurazioni per:

- Exchange 2016;
- Exchange 2019;
- Exchange Server Subscription Edition.

## Aggiornamenti successivi

Una volta che il connettore è già nella nuova struttura, ad esempio in versione 24.08, il passaggio alla 26.04 non richiede più lo script di registrazione.

Il passaggio **24.08 → 26.04** viene eseguito come normale aggiornamento del modulo utilizzando il relativo pacchetto ZIP.

Questa distinzione è importante:

- **20.04 → 24.08 o 26.04 = migrazione strutturale**;
- **24.08 → 26.04 = aggiornamento normale del modulo**.