Darmowy konwerter online VCARD do CSV

Wiele systemów CRM, narzędzi do wysyłania wiadomości, arkuszy kalkulacyjnych i baz danych wymaga kontaktów w postaci tabeli, a nie kart adresowych. Konwersja książki adresowej .vcf tworzy edytowalne wiersze do importu zbiorczego, przeglądania lub archiwizacji, zachowując oryginalny plik kontaktów na potrzeby odzyskiwania danych.

Czym jest format VCARD

VCARD, zwykle zapisywany z rozszerzeniem .vcf, to ustrukturyzowany format kart kontaktów. Telefony, klienci poczty e-mail i aplikacje książki adresowej używają go do przechowywania nazw, organizacji, stanowisk, numerów telefonów, adresów e-mail, adresów pocztowych, adresów URL, notatek, dat urodzenia, zdjęć i innych właściwości.

Plik może zawierać jedną kartę wyeksportowaną z urządzenia lub wiele kart z całej książki adresowej. Do popularnych wersji należą vCard 2.1, 3.0 i 4.0. Wersja i aplikacja eksportująca mają wpływ na nazwy właściwości, kodowanie znaków, składanie wierszy i obsługiwane pola.

Czym jest format CSV

CSV, czyli wartości rozdzielane przecinkami, przechowuje dane tabelaryczne w wierszach i kolumnach. CSV kontaktów zwykle zawiera jeden wiersz na osobę oraz kolumny takie jak Full name, Organization, Phone, Email, Street, City i Postal code.

Excel, Google Sheets, LibreOffice Calc, platformy CRM, systemy do masowej wysyłki wiadomości, bazy danych i skrypty często obsługują CSV. Jest to zwykły tekst, łatwy do edytowania i przetwarzania, ale nie ma uniwersalnego schematu kontaktów. W związku z tym plik CSV może pomijać lub spłaszczać funkcje vCard, takie jak zdjęcia, kategorie, wiele adresów z określonym typem, relacje i niestandardowe właściwości.

Jak przekonwertować plik

Za pomocą 101convert.com

1. Otwórz konwerter VCF na CSV w serwisie 101convert.com.
2. Wybierz plik .vcf lub przeciągnij go do konwertera. Plik zawierający wiele kart należy przesłać jako jeden plik, aby każda karta mogła stać się osobnym wierszem CSV.
3. Rozpocznij konwersję i pobierz wynikowy plik .csv. Konwersja jest dostępna bez instalowania software.
4. Otwórz plik CSV w Excelu, LibreOffice Calc lub innym arkuszu kalkulacyjnym. Jeśli pojawi się okno dialogowe importu, wybierz UTF-8 oraz separator używany przez dane wyjściowe, zwykle przecinek. Niektóre regionalne ustawienia arkuszy kalkulacyjnych używają zamiast niego średników.
5. Sprawdź kilka rekordów przed zaimportowaniem ich do innego systemu, w tym nazwy zawierające znaki diakrytyczne, numery telefonów, adresy, podziały wierszy oraz rekordy z wieloma adresami e-mail lub numerami telefonów.

Konwersja online wymaga przesłania pliku kontaktów, dlatego w przypadku książki adresowej zawierającej poufne dane lub informacje organizacyjne, które muszą pozostać na urządzeniu, użyj metody lokalnej.

Za pomocą lokalnego skryptu Python

W przypadku danych prywatnych lub powtarzalnej konwersji zbiorczej zainstaluj open-source parser vobject:

python -m pip install vobject

Zapisz poniższy kod jako vcf_to_csv.py:

import csv
import sys
import vobject

def value(card, name):
    item = getattr(card, name, None)
    return item.value if item else ""

def values(card, name):
    return "; ".join(item.value for item in getattr(card, name + "_list", []))

with open(sys.argv[1], encoding="utf-8-sig") as source, open(
    sys.argv[2], "w", newline="", encoding="utf-8-sig"
) as output:
    fields = ["full_name", "organization", "phone", "email", "street", "city", "region", "postal_code", "country"]
    writer = csv.DictWriter(output, fieldnames=fields)
    writer.writeheader()

    for card in vobject.readComponents(source):
        address = getattr(card, "adr", None)
        adr = address.value if address else None
        writer.writerow({
            "full_name": value(card, "fn"),
            "organization": value(card, "org"),
            "phone": values(card, "tel"),
            "email": values(card, "email"),
            "street": adr.street if adr else "",
            "city": adr.city if adr else "",
            "region": adr.region if adr else "",
            "postal_code": adr.code if adr else "",
            "country": adr.country if adr else ""
        })

Uruchom skrypt, podając nazwy pliku wejściowego i wyjściowego:

python vcf_to_csv.py contacts.vcf contacts.csv

Ten przykład łączy wiele numerów telefonów i adresów e-mail w jednej komórce oraz eksportuje pierwszy adres pocztowy. Rozszerz listę pól i logikę wyodrębniania, jeśli system docelowy wymaga osobnych kolumn dla wartości telefonu komórkowego, służbowego i domowego.

Ograniczenia jakości i zgodności

Właściwości VCARD mogą zawierać składane wiersze, tekst w formacie quoted-printable lub UTF-8, znaki ucieczki przed przecinkami i średnikami, parametry takie jak TEL;TYPE=CELL oraz powtarzające się pola. Używaj konwertera opartego na parserze; bezpośrednie zastępowanie przecinków lub średników może uszkodzić nazwy, adresy, notatki i dane telefoniczne.

CSV nie może zachować każdej właściwości vCard. Zdjęcia, kategorie, notatki z podziałami wierszy, pola niestandardowe, wiele adresów i etykiety typów mogą zostać odrzucone lub połączone. Zachowaj oryginalny plik .vcf do czasu zweryfikowania pliku CSV i pomyślnego zaimportowania go.

Podczas otwierania wyniku w arkuszu kalkulacyjnym importuj kolumny z numerami telefonów jako tekst, aby zachować początkowe zera, znaki plus i numery wewnętrzne. Przed otwarciem niezaufanych danych w arkuszu kalkulacyjnym sprawdź pola zaczynające się od =, +, - lub @, ponieważ niektóre aplikacje mogą interpretować je jako formuły, a nie tekst kontaktu.