Konverter online gratis VCARD ke CSV

Banyak sistem CRM, mailing tools, spreadsheet, dan database memerlukan kontak dalam bentuk tabel, bukan kartu alamat. Mengonversi address book .vcf menghasilkan baris yang dapat diedit untuk impor massal, peninjauan, atau pengarsipan, sekaligus mempertahankan file kontak asli untuk pemulihan.

Apa itu format VCARD

VCARD, yang biasanya disimpan dengan ekstensi .vcf, adalah format terstruktur untuk kartu kontak. Ponsel, email client, dan aplikasi address book menggunakannya untuk menyimpan nama, organisasi, jabatan, nomor telepon, alamat email, alamat pos, URL, catatan, ulang tahun, foto, dan properti lainnya.

Sebuah file dapat berisi satu kartu yang diekspor dari perangkat atau banyak kartu dari seluruh address book. Versi yang umum mencakup vCard 2.1, 3.0, dan 4.0. Versi dan aplikasi yang melakukan ekspor memengaruhi nama properti, character encoding, line folding, dan field yang didukung.

Apa itu format CSV

CSV, atau comma-separated values, menyimpan data tabular sebagai baris dan kolom. CSV kontak biasanya memiliki satu baris per orang dan kolom seperti Full name, Organization, Phone, Email, Street, City, dan Postal code.

Excel, Google Sheets, LibreOffice Calc, platform CRM, sistem bulk-mailing, database, dan script biasanya menerima CSV. Format ini berupa plain text dan mudah diedit atau diproses, tetapi tidak memiliki contact schema universal. Karena itu, CSV mungkin menghilangkan atau meratakan fitur vCard seperti foto, kategori, beberapa alamat dengan tipe berbeda, relasi, dan custom properties.

Cara mengonversi file

Menggunakan 101convert.com

1. Buka konverter VCF ke CSV di 101convert.com.
2. Pilih atau seret file .vcf ke dalam konverter. File yang berisi beberapa kartu sebaiknya dikirim sebagai satu file agar setiap kartu dapat menjadi baris CSV terpisah.
3. Mulai konversi dan unduh file .csv yang dihasilkan. Konversi tersedia tanpa menginstal software.
4. Buka CSV di Excel, LibreOffice Calc, atau spreadsheet lainnya. Jika dialog impor muncul, pilih UTF-8 dan delimiter yang digunakan oleh output, biasanya koma. Beberapa pengaturan spreadsheet regional menggunakan titik koma.
5. Periksa beberapa record sebelum mengimpornya ke sistem lain, termasuk nama dengan aksen, nomor telepon, alamat, line break, serta record dengan beberapa alamat email atau nomor telepon.

Konversi online memerlukan pengunggahan file kontak, jadi gunakan metode lokal jika address book berisi data rahasia atau informasi organisasi yang harus tetap berada di perangkat.

Menggunakan script Python lokal

Untuk data pribadi atau konversi batch yang dapat diulang, instal parser vobject open-source:

python -m pip install vobject

Simpan ini sebagai 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 ""
        })

Jalankan script dengan nama file input dan output:

python vcf_to_csv.py contacts.vcf contacts.csv

Contoh ini menggabungkan beberapa nomor telepon dan alamat email dalam satu sel serta mengekspor alamat pos pertama. Perluas daftar field dan logika ekstraksi jika sistem tujuan memerlukan kolom terpisah untuk nilai seluler, kantor, dan rumah.

Batasan kualitas dan kompatibilitas

Properti VCARD dapat berisi folded lines, teks quoted-printable atau UTF-8, koma dan titik koma yang di-escape, parameter seperti TEL;TYPE=CELL, serta field berulang. Gunakan konverter berbasis parser; mengganti koma atau titik koma secara langsung dapat merusak nama, alamat, catatan, dan data telepon.

CSV tidak dapat mempertahankan setiap properti vCard. Foto, kategori, catatan dengan line break, custom fields, beberapa alamat, dan label tipe mungkin dibuang atau digabungkan. Simpan file .vcf asli sampai CSV diverifikasi dan berhasil diimpor.

Saat membuka hasilnya di spreadsheet, impor kolom nomor telepon sebagai text agar angka nol di awal, tanda plus, dan ekstensi tetap utuh. Periksa field yang diawali =, +, -, atau @ sebelum membuka data yang tidak tepercaya di spreadsheet, karena beberapa aplikasi mungkin menafsirkannya sebagai formula, bukan teks kontak.