Convertitore online gratuito da VCARD a CSV

Molti sistemi CRM, strumenti di mailing, fogli di calcolo e database richiedono i contatti sotto forma di tabella anziché di schede contatto. La conversione di una rubrica .vcf produce righe modificabili per l'importazione in blocco, la revisione o l'archiviazione, preservando al contempo il file di contatti originale per il ripristino.

Che cos'è il formato VCARD

VCARD, generalmente salvato con l'estensione .vcf, è un formato strutturato per le schede contatto. Telefoni, client email e applicazioni per rubriche lo usano per memorizzare nomi, organizzazioni, qualifiche professionali, numeri di telefono, indirizzi email, indirizzi postali, URL, note, compleanni, foto e altre proprietà.

Un file può contenere una scheda esportata da un dispositivo oppure molte schede provenienti da un'intera rubrica. Le versioni comuni includono vCard 2.1, 3.0 e 4.0. La versione e l'applicazione che esegue l'esportazione influiscono sui nomi delle proprietà, sulla codifica dei caratteri, sulla suddivisione delle righe e sui campi supportati.

Che cos'è il formato CSV

CSV, ovvero valori separati da virgole, memorizza i dati tabulari sotto forma di righe e colonne. Un CSV di contatti contiene comunemente una riga per persona e colonne come Full name, Organization, Phone, Email, Street, City e Postal code.

Excel, Google Sheets, LibreOffice Calc, piattaforme CRM, sistemi di mailing in blocco, database e script accettano comunemente file CSV. È testo semplice e facile da modificare o elaborare, ma non dispone di uno schema universale per i contatti. Un CSV può quindi omettere o semplificare funzioni di vCard come foto, categorie, più indirizzi con tipo, relazioni e proprietà personalizzate.

Come convertire il file

Utilizzo di 101convert.com

1. Apri il convertitore da VCF a CSV su 101convert.com.
2. Seleziona o trascina il file .vcf nel convertitore. Un file contenente più schede deve essere inviato come file singolo, in modo che ogni scheda possa diventare una riga CSV separata.
3. Avvia la conversione e scarica il file .csv risultante. La conversione è disponibile senza installare software.
4. Apri il CSV in Excel, LibreOffice Calc o un altro foglio di calcolo. Se viene visualizzata una finestra di dialogo per l'importazione, seleziona UTF-8 e il delimitatore utilizzato dall'output, normalmente una virgola. Alcune impostazioni regionali dei fogli di calcolo utilizzano invece il punto e virgola.
5. Controlla diversi record prima di importarli in un altro sistema, inclusi nomi con caratteri accentati, numeri di telefono, indirizzi, interruzioni di riga e record con più indirizzi email o numeri di telefono.

La conversione online richiede il caricamento del file di contatti; pertanto, utilizza invece un metodo locale quando la rubrica contiene dati riservati o informazioni dell'organizzazione che devono rimanere sul dispositivo.

Utilizzo di uno script Python locale

Per dati privati o conversioni batch ripetibili, installa il parser open-source vobject:

python -m pip install vobject

Salva questo file come vcf_to_csv.py:

import csv
import sys
import vobject

def value(card, name):
    item = getattr(card, name, None)
    return item.value if item else ""

def values(card, name):
    return "; ".join(item.value for item in getattr(card, name + "_list", []))

with open(sys.argv[1], encoding="utf-8-sig") as source, open(
    sys.argv[2], "w", newline="", encoding="utf-8-sig"
) as output:
    fields = ["full_name", "organization", "phone", "email", "street", "city", "region", "postal_code", "country"]
    writer = csv.DictWriter(output, fieldnames=fields)
    writer.writeheader()

    for card in vobject.readComponents(source):
        address = getattr(card, "adr", None)
        adr = address.value if address else None
        writer.writerow({
            "full_name": value(card, "fn"),
            "organization": value(card, "org"),
            "phone": values(card, "tel"),
            "email": values(card, "email"),
            "street": adr.street if adr else "",
            "city": adr.city if adr else "",
            "region": adr.region if adr else "",
            "postal_code": adr.code if adr else "",
            "country": adr.country if adr else ""
        })

Esegui lo script con i nomi dei file di input e output:

python vcf_to_csv.py contacts.vcf contacts.csv

Questo esempio combina più numeri di telefono e indirizzi email in una singola cella ed esporta il primo indirizzo postale. Estendi l'elenco dei campi e la logica di estrazione se il sistema di destinazione richiede colonne separate per i valori di cellulare, lavoro e casa.

Limiti di qualità e compatibilità

Le proprietà VCARD possono contenere righe suddivise, testo quoted-printable o UTF-8, virgole e punti e virgola con caratteri di escape, parametri come TEL;TYPE=CELL e campi ripetuti. Utilizza un convertitore basato su parser; sostituire direttamente virgole o punti e virgola può danneggiare nomi, indirizzi, note e dati telefonici.

CSV non può preservare tutte le proprietà vCard. Foto, categorie, note con interruzioni di riga, campi personalizzati, più indirizzi ed etichette dei tipi possono essere eliminati o combinati. Conserva il file .vcf originale finché il CSV non è stato verificato e importato correttamente.

Quando apri il risultato in un foglio di calcolo, importa le colonne dei numeri di telefono come testo, in modo da mantenere intatti gli zeri iniziali, i segni più e gli interni. Controlla i campi che iniziano con =, +, - o @ prima di aprire dati non attendibili in un foglio di calcolo, poiché alcune applicazioni potrebbero interpretarli come formule anziché come testo dei contatti.