vCard - vCard

vCard
Dateinamenerweiterung
.vcf, .vcard
Internet-Medientyp
text/vcard
Typschlüssel vCrd
Uniform Type Identifier (UTI) public.vcard
Entwickelt von Erstellt von Versit Consortium , alle Rechte wurden 1996 auf Internet Mail Consortium übertragen , alle Rechte wurden 2004 auf CalConnect übertragen
Formattyp Elektronische Visitenkarte
Behälter für Kontaktinformationen

vCard , auch bekannt als VCF (Virtual Contact File), ist ein Dateiformatstandard für elektronische Visitenkarten . vCards können an E-Mail- Nachrichten angehängt , über Multimedia Messaging Service (MMS), im World Wide Web , Instant Messaging oder über QR-Code versendet werden . Sie können Namens- und Adressinformationen , Telefonnummern , E-Mail- Adressen, URLs , Logos , Fotos und Audioclips enthalten.

vCard wird als Datenaustauschformat in Smartphone- Kontakten, Personal Digital Assistants (PDAs), Personal Information Managers (PIMs) und Customer Relationship Management (CRMs) verwendet. Um diese Datenaustauschanwendungen zu verwirklichen, wurden andere "vCard-Varianten" verwendet und als "Variantenstandards" vorgeschlagen, jede für ihre spezifische Nische: XML- Darstellung, JSON- Darstellung oder Webseiten . vCard Plus, eine erweiterte vCard, verwendet eine benutzerdefinierte Landingpage mit allen grundlegenden Informationen zusammen mit einem Profilfoto, einem Kartenstandort und anderen Feldern. Diese kann auch als Kontaktdatei auf Smartphones gespeichert werden.

Überblick

Der Standard-Internet-Medientyp (MIME-Typ) für eine vCard hat sich mit jeder Version der Spezifikation geändert:

vCard-Informationen sind auf Webseiten üblich : Der "Freitext"-Inhalt ist für Menschen lesbar, aber nicht maschinenlesbar. Mit der Weiterentwicklung der Technologien passte sich der "Freitext" ( HTML ) an, um auch maschinenlesbar zu sein.

RDFa mit der vCard Ontology kann in HTML und verschiedenen Sprachen der XML-Familie verwendet werden, zB SVG, MathML.

Verwandte Formate

jCard, "The JSON Format for vCard" ist ein Standardvorschlag von 2014 in RFC  7095 . Dieser Vorschlag hat sich noch nicht zu einem weit verbreiteten Standard entwickelt. Der RFC 7095 verwendet keine echten JSON-Objekte, sondern verwendet Arrays von sequenzabhängigen Tag-Wert-Paaren (wie eine XML-Datei).

hCard ist ein Mikroformat, mit dem eine vCard in eine HTML-Seite eingebettet werden kann. Es verwendet CSS- Klassennamen, um jede vCard-Eigenschaft zu identifizieren. Normales HTML-Markup und CSS-Styling können neben den hCard-Klassennamen verwendet werden, ohne die Fähigkeit der Webseite, von einem hCard-Parser geparst zu werden, zu beeinträchtigen. h-card ist das microformats2-Update für hCard.

Eigenschaften

vCard definiert die folgenden Eigenschaftstypen.

Alle vCards beginnen mit BEGIN:VCARDund enden mit END:VCARD. Alle vCards müssen die VERSIONEigenschaft enthalten , die die vCard-Version angibt. VERSIONmuss unmittelbar nach kommen BEGIN, außer im vCard 2.1-Standard, der es erlaubt, sich überall in der vCard zu befinden. Ansonsten können Eigenschaften in beliebiger Reihenfolge definiert werden.

Name Immobilienpräsenz Beschreibung Beispiel
v. 2.1 v. 3.0 v. 4.0
ADR Optional Optional Optional Eine strukturierte Darstellung der physischen Lieferadresse für das vCard-Objekt. ADR;TYPE=home:;;123 Main St.;Springfield;IL;12345;USA
AGENT Optional Optional Nicht definiert Informationen über eine andere Person, die im Namen des vCard-Objekts handelt. Typischerweise wäre dies ein Bereichsadministrator, Assistent oder Sekretär für die Person. Kann entweder eine URL oder eine eingebettete vCard sein. AGENT:http://mi6.gov.uk/007
ANNIVERSARY Nicht definiert Nicht definiert Optional Definiert den Jahrestag der Person. ANNIVERSARY:19901021
BDAY Optional Optional Optional Geburtsdatum der mit der vCard verknüpften Person. BDAY:19700310
BEGIN Erforderlich Erforderlich Erforderlich Alle vCards müssen mit dieser Eigenschaft beginnen. BEGIN:VCARD
CALADRURI Nicht definiert Nicht definiert Optional Eine URL zum Senden einer Terminanfrage an den Kalender der Person. CALADRURI:http://example.com/calendar/jdoe
CALURI Nicht definiert Nicht definiert Optional Eine URL zum Kalender der Person. CALURI:http://example.com/calendar/jdoe
CATEGORIES Optional Optional Optional Eine Liste von "Tags", die verwendet werden können, um das von dieser vCard repräsentierte Objekt zu beschreiben. CATEGORIES:swimmer,biker
CLASS Nicht definiert Optional Nicht definiert Beschreibt die Sensibilität der Informationen in der vCard. CLASS:public
CLIENTPIDMAP Nicht definiert Nicht definiert Optional Wird zum Synchronisieren verschiedener Revisionen derselben vCard verwendet. CLIENTPIDMAP:1;urn:uuid:3df403f4-5924-4bb7-b077-3c711d9eb34b
EMAIL Optional Optional Optional Die Adresse für die E-Mail-Kommunikation mit dem vCard-Objekt. EMAIL:johndoe@hotmail.com
END Erforderlich Erforderlich Erforderlich Alle vCards müssen mit dieser Eigenschaft enden. END:VCARD
FBURL Nicht definiert Nicht definiert Optional Definiert eine URL, die anzeigt, wann die Person in ihrem Kalender "frei" oder "beschäftigt" ist. FBURL:http://example.com/fb/jdoe
FN Optional Erforderlich Erforderlich Die formatierte Namenszeichenfolge, die dem vCard-Objekt zugeordnet ist. FN:Dr. John Doe
GENDER Nicht definiert Nicht definiert Optional Definiert das Geschlecht der Person. GENDER:F
GEO Optional Optional Optional Gibt einen Breiten- und Längengrad an. 2.1 , 3.0 : GEO:39.95;-75.1667
4.0 :GEO:geo:39.95,-75.1667
IMPP Nicht definiert Vielleicht Optional Definiert ein Instant Messenger-Handle.

Diese Eigenschaft wurde in einem separaten RFC eingeführt, als die neueste vCard-Version 3.0 war. Daher können 3.0 vCards diese Eigenschaft verwenden, ohne sie anderweitig zu deklarieren.

IMPP:aim:johndoe@aol.com
KEY Optional Optional Optional Der öffentliche Verschlüsselungsschlüssel, der dem vCard-Objekt zugeordnet ist. Er kann auf eine externe URL verweisen, ein einfacher Text sein oder als Base64- codierter Textblock in die vCard eingebettet sein . 2.1 : KEY;PGP:http://example.com/key.pgp
2.1 : KEY;PGP;ENCODING=BASE64:[base64-data]
3.0 : KEY;TYPE=PGP:http://example.com/key.pgp
3.0 : KEY;TYPE=PGP;ENCODING=b:[base64-data]
4.0 : KEY;MEDIATYPE=application/pgp-keys:http://example.com/key.pgp
4.0 :KEY:data:application/pgp-keys;base64,[base64-data]
KIND Nicht definiert Nicht definiert Optional Definiert die Art der Entität, die diese vCard repräsentiert: 'Anwendung', 'Individuum', 'Gruppe', 'Standort' oder 'Organisation'; 'x-*'-Werte können für experimentelle Zwecke verwendet werden. KIND:individual
LABEL Optional Optional Eingebaut ohne Stellt den tatsächlichen Text dar, der auf dem Versandetikett angebracht werden sollte, wenn ein physisches Paket an die Person/das Objekt geliefert wird, das/das mit der vCard verknüpft ist (in Bezug auf die ADRImmobilie).

Wird in Version 4.0 nicht unterstützt. Stattdessen werden diese Informationen im LABELParameter der ADREigenschaft gespeichert . Beispiel:ADR;TYPE=home;LABEL="123 Main St\nNew York, NY 12345":;;123 Main St;New York;NY;12345;USA

LABEL;TYPE=HOME:123 Main St.\nSpringfield, IL 12345\nUSA
LANG Nicht definiert Nicht definiert Optional Definiert eine Sprache, die die Person spricht. LANG:fr-CA
LOGO Optional Optional Optional Ein Bild oder eine Grafik des Logos der Organisation, die mit der Person verknüpft ist, der die vCard gehört. Es kann auf eine externe URL verweisen oder als Base64- codierter Textblock in die vCard eingebettet sein . 2.1 : LOGO;PNG:http://example.com/logo.png
2.1 : LOGO;PNG;ENCODING=BASE64:[base64-data]
3.0 : LOGO;TYPE=PNG:http://example.com/logo.png
3.0 : LOGO;TYPE=PNG;ENCODING=b:[base64-data]
4.0 : LOGO;MEDIATYPE=image/png:http://example.com/logo.png
4.0 :LOGO:data:image/png;base64,[base64-data]
MAILER Optional Optional Nicht definiert Art des verwendeten E-Mail-Programms. MAILER:Thunderbird
MEMBER Nicht definiert Nicht definiert Optional Definiert ein Mitglied, das Teil der Gruppe ist, die diese vCard repräsentiert. Zulässige Werte sind:
  • eine "mailto:"-URL mit einer E-Mail-Adresse
  • eine UID, die auf die eigene vCard des Mitglieds verweist
Die KINDEigenschaft muss auf "group" gesetzt sein, um diese Eigenschaft zu verwenden.
MEMBER:urn:uuid:03a0e51f-d1aa-4385-8a53-e29025acd8af
N Erforderlich Erforderlich Optional Eine strukturierte Darstellung des Namens der Person, des Ortes oder der Sache, die mit dem vCard-Objekt verknüpft ist. N:Doe;John;;Dr;
NAME Nicht definiert Optional Nicht definiert Stellt eine Textdarstellung der SOURCEEigenschaft bereit .
NICKNAME Nicht definiert Optional Optional Ein oder mehrere beschreibende/vertraute Namen für das von dieser vCard repräsentierte Objekt. NICKNAME:Jon,Johnny
NOTE Optional Optional Optional Gibt zusätzliche Informationen oder einen Kommentar an, der der vCard zugeordnet ist. NOTE:I am proficient in Tiger-Crane Style,\nand I am more than proficient in the exquisite art of the Samurai sword.
ORG Optional Optional Optional Der Name und optional die Einheit(en) der Organisation, die mit dem vCard-Objekt verknüpft ist. Diese Eigenschaft basiert auf dem Attribut X.520 Organization Name und dem Attribut X.520 Organization Unit. ORG:Google;GMail Team;Spam Detection Squad
PHOTO Optional Optional Optional Ein Bild oder Foto der Person, die mit der vCard verknüpft ist. Es kann auf eine externe URL verweisen oder als Base64- codierter Textblock in die vCard eingebettet sein . 2.1 : PHOTO;JPEG:http://example.com/photo.jpg
2.1 : PHOTO;JPEG;ENCODING=BASE64:[base64-data]
3.0 : PHOTO;TYPE=JPEG;VALUE=URI:http://example.com/photo.jpg
3.0 : PHOTO;TYPE=JPEG;ENCODING=b:[base64-data]
4.0 : PHOTO;MEDIATYPE=image/jpeg:http://example.com/photo.jpg
4.0 :PHOTO:data:image/jpeg;base64,[base64-data]
PRODID Nicht definiert Optional Optional Der Bezeichner für das Produkt, das das vCard-Objekt erstellt hat. PRODID:-//ONLINE DIRECTORY//NONSGML Version 1//EN
PROFILE Optional Optional Nicht definiert Gibt an, dass die vCard eine vCard ist. PROFILE:VCARD
RELATED Nicht definiert Nicht definiert Optional Eine andere Entität, mit der die Person verwandt ist. Zulässige Werte sind:
  • eine "mailto:"-URL mit einer E-Mail-Adresse
  • eine UID, die auf die eigene vCard der Person verweist
RELATED;TYPE=friend:urn:uuid:03a0e51f-d1aa-4385-8a53-e29025acd8af
REV Optional Optional Optional Ein Zeitstempel für die letzte Aktualisierung der vCard. REV:20121201T134211Z
ROLE Optional Optional Optional Die Rolle, der Beruf oder die Geschäftskategorie des vCard-Objekts innerhalb einer Organisation. ROLE:Executive
SORT-STRING Nicht definiert Optional Eingebaut ohne Definiert eine Zeichenfolge, die verwendet werden soll, wenn eine Anwendung diese vCard in irgendeiner Weise sortiert.

Wird in Version 4.0 nicht unterstützt. Stattdessen werden diese Informationen in den SORT-ASParametern der Nund/oder ORGEigenschaften gespeichert .

SORT-STRING:Doe
SOUND Optional Optional Optional Wenn diese Eigenschaft nicht mit anderen Eigenschaften gruppiert ist, gibt sie standardmäßig die Aussprache der FNEigenschaft des vCard-Objekts an. Es kann auf eine externe URL verweisen oder als Base64- codierter Textblock in die vCard eingebettet sein . 2.1 : SOUND;OGG:http://example.com/sound.ogg
2.1 : SOUND;OGG;ENCODING=BASE64:[base64-data]
3.0 : SOUND;TYPE=OGG:http://example.com/sound.ogg
3.0 : SOUND;TYPE=OGG;ENCODING=b:[base64-data]
4.0 : SOUND;MEDIATYPE=audio/ogg:http://example.com/sound.ogg
4.0 :SOUND:data:audio/ogg;base64,[base64-data]
SOURCE Optional Optional Optional Eine URL, die verwendet werden kann, um die neueste Version dieser vCard zu erhalten. SOURCE:http://johndoe.com/vcard.vcf
TEL Optional Optional Optional Der kanonische Nummernstring für eine Telefonnummer für die Telefonie-Kommunikation mit dem vCard-Objekt. TEL;TYPE=cell:(123) 555-5832
TITLE Optional Optional Optional Gibt die Berufsbezeichnung, funktionale Position oder Funktion der Person an, die dem vCard-Objekt innerhalb einer Organisation zugeordnet ist. TITLE:V.P. Research and Development
TZ Optional Optional Optional Die Zeitzone des vCard-Objekts. 2.1 , 3.0 : TZ:-0500
4.0 :TZ:America/New_York
UID Optional Optional Optional Gibt einen Wert an, der einen persistenten, global eindeutigen Bezeichner darstellt, der dem Objekt zugeordnet ist. UID:urn:uuid:da418720-3754-4631-a169-db89a02b831b
URL Optional Optional Optional Eine URL, die auf eine Website verweist, die die Person in irgendeiner Weise repräsentiert. URL:http://www.johndoe.com
VERSION Erforderlich Erforderlich Erforderlich Die Version der vCard-Spezifikation. In Version 4.0 muss dies direkt nach der BEGINEigenschaft kommen. VERSION:3.0
XML Nicht definiert Nicht definiert Optional Alle XML-Daten, die an die vCard angehängt sind. Dies wird verwendet, wenn die vCard in XML (xCard-Standard) kodiert wurde und das XML-Dokument Elemente enthielt, die nicht Teil des xCard-Standards sind. XML:<b>Not an xCard XML element</b>

Siehe auch

Verweise

Externe Links