# Introduzione

# Presentazione

Il plugin è uno strumento avanzato per **l'esportazione di dati in formato CSV**, progettato per semplificare e automatizzare il processo di esportazione di informazioni da diverse tabelle del database. Questo plugin offre un'interfaccia intuitiva che permette di configurare facilmente le modalità di esportazione, personalizzare i formati dei dati e mappare i campi secondo le proprie esigenze.

[![image-1751528192127.png](https://manual.vtenext.ch/uploads/images/gallery/2025-07/scaled-1680-/Nzwbj1ArHk2g35th-image-1751528192127.png)](https://manual.vtenext.ch/uploads/images/gallery/2025-07/Nzwbj1ArHk2g35th-image-1751528192127.png)

Il sistema è dotato di un **wizard** guidato che accompagna l'utente attraverso tutti i passaggi necessari per configurare correttamente l'esportazione, garantendo un'esperienza d'uso fluida e professionale anche per utenti meno esperti.

# Regole di utilizzo

Per poter utilizzare il modulo Esportazione CSV, è fondamentale che il plugin sia correttamente installato e attivato all’interno dell’ambiente vtenext. Al termine dell’installazione, è necessario verificare che non si siano verificati errori durante la procedura e che il plugin risulti attivo nella sezione dedicata ai moduli installati: un’installazione incompleta o un plugin disattivato compromettono il funzionamento dell’intero processo di esportazione.

È inoltre indispensabile assicurarsi che la cartella: *"storage/CSVExporter/"* disponga dei permessi di scrittura adeguati. In caso contrario, il sistema non sarà in grado di generare o salvare correttamente i file CSV esportati.

In ultimo, e non meno importante, sono richieste alcune competenze di base dell'operatore, in particolare su quattro ambiti:

1. **Conoscenza dei moduli CRM:** comprendere la struttura dei moduli da esportare, i tipi di campo utilizzati, le relazioni tra le entità e le logiche di business.
2. **Familiarità con il formato CSV:** conoscere i concetti di separatori di campo (`;`, `,`), delimitatori di testo (`"`), caratteri di fine riga e compatibilità con software come Excel, LibreOffice o Google Sheets.
3. **Gestione della codifica dei carattere:** utilizzare la codifica UTF-8 per garantire la corretta visualizzazione di accenti, simboli e caratteri speciali nei file esportati.
4. **Organizzazione dei file:** saper gestire strutture di cartelle, usare nomi coerenti per i file e implementare strategie di backup, per mantenere ordine e sicurezza nei dati generati.