8.3.4.1. Qual è la struttura di un file CSV standard?

Un file CSV standard contiene contatti in forma tabellare. La tabella ha la seguente struttura:

  • La prima riga contiene le intestazioni, ad es. i nomi dei campi di dati.

  • Ognuna delle righe seguenti contiene i campi di dati per un contatto nelle singole colonne.

  • I campi dei dati sono separati da virgole.

  • La fine della riga è indicata da un ritorno a capo.

Un file CSV può, ad esempio, essere creato con un foglio elettronico o un editor di testo. In questi casi, è necessario considerare i seguenti dettagli.

  • In presenza di dieresi nei campi di dati del file CSV, i campi devono essere codificati in utf-8.

  • La prima riga del file CSV deve contenere almeno una delle intestazioni di colonna riportate in seguito.

  • I titoli delle colonne sono sensibili alle maiuscole.

  • Le colonne possono essere in qualsiasi ordine. I dati importati saranno assegnati ai campi di dati nel groupware.

  • I campi dei dati sono separati da virgole.

  • Se esistono formati non validi nei campi di dati, il relativo contatto sarà omesso. I campi di dati devono rispettare il seguente formato:

    • Tutti i campi E-mail devono contenere il carattere "@".

    • Il file può avere un campo di dati vuoto.

  • Se un campo di dati eccede il numero massimo di caratteri consentiti, tutti i caratteri eccedenti saranno rimossi. La tabella che segue, mostra il numero massimo di caratteri consentiti per ogni campo di dati.

La prima riga del file CSV deve contenere una o più delle seguenti intestazioni di colonna:

Display name Sur name Given name Middle name
Suffix Title Street home Postal code home
City home State home Country home Martial status
Number of children Profession Nickname Spouse name
Note Company Department Position
Room number Street business Postal code business City business
State business Country business Number of employee Sales volume
Tax id Commercial register Branches Manager's name
Assistant's name Street other Postal code other City other
State other Country other Telephone business 1 Telephone business 2
FAX business Telephone car Telephone company Telephone home 1
Telephone home 2 FAX home Cellular telephone 1 Cellular telephone 2
Telephone other FAX other Telephone pager Telephone telex
Telephone TTY/TDD Instantmessenger 1 Instantmessenger 2 Telephone IP
Email 1 Email 2 Email 3 URL
Categories Dynamic Field 1 Dynamic Field 2 Dynamic Field 3
Dynamic Field 4 Dynamic Field 5 Dynamic Field 6 Dynamic Field 7
Dynamic Field 8 Dynamic Field 9 Dynamic Field 10 Dynamic Field 11
Dynamic Field 12 Dynamic Field 13 Dynamic Field 14 Dynamic Field 15
Dynamic Field 16 Dynamic Field 17 Dynamic Field 18 Dynamic Field 19
Dynamic Field 20 private Birthday Anniversary