Summing up, UID in subject

David Faure dfaure at klaralvdalens-datakonsult.se
Wed Jul 21 01:21:31 CEST 2004


On Tuesday 20 July 2004 15:25, Bernhard Reiter wrote:
> On Tuesday 20 July 2004 13:40, Martin Konold wrote:
> > Am Dienstag, 20. Juli 2004 13:04 schrieb Bernhard Reiter:
> 
> > > I also got an agreement by Martin in personal communication.
> >
> > But only provided there is a big warning in the format specification that
> > the euid in the subject is only for clients which absolutly need it. Its
> > use is discouraged!
> 
> That is not precise, the use is okay for the rare optimisation cases
> that we talked about or new ones. 
> 
> As I wrote in my summary
> I suggest adding a recommendation that a client SHOULD 
> use the desireable algorithm to try the corresponding imap uid first
> before searching the event uid in the subject.

I added this to the specification (and fixed kontact to set the subject and X-Kolab-Type).


<sect1><title>Mail structure</title>

<para>Each Kolab object (note, event, contact etc.) is stored in its own email,
in the appropriate folder for this type of object.</para>

<para>The email uses a multipart/mixed structure, with the following parts:</para>

<itemizedlist>
<listitem><para>A text body part with a fixed text telling about Kolab. Content-Type: text/plain</para></listitem>
<listitem><para>The XML describing the object. Content-Type: application/x-vnd.kolab.*</para></listitem>
<listitem><para>Other attachments, like a contact's picture or the attachments associated with e.g. a note or event.</para></listitem>
</itemizedlist>

<para>The following requirements apply to the mail headers:</para>
<itemizedlist>
<listitem><para>The subject of the mail must be set to the UID of the object. (*)</para></listitem>
<listitem><para>An additional header named X-Kolab-Type, must be set to the mimetype of the object, application/x-vnd.kolab.*</para></listitem>
</itemizedlist>

<para>(*) This can be used by some clients for searching but it is not recommended
to implement clients that way; searching on the IMAP ID is much faster when it's possible.</para>

</sect1>


-- 
David Faure -- faure at kde.org, dfaure at klaralvdalens-datakonsult.se
Qt/KDE/KOffice developer
Klarälvdalens Datakonsult AB, Platform-independent software solutions




More information about the format mailing list