Darmowy konwerter online VCF do XML

System zarządzania kontaktami, narzędzie do migracji lub archiwum może wymagać formatu XML, gdy kontakty są dostarczane jako plik .vcf. Konwersja udostępnia nazwy, numery, adresy e-mail i inne pola oprogramowaniu opartemu na XML w celu importu lub edycji.

Czym jest format VCF

W przypadku danych kontaktowych VCF oznacza vCard — format tekstowy określony przez standardy, w tym vCard 3.0 (RFC 2426) i vCard 4.0 (RFC 6350). Jeden plik może zawierać jeden lub wiele rekordów kontaktów z polami takimi jak FN, N, TEL, EMAIL, ADR, ORG, NOTE i PHOTO.

Apple Contacts, Google Contacts, Microsoft Outlook, książki adresowe systemu Android i klienci poczty e-mail tworzą pliki VCF na potrzeby eksportu, udostępniania lub tworzenia kopii zapasowych. VCF obsługuje składanie wierszy, znaki poprzedzone znakami ucieczki, parametry pól takie jak TYPE=CELL oraz właściwości specyficzne dla aplikacji, oznaczane jako X-. Składnia oparta na wierszach jest przenośna, ale wiele systemów przetwarzających dane hierarchiczne wymaga formatu XML.

Czym jest XML

XML reprezentuje dane za pomocą zagnieżdżonych elementów, atrybutów i tekstu. Standardowe parsery XML mogą go odczytywać, a XML Schema Definition (XSD) może sprawdzać jego strukturę, wymagane pola, typy danych i przestrzenie nazw. XML nie ma uniwersalnego schematu kontaktów, dlatego konwerter musi generować nazwy elementów i hierarchię wymaganą przez aplikację odbierającą dane.

Podstawowy wynik może wykorzystywać elementy <contacts>, <contact>, <fullName>, <phone> i <email>. Prawidłowe kodowanie znaków XML za pomocą znaków ucieczki zachowuje znaki takie jak & i <; atrybuty mogą zachować parametry VCF, takie jak CELL i WORK. Wynikowy plik XML jest użyteczny tylko wtedy, gdy jego struktura odpowiada dokumentacji lub schematowi docelowego oprogramowania.

Korzystanie z wbudowanego konwertera

1. Otwórz stronę 101convert.com i wybierz konwersję VCF do XML.
2. Wybierz plik kontaktów z rozszerzeniem .vcf i rozpocznij konwersję.
3. Pobierz wygenerowany plik .xml.
4. Otwórz plik XML w przeglądarce lub edytorze XML i przed zaimportowaniem sprawdź liczbę kontaktów, nazwy, numery telefonów, adresy e-mail oraz pola specjalne.

Ta metoda nie wymaga instalacji i jest odpowiednia, gdy miejsce docelowe akceptuje ogólną strukturę XML konwertera. Pliki kontaktów mogą zawierać dane osobowe, dlatego w przypadku ograniczeń dotyczących przesyłania plików lub wymogów poufności użyj metody lokalnej.

Korzystanie z języka Python w przypadku określonej struktury

Użyj skryptu, gdy miejsce docelowe wymaga dokładnych nazw elementów, przestrzeni nazw, atrybutów lub XSD. Zainstaluj parser vCard za pomocą polecenia python -m pip install vobject, a następnie zapisz poniższy kod jako vcf_to_xml.py:

import base64
import xml.etree.ElementTree as ET
import vobject

root = ET.Element("contacts")
with open("contacts.vcf", encoding="utf-8-sig") as source:
    for card in vobject.readComponents(source):
        contact = ET.SubElement(root, "contact")
        for name, properties in card.contents.items():
            for prop in properties:
                element = ET.SubElement(contact, name.lower())
                for parameter, values in prop.params.items():
                    if not isinstance(values, (list, tuple)):
                        values = [values]
                    element.set(parameter.lower(), ",".join(str(v) for v in values))
                value = prop.value
                if isinstance(value, bytes):
                    element.set("encoding", "base64")
                    element.text = base64.b64encode(value).decode("ascii")
                else:
                    element.text = str(value)

ET.ElementTree(root).write("contacts.xml", encoding="utf-8", xml_declaration=True)

Uruchom go za pomocą polecenia python vcf_to_xml.py. Skrypt tworzy ogólną strukturę i zachowuje powtarzające się właściwości oraz parametry, ale nie dostosowuje się automatycznie do schematu kontaktów konkretnego dostawcy. Zastąp wygenerowane nazwy, dodaj przestrzenie nazw lub zmapuj wartości strukturalne, takie jak N i ADR, zgodnie z XSD odbiorcy lub specyfikacją importu.

Ograniczenia jakości i zgodności

Przed konwersją sprawdź wersję źródłową i kodowanie. Parser powinien obsługiwać składane wiersze i znaki interpunkcyjne poprzedzone znakami ucieczki, ale pola niestandardowe, grupy kontaktów, strefy czasowe, osadzone zdjęcia i właściwości specyficzne dla dostawcy mogą zostać pominięte, spłaszczone lub przedstawione w inny sposób. Strukturalne pola vCard mogą również stać się zwykłym tekstem, jeśli konwerter nie odwzoruje jawnie ich komponentów.

Poprawny składniowo plik XML nie jest automatycznie plikiem XML możliwym do zaimportowania. Jeśli istnieje XSD odbiorcy, sprawdź wynik względem tego schematu lub porównaj go z przykładowym plikiem z aplikacji docelowej. Nie używaj arkusza kalkulacyjnego jako ogólnej metody konwersji: importowanie VCF do programu Excel lub innego arkusza kalkulacyjnego może spowodować utratę powtarzających się pól, parametrów, zdjęć i wartości wielowierszowych, a eksport XML może używać schematu specyficznego dla arkusza zamiast schematu kontaktów wymaganego przez miejsce docelowe.

Upewnij się, że dane wejściowe to kontaktowy plik VCF. To samo rozszerzenie jest używane przez naukowy Variant Call Format, który rozpoczyna się od metadanych takich jak ##fileformat=VCF i przechowuje warianty genomowe, a nie kontakty; wymaga on specyficznego dla genomiki schematu XML i konwertera.