vCard-4.0-Grundlagen: das Format text/vcard zum Austausch von Kontakten

Worum es geht

Eine vCard (RFC 6350, Medientyp text/vcard) ist eine Folge von CRLF-terminierten Inhaltszeilen zwischen BEGIN:VCARD und END:VCARD, jede von der Form NAME;PARAM=value:value. VERSION:4.0 muss unmittelbar auf BEGIN:VCARD folgen; FN (der formatierte Anzeigename) ist die einzige weitere verpflichtende Eigenschaft. N enthält den strukturierten Namen als fünf durch Semikolon getrennte Komponenten (Nachnamen; Vornamen; weitere Namen; Titel-Präfixe; Titel-Suffixe). TEL, EMAIL, ADR, URL, ORG, TITLE, PHOTO, BDAY, NOTE, UID und REV sind optional, die meisten davon wiederholbar, mit den Parametern TYPE (work, home) und PREF, um sie zu unterscheiden und zu ordnen. Der Zeichensatz ist UTF-8 und kann nicht überschrieben werden; ein Komma, Semikolon oder Backslash in einem Wert wird mit einem Backslash maskiert; Inhaltszeilen sollten bei 75 Oktetten gefaltet werden, indem CRLF plus ein Leerzeichen eingefügt wird. RFC 7095 definiert jCard, dasselbe Datenmodell in Form einer JSON-Array-Struktur.

Warum es wichtig ist

vCards wandern durch QR-Codes, E-Mail-Signaturen, CardDAV-Synchronisation und CRM-Importe. Die meisten Fehlschläge liegen auf Formatebene: ein fehlendes FN, ein nicht maskiertes Komma in einem Firmennamen, das den Wert aufteilt, Version-3.0-Syntax gemischt mit 4.0-Parametern, oder ein als mehrere Megabyte grosses Base64 eingebettetes Foto, das in keinen QR-Code passt.

So wird es angewendet

• Mindestens VERSION:4.0, FN und N ausgeben; N aus strukturierten Feldern aufbauen, statt einen Anzeigenamen an Leerzeichen zu splitten, was bei vielen Namenskonventionen scheitert.
• TEL als tel:-URI in internationaler Form schreiben (TEL;TYPE=work;VALUE=uri:tel:+41…), EMAIL mit einem TYPE, und ADR mit ihren sieben Komponenten in Reihenfolge (Postfach; Adresszusatz; Strasse; Ort; Region; Postleitzahl; Land), wobei leere Komponenten als leere Zeichenketten zwischen den Semikolons stehen.
• UID (eine stabile URN oder URL pro Kontakt) und REV (ein Zeitstempel) setzen, damit synchronisierende Clients aktualisieren statt zu duplizieren.
• Fotos in für QR-Codes gedachten Karten per URL referenzieren; sie nur in direkt ausgetauschten Dateien einbetten.
• Durch Import in zwei verschiedene Kontakt-Anwendungen validieren; Fehler bei Maskierung und Faltung zeigen sich als abgeschnittene oder zusammengeführte Felder.

Stolpersteine

Anzunehmen, dass jeder Importer 4.0 spricht: Viele erwarten noch 3.0-Konventionen, also bei weitverbreitet unterstützten Eigenschaften und Parameterschreibweisen bleiben. Zeilenenden, die ein Texteditor zu LF konvertiert. Feste westliche Namensreihenfolge in FN bei Namen, die dieser nicht folgen. Kontakte mit der vCard als massgeblicher Quelle statt mit strukturierten Feldern speichern, aus denen sie erzeugt wird.