The Kolab Storage Format

2.0rc7

Draft CVS

Bo Thorsen

David Faure

Joon Radley

Martin Konold

Stephan Buys

Stuart Binge

This documentation was written in SGML using the DocBook DTD. HTML and Postscript output is generated automatically and depends on the tools used.

Windows XP®, Microsoft Outlook® are registered trademarks of Microsoft Corporation Inc.

K Desktop Environment™ and KDE™ are registered trademarks of the KDE e.V.

KONSEC Konnektor™ is a trademark of KONSEC GmbH, Germany.

Toltec Connector™ is a trademark of Radley Network Technologies CC, South Africa.

All other herein mentioned trademarks belong to their respective owners. Use of a term in this document should not be regarded as affecting the validity of any trademark or service mark.

Finally, the authors of this document are not liable for any errors found as well as anything that may cause a fault. However, if that does occur, please notify the authors so corrections can be made. Furthermore, the reader must also agree to use the information in this document at his/her own risk and relinquish the authors, from any mistakes due to this document. If not, please stop reading now.

BECAUSE THE CONTENT IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY FOR THE CONTENT, TO THE EXTENT PERMITTED BY APPLICABLE LAW. THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES PROVIDE THE CONTENT "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK OF USE OF THE CONTENT IS WITH YOU. SHOULD THE CONTENT PROVE FAULTY, INACCURATE, OR OTHERWISE UNACCEPTABLE YOU ASSUME THE COST OF ALL NECESSARY REPAIR OR CORRECTION.

IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MIRROR AND/OR REDISTRIBUTE THE CONTENT AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE THE CONTENT, EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.

Revision History
  • Revision 0.0.1 | June 9th 2004
  • Revision cvs20040813 | August 13th 2004
  • Revision cvs20040903 | September 3rd 2004
    Changed tag "email" to "smtp-address"; added tag "product-id"; added tag "color-label" description.
  • Revision cvs20041007 | October 7th 2004
    Updated start-date, attachements. Removed invitation-sent. Added creator.
  • Revision 2.0rc1 | May 3rd 2005
    Added version attribute, "yearly weekday" recurrence, scheduling-id; Changed date to daynumber.
  • Revision 2.0rc2 | May 12th 2005
    Removed scheduling-id.
  • Revision 2.0rc3 | May 12th 2005
    Distribution list have their own MIME-type now.
  • Revision 2.0rc4 | July 26th 2005
    Clarifications about keywords and folder annotations.
  • Revision 2.0rc5 | November 16th 2006
    Clarifications about empty strings and changed </webpage> to </web-page>.
  • Revision 2.0rc7 | April 22th 2008
    Fixed the example for a non-standard folder type. Clarified contents of <gender> tags. Clarified that commonfield <sensitifiy> is a label in current implementations.


Table of Contents
1. Kolab Storage Format Overview
1.1. Mail structure
1.2. XML format description
1.2.1. Types Used
2. Per Folder requirements
2.1. IMAP requirements
2.2. Mail contents
3. Mail Folders
4. Common Fields
4.1. Common Fields In All Types
4.2. Common In Tasks And Events
4.2.1. Recurrence
4.2.2. Recurrence examples
4.2.3. Attendees
5. Format Of Notes
6. Format Of Contacts
7. Format Of Distribution Lists
8. Format Of Journals
9. Format Of Events
10. Format Of Tasks