Questa guida illustra le regole di formattazione per l'Importazione CSV/XLSX da seguire prima di caricare i file nel sistema. Scoprirai quale struttura devono avere i tuoi dati, quali campi sono obbligatori e come devono essere formattati i valori per essere riconosciuti correttamente durante l'importazione. Attenerti a queste regole aiuta a prevenire problemi comuni come colonne mancanti, tipi di dati non validi o errori imprevisti di mappatura. Usa questo articolo come checklist per convalidare il tuo file e garantire un'importazione rapida e affidabile ogni volta.
Attualmente l'applicazione consente di caricare dati da due tipi di file:
CSV
XLSX
Il tuo file deve utilizzare uno dei separatori standard. In caso contrario, il file potrebbe essere rifiutato.
Opzioni consentite:
virgola (,)
punto e virgola (;)
tab
Da evitare:
Doppie virgole (,,)
Virgole in posizioni irregolari
Caratteri separatori insoliti
Se utilizzi la virgola come separatore, non puoi usarla all'interno dei valori. Ad esempio, "Baker street, 20" non è consentito nel campo "Indirizzo".
La codifica è il metodo utilizzato per rappresentare il testo come dati digitali. Definisce come lettere, numeri, simboli e caratteri speciali vengono memorizzati e visualizzati da un sistema. Scegliere la codifica corretta è essenziale per preservare l'accuratezza del testo, soprattutto quando si lavora con contenuti multilingue. Se viene selezionata una codifica errata, i caratteri potrebbero apparire corrotti o illeggibili, un problema spesso definito mojibake.
Tra le opzioni più utilizzate, UTF-8 è lo standard moderno. Supporta un'ampia gamma di caratteri di diversi sistemi di scrittura ed è ampiamente consigliato per i contenuti internazionali grazie alla sua compatibilità e flessibilità.
Cyrillic (Windows-1251) è una codifica legacy comunemente utilizzata per testi scritti in lingue basate sul cirillico, in particolare in ambienti Windows più datati. Cyrillic (ISO-8859-5) è un altro vecchio standard per il testo cirillico, anche se oggi è meno diffuso rispetto a Windows-1251 o alle codifiche basate su Unicode.
Per le lingue dell'Europa centrale e orientale, Eastern Europe (Windows-1250) è spesso utilizzato nelle applicazioni Windows legacy. Supporta le lingue che utilizzano l'alfabeto latino con segni diacritici aggiuntivi, come polacco, ceco e ungherese. Allo stesso modo, Eastern Europe (ISO-8859-2) è uno standard internazionale più datato progettato per lo stesso gruppo linguistico, sebbene sia stato in gran parte sostituito da Unicode nei sistemi moderni.
Infine, US ASCII è una delle codifiche più antiche e limitate. Include solo lettere inglesi di base, numeri e segni di punteggiatura, il che la rende adatta solo per semplici contenuti in testo normale senza caratteri accentati o non latini.
Nella maggior parte dei casi d'uso moderni, UTF-8 è la scelta più sicura e universale, mentre le codifiche legacy rimangono utili principalmente per la compatibilità con file e sistemi più datati.
Ogni intestazione di colonna deve rappresentare un campo e ogni cella deve contenere solo il valore di quel campo.
Se lasci valori aggiuntivi in una riga che non corrispondono a nessun campo, l'importatore potrebbe tentare di unire i valori e trattarli come un unico campo. Questo può portare a errori di validazione fuorvianti (ad esempio, un messaggio "last_name too long" anche quando il cognome sembra corretto).
Checklist
Ogni colonna ha un'intestazione chiara (nome del campo).
Ogni valore appartiene a un campo esistente (o a uno che intendi creare).
Nessun valore "extra" collocato dopo l'ultima colonna prevista.
La corretta formattazione è importante perché il motore di importazione convalida i tipi di valore.
Prima di creare nuovi campi, verifica quali tipi di campi sono disponibili per l'uso:
Tipo | Descrizione | Esempio |
Booleano | Rappresenta opzioni binarie: true / false. | Campo "Consenso marketing", valore "True" |
Data | Campo per memorizzare informazioni su una data specifica. Formato: ISO 8601. | Campo "Compleanno", valore "1996-01-20" |
Datetime | Campo per memorizzare dettagli specifici sull'ora, come informazioni di iscrizione o ultima attività. Richiede il formato ISO 8601. | Campo "Ultimo accesso", valore "2016-08-03 12:00:00+00:00" |
Scelta fissa | Insieme di opzioni possibili che limitano i valori per un campo specifico. Tali campi possono includere anche la variante "Consenti scelte multiple". Se questa opzione è attiva, puoi inserire più di 1 valore nella cella, separandoli con il simbolo "|". | Campo "Lingua preferita", valore "Inglese", "Polacco", "Spagnolo" |
Numero in virgola mobile | Dati numerici che accettano decimali, adatti a rappresentare prezzi o misure statistiche. | Campo "Lifetime value", valore "1000.59" |
Intero | Dati numerici, include solo numeri interi. | Campo "Numero totale di ordini", valore "9" |
Formato file JSON | Funziona per valori più lunghi che non possono essere collocati in altri formati di dati. Non disponibile per gli eventi di prodotto. | Campo "Informazioni aggiuntive sull'ordine", valore (oggetto JSON valido): "key": "value" |
Numero | Solo eventi (!). Questo campo viene utilizzato in particolare per i campi degli eventi. Copre sia le opzioni intero sia numero in virgola mobile. | Campo "Punti raccolti", valore "15" |
Stringa | Qualsiasi stringa di caratteri limitata a 255 elementi. È perfetta per informazioni testuali, inclusi nomi, indirizzi email o qualsiasi altro dato testuale. | Campo "Piano di abbonamento", valore "Standard" |
I campi booleani devono contenere valori booleani validi:
- Usa TRUE o FALSE
- Non lasciare i campi booleani vuoti (i valori vuoti possono generare errori di validazione)
Puoi leggere di più sui campi qui.
Alcuni campi richiedono valori specifici e predefiniti. Assicurati di utilizzare il formato corretto.
Campo | Descrizione | Valori richiesti |
Genere (campo del contatto) | Campo standard che puoi aggiornare con i tuoi valori personalizzati. Vuoto per impostazione predefinita. |
|
Numero di telefono (campo del contatto) | Campo standard che puoi aggiornare con i tuoi valori personalizzati. Vuoto per impostazione predefinita. Formato consigliato adatto a tutti i provider: E.164 | Formato E.164. Esempio: +44754123434 |
Status (campo dell'opportunità di vendita) | Questo campo definisce lo status della tua opportunità di vendita. |
|
Status del task (campo dell'opportunità di vendita) | Definisce lo status del tuo task. |
|
Assegnato a (campo del contatto) | Definisce a quale membro del team è assegnato il contatto | Deve corrispondere a un ID membro del team esistente o al nome di un membro del team/gruppo (in base alla configurazione del sistema). |
Status (campo del ticket) | Questo campo definisce lo status del ticket. |
|
Per saperne di più sull'importazione di oggetti specifici nell'applicazione, consulta la sezione dedicata nella nostra Guida: Importazione ed esportazione dei dati
