Guida alla mappatura delle colonne
Quando carichi un file CSV dalla tua vecchia piattaforma, l'assistente di migrazione di Agon prova automaticamente ad abbinare i nomi delle tue colonne ai campi dati di Agon. Questa pagina spiega come funziona questo processo, cosa fare quando una colonna non può essere mappata, e le variazioni più comuni dei nomi di colonna.
Come funziona la mappatura automatica
Il processo di mappatura avviene in due fasi:
Fase 1 — Corrispondenza euristica Agon confronta i nomi delle tue colonne con una libreria di variazioni note per ciascun campo. Ad esempio, colonne chiamate "First Name", "firstname", "nome" e "nome cliente" vengono tutte riconosciute come probabili corrispondenze per full_name. Questa fase gestisce la maggior parte delle esportazioni standard dalle piattaforme più comuni.
Fase 2 — Fallback IA Se il nome di una colonna non viene riconosciuto dal matcher euristico, l'assistente di migrazione usa un modello IA per interpretarlo in base al nome della colonna e a un campione dei suoi valori. Ad esempio, se hai una colonna chiamata "ID membro" che contiene valori come "m-1234", l'IA la riconoscerà come identificativo interno e suggerirà di lasciarla non mappata.
Rivedere e modificare le mappature
Dopo il caricamento, la tabella di mappatura colonne mostra ogni colonna del tuo file e il campo Agon a cui è stata mappata.
Ogni mappatura è codificata a colori:
- Verde — corrispondenza ad alta sicurezza; sicura da procedere
- Giallo — sicurezza minore — controlla la mappatura e correggila se necessario
- Rosso — nessuna mappatura trovata; i dati di questa colonna non verranno importati a meno che tu non li mappi manualmente
Per cambiare una mappatura:
- Clicca sul menu a tendina nella colonna Campo Agon accanto alla riga che vuoi cambiare.
- Seleziona il campo corretto dall'elenco dei campi Agon disponibili.
- La mappatura si aggiorna immediatamente.
Per lasciare una colonna non mappata: Seleziona Non importare dal menu a tendina. I dati della colonna verranno ignorati durante l'importazione. Questo va bene per colonne che contengono ID interni, codici specifici della piattaforma, o dati di cui Agon non ha bisogno.
Variazioni comuni dei nomi di colonna
Campi cliente
| Il tuo nome colonna | Mappa al campo Agon |
|---|---|
| Nome, Nome completo, Nome cliente, Nome membro, Nome + Cognome | full_name |
| Email, Indirizzo email, Email cliente, Login | email |
| Telefono, Cellulare, Numero di telefono, Tel | phone |
| Data di nascita, Nato il, Compleanno | date_of_birth |
Se il tuo file ha colonne separate per nome e cognome, l'assistente le combinerà automaticamente in
full_name.
Campi abbonamento
| Il tuo nome colonna | Mappa al campo Agon |
|---|---|
| Email, Email membro, Email cliente | client_email |
| Abbonamento, Piano, Sottoscrizione, Pacchetto | membership_type_name |
| Data inizio, Membro da, Data attivazione | starts_at |
| Scadenza, Data scadenza, Valido fino a, Data rinnovo | expires_at |
| Crediti, Lezioni rimanenti, Sessioni rimaste | credits_remaining |
Campi lezione
| Il tuo nome colonna | Mappa al campo Agon |
|---|---|
| Lezione, Nome lezione, Nome sessione, Titolo | class_name |
| Inizio, Ora inizio, Data/ora inizio | starts_at |
| Fine, Ora fine, Termina alle | ends_at |
| Capienza, Partecipanti max, Posti, Max | capacity |
| Istruttore, Insegnante, Coach, Staff | instructor_name |
Formati data e ora
Agon accetta date nei formati più comuni:
2026-06-15(ISO 8601 — preferito)15/06/2026o06/15/202615 giugno 2026ogiugno 15 20262026-06-15T10:00:00(data + ora per le lezioni)
Se le tue date sono in un formato insolito, convertile in Excel o Google Sheets prima del caricamento: seleziona la colonna, formattala come data standard e salva.
Cosa fare quando una colonna non può essere mappata
Se una colonna appare in rosso (nessuna mappatura trovata):
-
Controlla se il dato è necessario. Se è un ID interno, un riferimento specifico della piattaforma, o un dato che Agon non usa, seleziona Non importare e vai avanti.
-
Rinomina la colonna e ricarica. Se il dato è importante ma il nome della colonna è insolito, modifica il tuo file CSV per rinominare la colonna in uno dei nomi standard nella tabella sopra, quindi ricarica il file.
-
Mappala manualmente. Se il dato corrisponde a un campo Agon ma non è stato riconosciuto, seleziona il campo corretto dal menu a tendina.
Colonne sempre ignorate
Alcune colonne non vengono mai importate in Agon, a prescindere dalla mappatura:
- Password — le password non vengono mai importate (sono cifrate dalla tua vecchia piattaforma e non possono essere lette). I clienti vengono invitati a impostare una nuova password tramite il link di invito.
- ID interni — gli ID numerici o testuali specifici della piattaforma non hanno significato in Agon
- Codici di stato specifici della piattaforma — gli stati di altre piattaforme vengono tradotti durante l'importazione in base ai valori dei dati, non importati così come sono
Cosa fare se qualcosa va storto?
L'IA ha mappato una colonna in modo completamente sbagliato Usa il menu a tendina per selezionare manualmente il campo Agon corretto. Il fallback IA è un tentativo basato sul miglior sforzo — non è sempre corretto, specialmente per nomi di colonna insoliti o terminologia specifica della piattaforma.
Le date vengono importate nel formato sbagliato
Se le date vengono interpretate in modo errato, apri il tuo CSV in un'app di fogli di calcolo, seleziona la colonna data e formattala come YYYY-MM-DD (ISO 8601). Salva il file e ricarica.
Il mio file ha celle unite o intestazioni che si estendono su più righe L'assistente di migrazione si aspetta una singola riga di intestazione seguita da una riga per record. Ripulisci le celle unite e le righe di intestazione extra nel tuo foglio di calcolo prima del caricamento.