Guida alla mappatura delle colonne
Dopo aver letto questa pagina saprai leggere la tabella Rivedi l'abbinamento delle colonne in Impostazioni → Migrazione, capire quali delle tue colonne Agon ha abbinato, correggere un abbinamento sbagliato e gestire le colonne che Agon non è riuscito a collocare — per clienti, abbonamenti e lezioni.
Questa è una pagina complementare alla Panoramica migrazione: parti da lì per l'intero flusso di importazione.
Come Agon abbina le tue colonne
Prima di caricare il file, scegli cosa stai importando — Clienti, Abbonamenti o Lezioni — sotto Cosa stai importando?. Questa scelta decide a quale insieme di campi Agon possono essere abbinate le tue colonne; ogni entità ha il proprio elenco di campi, trattato nella sua sezione qui sotto.
Quando clicchi Analizza file, Agon esamina ogni intestazione di colonna del tuo file e prova ad allinearla a uno dei campi dell'entità che hai scelto. Le intestazioni che corrispondono in modo evidente al nome di un campo (per esempio email, Email, email_address) vengono abbinate direttamente; le altre vengono abbinate interpretando il testo dell'intestazione (e, per le colonne ricche di testo, anche alcuni valori della colonna stessa, per distinguere intestazioni come "Tipo" o "Piano"). La tabella ti mostra poi cosa ha deciso, con il messaggio "Abbiamo abbinato ogni colonna del tuo file a un campo di Agon".
A questo punto non viene importato nulla. L'abbinamento è solo un suggerimento di partenza che rivedi e correggi prima di confermare.
Campi cliente
Ogni riga della tabella di abbinamento ha un menu a tendina Campo Agon con queste scelte quando importi Clienti:
| Scelta | Cosa fa |
|---|---|
| Nome completo | Il nome del cliente. Se nessuna colonna è mappata qui, come nome viene usata l'email del cliente. |
| L'indirizzo email del cliente. Obbligatorio — una riga senza email viene saltata. Se l'email appartiene già a un cliente in Agon, la riga viene saltata invece di sovrascrivere quel cliente. | |
| Telefono | Il numero di telefono del cliente. Facoltativo. |
| Data di nascita | La data di nascita del cliente. Facoltativa. Usa YYYY-MM-DD. |
| Note | Note libere sul cliente. Facoltativo. |
| Nome di fatturazione | Il nome da indicare sulle fatture future di questo cliente, se diverso dal nome completo — per esempio la ragione sociale di un'azienda. Facoltativo. |
| Indirizzo di fatturazione | L'indirizzo da indicare sulle fatture future di questo cliente. Facoltativo. |
| Codice fiscale / Partita IVA | Il codice fiscale o la partita IVA del cliente, per le sue fatture future. Facoltativo. |
| — non importare — | Ignora questa colonna. I suoi valori non vengono importati. |
Nome di fatturazione, indirizzo di fatturazione e Codice fiscale / Partita IVA vengono usati solo per le fatture che Agon genera dopo l'importazione del cliente — non cambiano in alcun modo l'esecuzione dell'import stesso. Agon non importa le fatture storiche del cliente dalla tua vecchia piattaforma: restano archiviate nel vecchio sistema, e la migrazione non tenta di riportarle. Se un cliente deve apparire correttamente sulle fatture future (per esempio un'azienda da fatturare, o un cliente il cui paese richiede un codice fiscale/IVA in fattura), compila questi tre campi — altrimenti lasciali fuori.
Rinominare invece le colonne nel tuo file
| Rinomina la tua intestazione in | Per |
|---|---|
full_name | Il nome del cliente |
email | L'indirizzo email del cliente |
phone | Il numero di telefono del cliente |
date_of_birth | La data di nascita del cliente |
notes | Note libere sul cliente |
billing_name | Il nome di fatturazione per le fatture future di questo cliente |
billing_address | L'indirizzo di fatturazione per le fatture future di questo cliente |
tax_id | Il codice fiscale o la partita IVA del cliente per le sue fatture future |
Metti le date di nascita nel formato YYYY-MM-DD, per esempio 1990-01-15.
Campi abbonamento
Scelte proposte quando importi Abbonamenti:
| Scelta | Cosa fa |
|---|---|
| Email cliente | L'email del cliente a cui appartiene questo abbonamento. Obbligatorio — il cliente deve già esistere in Agon (importa prima i clienti). Una riga la cui email non corrisponde a nessun cliente in Agon viene saltata. |
| Tipo di abbonamento | Il nome del tipo di abbonamento in Agon (per esempio "Pacchetto 10 lezioni"). Obbligatorio — abbinato per nome a un tipo di abbonamento esistente (maiuscole/minuscole non contano, l'ortografia sì). Se nulla corrisponde, la riga viene saltata — crea prima il tipo di abbonamento in Agon (Abbonamenti nella barra laterale sinistra), poi ri-importa. |
| Inizio | Quando inizia l'abbonamento. Obbligatorio. Usa YYYY-MM-DD. |
| Scadenza | Quando termina l'abbonamento. Facoltativo. Usa YYYY-MM-DD. Una data già nel passato viene importata comunque — come abbonamento con stato scaduto, non scartata, così il tuo storico resta intatto. |
| Credits rimanenti | Il numero di credits rimasti sull'abbonamento. Facoltativo, solo numeri interi. |
| — non importare — | Ignora questa colonna. |
Rinominare invece le colonne nel tuo file
| Rinomina la tua intestazione in | Per |
|---|---|
client_email | L'indirizzo email del cliente |
membership_type_name | Il nome del tipo di abbonamento in Agon |
starts_at | La data di inizio dell'abbonamento |
expires_at | La data di scadenza dell'abbonamento |
credits_remaining | I credits rimasti sull'abbonamento |
Campi lezione
Scelte proposte quando importi Lezioni:
| Scelta | Cosa fa |
|---|---|
| Nome lezione | Il nome della lezione (per esempio "Yoga Flow"). Obbligatorio. Abbinato per nome a un tipo di lezione esistente in Agon — a differenza dei tipi di abbonamento, se nulla corrisponde Agon crea automaticamente un nuovo tipo di lezione usando l'orario di inizio/fine (per la durata) e la capacità di questa riga come valori predefiniti, invece di saltare la riga. Questo è intenzionale: una prima migrazione di solito è l'arrivo per la prima volta dell'intero catalogo lezioni dello studio. |
| Inizio | Quando inizia la lezione. Obbligatorio. Usa YYYY-MM-DD HH:MM:SS. Un orario di inizio che non è strettamente nel futuro viene saltato — vengono importate solo le lezioni future. |
| Fine | Quando termina la lezione. Obbligatorio. Usa YYYY-MM-DD HH:MM:SS. |
| Capacità | Numero massimo di clienti che possono prenotare. Facoltativo, solo numeri interi. Il valore predefinito è 1 se lasciato vuoto. |
| Nome istruttore | Il nome dell'istruttore. Facoltativo. Abbinato per nome a un istruttore esistente in Agon. A differenza dei campi sopra, nessuna corrispondenza non fa saltare la riga — la lezione viene comunque importata senza istruttore, e ne assegni uno manualmente in seguito dalla schermata di modifica della lezione stessa. |
| — non importare — | Ignora questa colonna. |
Rinominare invece le colonne nel tuo file
| Rinomina la tua intestazione in | Per |
|---|---|
class_name | Il nome della lezione |
starts_at | La data e l'ora di inizio della lezione |
ends_at | La data e l'ora di fine della lezione |
capacity | Il numero massimo di prenotazioni |
instructor_name | Il nome dell'istruttore |
Colonne che Agon non è riuscito a mappare
Una colonna che Agon non è riuscito a collocare mostra un badge non mappata nella tabella.
Una colonna lasciata come non mappata viene saltata — i suoi dati non vengono importati. È l'esito giusto per le colonne per cui Agon non ha un campo, come ID interni dei record o tag. (Quando importi Clienti, una colonna "Notes" non deve necessariamente restare non mappata — abbinala al campo Note sopra se vuoi che venga importata.)
Se una colonna non mappata dovrebbe essere importata, apri il suo menu a tendina e scegli il campo corretto dall'elenco per l'entità che stai importando.
Correggere un abbinamento
- Trova la riga nella tabella Rivedi l'abbinamento delle colonne.
- Apri il menu a tendina nella colonna Campo Agon.
- Scegli il campo corretto, oppure — non importare — per saltare la colonna.
- Ripeti per ogni riga sbagliata.
- Clicca Conferma importazione quando l'intera tabella è corretta.
Le intestazioni che corrispondono ai nomi dei campi di Agon (vedi le tabelle di rinomina sopra, una per entità) vengono abbinate direttamente, quindi la tabella torna corretta. Dopo aver rinominato, salva il file ed esegui di nuovo Analizza file.
Cosa fare se qualcosa va storto?
Una colonna è stata abbinata al campo sbagliato Usa il menu a tendina Campo Agon su quella riga per scegliere quello giusto. L'abbinamento automatico è solo un suggerimento e i nomi di intestazione insoliti sono facili da sbagliare.
Una colonna che mi serve mostra "non mappata" Apri il suo menu a tendina e scegli il campo a cui appartiene. Le colonne non mappate vengono saltate, quindi nulla di quella colonna viene importato finché non la mappi.
Due delle mie colonne contengono lo stesso tipo di dato Solo una colonna può alimentare ciascun campo Agon. Mappa quella migliore e imposta l'altra su — non importare —, oppure uniscile nel foglio di calcolo prima di caricare.
Il mio file ha più di una riga di intestazione, o celle unite Agon si aspetta una singola riga di intestazione seguita da una riga per record. Appiattisci le celle unite e rimuovi le righe di intestazione extra nel tuo foglio di calcolo, poi carica di nuovo.
La mia colonna "Tipo di abbonamento" torna sempre non mappata, oppure il tipo non viene trovato Il campo Tipo di abbonamento abbina solo un tipo di abbonamento esistente per nome — non ne crea mai uno. Controlla che il nome nel tuo file corrisponda esattamente a un tipo di abbonamento già configurato in Agon (Abbonamenti nella barra laterale sinistra), poi esegui di nuovo Analizza file. Questo è diverso da Nome lezione sotto, che crea automaticamente un nuovo tipo di lezione quando nulla corrisponde.
Una riga di lezione ha creato un tipo di lezione che non mi aspettavo È il comportamento previsto per Nome lezione: se il nome non corrisponde a un tipo di lezione esistente in Agon, ne viene creato automaticamente uno nuovo a partire dall'orario di inizio/fine e dalla capacità di quella riga, invece di saltarla. Rinomina o unisci i nomi di tipo di lezione duplicati nel tuo file di origine prima di importare se vuoi che confluiscano in un unico tipo di lezione in Agon.
"Nome istruttore" non sembra avere importanza È facoltativo e non fa mai saltare una riga di lezione. Se non corrisponde esattamente al nome di un istruttore in Agon, la lezione viene importata comunque senza istruttore — assegnane uno manualmente in seguito.