Online konvertor VCARD do XML zdarma

Co je vCard

vCard je textový formát kontaktů, který se obvykle ukládá s příponou .vcf. Každý záznam je uzavřen mezi BEGIN:VCARD a END:VCARD a může obsahovat jména, telefonní čísla, e-mailové adresy, poštovní adresy, organizace, narozeniny, fotografie, poznámky a vlastní vlastnosti.

Telefony, Microsoft Outlook, Apple Contacts, Google Contacts, Thunderbird, CRM systémy a poštovní aplikace běžně vytvářejí nebo exportují vCard. Jeden soubor může obsahovat jeden kontakt nebo mnoho kontaktů. Verze 2.1, 3.0 a 4.0 se liší syntaxí vlastností, kódováním znaků, parametry a podporovanými funkcemi.

Co je XML

XML je hierarchický textový formát, který reprezentuje data pomocí prvků, atributů, jmenných prostorů a textových hodnot. Podporuje ověřování proti schématu XSD, dotazování a transformaci pomocí nástrojů XML a integraci s aplikacemi, které definují formát importu XML.

XML obvykle neznamená jednu univerzální strukturu kontaktů. Standardizovaný formát xCard, definovaný v RFC 6351, reprezentuje vCard 4.0 v XML, ale mnoho programů místo toho vyžaduje proprietární schéma s odlišnými názvy prvků, jmennými prostory a vnořením. Před výběrem výstupní struktury si ověřte dokumentaci, XSD nebo ukázkový XML soubor přijímající aplikace.

Jak soubor převést

Použití 101convert.com

Na webu 101convert.com vyberte převod VCARD-to-XML, nahrajte soubor .vcf, spusťte převod a stáhněte výsledný soubor .xml. Tato možnost je vhodná, pokud struktura XML převodníku odpovídá importujícímu programu a kontaktní data mohou být zpracována online; u adresářů, které musí zůstat v zařízení, použijte místní metodu.

Otevřete výstup v editoru se znalostí XML a zkontrolujte, zda je správně vytvořený. Úspěšné stažení nezaručuje, že cílový program schéma přijme nebo zachová všechny vlastnosti vCard.

Místní převod pomocí Python

V případě soukromých dat nebo opakovaného zpracování analyzujte vCard pomocí balíčku vobject namísto mechanického nahrazování řádků. Následující skript vytvoří jednoduchou vlastní strukturu XML a zachová název každé vlastnosti, sadu parametrů a textovou reprezentaci její hodnoty:

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)

Uložte jej jako vcard_to_xml.py a spusťte pomocí Python 3.9 nebo novějšího:

python vcard_to_xml.py contacts.vcf contacts.xml

Výsledkem budou prvky jako <contacts>, <contact> a <property name="tel">. Jde o výchozí bod, nikoli o univerzální formát importu. Upravte názvy prvků, jmenný prostor, reprezentaci parametrů, formátování dat a zpracování strukturovaných hodnot tak, aby odpovídaly cílovému schématu. Pokud cílový systém přijímá xCard, implementujte mapování prvků a jmenného prostoru podle RFC 6351 namísto použití této vlastní struktury.

Kontroly kvality a kompatibility

Platné XML nemusí být kompatibilní XML. Importní programy mohou vyžadovat konkrétní kořenový prvek, jmenný prostor, vnoření kontaktů, názvy polí, syntaxi typů telefonů a e-mailů, formát data nebo verzi xCard. Pokud je k dispozici XSD, ověřte proti němu výsledek a otestujte jej s kopií cílového adresáře.

K řešení zalomených řádků, hodnot quoted-printable, textu UTF-8, escapovaných znaků, parametrů vlastností, opakovaných vlastností a pravidel specifických pro jednotlivé verze používejte parser vCard. Převod po jednotlivých řádcích může poškodit víceřádkové poznámky, názvy s ne-ASCII znaky, štítky telefonních čísel nebo adresy.

Ukázkový skript převádí hodnoty na text a nemusí zachovat úplnou sémantiku strukturovaných polí, jako jsou ADR a ORG, binární fotografie, členství ve skupinách, časová pásma, soukromá pole nebo rozšíření dodavatele. Zkontrolujte záznamy obsahující více telefonních čísel, opakované e-mailové adresy, fotografie a poznámky. Pokud musí být zachována každá funkce vCard, použijte zdokumentované schéma xCard nebo schéma dodavatele a původní soubor .vcf uchovejte jako autoritativní zálohu.