Eine vCard ist eine „elektronische Visitenkarte“, die ein Benutzer mit einem Mausklick direkt in das Adressbuch seines E-Mail-Programms oder Personal Information Manager übernehmen kann. vCards können in HTML-Seiten eingebettet, als Anhang zu einer E-Mail verschickt werden oder als QR-Code vorliegen. Mobiltelefone und PDA verwenden auch vCards, um Kontaktinformationen zu speichern und mit IrDA oder Bluetooth auszutauschen.
Geschichte und Bezeichnung Anfang der 1990er Jahre gründeten Apple, AT&T, IBM und Siemens das Versit Consortium, um gemeinsame Standards unter anderem für den Austausch persönlicher Daten (engl. personal data interchange, PDI) zu entwickeln. 1996 veröffentlichte das Versit Consortium die Spezifikation für vCard in der Version 2.1 und für vCalendar in der Version 1.0. Der Buchstabe v in vCard steht dabei nicht für „Visitenkarte“, sondern für den Herausgeber Versit.
Ende 1996 löste sich das Konsortium auf und übertrug alle Rechte an vCard an das Internet Mail Consortium (IMC).
Spezifikation Viele E-Mail-Programme können Kontaktdaten im vCard-Format importieren und exportieren, jedoch ist die Unterstützung oft fehlerhaft. Eine vCard, die mit einem bestimmten Programm erstellt wurde, kann für ein anderes Programm unlesbar sein. Umlaute können verlorengehen wenn Inhalte nicht gemäß den Spezifikationen mit den notwendigen Zeichensatz-Informationen abgespeichert werden. Eine vCard kann z. B. in der Version 2.1 die Adresse und den Namen mit unterschiedlichen Zeichensätzen speichern und muss den Zeichensatz jeweils angeben. Eine Information ohne Angabe des Zeichensatzes sollte in Version 2.1 nur ASCII-Zeichen enthalten. Ab Version 3.0 sollte, ab Version 4.0 muss die gesamte Datei in UTF-8 codiert werden.
Mehrere vCards für unterschiedliche Personen oder in unterschiedlichen Versionen für dieselbe Person können im selben Datenstrom bzw. in derselben Datei zusammengefasst werden. Die übliche Dateinamenserweiterung für vCard-Dateien ist .vcf aber auch .vcard ist gebräuchlich.
Derzeit bietet das IMC keinen offiziellen Test, mit dem die Qualität einer vCard geprüft werden kann, oder eine Liste der Produkte, die vCards (zuverlässig) unterstützen.
Internet Media Type (MIME-Typ) Der standardisierte Internet Media Type einer vCard lautet ab Version 4.0 der vCard-Spezifikation: text/vcard
Anderslautende Inhaltstypen gelten als überholt, beispielsweise: text/x-vcard text/directory;profile=vCard text/directory
In einigen SyncML-Dokumentationen in Bezug auf vCard 3.0 wurde fälschlicherweise statt text/x-vcard der MIME-Type text/vcard verwendet – und diesem Beispiel wurde in verschiedenen Implementierungen gefolgt – obwohl letzterer erst mit Version 4.0 standardisiert wurde.
Eigenschaften Nach der Referenzspezifikation RFC 6350 (August 2011) definiert vCard nachfolgende Eigenschaftstypen.
Eine vCard beginnt und endet mit den Eigenschaften BEGIN:VCARD und END:VCARD. In einer vCard muss die VERSION-Eigenschaft definiert sein. VERSION muss außerdem direkt auf BEGIN folgen (außer im vCard-2.1-Standard, wo es überall innerhalb der vCard vorkommen darf).
Die Inhalte der vCard bestehen aus einzelnen Eigenschaften und deren Attributen. Die Eigenschaften können in beliebiger Reihenfolge wie folgt definiert werden:
EIGENSCHAFT[;PARAMETER]:Attribut[;Attribut]
15px|erforderlich = unterstützt und erforderlich 15px|unterstützt = unterstützt, nicht erforderlich 15px|erforderlich = als Eigenschaft nicht länger unterstützt, da jetzt als Parameter innerhalb anderer Eigenschaft nutzbar 15px|erforderlich = Sonderfall, unterstützt
Name Version Beschreibung Beispiel 2.1 3.0 4.0 ADR 15px|zentriert|unterstützt 15px|zentriert|unterstützt 15px|zentriert|unterstützt Strukturierte Darstellung der physischen Anschrift des vCard-Objekts. ADR;TYPE=home:;;Heidestrasse 17;Koeln;;51147;Germany AGENT 15px|zentriert|unterstützt 15px|zentriert|unterstützt Informationen über eine andere Person, die im Namen des vCard-Objekts handeln soll. Typischerweise ist das ein Vertreter, Assistent oder Sekretär. Hier kann entweder ein URL oder eine eingebettete vCard angegeben werden. AGENT:http://de.wikipedia.org/wiki/007 ANNIVERSARY 15px|zentriert|unterstützt Jahrestag (gemeint ist im Allg. der Hochzeitstag) der Person. ANNIVERSARY:20140812 oder ANNIVERSARY:2014-08-12 BDAY 15px|zentriert|unterstützt 15px|zentriert|unterstützt 15px|zentriert|unterstützt Geburtsdatum der mit der vCard verbundenen Person. 2.1, 3.0: BDAY:1964-08-12 4.0: BDAY:19640812 oder BDAY:1964-08-12 BEGIN 15px|zentriert|erforderlich 15px|zentriert|erforderlich 15px|zentriert|erforderlich Jede vCard muss mit dieser Eigenschaft beginnen. BEGIN:VCARD CALADRURI 15px|zentriert|unterstützt URL für das Senden einer Terminanforderung zur Verwendung des Kalenders der Person. CALADRURI:http://example.org/kalender/emuster CALURI 15px|zentriert|unterstützt URL zum Kalender der Person. CALURI:http://example.org/kalender/emuster CATEGORIES 15px|zentriert|unterstützt 15px|zentriert|unterstützt 15px|zentriert|unterstützt Liste von Eigenschaften, die das Objekt der vCard beschreiben. CATEGORIES:swimmer,biker CLASS 15px|zentriert|unterstützt Sensibilität der in der vCard enthaltenen Daten. CLASS:public CLIENTPIDMAP 15px|zentriert|unterstützt UUID für die Synchronisation verschiedener Revisionsstände derselben vCard. CLIENTPIDMAP:1;urn:uuid:3df403f4-5924-4bb7-b077-3c711d9eb34b EMAIL 15px|zentriert|unterstützt 15px|zentriert|unterstützt 15px|zentriert|unterstützt E-Mail-Adresse zur Kommunikation mit dem vCard-Objekt. EMAIL:[email protected] END 15px|zentriert|erforderlich 15px|zentriert|erforderlich 15px|zentriert|erforderlich Jede vCard muss mit dieser Eigenschaft enden. END:VCARD FBURL 15px|zentriert|unterstützt URL, der beschreibt, ob auf dem Kalender der Person „frei“ oder „besetzt“ angezeigt wird. FBURL:http://example.org/fb/emuster FN 15px|zentriert|unterstützt 15px|zentriert|erforderlich 15px|zentriert|erforderlich Formatierte Zeichenfolge mit dem vollständigen Namen des vCard-Objekts. FN:Dr. Erika Mustermann GENDER 15px|zentriert|unterstützt Geschlecht (biologisch) und Geschlechtsidentität der Person. GENDER:FGENDER:O;intersex GEO 15px|zentriert|unterstützt 15px|zentriert|unterstützt 15px|zentriert|unterstützt Längen- und Breitengrad. 2.1, 3.0: GEO:50.858;7.0885 4.0: GEO:geo:50.858\,7.0885 IMPP 15px|zentriert|unterstützt 15px|zentriert|unterstützt Definiert ein Instant-Messenger-Handle. IMPP:aim:[email protected] KEY 15px|zentriert|unterstützt 15px|zentriert|unterstützt 15px|zentriert|unterstützt Öffentlicher Schlüssel, der dem vCard-Objekt zugeordnet ist. Es kann zu einem externen URL verwiesen werden, Klartext angegeben werden oder ein Base64-kodierter Textblock in die vCard eingebettet werden. 2.1: KEY;PGP:http://example.org/key.pgp 2.1: KEY;PGP;ENCODING=BASE64:[base64-data] 3.0: KEY;TYPE=PGP:http://example.org/key.pgp 3.0: KEY;TYPE=PGP;ENCODING=B:[base64-data] 4.0: KEY;MEDIATYPE=application/pgp-keys:http://example.org/key.pgp 4.0: KEY:data:application/pgp-keys;base64\,[base64-data] KIND 15px|zentriert|unterstützt Art des Objekts, das die vCard beschreibt: Eine Person (individual), eine Organisation (org) oder eine Gruppe (group). KIND:individual LABEL 15px|zentriert|unterstützt 15px|zentriert|unterstützt 15px|zentriert|unterstützt Stellt den eigentlichen Text dar, der auf einem physischen Adressetikett zur Adressierung an das mit der vCard verbundene Objekt vorhanden ist (ähnlich der ADR-Eigenschaft). LABEL;TYPE=HOME:Heidestrasse 17\n51147 Koeln\nDeutschland LANG 15px|zentriert|unterstützt Sprache, die die Person spricht. LANG:de-DE LOGO 15px|zentriert|unterstützt 15px|zentriert|unterstützt 15px|zentriert|unterstützt Logo der Organisation, mit der die Person in Beziehung steht, der die vCard gehört. Es kann auf einen externen URL verwiesen oder ein Base64-kodierter Textblock in die vCard eingebettet werden. 2.1: LOGO;PNG:http://example.org/logo.png 2.1: LOGO;PNG;ENCODING=BASE64:[base64-data] 3.0: LOGO;TYPE=PNG:http://example.org/logo.png 3.0: LOGO;TYPE=PNG;ENCODING=b:[base64-data] 4.0: LOGO;MEDIATYPE=image/png:http://example.org/logo.png 4.0: LOGO:data:image/png;base64,[base64-data] MAILER 15px|zentriert|unterstützt 15px|zentriert|unterstützt Art des genutzten E-Mail-Programms. MAILER:Thunderbird MEMBER 15px|zentriert|unterstützt Definiert das Objekt, das die vCard repräsentiert, als Teil einer Gruppe. Zulässige Werte sind: ein „mailto:“-URL, der eine E-Mail-Adresse enthält ein UUID, der auf die eigene vCard des Mitglieds verweist Um diese Eigenschaft verwenden zu können, muss die KIND-Eigenschaft auf „group“ gesetzt werden. MEMBER:urn:uuid:550e8400-e29b-11d4-a716-446655440000 N 15px|zentriert|erforderlich 15px|zentriert|erforderlich 15px|zentriert|unterstützt Strukturierte Darstellung von Namen der Person, Ort oder Sache, der das vCard-Objekt zugeordnet ist. (N:<Nachname>;<Vorname>;<zusätzliche Vornamen>;<Präfix>;<Suffix>) N:Mustermann;Erika;;Dr.; NAME 15px|zentriert|unterstützt Textdarstellung der SOURCE-Eigenschaft. NICKNAME 15px|zentriert|unterstützt 15px|zentriert|unterstützt Ein oder mehrere Alternativnamen für das Objekt, das von der vCard repräsentiert wird. NICKNAME:Erica,Ehrenreiche NOTE 15px|zentriert|unterstützt 15px|zentriert|unterstützt 15px|zentriert|unterstützt Zusätzliche Informationen oder Kommentar, welche mit der vCard in Verbindung stehen. NOTE:Ich bin eine fiktive Person aus Deutschland\nund ich bin bundesweit bekannt. ORG 15px|zentriert|unterstützt 15px|zentriert|unterstützt 15px|zentriert|unterstützt Name und gegebenenfalls Einheit(en) der Organisation, der das vCard-Objekt zugeordnet ist. Diese Eigenschaft basiert auf den Attributen „Organization Name“ und „Organization Unit“ des X.520-Standards. ORG:Google;GMail Team;Spam Detection Squad PHOTO 15px|zentriert|unterstützt 15px|zentriert|unterstützt 15px|zentriert|unterstützt Bild oder Fotografie der mit der vCard verbundenen Person. Es kann auf einen externen URL verwiesen oder ein Base64-kodierter Textblock in die vCard eingebettet werden. 2.1: PHOTO;JPEG:http://example.org/photo.jpg 2.1: PHOTO;JPEG;ENCODING=BASE64:[base64-data] 3.0: PHOTO;TYPE=JPEG:http://example.org/photo.jpg 3.0: PHOTO;TYPE=JPEG;ENCODING=b:[base64-data] 4.0: PHOTO;MEDIATYPE=image/jpeg:http://example.org/photo.jpg 4.0: PHOTO:data:image/jpeg;base64,[base64-data] PRODID 15px|zentriert|unterstützt 15px|zentriert|unterstützt Kennung für das Produkt, mit dem das vCard-Objekt erstellt wurde. PRODID:-//ONLINE DIRECTORY//NONSGML Version 1//DE PROFILE 15px|zentriert|unterstützt 15px|zentriert|unterstützt Legt fest, dass die vCard eine vCard ist. PROFILE:VCARD RELATED 15px|zentriert|unterstützt Andere Einheit, zu der die Person Verbindung hat. Zulässige Werte sind: ein „mailto:“-URL, der eine E-Mail-Adresse enthält