Konverter online gratis XML ke VCARD

Phone, email client, atau aplikasi address book mungkin memerlukan kontak dalam format vCard (.vcf), bukan XML export khusus aplikasi. Mengonversi file membuat kontak lebih mudah diimpor, dibagikan, diedit, dan ditransfer antarperangkat serta program yang didukung.

Apa itu XML

XML adalah format teks berbasis tag untuk menyimpan dan bertukar data hierarkis. File XML kontak dapat dihasilkan oleh sistem CRM, email client, address book, web service, backup perangkat, dan database khusus.

XML tidak memiliki contact schema universal. Satu file mungkin menggunakan <contact>, <firstName>, dan <phone>; file lain mungkin menggunakan <person>, <given>, dan <telephoneNumber>. Sebelum konversi, identifikasi elemen kontak yang berulang serta field yang berisi nama, alamat email, nomor telepon, organisasi, alamat pos, catatan, dan identifier. Namespace dan elemen bertingkat juga dapat memengaruhi deteksi field.

Apa itu format vCard

vCard adalah format teks biasa terstandardisasi untuk record kontak, yang biasanya disimpan dengan ekstensi .vcf. Sebuah file dapat berisi satu atau beberapa kontak dan dapat diimpor oleh phone, email client, address book, sistem CRM, dan contact manager desktop.

Setiap record dimulai dengan BEGIN:VCARD dan diakhiri dengan END:VCARD. Properti umum meliputi FN untuk display name, N untuk komponen nama terstruktur, TEL, EMAIL, ORG, ADR, NOTE, dan UID. vCard 3.0 biasanya merupakan pilihan kompatibilitas yang paling aman; vCard 4.0 mendukung fitur yang lebih baru, tetapi mungkin tidak dapat diimpor dengan benar pada phone dan aplikasi versi lama.

Cara mengonversi XML ke vCard

Untuk contact export konvensional, gunakan converter di 101convert.com: upload file XML, pilih VCARD sebagai format output, mulai konversi, lalu download file .vcf yang dihasilkan. Tidak diperlukan instalasi software. Periksa output sebelum mengimpornya jika XML berasal dari aplikasi proprietary.

Jika deteksi field otomatis gagal, gunakan XML editor, program data-transformation, atau custom script:

1. Buka XML dan temukan elemen yang diulang satu kali untuk setiap kontak.
2. Petakan source field ke properti vCard: display name ke FN, nama depan dan nama keluarga ke N, nomor telepon ke TEL, alamat email ke EMAIL, perusahaan ke ORG, dan komponen alamat pos ke ADR.
3. Pilih vCard 3.0 kecuali aplikasi penerima secara eksplisit mendukung vCard 4.0.
4. Hasilkan satu blok vCard lengkap untuk setiap kontak dan simpan semua blok sebagai file UTF-8, misalnya contacts.vcf.
5. Impor file melalui menu kontak pada aplikasi tujuan, biasanya Contacts → Import atau File → Import.

Record vCard 3.0 minimal adalah:

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

Untuk konversi yang dapat diulang, standard library Python dapat mem-parse struktur XML sederhana dan menghasilkan vCard. Ubah nama elemen dan path agar sesuai dengan source:

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")

Jalankan dengan python convert_contacts.py. Production script harus menangani XML namespace, nilai yang tidak ada, beberapa elemen telepon dan email, vCard line folding untuk baris yang panjang, serta escaping khusus properti. Script tersebut juga harus menetapkan parameter TYPE yang sesuai hanya jika XML mengidentifikasi suatu nomor sebagai mobile, work, home, atau fax.

Batasan kualitas dan kompatibilitas

Kualitas konversi bergantung pada XML schema, bukan ekstensi filenya. Converter tidak dapat secara andal menyimpulkan arti nomor yang tidak memiliki label, dan field proprietary mungkin tidak memiliki padanan vCard. Foto, grup, custom field, permission, linked record, beberapa alamat, dan data relasi mungkin dihapus atau ditransformasi.

Simpan XML asli sebagai backup. Uji sampel kecil sebelum mengonversi address book berukuran besar, lalu periksa nama, character encoding, label telepon, record duplikat, teks non-Latin, dan line break setelah impor. Mengimpor kembali file .vcf yang sama dapat membuat duplikat, dan beberapa aplikasi hanya mendukung sebagian properti vCard 3.0 atau 4.0.