Zum Inhalt springen
Developer

Kontakte aus vCard

Übernimmt Kontakte aus einer Adressbuch-Datei (vCard) als Personen, optional mit Konto.

Format
vCard (.vcf)
Rechte
Administrator, Kontakte (CRM) schreiben
Beispieldatei
contacts.vcf (herunterladen)

Kurz gesagt: Ihr exportiert eure Kontakte aus dem Adressbuch als vCard-Datei und übernehmt sie als Personen in vynst. Ein Konto legt vynst nur an, wenn ihr das im Dateinamen angebt.

Wofür ihr das braucht

Viele Kontakte liegen nur im Adressbuch eines Mailprogramms oder Telefons. Mit dieser Datei übernehmt ihr Name, Adresse, E-Mail, Telefon, Geburtstag und, falls vorhanden, Eintritt und Austritt, ohne alles abzutippen.

Bevor ihr startet

  • Rechte: Ihr braucht das Zugriffsrecht Importe und seid Administrator mit Schreibrecht für Kontakte (CRM).
  • Export: Exportiert die Kontakte aus eurem Adressbuch als vCard-Datei (.vcf). Der Dateiname muss den Teil contacts.vcf enthalten.
  • Sicherung: Zieht vor dem Import einen Export eurer Personen.

Datei vorbereiten

  • Dateiname: Der Name muss contacts.vcf enthalten, zum Beispiel contacts.vcf. Groß- und Kleinschreibung spielen keine Rolle.

  • Zusätze im Dateinamen:

    Zusatz Wirkung
    WITH_COMPANY (genau so geschrieben), zum Beispiel WITH_COMPANY_contacts.vcf Legt für jede Person ohne Konto ein eigenes Abrechnungskonto an
    COMPANY_CONTACT (genau so geschrieben), zum Beispiel COMPANY_CONTACT_contacts.vcf Ändert nur die Kontaktdaten bestehender Konten, sonst nichts
  • Inhalt: Jede Karte wird zu einer Person. Ohne Vorname oder Nachname wird die Karte übersprungen.

Was übernommen wird

Feld in der Kontaktkarte Übernommen als
Name (N): Familienname, Vorname, Titel Nachname, Vorname, Titel (wenn kein eigenes Titelfeld da ist)
Titel (TITLE) Titel
Geschlecht (GENDER) Geschlecht
Geburtstag (BDAY), Format 1980-02-01 oder 19800201 Geburtstag
Anrede (X-SPECIAL-SALUTATION) Anrede
E-Mail (EMAIL), nur die erste Adresse E-Mail
Telefon (TEL), nur die erste Nummer ohne Fax-Kennzeichnung Telefon
Adresse (ADR): Adresszusatz, Straße, Ort, PLZ, Land Adresse, Land ohne Angabe: Deutschland
Eintritt (X-MEMBERSHIP-START) Eintrittsdatum
Austritt (X-MEMBERSHIP-END) Austrittsdatum
Fax (TEL mit TYPE=FAX) und Website (URL) nur bei Konten, also mit WITH_COMPANY oder COMPANY_CONTACT

Weitere Telefonnummern einer Karte werden nicht übernommen. Zahlungsfelder (X-PAYMENT-…) und die Mitgliedsart (X-MEMBERSHIP-TYPE) übernimmt dieser Import nicht als Konto- oder Bankdaten.

Beispiel (zwei Karten, Inhalt der Beispieldatei):

BEGIN:VCARD
VERSION:3.0
N:Probe;Clara;;;
FN:Clara Probe
TITLE:Dr.
GENDER:W
X-SPECIAL-SALUTATION:Frau
EMAIL;TYPE=INTERNET:clara.probe@example.org
TEL;TYPE=CELL:0170 7654321
ADR;TYPE=HOME:;Hinterhaus;Gartenweg 4;Köln;;50668;Deutschland
BDAY:1975-09-15
X-MEMBERSHIP-START:2023-09-15
END:VCARD
BEGIN:VCARD
VERSION:3.0
N:Muster;Ben;;;
FN:Ben Muster
GENDER:M
X-SPECIAL-SALUTATION:Herr
EMAIL;TYPE=INTERNET:ben.muster@example.org
TEL;TYPE=CELL:0171 1234567
ADR;TYPE=HOME:;;Musterweg 1;Köln;;50667;Deutschland
BDAY:2012-05-14
X-MEMBERSHIP-START:2022-03-01
X-MEMBERSHIP-END:2026-12-31
END:VCARD

Beispieldatei: contacts.vcf

So geht’s

  1. Exportiert die Kontakte aus eurem Adressbuch als vCard-Datei.
  2. Öffnet Einstellungen → Import.
  3. Klickt auf Hinzufügen und wählt die Datei aus.
  4. Wartet, bis der Eintrag grün oder rot ist.
  5. Prüft das Protokoll auf Zeilen mit Error:.

Gut zu wissen

  • Wiedererkennung: vynst erkennt eine Person an Vorname, Nachname und Straße. Ändert sich eine dieser drei Angaben in der Karte, legt vynst eine neue Person an. Ein erneuter Import mit geänderter Straße erzeugt deshalb eine zweite Person.
  • Erneuter Import: Gleiche Karten aktualisieren die vorhandenen Personen.
  • Keine Mitgliedsnummer: Eine vCard hat keine Mitgliedsnummer. Die Personen erhalten ihre Nummer über den Personenimport oder von Hand.
  • Konten: Wollt ihr Konten anlegen, nehmt WITH_COMPANY in den Dateinamen. Die Konten übernehmen Telefax und Website aus der Karte.

Wenn etwas nicht klappt

Meldung im Protokoll Bedeutung Was tun
Error processing vCard file: <Text> Die Datei konnte nicht vollständig gelesen werden. Der Text nennt den Grund. Datei in einem Adressbuch oder Texteditor öffnen und die Karte mit dem Fehler korrigieren.
Error: skipped missing identifier or name Vorname oder Nachname fehlt. Die Karte steht danach als LINE-DATA. Namen ergänzen und die Datei erneut importieren.
Processed N lines So viele Karten wurden verarbeitet. Nichts tun.
Error: less then one line Die Datei enthält keine Karte. Export prüfen.

Siehe auch