Annotating Messages

	Sign In Sign-Up

Annotating Messages

Note: This document was originally written as a companion to the "AnnotateMessage" script that I built for Poco 2.1. The capability to annotate messages is now builtin to Poco itself and is documented in the Poco help files. Additional tips on using the message annotation feature can be found below. The script mentioned in the following discussion remains available (it is useful for demonstrating techniques of adding headers to messages) and the techniques for displaying the annotations remain valid (although Poco has powerful builtin features as well).

Additional Tips on Using Annotations

To display the annotation from within the mailbox index pane hold the mouse over the yellow message annotation icon.
To delete an annotation from a message open the message annotation input box and clear the annotation text by pressing the "Delete" key.
To add an annotation to a message via a script insert the "X-Poco-Annotation" header.

AnnotateMessage Script

I had a requirement to be able to annotate (add comments to) messages so I wrote a script to do this. The script is limited in only adding a single line to the message and in that you have to select the mailbox you want to save the annotated message to but it works (the original message is not deleted by the script). If this script is useful to others it can be downloaded from the registered user's area.

Once the script has been downloaded it can be assigned to a button to allow quick access to it. To display the annotations either display the full message headers or configure the message index to display the "X-Poco-Annotation:" header.

The script preserves the original header information with the exception of the "X-Poco-Annotation:" header which is used to save the annotation.

Notes:

You will have to compress your mailbox every time you add an annotation, otherwise the annotation will not appear. The need for a script command to do this has already been raised with Slaven and I believe it will be addressed in a future release.
The script does not delete the original message.