Darmowy konwerter online XML do VCARD

Telefon, klient poczty e-mail lub aplikacja książki adresowej może wymagać kontaktów w formacie vCard (.vcf) zamiast eksportu XML specyficznego dla aplikacji. Konwersja pliku ułatwia importowanie, udostępnianie, edytowanie i przesyłanie kontaktów między obsługiwanymi urządzeniami i programami.

Czym jest XML

XML to tekstowy format oparty na znacznikach, służący do przechowywania i wymiany danych hierarchicznych. Pliki XML z kontaktami mogą być tworzone przez systemy CRM, klientów poczty e-mail, książki adresowe, usługi internetowe, kopie zapasowe urządzeń i niestandardowe bazy danych.

XML nie ma uniwersalnego schematu kontaktów. Jeden plik może używać elementów <contact>, <firstName> i <phone>, a inny elementów <person>, <given> i <telephoneNumber>. Przed konwersją zidentyfikuj powtarzający się element kontaktu oraz pola zawierające imiona i nazwiska, adresy e-mail, numery telefonów, organizacje, adresy pocztowe, notatki i identyfikatory. Przestrzenie nazw i zagnieżdżone elementy również mogą wpływać na wykrywanie pól.

Czym jest format vCard

vCard to ustandaryzowany format tekstowy przeznaczony do przechowywania rekordów kontaktów, zwykle zapisywany z rozszerzeniem .vcf. Plik może zawierać jeden kontakt lub wiele kontaktów i może być importowany przez telefony, klientów poczty e-mail, książki adresowe, systemy CRM oraz komputerowe menedżery kontaktów.

Każdy rekord zaczyna się od BEGIN:VCARD i kończy na END:VCARD. Typowe właściwości obejmują FN dla nazwy wyświetlanej, N dla uporządkowanych składników nazwy, TEL, EMAIL, ORG, ADR, NOTE i UID. vCard 3.0 jest zazwyczaj najbezpieczniejszym wyborem pod względem zgodności; vCard 4.0 obsługuje nowsze funkcje, ale może nie zostać poprawnie zaimportowany do starszych telefonów i aplikacji.

Jak przekonwertować XML do vCard

W przypadku typowego eksportu kontaktów użyj konwertera na stronie 101convert.com: prześlij plik XML, wybierz VCARD jako format wyjściowy, rozpocznij konwersję i pobierz wynikowy plik .vcf. Instalowanie oprogramowania nie jest wymagane. Jeśli XML pochodzi z zastrzeżonej aplikacji, przed zaimportowaniem sprawdź wynik.

Jeśli automatyczne wykrywanie pól nie powiedzie się, użyj edytora XML, programu do transformacji danych lub niestandardowego skryptu:

1. Otwórz XML i znajdź element powtarzający się raz dla każdego kontaktu.
2. Przypisz pola źródłowe do właściwości vCard: nazwę wyświetlaną do FN, imiona i nazwiska do N, numery telefonów do TEL, adresy e-mail do EMAIL, firmę do ORG, a składniki adresu pocztowego do ADR.
3. Wybierz vCard 3.0, chyba że aplikacja docelowa wyraźnie obsługuje vCard 4.0.
4. Wygeneruj jeden kompletny blok vCard dla każdego kontaktu i zapisz wszystkie bloki jako plik UTF-8, na przykład contacts.vcf.
5. Zaimportuj plik za pomocą menu kontaktów aplikacji docelowej, zazwyczaj Contacts → Import lub File → Import.

Minimalny rekord vCard 3.0 wygląda następująco:

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

W przypadku powtarzalnych konwersji standardowa biblioteka Python może przeanalizować prostą strukturę XML i wygenerować vCards. Zmień nazwy elementów i ścieżki tak, aby odpowiadały źródłu:

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

Uruchom go za pomocą polecenia python convert_contacts.py. Skrypt produkcyjny musi obsługiwać przestrzenie nazw XML, brakujące wartości, wiele elementów telefonów i adresów e-mail, składanie wierszy vCard w przypadku długich wierszy oraz zmiany znaczenia właściwe dla poszczególnych właściwości. Powinien również przypisywać odpowiednie parametry TYPE tylko wtedy, gdy XML wskazuje, że dany numer jest numerem komórkowym, służbowym, domowym lub faksem.

Ograniczenia jakości i zgodności

Jakość konwersji zależy od schematu XML, a nie od rozszerzenia pliku. Konwerter nie jest w stanie niezawodnie określić znaczenia nieopisanego numeru, a zastrzeżone pola mogą nie mieć odpowiednika w vCard. Zdjęcia, grupy, pola niestandardowe, uprawnienia, powiązane rekordy, wiele adresów i dane dotyczące relacji mogą zostać pominięte lub przekształcone.

Przechowuj oryginalny plik XML jako kopię zapasową. Przed konwersją dużej książki adresowej przetestuj niewielką próbkę, a następnie po imporcie sprawdź nazwy, kodowanie znaków, etykiety telefonów, zduplikowane rekordy, tekst w alfabetach innych niż łaciński oraz podziały wierszy. Ponowny import tego samego pliku .vcf może utworzyć duplikaty, a niektóre aplikacje obsługują tylko podzbiór właściwości vCard 3.0 lub 4.0.