What filters can I apply to monitoring emails?

You can use X-headers to sort and filter emails sent by CollabNet TeamForge . Depending on the context of the message, custom email headers (X-headers) are added to the email. The custom headers can be used by email agents and clients to filter and sort email.

For example, both Outlook and Thunderbird support filtering on custom email headers.

Some ways you might filter monitoring emails include:

• Use X-TeamForge-ProjectId, X-TeamForge-Forum, and X-TeamForgeFolderId to sort email into different folders depending on the project, discussion forum, or tracker.
• Use X-TeamForge-AssignedTo to flag tasks or artifacts that are assigned to you.
• Use X-TeamForge-Artifact-Monitoring to flag artifacts that you have created, modified, commented on, or been assigned to. This is useful if you are monitoring a high-traffic tracker to identify artifacts that you have touched.

These are the available X-headers:

X-header	Example	Description
X-TeamForge-ServerName	collab.net	Hostname portion of TeamForge URL.
X-TeamForge-ProjectId	proj1006	Project ID, if applicable.
X-TeamForge-Application	Tracker	Application, if applicable. Values include Documents, Wiki, Source Code, TeamForge, Tasks, Tracker, Discussion, File Releases.
X-TeamForge-FolderId	tracker1005	If the object is a folder, the object’s ID, or the ID of the object’s container.
X-TeamForge-Type	Artifact	The type of the object, if applicable. Values include Tracker, Artifact, Document Folder, Document, Document Version, Wiki Page, Wiki Page Version, Task Folder, Task, FRS Package, FRS Release, Discussion Forum, Discussion Topic, SCM Repository, SCM Commit.
X-TeamForge-AssignedTo	admin	User assigned to artifact or task.
X-TeamForge-Status	Open	Status of artifacts, tasks, documents, and document reviews. Values include: For artifacts: Open, Closed, Pending, or user-defined. For tasks: Not Started, OK, Complete, Warning, or Alert. For documents: Draft, Review, or Final. For document reviews: Open or Closed.
X-TeamForge-Forum	New user forum	For posts, this is the forum title.
X-TeamForge-Artifact-Monitoring	true	For artifacts, true if the user is monitoring the artifact directly. If value is false, you are monitoring the folder, not the artifact.