Convertitore online gratuito da XML a VCARD

Un telefono, un client di posta elettronica o un'applicazione per la rubrica potrebbe richiedere contatti in formato vCard (.vcf) invece di un'esportazione XML specifica dell'applicazione. La conversione del file facilita l'importazione, la condivisione, la modifica e il trasferimento dei contatti tra dispositivi e programmi supportati.

Che cos'è XML

XML è un formato di testo basato su tag per l'archiviazione e lo scambio di dati gerarchici. I file XML dei contatti possono essere prodotti da sistemi CRM, client di posta elettronica, rubriche, servizi web, backup di dispositivi e database personalizzati.

XML non dispone di uno schema universale per i contatti. Un file può usare <contact>, <firstName> e <phone>; un altro può usare <person>, <given> e <telephoneNumber>. Prima della conversione, identifica l'elemento dei contatti ripetuto e i campi contenenti nomi, indirizzi email, numeri di telefono, organizzazioni, indirizzi postali, note e identificatori. Anche gli spazi dei nomi e gli elementi nidificati possono influire sul rilevamento dei campi.

Che cos'è il formato vCard

vCard è un formato di testo semplice standardizzato per i record dei contatti, normalmente salvato con l'estensione .vcf. Un file può contenere uno o più contatti e può essere importato da telefoni, client di posta elettronica, rubriche, sistemi CRM e gestori dei contatti desktop.

Ogni record inizia con BEGIN:VCARD e termina con END:VCARD. Le proprietà comuni includono FN per il nome visualizzato, N per i componenti strutturati del nome, TEL, EMAIL, ORG, ADR, NOTE e UID. vCard 3.0 è generalmente la scelta più sicura per la compatibilità; vCard 4.0 supporta funzionalità più recenti, ma potrebbe non essere importato correttamente nei telefoni e nelle applicazioni meno recenti.

Come convertire XML in vCard

Per un'esportazione convenzionale dei contatti, usa il convertitore su 101convert.com: carica il file XML, scegli VCARD come formato di output, avvia la conversione e scarica il file .vcf risultante. Non è necessaria alcuna installazione software. Esamina l'output prima di importarlo quando l'XML proviene da un'applicazione proprietaria.

Se il rilevamento automatico dei campi non riesce, usa un editor XML, un programma di trasformazione dei dati o uno script personalizzato:

1. Apri l'XML e individua l'elemento ripetuto una volta per ogni contatto.
2. Mappa i campi di origine sulle proprietà vCard: il nome visualizzato su FN, il nome e il cognome su N, i numeri di telefono su TEL, gli indirizzi email su EMAIL, l'azienda su ORG e i componenti dell'indirizzo postale su ADR.
3. Scegli vCard 3.0, a meno che l'applicazione di destinazione non supporti esplicitamente vCard 4.0.
4. Genera un blocco vCard completo per ogni contatto e salva tutti i blocchi in un file UTF-8, ad esempio contacts.vcf.
5. Importa il file tramite il menu dei contatti dell'applicazione di destinazione, generalmente Contacts → Import o File → Import.

Un record vCard 3.0 minimo è:

BEGIN:VCARD
VERSION:3.0
N:Doe;Jane;;;
FN:Jane Doe
TEL;TYPE=CELL:+1-202-555-0147
EMAIL:jane.doe@example.com
ORG:Example Ltd
END:VCARD

Per conversioni ripetibili, la libreria standard di Python può analizzare una struttura XML semplice e generare vCard. Modifica i nomi e i percorsi degli elementi in base all'origine:

import xml.etree.ElementTree as ET

def esc(value):
    return (value or "").replace("\\", "\\\\").replace(";", "\\;") \
        .replace(",", "\\,").replace("\r", "").replace("\n", "\\n")

root = ET.parse("contacts.xml").getroot()
blocks = []
for contact in root.findall(".//contact"):
    first = contact.findtext("firstName", "")
    last = contact.findtext("lastName", "")
    full = (first + " " + last).strip()
    name = ";".join((esc(last), esc(first), "", "", ""))
    lines = [
        "BEGIN:VCARD", "VERSION:3.0", f"N:{name}",
        f"FN:{esc(full)}"
    ]
    phone = contact.findtext("phone", "")
    email = contact.findtext("email", "")
    if phone:
        lines.append(f"TEL:{esc(phone)}")
    if email:
        lines.append(f"EMAIL:{esc(email)}")
    lines.append("END:VCARD")
    blocks.append("\r\n".join(lines))

with open("contacts.vcf", "w", encoding="utf-8", newline="") as output:
    output.write("\r\n".join(blocks) + "\r\n")

Eseguilo con python convert_contacts.py. Uno script destinato alla produzione deve gestire gli spazi dei nomi XML, i valori mancanti, più elementi di telefono ed email, il ripiegamento delle righe vCard per le righe lunghe e l'escaping specifico delle proprietà. Dovrebbe inoltre assegnare parametri TYPE appropriati solo quando l'XML identifica un numero come cellulare, lavorativo, domestico o fax.

Limiti di qualità e compatibilità

La qualità della conversione dipende dallo schema XML, non dalla sua estensione. Un convertitore non può dedurre in modo affidabile il significato di un numero senza etichetta e i campi proprietari potrebbero non avere un equivalente vCard. Foto, gruppi, campi personalizzati, autorizzazioni, record collegati, più indirizzi e dati sulle relazioni potrebbero essere eliminati o trasformati.

Conserva l'XML originale come backup. Testa un piccolo campione prima di convertire una rubrica di grandi dimensioni, quindi verifica nomi, codifica dei caratteri, etichette dei numeri di telefono, record duplicati, testo non latino e interruzioni di riga dopo l'importazione. Reimportare lo stesso file .vcf può creare duplicati e alcune applicazioni supportano solo un sottoinsieme delle proprietà vCard 3.0 o 4.0.