Mappatura dei campi

Fase 3 wizard

Mapping - Introduzione

Il terzo passaggio definisce la corrispondenza tra i campi del modulo VTE e le colonne che appariranno nel file CSV finale.
Questa fase è cruciale per determinare quali informazioni verranno esportate e come saranno strutturate.

image-1751549152050.png

L'interfaccia di mappatura è organizzata in due colonne principali che lavorano insieme in modo coordinato:

Colonna Sinistra - Campo VTE
Questa sezione mostra i campi disponibili nel modulo selezionato, con caratteristiche specifiche:
- Checkbox di selezione: Permette di includere o escludere ciascun campo dall'esportazione
- Nome del campo: Etichetta descrittiva del campo nel sistema VTE
- Tipo di campo: Identificazione automatica tra campi dinamici e valori fissi

Colonna Destra - Campo CSV
Questa sezione definisce come i campi appariranno nel file di output:
- Nome colonna: Etichetta che apparirà come intestazione nel CSV
- Campo editabile: Possibilità di personalizzare completamente il nome della colonna
- Controllo rimozione: Pulsante X per eliminare singole mappature

 

Tipologie di Mappatura

Il sistema supporta diverse tipologie di mappatura per adattarsi a esigenze specifiche:

Campi Dinamici
I campi dinamici rappresentano dati reali estratti dal database:
- Esempio: "Soggetto" → "soggetto"
- Funzione: Trasferisce il valore effettivo del campo dal record VTE
- Personalizzazione: Il nome della colonna CSV può essere modificato mantenendo il collegamento ai dati

Valori Fissi
I valori fissi permettono di inserire informazioni statiche in ogni riga:
- Esempio: "Valore}" → "Valore11"
- Funzione: Inserisce lo stesso valore predefinito in tutte le righe esportate
- Utilizzo: Ideale per identificatori, categorie o metadati comuni

 

Gestione delle Mappature

La mappattura dei campi viene gestita dalla:

Selezione di Campi:
- Checkbox attivo: Il campo viene incluso nell'esportazione
- Checkbox disattivo: Il campo viene escluso dall'esportazione
Controllo granulare: Possibilità di selezionare solo i campi necessari

Personalizzazione Nomi Colonne
- Modifica diretta: Click sul campo per editare il nome della colonna CSV
- Convenzioni: Possibilità di adottare standard di denominazione specifici
Chiarezza: Utilizzo di nomi descrittivi per facilitare l'interpretazione dei dati

Rimozione Mappature
-Pulsante X rosso: Elimina completamente la mappatura
- Azione immediata: Rimozione istantanea senza conferma
Flessibilità: Possibilità di riorganizzare l'elenco dei campi

Esempi Pratici di Mappatura

Scenario 1 - Esportazione Contatti
- Campo VTE: "Nome Azienda" → Campo CSV: "company_name"
- Campo VTE: "Email Principale" → Campo CSV: "email"
Valore Fisso: "Tipo" → Campo CSV: "customer_type" (valore: "Cliente")

Suggerimento: Iniziare con una mappatura essenziale includendo solo i campi indispensabili, quindi espandere gradualmente aggiungendo campi aggiuntivi in base alle necessità specifiche del progetto.

Gestione dinamica dei campi di mapping

Il sistema offre la possibilità di espandere dinamicamente la configurazione attraverso il pulsante "+ AGGIUNGI CAMPO", che rappresenta uno strumento fondamentale per la personalizzazione avanzata dell'esportazione. Quando si clicca su questo pulsante, il sistema aggiunge immediatamente una nuova riga di mappatura vuota alla fine dell'elenco esistente, permettendo di includere campi aggiuntivi che potrebbero non essere stati considerati nella configurazione iniziale.

 

image-1751549702702.png