martin: doc/kolab-formats/kolab2 Contacts,1.2,1.3
cvs at intevation.de
cvs at intevation.de
Sun May 30 02:33:56 CEST 2004
Author: martin
Update of /kolabrepository/doc/kolab-formats/kolab2
In directory doto:/tmp/cvs-serv3405
Modified Files:
Contacts
Log Message:
Martin K.: Fixed the example, more synonyms, explained syntax and data structures (records) incl. default semantics
Index: Contacts
===================================================================
RCS file: /kolabrepository/doc/kolab-formats/kolab2/Contacts,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -d -r1.2 -r1.3
--- Contacts 29 May 2004 22:49:41 -0000 1.2
+++ Contacts 30 May 2004 00:33:54 -0000 1.3
@@ -1,6 +1,6 @@
-This is an early _draft_ of the specification for handling contacts in a
-common format for the KDE Kolab client, the Kolab web client and the Toltec
-Kolab Connector for Outlook.
+This is a request for comments of the kcard specification for handling
+contacts in a common format for the KDE Kolab client, the Kolab web client
+and the Toltec Kolab Connector for Outlook.
The format is basically derived from an reverse engineering effort of the
Outlook data structures using Outlook Spy.
@@ -137,51 +137,73 @@
FULL_NAME, FILE_AS, EMAIL, EMAIL1, EMAIL2, ORG, TITLE, NULL
-Synonyms:
+Every client must implement the following table defining synonyms. This
+allows to stay compatible with vcard, Windows and LDAP naming schemes whenever
+reasonable.
+
full_name displayName
-given_name givenName
-family_name sn
+given_name givenName First Name
+middle_name initials
+family_name sn last_name
+birth_date bday
email mail
+email_2 email2
+email_3 email3
business_phone telephoneNumber
business_phone_2 otherTelephone
+business_fax officeFax facsimileTelephoneNumber
home_phone homePhone
home_phone2_ otherHomePhone
-mobile_phone mobile
+mobile_phone mobile Mobile
business_fax facsimileTelephoneNumber
other_fax otherFacsimileTelephoneNumber
-pager Pager
-org company
-org_unit department
+pager Pager officePager
+org company o organizationName
+org_unit department ou organizationalUnitName
office physicalDeliveryOfficeName
title Title
manager Manager
+street st homePostalAddress
+state st
+zip_code postalCode
location l
-country c
+country c co countryName
zip postalCode
url wwwHomePage
-note info
-fburl msExchFBURL
+note info comment
+fburl msExchFBURL labeledURI
+
+The following example of a kcard shows how we allow vcard-, Windows- and LDAP like attribute synonyms
+and how we user a vcard like syntax. The later shall help us to easily extend the definition in the future
+and also makes it easy to implement the functionality in the opensource client and LDAP repositories.
Example:
-Content-Type: text/directory; profile="vcard"; charset=iso-8859-15
+Content-Type: text/directory; profile="kcard"; charset=iso-8859-15
Content-ID: <id3 at erfrakon.com>
Content-Transfer-Encoding: Quoted-Printable
-begin:vcard
+begin:kcard
source:ldap://cn=Martin%20Konold,cn=erfrakon,cn=de
-name:Martin Konold
-fn: Martin Konold
-n:Konold;Martin
+displayName:Martin (K) onold
+givenName: Martin
+sn: Konold
bday;value=date:1967-10-13
o:erfrakon
title:Diplom Physiker
-title;language=de;value=text:Gesellschafter
note:Founding member
-email;internet:martin.konold at erfrakon.de
-home.tel;type=fax,voice,msg:+49 711 674009-63
-home.label:Nobelstrasse 15\n
- 70569 Stuttgart\n
- Germany
+email;entryid:Qs23445csasadd12312321das
+email;address:martin.konold at erfrakon.de
+email;dn:Martin Konold (erfrakon)
+email2:martin at konold.de
+business_phone:+49 711 674009-63
+business_phone_2:+49 711 674009-65
+other_fax:+49 711 674009-59
+home_phone:+49 7071 940353
+business_address;po_box:123456
+business_address;street:Nobelstrasse 15
+business_address;city:Stuttgart
+business_address;zip:70569
+business_address;country;Germany
key;type=X509;encoding=b:MIICajCCAdOgAwIBAgICBEUwDQYJKoZIhvcNAQEEBQ
AwdzELMAkGA1UEBhMCVVMxLDAqBgNVBAoTI05ldHNjYXBlIENvbW11bmljYXRpb25zI
ENvcnBvcmF0aW9uMRwwGgYDVQQLExNJbmZvcm1hdGlvbiBTeXN0ZW1zMRwwGgYDVQQD
@@ -195,5 +217,14 @@
w0BAQQFAAOBgQBexv7o7mi3PLXadkmNP9LcIPmx93HGp0Kgyx1jIVMyNgsemeAwBM+M
SlhMfcpbTrONwNjZYW8vJDSoi//yrZlVt9bJbs7MNYZVsyF1unsqaln4/vy6Uawfg8V
UMk1U7jt8LYpo4YULU7UZHPYVUaSgVttImOHZIKi4hlPXBOhcUQ==
-end:vcard
+end:kcard
+
+In this example the properties source and key are unknown to most clients
+and have to be preserved(ignored) whenever possible.
+
+The property email has in total four lines representing the structure of a
+kcard email address. The following email2 property shows the simple
+default behaviour in the absense of detailed specifications.
+
+The business_address is an example for a complete record.
More information about the commits
mailing list