Benutzer-Werkzeuge

Webseiten-Werkzeuge


computer:vcard

Dies ist eine alte Version des Dokuments!


Sogenannte VCards sind „digitale Visitenkarten“ und werden meist von PIMs (Personal Information Manager), wie beispielsweise Mozilla Thunderbird, verwendet, um einfach Kontaktdaten auszutauschen. In einem solchen VCF (Virtual business card file) werden alle Kontaktinformationen, wie beispielsweise Adressen, Telefonnumern und auch weitere Meta-Informationen, wie Fotos, zum einfachen Austausch gesichert. Eine solche Datei kann als Signatur in jeder E-Mail angehängt werden, sodass jeder Mail-Empfänger über alle Kontaktinformationen verfügt. Leider gibt es keine Qualitätssicherung - es ist leider durchaus möglich, dass eine erstellte VCard nicht unter allen PIMs die selben Informationen anzeigt. Ebenfalls möglich sind die Ignorierung hinterlegter Informationen.

Anwendungen

Anwendungen, die VCards unterstützen, sind beispielsweise:

  • Microsoft Outlook (nur ein Kontakt pro Datei, Spezifikation sieht auch mehrere Kontakte innerhalb einer Datei vor)
  • Microsoft Adressbuch
  • Kontact / KAddressBook
  • Novell Evolution / GNOME Evolution
  • Mozilla Thunderbird (mit Erweiterung MoreFunctionsForAddressBook)

Diese Liste erhebt nicht den Anspruch vollständig zu sein.

Aufbau und Beispiel

Eine VCard ist eine herkömmliche ASCII-Textdatei, in der die Kontakt- und Metainformationen hinterlegt werden. Jede Definition ist nach dem folgenden Schema aufgebaut:

EIGENSCHAFT[;PARAMETER]:Attribut[;Attribut]

In Klammern gesetzte Angaben sind optionale zusätzliche Angaben. Dringend benötigt werden die folgenden Angaben in einer gültigen VCard:

  • FN (Formal name,…)
  • N ()
  • Version (3.0)

Für manche Eigenschaften können mehrere Parameter gesetzt werden (z.B. TEL) - solche Mehrfachdefinitionen können entweder als Parameter- oder Werteliste vorgenommen werden:

Parameterliste: TYPE=work;TYPE=voice;TYPE=pref
Werteliste:     TYPE=work,voice,pref

Ein gültiges Beispiel ist:

BEGIN:VCARD
VERSION:3.0
FN:Lukas Localhost
N:Localhost;Lukas
ORG:Musterfirma
URL:http://localserver.loc/
EMAIL;TYPE=INTERNET:ll@localserver.loc
TEL;TYPE=voice,pref:+49 1234 56789
ADR;TYPE=intl,work,postal,parcel:;;Musterstrassee 1;Musterstadt;;12345;Germany
END:VCARD

Spezifikation

Die Spezifikation sieht die folgenden Angaben vor:

Identifikationsdefinitionen

FN

  • formal name, Anzeigename des Kontakts
  • 8bit kodiert, ein Wert
  • zwingend erforderliche Definitionen
FN:Max Mustermann

N

  • Name und Namenszusätze
  • 8bit kodiert, mehrere Werte
  • Nachname, Vorname, Zusatznamen (getrennt durch Komma), Anrede, Titel (Junior, A.C.P, etc..)
N:Localhost;Lukas;Lulu;Mr.;Jr.
N:Stevenson;John;Philip,Paul;Dr.;Jr.,M.D.,A.C.P.

NICKNAME

  • Spitzname
  • 8bit kodiert, ein Wert oder mehrere Werte
NICKNAME:Max,Maxi,Maxx

PHOTO

  • Foto des Kontakts
  • 8bit kodiert bzw. BASE64-Binärkodierung, ein Wert
  • Angabe einer URL oder kodierter Inhalt eines Bildes (Binärdatei)
  • Definition des Bildtyps mittels TYPE-Parameter (IANA-registrierter Typ, idealerweise JPEG)
PHOTO;VALUE=uri:http://localserver.loc/bla.gif
PHOTO;ENCODING=b;TYPE=JPEG://MMCaddBEU...

BDAY

  • Geburtsdatum des Kontakts
  • 8bit kodiert, ein Wert
  • Angabe idealerweise in YYYY-MM-TT
BDAY:1990-07-09

Adressdefinitionen

ADR

  • Definition von Adressen
  • Mehrfachdefinitionen zulässig
  • 8bit codiert, mehrere Werte zulässig
  • Angabe von Adresse, Stadt/Ort, Region/Provinz, PLZ, Land,…
  • Genauere Definition durch TYPE-Parameter
    • dom - Dienstbotenadresse
    • intl - Internationale Adresse
    • postal - Postadresse
    • parcel - Warenadresse
    • home private Adresse
    • work - geschäftliche Adresse
    • pref - bevorzugte Adresse

LABEL

  • Angezeigter Text des Adressefelds im PIM
  • 8bit codiert, ein Text-Wert
  • kann auch weitere Informationen (beispielsweise zu Sendungen in Abwesenheit) enthalten
LABEL;TYPE=dom,home,postal,parcel:Adressat...
\nIn Abwesenheit Postsendungen dem Nachbarn geben

Kommunikationsdefinitionen

TEL

  • Telefonnummern des Kontakts
  • 8bit kodiert, ein Wert, mehrere Defintionen möglich
  • Genauere Definitierung durch TYPE-Parameter
    • home (Privatnummer)
    • work (Geschäftliche Telefonnummer)
    • pref (Bevorzugte Telefonummer)
    • voice ()
    • fax (Telefax)
    • cell (Mobiltelefon)
    • car (Autotelefon)
    • isdn (ISDN-Telefon)
TEL;TYPE=home,pref:+461234-567890

EMAIL

  • E-Mail-Adressen des Kontakts
  • 8bit kodiert, ein Wert, mehrere Defintionen möglich
  • Genauere Definition durch TYPE-Parameter
    • internet („herkömmliche“ Internet E-Mail)
    • x400 (X400 E-Mail, eher selten)
    • pref (bevorzugte E-Mail)
EMAIL;TYPE=internet,pref:ll@localserver.loc

MAILER

  • Angabe des PIMs bei Programm-eigenen zusätzlichen Definitionen
  • 8bit kodiert, ein Wert
MAILER:LocalMail 1.337

Geografische Definitionen

TZ

  • Angabe der Zeitzone / Zeitverschiebung von UTC
  • 8bit kodiert, ein Wert
TZ:-02:00

Hier handelt es sich um eine Zeitzone, in der ein Zeitunterschied von -2 Stunden gegenüber UTC gilt

GEO

  • Geografische Lage, Angabe von Längen- und Breitengrad
  • 8bit kodiert, Angabe von zwei sechsstelligen Kommazahlen
GEO:31.403792;-173.197210

Geschäftsorganisatorische Angaben

TITLE

  • Angabe der Funktion im Unternehmen
  • 8bit kodiert, ein Wert
TITLE:Abteilungsleiter Service

ROLE

  • Angabe einer logischen Kategorisierung, beispielsweise Abteilung im Unternehmen
  • 8bit kodiert, ein Wert
Programmierung
  • Definition äquivalent zu PHOTO
  • Logo des Unternehmens

AGENT

  • Angabe einer Person/Einheit, die im Namen des Kontakts handelt/handeln kann oder Angabe eines hierarisch in Verbindung stehenden Kontakts, wie beispielsweise ein Administrator, Sekretär, Vorsitzender,…
  • 8bit kodiert, integrierte VCard oder URI-Angabe
AGENT;VALUE=uri:...
AGENT:BEGIN:VCARD\nFN:Volker Vorsitzender\nTEL:...\nEND:VCARD\n

ORG

  • Firmenenname und -beschreibung
  • 8bit kodiert, ein Wert (Firmenname) oder mehrere Werte (Firmenname, Niederlassung und Abteilung)
Mustermann Holding AG;Office Frankfurt;HR Europa

Zusätzliche Erklärungsdefinitionen

CATEGORIES

  • Kategorisierung des Kontakts zur besseren Überischt im Programm
  • 8bit kodiert, ein Wert oder mehrere Wert
CATEGORIES:Personal,HR,Frankfurt

NOTE

  • Zusätzliche Information, Kommentar
  • 8bit kodiert, ein Wert
NOTE:Telefonisch nur werktags erreichbar

PRODID

  • Angabe des Software, die die VCard erstellt hat
  • 8bit kodiert, ein Wert
PRODID:vcardexp 0.5 <vcardexp.stankowic-development.net>

REV

  • Revision der Karte, Datum-/Zeitangabe
  • 8bit kodiert, ein Wert
  • idealerweise Angabe in YYYY-MM-TT
REV:2010-12-22

SORT-STRING

  • Angabe des zu sortierenden Teils des Nachnames zur besseren Sortierung bei komplexen Namen
  • 8bit kodiert, ein Wert
FN:Marcel d'Ofie Avis
N:d'Ofie Avis;Marcel
SORT-STRING:Ofie

SOUND

  • Verknüpfte Sound-Datei, beispielsweise Aussprache des Namens
  • 8bit kodiert bzw. BASE64-Binärkodierung, ein Wert
  • Angabe einer URL oder kodierter Inhalt einer Binärdatei
  • Definition des Typs mittels TYPE-Parameter (IANA-registrierter Typ)
SOUND;TYPE=BASIC;VALUE=uri:...
SOUND;TYPE=BASIC;ENCODING=b:MIICa...

UID

  • Eindeutiger Bezeichner zur Identifizierung
  • 8bit kodiert, ein Wert
  • Genauere Bezeichnung durch TYPE-Parameter ((IANA-registrierter Typ)
UID:87987THIS789IS780A6698UNIQUE78789ID

URL

  • Angabe einer URL (Webseite)
  • 8bit kodiert, ein URI Wert
URL:http://localserver.loc/index.html

VERSION

  • Version des VCard-Standards
  • zwingend erforderliche Definition
  • 8bit kodiert, eine Angabe
VERSION:3.0

Sicherheitsdefinitionen

CLASS

  • Zugriffsklasse der VCard
  • 8bit kodiert, eine Angabe
  • IANA-registrierter Wert, beispielsweise PUBLIC (öffentlich), PRIVATE (privat), CONFIDENTIAL (vertraulich)

KEY

  • Verknüpfter Public Key oder verknüpftes Zertifikat
  • 8bit kodiert bzw. BASE64-Binärkodierung, ein Wert
KEY;ENCODING=b:MIcaCDDDdseQW...

Eigene Definitionen

Es ist möglich im „X-“-Namesraum eigene Defintionen für eigene Software vorzunehmen. Einige bekannte „Third-Party“-Definitionen sind:

X-GENDER

  • Angabe des Geschlechts
  • Wird wahrscheinlich mit VCard Standard 4.0 fest zum Definitionsstandard gehören

Instant-Messanging Definitionen

  • Für die gängigsten Messenger gibt es eigene Definitionen:
    • X-AIM
    • X-ICQ
    • X-MSN
    • X-JABBER
    • X-YAHOO
    • X-SKYPE / X-SKYPE-USERNAME

Internetverweise

computer/vcard.1293223923.txt.gz · Zuletzt geändert: 2010/12/24 21:52 von christian