Darmowy konwerter online XLSX do VCF

Książki adresowe telefonu, klienci poczty e-mail i systemy zarządzania kontaktami często importują kontakty jako pliki VCF. Konwersja listy kontaktów XLSX pozwala uniknąć ręcznego ponownego wprowadzania imion i nazwisk, numerów telefonów, adresów e-mail oraz danych organizacji.

Czym jest format XLSX

XLSX to oparty na ZIP format skoroszytu Open XML programu Microsoft Excel, obsługiwany przez Excel, LibreOffice Calc, Apple Numbers oraz wiele systemów biznesowych. Skoroszyt może zawierać wiele arkuszy, wartości komórek, formuły, formatowanie, tabele oraz dane kontaktów uporządkowane w wierszach i kolumnach.

XLSX nie definiuje standardowego schematu kontaktu. Konwersja musi więc mapować nagłówki, takie jak First Name, Last Name, Phone i Email, na odpowiadające im właściwości VCF. Skoroszyt powinien zazwyczaj zawierać jeden kontakt w każdym wierszu oraz wiersz nagłówków u góry.

Czym jest format VCF

VCF, nazywany również vCard, to format tekstowy służący do wymiany rekordów kontaktów. Plik może zawierać jeden kontakt lub wiele kontaktów, z właściwościami takimi jak FN dla wyświetlanej nazwy, N dla strukturalnego imienia i nazwiska, TEL dla numerów telefonów, EMAIL, ORG, TITLE oraz ADR dla adresu.

Aplikacje kontaktów Android i iOS, Microsoft Outlook, Apple Contacts, Thunderbird, systemy webmail oraz firmowe książki adresowe zazwyczaj obsługują import VCF. W przeciwieństwie do ogólnego pliku CSV format VCF bezpośrednio identyfikuje pola kontaktów, jednak poszczególne aplikacje różnią się zakresem obsługiwanych pól, etykietami, kodowaniami znaków i wersjami VCF.

Konwertowanie XLSX do VCF online

Plik można bezpłatnie przekonwertować w serwisie 101convert.com, bez instalowania oprogramowania. Prześlij skoroszyt XLSX, rozpocznij konwersję i pobierz wygenerowany plik VCF. Jeśli skoroszyt zawiera kilka arkuszy lub nietypowe nagłówki, przed zaimportowaniem wyniku sprawdź, którego arkusza i których kolumn używa konwerter.

Konwersja online wymaga przesłania arkusza kalkulacyjnego. W przypadku poufnych list kontaktów klientów, pracowników lub kontaktów osobistych użyj metody lokalnej, gdy dane muszą pozostać na komputerze.

Konwertowanie XLSX do VCF lokalnie za pomocą Python

Python zapewnia powtarzalną metodę lokalną z użyciem openpyxl do odczytu XLSX oraz vobject do tworzenia danych vCard 3.0. Zainstaluj oba pakiety:

python -m pip install openpyxl vobject

Umieść kontakty w aktywnym arkuszu i użyj nagłówków takich jak First Name, Last Name, Phone, Mobile, Work Phone, Email, Organization, Title, Street, City, State, Postal Code i Country. Zapisz ten plik jako xlsx_to_vcf.py w tym samym folderze co contacts.xlsx:

from openpyxl import load_workbook
import vobject

workbook = load_workbook("contacts.xlsx", data_only=True, read_only=True)
worksheet = workbook.active
rows = worksheet.iter_rows(values_only=True)
headers = [str(value or "").strip().lower() for value in next(rows)]

with open("contacts.vcf", "w", encoding="utf-8", newline="") as output:
    for values in rows:
        row = dict(zip(headers, values))

        def get(*names):
            for name in names:
                value = row.get(name.lower())
                if value not in (None, ""):
                    return str(value).strip()
            return ""

        first = get("first name", "given name")
        last = get("last name", "surname", "family name")
        display = get("full name", "name") or " ".join(
            part for part in (first, last) if part
        )
        if not display:
            continue

        card = vobject.vCard()
        card.add("fn").value = display
        card.add("n").value = vobject.vcard.Name(family=last, given=first)

        for column, label in (("phone", "VOICE"), ("mobile", "CELL"), ("work phone", "WORK")):
            number = get(column)
            if number:
                telephone = card.add("tel")
                telephone.value = number
                telephone.type_param = label

        email = get("email", "email address")
        if email:
            card.add("email").value = email

        organization = get("organization", "company")
        if organization:
            card.add("org").value = [organization]

        title = get("title", "job title")
        if title:
            card.add("title").value = title

        address = vobject.vcard.Address(
            street=get("street", "address"),
            city=get("city"),
            region=get("state", "province", "region"),
            code=get("postal code", "zip", "zip code"),
            country=get("country")
        )
        if any(address.value):
            card.add("adr").value = address

        output.write(card.serialize())

Uruchom skrypt z tego folderu:

python xlsx_to_vcf.py

Skrypt odczytuje pierwszy aktywny arkusz i zapisuje wszystkie przekonwertowane rekordy w pliku contacts.vcf. Dodaj dodatkowe nazwy nagłówków do wywołań get(), jeśli arkusz kalkulacyjny używa innych etykiet; dodaj kolejne mapowanie numeru telefonu, gdy plik zawiera pola takie jak Home Phone lub Phone 2.

Zaimportuj wynik za pomocą polecenia kontaktów w aplikacji docelowej, takiego jak Contacts → Settings → Import lub File → Import. Dokładne menu oraz to, czy aplikacja akceptuje VCF zawierający wiele kontaktów, zależy od oprogramowania.

Ograniczenia jakości i zgodności

• Mapowanie kolumn kontroluje wynik. Zmień nazwy niejednoznacznych nagłówków przed konwersją. Nagłówek taki jak Phone 2 nie jest rozpoznawany przez przykładowy skrypt, dopóki nie zostanie dodany do jego mapowania.
• Utrzymuj jeden kontakt w każdym wierszu. Kilka numerów telefonów lub adresów e-mail w jednej komórce może zostać zaimportowanych jako jedna nieustrukturyzowana wartość, chyba że reguły konwersji je rozdzielają.
• Przykład w Python używa data_only=True, dlatego komórki zawierające formuły wymagają wyników zapisanych w pamięci podręcznej przez Excel lub LibreOffice. Przelicz i zapisz skoroszyt przed uruchomieniem skryptu.
• Formatowanie XLSX, kolory, szerokości kolumn, filtry, formuły i struktura arkusza nie mają odpowiedników w VCF i zostaną odrzucone.
• Po imporcie sprawdź imiona i nazwiska, zduplikowane rekordy, kody krajów, numery wewnętrzne, puste wiersze oraz etykiety numerów telefonów. Numery w arkuszu kalkulacyjnym mogą również zostać zmienione przez automatyczne formatowanie liczb; przechowuj numery telefonów jako tekst, jeśli trzeba zachować początkowe zera lub znaki plus.
• VCF 3.0 jest szeroko obsługiwany, natomiast niektóre nowsze aplikacje obsługują również VCF 4.0, a starsze urządzenia mogą wymagać VCF 2.1. Jeśli importer odrzuca wynik, wyeksportuj dane w określonej przez niego wersji lub podziel duży plik na mniejsze partie.
• UTF-8 zazwyczaj zachowuje znaki diakrytyczne, jednak starsze telefony i programy do kontaktów mogą nieprawidłowo obsługiwać tekst spoza ASCII, długie notatki, wiele etykiet numerów telefonów lub mniej typowe pola adresowe.