vCard-Anwendung (Kontaktdaten)

Das vCard-Format kennen Sie vielleicht aus Microsoft Outlook oder vergleichbaren Anwendungen für E-Mail und/oder Personal Information Management. Entsprechende Dateien haben die Standardendung .vcf. Das vCard-Format ist ein standardisiertes Klartextformat zum Speichern von Adress- und Kontaktdaten. Gedacht war es zunächst vor allem für den Datenaustausch. So bieten beispielsweise viele E-Mail-Programme die Möglichkeit an, die eigenen Kontaktdaten als vcf-Datei automatisch an alle ausgehende E-Mails anzuhängen. Der Empfänger kann die vcf-Datei dann direkt in seine Adressdaten importieren. Mittlerweile erhält das Format jedoch auch mehr und mehr Bedeutung für die semantische Mikrodatenauszeichnung.

vCard-Beispiel

BEGIN:VCARD
VERSION:3.0
N:Lyse;Anna
FN:Anna Lyse
ORG:Beispiel-AG
ADR;WORK:;;Phantasiestr. 1;Nirgendwo;;D-99991
TEL;WORK;VOICE:+49 999 12345
TEL;TYPE=CELL:+49 144 234422
TEL;WORK;FAX:+49 999 54321
URL:http://de.example.com/
EMAIL;INTERNET:anna.lyse@example.com
END:VCARD

Erläuterung

Jede Zeile der Datei beschreibt ein Datenfeld. Zu Beginn steht der Name des Datenfeldes in Großbuchstaben. Getrennt durch einen Doppelpunkt, folgt der zugehörige Feldwert. Sowohl Feldnamen als auch Feldwerte können nochmals strukturell unterteilt sein. Solche Unterstrukturen werden durch Semikolonzeichen angegeben. Im obigen Beispiel etwa ist das Feld TEL;WORK;VOICE ein solcher Fall. TEL steht für „Telekommunikationsdatum“, WORK für „Büro/Geschäftlich“ und VOICE für „Festnetztelefon“. Ebenso wäre auch die Angabe TEL;HOME;VOICE möglich, nämlich für die private Festnetztelefonnummer.

Die offizielle Spezifikation und Dokumentation des vCard-Formats mit allen Kontaktfeldern finden Sie unter:

http://www.ietf.org/rfc/rfc2426
RFC (Request for Comment) 2426

Eine andere Möglichkeit, um sich mit dem vcf-Format vertraut zu machen, besteht darin, einfach Adressdatensätze aus einem E-Mail-Programm in vcf-Dateien zu exportieren. Voraussetzung ist natürlich, dass das Mailprogramm dies unterstützt. Mit einem Texteditor oder Text-Viewer können Sie anschließend die exportierte vcf-Datei ansehen.

Beispiel einer Umsetzung in HTML5-Mikrodatensyntax

Nachfolgender HTML-Ausschnitt setzt das obige VCARD-Beispiel in Mikrodaten um:

<p itemscope itemtype="http://microformats.org/profile/hcard">
<meta itemprop="n" content="Lyse, Anna">
<meta itemprop="family-name" content="Lyse">
<meta itemprop="given-name" content="Anna">
<span itemprop="fn">Anna Lyse</span><br>
<span itemprop="org">Beispiel-AG</span><br>
<span itemprop="adr" itemscope><meta itemprop="type" content="work">
<span itemprop="street-address">Phantasiestr. 1</span><br>
<span itemprop="country-name">D</span>-<span itemprop="postal-code">99991</span> 
<span class="locality">Nirgendwo</span>
</span><br>
<span itemprop="tel" itemscope>
<meta itemprop="type" content="work">
<span itemprop="voice">+49 999 12345</span> (privat)</span><br>
<span itemprop="tel" itemscope>
<span itemprop="cell">+49 144 234422</span> (mobil)</span><br>
<span itemprop="tel" itemscope>
<meta itemprop="type" content="work"><span itemprop="fax">+49 999 54321</span>
(Fax geschäftlich)</span><br>
<a itemscope="url" href="http://www.example.com/">http://www.example.com/</a><br>
<a itemscope="email" href="mailto:anna.lyse@example.com">anna.lyse@example.com</a>
</p>

Erläuterung

Das Beispiel erzeugt zum einen eine gewöhnliche, unspektakuläre HTML-Ausgabe.


Das Beispiel im Browser

Darüber hinaus erzeugt das Beispiel aber auch eine nicht sichtbare, logische Mikrodatenstruktur, welche die Kontaktdaten maschinenlesbar abbildet.



Das Beispiel aus logischer Sicht

Das gesamte Kontaktdaten-Set ist in ein p-Element eingeschlossen. Dieses Element ist folglich das Element, in dem mit itemscope das gesamte Mikrodaten-Set deklariert wird. Da es sich um ein kontrolliertes, offen standardisiertes Vokabularium handelt, wird mit itemtype die URL-Adresse angegeben, an der sich die Spezifikation des Vokabulariums befindet. Die itemtype-Angabe mit dieser URL-Adresse ist unbedingt erforderlich, damit der zugehörige Inhalt als Mikrodaten vom Typ vCard erkannt wird.

Die Adresse ist die eines sogenannten XMDP-Profils. XMDP ist eine XHTML-basierte Konvention, um kontrollierte Vokabularien maschinenlesbar zu definieren. Die im obigen Beispiel bei itemtype verlinkte XMDP-Definition, die in dieser Form auch in der HTML5-Spezifikation verwendet wird, definiert allerdings genaugenommen nicht vCard, sondern hCard. Das ist der Name der Mikroformate-Spezifikation zu vCard. Zum Verhältnis von Mikroformaten und HTML5-Mikrodaten siehe Buchabschnitt Mikrodaten und Mikroformate in den Backgrounds zu diesem Kapitel.

Innerhalb des p-Elements des obigen Beispiels wird mit span-Elementen gearbeitet, ergänzt um einzelne meta-Elemente. Die span- und meta-Elemente tragen nichts zur sichtbaren Strukturierung der Inhalte bei. Sie dienen lediglich der Definition der anderen Informationsschicht, also der Mikrodatenstruktur. Die <meta>-Tags werden für Daten verwendet, die nicht sichtbar ausgegeben werden, so etwa die Daten zur Aufschlüsselung des Namens. Sie können selbstverständlich beliebige andere HTML-Elemente verwenden, um die itemscope- und itemprop-Attribute zu notieren.

Pro itemprop-Attribut werden nur „einfache“ Eigenschaften zugewiesen. Zusammengesetzte Eigenschaften aus vCard wie TEL;WORK;VOICE werden aufgelöst in ein Element mit itemprop="tel", das zugleich wieder ein itemscope-Attribut erhält, um zu signalisieren, dass innere Elemente mit untergeordneten Eigenschaften folgen. Die type-Eigenschaft wird im obigen Beispiel in unsichtbare <meta>-Tags verbannt, könnte aber auch in sichtbaren Elementen untergebracht werden. Einige Eigenschaften kommen in der zusammengesetzten Form auch gar vor. So muss man beispielsweise wissen, dass die Anschrift durch itemprop="street-address" markiert wird, was in der zusammengesetzten VCARD-Originalzeile ADR;WORK gar nicht vorkommt.

Nachfolgende Tabelle listet die zum Redaktionszeitpunkt in der HTML5-Spezifikation explizit erwähnten vCard-Eigenschaften für itemprop-Attribute auf. Die Spalte „innerhalb von“ bedeutet, dass die betreffende Eigenschaft nur im Elementinhalt eines äußeren Elements vorkommen darf, das die genannte Eigenschaft enthält und außerdem ein itemscope-Attribut haben muss.

Eigenschaft innerhalb von Bedeutung u. mögliche Werte
fn Vollständiger Name
n Name
family-name n Familienname
given-name n Rufname
additional-name n Weiterer Name oder Namenszusatz
honorific-prefix n Titel (vor dem Namen)
honorific-suffix n Titel (nach dem Namen)
nickname Spitzname, kann auch einfach der Name sein, wie eine Person im Alltag genannt wird
photo URL-Adresse eines Foto der Person oder Organisation - Verwendung: <img src="URL" itemprop="photo">
bday Geburtstag der Person oder Organisation
adr Adresse
type adr Typ der Adresse: erlaubt sind die Werte dom (heimische Lieferadresse), intl (internationale Lieferadresse), postal (Postadresse), parcel (Paketadresse), home (Privatadresse), work (geschäftliche Adresse) und pref (bevorzugte Adresse für den Fall, dass mehrere Adressen angegeben sind)
post-office-box adr Postfach
extended-address adr Adresszusatz wie z.B. „Rückgebäude“
street-address adr Straße u. Hausnummer
locality adr Ort, Stadt
region adr Bundesland, Provinz usw.
postal-code adr Postleitzahl
country-name adr Postalisches Länderkürzel
label Zusammenhängende Lieferadresse der Person oder Organisation
type label Typ der Lieferadresse, Werte wie bei adr
value label Eigentliche zusammenhängende Lieferadresse
tel Telekommunikationsnummer
type tel Typ der Telekommunikationsnummer: erlaubt sind die Werte home (privat), msg (Nummer mit Ansage- oder Beantworter-Funktion), work (geschäftlich), voice (Festnetznummer), fax (Faxnummer), cell (Mobiltelefonnummer), video (Nummer für Videokonferenzen), pager (Pager-Nummer), bbs (Mailbox-Rufnummer), modem (Modemanschlussnummer), car (Autotelefonnummer), isdn (ISDN-Service-Rufnummer), pcs (Rufnummer für Personal Communication Services) und pref (bevorzugte Rufnummer, wenn mehrere Rufnummern angegeben sind)
value tel Die eigentliche Nummer
email E-Mail-Adresse einer Person oder Organisation
type email Typ der E-Mail: erlaubt sind die Werte internet (Internet-Mail), x400 (X400-Adresse) und pref (bevorzugte E-Mail-Adresse, wenn mehrere E-Mail-Adressen angegeben sind )
value email Die eigentliche E-Mail-Adresse
mailer Verwendete E-Mail-Software der Person oder Organisation
tz Zeitzone der Person oder Organisation: erlaubt sind Werte von -23:59 bis +23:59 gemessen an Greenwich-Zeit
geo Geographische Position der Person oder Organisation: dezimale Gradangabe zu Breite und Länge, z.B. +45.329293;-102.393921 (ca. 45 Grad Nord und 102 Grad West) oder -28.203942;+88.028938 (ca. 28 Grad Süd und 88 Grad Ost). Beide Werte müssen durch ein Semikolon getrennt werden. Entweder volle Gradzahlen angeben, oder volle 6 Nachkommastellen für Dezimalgradangaben
title Berufsbezeichnung der Person
role Funktion der Person innerhalb der Organisation
logo URL-Adresse eines Logos der Person oder Organisation - Verwendung: <img src="URL" itemprop="photo">
agent Kontaktdaten einer anderen Person, die ein Vertreter oder Stellvertreter der Person oder Organisation ist - Entweder als vollständige, untergeordnete vCard, als reiner Text oder als URL-Adresse auf Kontaktdateninformationen
org Organisation (Unternehmen, Behörde, Verein usw.)
organization-name org Name der Organisation
organization-unit org Name der Organisationseinheit
categories Charakterisierende Tags, Stichwörter, Kategorien für die Person oder Organisation
note Bemerkungen zur Person oder Organisation
rev Datum und Uhrzeit der Kontaktdatenangaben (Revisions-Zeitstempel)
sort-string Indexeintrag für die alphabetische Einsortierung der Person oder Organisation, z.B. Lyse, Anna (Example AG)
sound URL-Adresse eines identifizierenden Audio-Tracks für die Person oder Organisation - typische Verwendung: <audio preload controls> <source itemprop="sound" src="track.mp3"> <source itemprop="sound" src="track.ogg"> </audio>
url URL einer Webpräsenz der Person oder Organisation - typische Verwendung: <a href="URL" itemprop="url">…</a>
class Klassifikation der Kontaktdaten - erlaubt sind die Werte public (öffentlich), private (privat) oder confidential (vertraulich)
impp URL-Adresse einer Adresse für Instant-Messaging- oder Social-Networking-Kontakt der Person oder Organisation
type impp Typ der Instant-Messaging- oder Social-Networking-URL - erlaubte Werte sind einer von personal (persönlich) oder business, (geschäftlich), einer von home (privat), work (Büro) oder mobile (mobil), sowie optional pref (bevorzugte URL, wenn mehrere angegeben sind)
value impp Eigentliche URL-Adresse

 


Korrekturen, Hinweise und Ergänzungen
Bitte scheut euch nicht und meldet, was auf dieser Seite sachlich falsch oder irreführend ist, was ergänzt werden sollte, was fehlt usw. Dazu bitte oben aus dem Menü Seite den Eintrag Diskutieren wählen. Es ist keine Anmeldung erforderlich, um Anmerkungen zu posten. Unpassende Postings, Spam usw. werden allerdings kommentarlos entfernt.

Sofern nicht anders angegeben, steht der Inhalt dieser Seite unter Lizenz Creative Commons Attribution-ShareAlike 3.0 License