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