Convertitore online gratuito da VCARD a XML

Cos’è vCard

vCard è un formato di contatto basato su testo, normalmente archiviato con estensione .vcf. Ogni record è racchiuso tra BEGIN:VCARD e END:VCARD e può contenere nomi, numeri di telefono, indirizzi email, indirizzi postali, organizzazioni, compleanni, fotografie, note e proprietà personalizzate.

Telefoni, Microsoft Outlook, Apple Contacts, Google Contacts, Thunderbird, sistemi CRM e applicazioni di posta creano o esportano comunemente vCard. Un file può contenere uno o molti contatti. Le versioni 2.1, 3.0 e 4.0 differiscono nella sintassi delle proprietà, nella codifica dei caratteri, nei parametri e nelle funzionalità supportate.

Cos’è XML

XML è un formato di testo gerarchico che rappresenta i dati mediante elementi, attributi, namespace e valori di testo. Supporta la convalida rispetto a uno schema XSD, l’interrogazione e la trasformazione con strumenti XML e l’integrazione con applicazioni che definiscono un formato di importazione XML.

XML non indica normalmente un’unica struttura universale per i contatti. Il formato standardizzato xCard, definito da RFC 6351, rappresenta vCard 4.0 in XML, ma molti programmi richiedono invece uno schema proprietario con nomi di elementi, namespace e annidamenti diversi. Consultare la documentazione, lo schema XSD o un esempio XML dell’applicazione ricevente prima di scegliere la struttura di output.

Come convertire il file

Usare 101convert.com

Su 101convert.com, selezionare la conversione da VCARD a XML, caricare il file .vcf, avviare la conversione e scaricare il file .xml risultante. Questa soluzione è adatta quando la struttura XML del convertitore corrisponde a quella del programma di importazione e i dati dei contatti possono essere elaborati online; usare un metodo locale per le rubriche che devono rimanere sul dispositivo.

Aprire l’output in un editor compatibile con XML e verificare che sia ben formato. Un download completato correttamente non garantisce che il programma di destinazione accetti lo schema o conservi tutte le proprietà vCard.

Convertire localmente con Python

Per i dati privati o per elaborazioni ripetibili, analizzare la vCard con il package vobject invece di sostituire meccanicamente le righe. Lo script seguente crea una semplice struttura XML personalizzata e conserva il nome di ogni proprietà, l’insieme dei parametri e la rappresentazione testuale del relativo valore:

python -m pip install vobject

import sys
import vobject
import xml.etree.ElementTree as ET

source, destination = sys.argv[1:3]
root = ET.Element("contacts")

with open(source, "r", encoding="utf-8-sig", newline="") as file:
    for card in vobject.readComponents(file):
        contact = ET.SubElement(root, "contact")
        for name, properties in card.contents.items():
            for prop in properties:
                element = ET.SubElement(contact, "property", {"name": name})
                for key, values in prop.params.items():
                    element.set(key.lower(), ",".join(str(value) for value in values))
                value = prop.value
                if isinstance(value, (list, tuple)):
                    element.text = ";".join(str(part) for part in value)
                else:
                    element.text = "" if value is None else str(value)

ET.indent(root, space="  ")
ET.ElementTree(root).write(destination, encoding="utf-8", xml_declaration=True)

Salvarlo come vcard_to_xml.py ed eseguirlo con Python 3.9 o versione successiva:

python vcard_to_xml.py contacts.vcf contacts.xml

Questo produce elementi come <contacts>, <contact> e <property name="tel">. È un punto di partenza, non un formato di importazione universale. Modificare i nomi degli elementi, il namespace, la rappresentazione dei parametri, la formattazione delle date e la gestione dei valori strutturati in base allo schema di destinazione. Se la destinazione accetta xCard, implementare la mappatura degli elementi e dei namespace prevista da RFC 6351 invece di usare questa struttura personalizzata.

Controlli di qualità e compatibilità

Un XML valido non è necessariamente un XML compatibile. I programmi di importazione possono richiedere uno specifico elemento radice, namespace, annidamento dei contatti, nomi dei campi, sintassi dei tipi di telefono ed email, formato delle date o versione di xCard. Convalidare il risultato rispetto all’XSD fornito, quando disponibile, e testarlo con una copia della rubrica di destinazione.

Usare un parser vCard per gestire righe ripiegate, valori quoted-printable, testo UTF-8, caratteri con escape, parametri delle proprietà, proprietà ripetute e regole specifiche delle diverse versioni. Una conversione riga per riga può danneggiare note multilinea, nomi non ASCII, etichette telefoniche o indirizzi.

Lo script di esempio converte i valori in testo e potrebbe non preservare completamente la semantica dei campi strutturati come ADR e ORG, delle fotografie binarie, dell’appartenenza ai gruppi, dei fusi orari, dei campi privati o delle estensioni del fornitore. Esaminare i record contenenti più numeri di telefono, indirizzi email ripetuti, fotografie e note. Se è necessario conservare ogni funzionalità vCard, usare uno schema xCard o del fornitore documentato e conservare il file .vcf originale come backup autorevole.