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: <code>EIGENSCHAFT[;PARAMETER]:Attribut[;Attribut]</code> 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: <code> Parameterliste: TYPE=work;TYPE=voice;TYPE=pref Werteliste: TYPE=work,voice,pref </code> Ein gültiges Beispiel ist: <code> 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 </code> ======Spezifikation====== Die Spezifikation sieht die folgenden Angaben vor: =====Identifikationsdefinitionen===== ====FN==== * **formal name**, Anzeigename des Kontakts * 8bit kodiert, ein Wert * **zwingend erforderliche** Definitionen <code>FN:Max Mustermann</code> ====N==== * Name und Namenszusätze * 8bit kodiert, mehrere Werte * Nachname, Vorname, Zusatznamen (//getrennt durch Komma//), Anrede, Titel (//Junior, A.C.P, etc..//) <code> N:Localhost;Lukas;Lulu;Mr.;Jr. N:Stevenson;John;Philip,Paul;Dr.;Jr.,M.D.,A.C.P.</code> ====NICKNAME==== * Spitzname * 8bit kodiert, ein Wert oder mehrere Werte <code>NICKNAME:Max,Maxi,Maxx</code> ====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//) <code>PHOTO;VALUE=uri:http://localserver.loc/bla.gif PHOTO;ENCODING=b;TYPE=JPEG://MMCaddBEU... </code> ====BDAY==== * Geburtsdatum des Kontakts * 8bit kodiert, ein Wert * Angabe idealerweise in YYYY-MM-TT <code>BDAY:1990-07-09</code> =====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 <code>LABEL;TYPE=dom,home,postal,parcel:Adressat... \nIn Abwesenheit Postsendungen dem Nachbarn geben </code> =====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//) <code>TEL;TYPE=home,pref:+461234-567890</code> ====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//) <code>EMAIL;TYPE=internet,pref:ll@localserver.loc</code> ====MAILER==== * Angabe des PIMs bei Programm-eigenen zusätzlichen Definitionen * 8bit kodiert, ein Wert <code>MAILER:LocalMail 1.337</code> =====Geografische Definitionen===== ====TZ==== * Angabe der Zeitzone / Zeitverschiebung von UTC * 8bit kodiert, ein Wert <code>TZ:-02:00</code> <note>Hier handelt es sich um eine Zeitzone, in der ein Zeitunterschied von -2 Stunden gegenüber UTC gilt</note> ====GEO==== * Geografische Lage, Angabe von Längen- und Breitengrad * 8bit kodiert, Angabe von zwei sechsstelligen Kommazahlen <code>GEO:31.403792;-173.197210</code> =====Geschäftsorganisatorische Angaben===== ====TITLE==== * Angabe der Funktion im Unternehmen * 8bit kodiert, ein Wert <code>TITLE:Abteilungsleiter Service</code> ====ROLE==== * Angabe einer logischen Kategorisierung, beispielsweise Abteilung im Unternehmen * 8bit kodiert, ein Wert <code>Programmierung</code> ====LOGO==== * 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 <code> AGENT;VALUE=uri:... AGENT:BEGIN:VCARD\nFN:Volker Vorsitzender\nTEL:...\nEND:VCARD\n </code> ====ORG==== * Firmenenname und -beschreibung * 8bit kodiert, ein Wert (//Firmenname//) oder mehrere Werte (//Firmenname, Niederlassung und Abteilung//) <code>Mustermann Holding AG;Office Frankfurt;HR Europa</code> =====Zusätzliche Erklärungsdefinitionen===== ====CATEGORIES==== * Kategorisierung des Kontakts zur besseren Überischt im Programm * 8bit kodiert, ein Wert oder mehrere Wert <code>CATEGORIES:Personal,HR,Frankfurt</code> ====NOTE==== * Zusätzliche Information, Kommentar * 8bit kodiert, ein Wert <code>NOTE:Telefonisch nur werktags erreichbar</code> ====PRODID==== * Angabe des Software, die die VCard erstellt hat * 8bit kodiert, ein Wert <code>PRODID:vcardexp 0.5 <vcardexp.stankowic-development.net></code> ====REV==== * Revision der Karte, Datum-/Zeitangabe * 8bit kodiert, ein Wert * idealerweise Angabe in YYYY-MM-TT <code>REV:2010-12-22</code> ====SORT-STRING==== * Angabe des zu sortierenden Teils des Nachnames zur besseren Sortierung bei komplexen Namen * 8bit kodiert, ein Wert <code>FN:Marcel d'Ofie Avis N:d'Ofie Avis;Marcel SORT-STRING:Ofie</code> ====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//) <code>SOUND;TYPE=BASIC;VALUE=uri:... SOUND;TYPE=BASIC;ENCODING=b:MIICa... </code> ====UID==== * Eindeutiger Bezeichner zur Identifizierung * 8bit kodiert, ein Wert * Genauere Bezeichnung durch **TYPE**-Parameter ((//IANA-registrierter Typ//) <code>UID:87987THIS789IS780A6698UNIQUE78789ID</code> ====URL==== * Angabe einer URL (//Webseite//) * 8bit kodiert, ein URI Wert <code>URL:http://localserver.loc/index.html</code> ====VERSION==== * Version des VCard-Standards * **zwingend erforderliche Definition** * 8bit kodiert, eine Angabe <code>VERSION:3.0</code> =====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 <code>KEY;ENCODING=b:MIcaCDDDdseQW...</code> =====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====== * RFC 2426 vom September 2008 zum VCard-Standard **3.0**: http://tools.ietf.org/rfc/rfc2426.txt * Entwurf vom Dezember 2010 für den kommenden VCard-Standard **4.0**: http://tools.ietf.org/id/draft-ietf-vcarddav-vcardrev-15.txt * Thunderbird-Erweiterung "MoreFunctionsForAddressBook" https://nic-nac-project.org/~kaosmos/morecols-en.html