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 Teilcontacts.vcfenthalten. - Sicherung: Zieht vor dem Import einen Export eurer Personen.
Datei vorbereiten
-
Dateiname: Der Name muss
contacts.vcfenthalten, zum Beispielcontacts.vcf. Groß- und Kleinschreibung spielen keine Rolle. -
Zusätze im Dateinamen:
Zusatz Wirkung WITH_COMPANY(genau so geschrieben), zum BeispielWITH_COMPANY_contacts.vcfLegt für jede Person ohne Konto ein eigenes Abrechnungskonto an COMPANY_CONTACT(genau so geschrieben), zum BeispielCOMPANY_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 |
|
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
- Exportiert die Kontakte aus eurem Adressbuch als vCard-Datei.
- Öffnet Einstellungen → Import.
- Klickt auf Hinzufügen und wählt die Datei aus.
- Wartet, bis der Eintrag grün oder rot ist.
- 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_COMPANYin 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. |