Il formato vCard, riga per riga

vCard 2.1, 3.0 e 4.0 a confronto

Per sapere quale hai, apri il file in un editor di testo e leggi la seconda riga. VERSION:3.0 è quella che incontrerai più spesso.

Le proprietà che vedrai

I nomi delle proprietà non distinguono maiuscole e minuscole, quindi tel e TEL sono la stessa cosa. Le righe che iniziano con X- sono aggiunte di un singolo produttore, come X-SOCIALPROFILE. Apple e Google raggruppano anche un valore con un’etichetta personalizzata mettendo lo stesso prefisso su entrambe le righe: item1.EMAIL:[email protected] e item1.X-ABLabel:Billing vanno insieme. Un lettore che ignora il prefisso riceve comunque l’email, solo senza la sua etichetta.

Lo stesso contatto in ogni versione

vCard 2.1, con il nome accentato in quoted-printable:

BEGIN:VCARD
VERSION:2.1
N;CHARSET=UTF-8;ENCODING=QUOTED-PRINTABLE:Lef=C3=A8vre;Am=C3=A9lie;;;
FN;CHARSET=UTF-8;ENCODING=QUOTED-PRINTABLE:Am=C3=A9lie Lef=C3=A8vre
TEL;CELL;VOICE:+1 555 555 0142
END:VCARD

vCard 3.0:

BEGIN:VCARD
VERSION:3.0
N:Lefèvre;Amélie;;;
FN:Amélie Lefèvre
TEL;TYPE=CELL:+1 555 555 0142
END:VCARD

vCard 4.0, con il numero come link tel::

BEGIN:VCARD
VERSION:4.0
FN:Amélie Lefèvre
N:Lefèvre;Amélie;;;
TEL;TYPE=cell;VALUE=uri:tel:+1-555-555-0142
END:VCARD

Righe spezzate e quoted-printable

Le righe lunghe vengono spezzate. Nella 3.0 e nella 4.0 chi scrive il file divide una riga lunga inserendo un a capo seguito da uno spazio o da una tabulazione; la RFC 6350 chiede righe di non più di 75 ottetti. Chi legge le riunisce cancellando l’a capo e quel carattere, e nient’altro. Uno strumento che cancella anche lo spazio successivo, o tiene il primo, incolla due parole o aggiunge uno spazio in mezzo a un indirizzo email. Una foto in base64 occupa centinaia di righe spezzate, ed è per questo che un .vcf con le immagini è molte volte più grande di uno senza.

Il quoted-printable appartiene alla 2.1. Ogni byte fuori dall’ASCII semplice diventa un segno di uguale e due cifre esadecimali, quindi «é» in UTF-8 è =C3=A9. Una riga che finisce con = è un a capo morbido: il valore continua all’inizio della riga successiva.

Set di caratteri e nomi illeggibili

• Un file 2.1 senza CHARSET= di solito è stato scritto nella tabella codici locale del telefono o di Windows. Letto come UTF-8, i suoi accenti diventano punti interrogativi.
• «Ã©» dove dovrebbe esserci «é» indica il contrario: un testo UTF-8 letto come Windows-1252, spesso da Excel.
• Un file 3.0 non indica il suo set di caratteri. Le esportazioni di oggi scrivono UTF-8, e un lettore dovrebbe presumerlo.
• Un file 4.0 è UTF-8 per definizione.
• Nella 3.0 e nella 4.0 una virgola, un punto e virgola o una barra rovesciata dentro un valore sono preceduti da una barra rovesciata, e un a capo dentro una nota si scrive \n. Un lettore che salta questa regola divide un valore in due.

Convertire tra versioni e in CSV

Il convertitore da VCF a CSV legge tutte e tre le versioni, le righe spezzate, il testo quoted-printable, le etichette item1. e i file in UTF-8, UTF-16 o Windows-1252, poi scrive un CSV con una riga per contatto. Al contrario, da un CSV crea un unico file vCard 3.0. Funziona nel tuo browser e non carica nulla. Le foto vengono saltate. Se prima ti servono le basi, leggi cos’è un file VCF.