Konverter online gratis VCARD ke XML

Apa itu vCard

vCard adalah format kontak berbasis teks yang biasanya disimpan dengan ekstensi .vcf. Setiap data dibungkus oleh BEGIN:VCARD dan END:VCARD serta dapat berisi nama, nomor telepon, alamat email, alamat pos, organisasi, tanggal lahir, foto, catatan, dan properti khusus.

Telepon, Microsoft Outlook, Apple Contacts, Google Contacts, Thunderbird, sistem CRM, dan aplikasi email umumnya membuat atau mengekspor vCard. Satu file dapat berisi satu atau banyak kontak. Versi 2.1, 3.0, dan 4.0 berbeda dalam sintaks properti, character encoding, parameter, dan fitur yang didukung.

Apa itu XML

XML adalah format teks hierarkis yang merepresentasikan data dengan elemen, atribut, namespace, dan nilai teks. XML mendukung validasi terhadap skema XSD, kueri dan transformasi dengan XML tools, serta integrasi dengan aplikasi yang menentukan format impor XML.

XML biasanya tidak berarti satu struktur kontak universal. Format standar xCard, yang ditentukan oleh RFC 6351, merepresentasikan vCard 4.0 dalam XML, tetapi banyak program justru memerlukan schema proprietari dengan nama elemen, namespace, dan nesting yang berbeda. Periksa dokumentasi, XSD, atau contoh XML dari aplikasi penerima sebelum memilih struktur output.

Cara mengonversi file

Gunakan 101convert.com

Di 101convert.com, pilih konversi VCARD-ke-XML, upload file .vcf, mulai konversi, lalu download file .xml yang dihasilkan. Cara ini sesuai jika struktur XML dari converter cocok dengan program pengimpor dan data kontak dapat diproses secara online; gunakan metode lokal untuk buku alamat yang harus tetap berada di perangkat.

Buka output dalam editor yang mendukung XML dan periksa apakah file tersebut well-formed. Download yang berhasil tidak menjamin bahwa program tujuan akan menerima schema atau mempertahankan setiap properti vCard.

Konversi secara lokal dengan Python

Untuk data pribadi atau pemrosesan berulang, parse vCard dengan package vobject alih-alih mengganti baris secara mekanis. Script berikut membuat struktur XML khusus yang sederhana dan mempertahankan setiap nama properti, kumpulan parameter, serta representasi teks dari nilainya:

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)

Simpan sebagai vcard_to_xml.py dan jalankan dengan Python 3.9 atau yang lebih baru:

python vcard_to_xml.py contacts.vcf contacts.xml

Ini menghasilkan elemen seperti <contacts>, <contact>, dan <property name="tel">. Ini adalah titik awal, bukan format impor universal. Ubah nama elemen, namespace, representasi parameter, format tanggal, dan penanganan nilai terstruktur agar sesuai dengan schema tujuan. Jika tujuan menerima xCard, implementasikan pemetaan elemen dan namespace RFC 6351, bukan struktur khusus ini.

Pemeriksaan kualitas dan kompatibilitas

XML yang valid belum tentu kompatibel dengan XML lainnya. Importer mungkin memerlukan elemen root, namespace, nesting kontak, nama field, sintaks tipe telepon dan email, format tanggal, atau versi xCard tertentu. Validasi hasil terhadap XSD yang disediakan jika ada dan uji dengan salinan buku alamat tujuan.

Gunakan parser vCard untuk menangani folded lines, nilai quoted-printable, teks UTF-8, karakter escape, parameter properti, properti berulang, dan aturan khusus versi. Konversi baris demi baris dapat merusak catatan multiline, nama non-ASCII, label telepon, atau alamat.

Script contoh mengonversi nilai menjadi teks dan mungkin tidak mempertahankan semantik lengkap dari field terstruktur seperti ADR dan ORG, foto binary, keanggotaan grup, zona waktu, field pribadi, atau ekstensi vendor. Periksa data yang berisi beberapa nomor telepon, alamat email berulang, foto, dan catatan. Jika setiap fitur vCard harus dipertahankan, gunakan schema xCard atau vendor yang terdokumentasi dan simpan file .vcf asli sebagai backup otoritatif.