MAPI named properties filters

The <NAMEDPROP> </NAMEDPROP> message attribute enables you to select Exchange Server messages for processing depending on the value assigned to specific MAPI named properties. Named properties can be single-valued or multi-valued.

The custom properties feature is used to define the required properties, so that they are indexed by Enterprise Vault. Users can then search archived messages for those with a particular value set for the named property.

Instructions are provided on how to define named properties.

See Additional properties.

A named property filter takes the following general format:

<NAMEDPROP TAG="EV_tag_name" INCLUDES="operator_value">
  <PROP VALUE="value" />
  [<PROP VALUE="value" />]
</NAMEDPROP>

The value of the TAG attribute is the name by which Enterprise Vault knows the property. This is the TAG value set in the Custom Properties.xml file.

The operator value can be "ANY", "NONE" or "ALL".

Each <PROP> line defines a specific value for the property that custom filtering is to use when evaluating messages.

For example, a third party application adds a multi-valued, named MAPI property called "Location" to messages. This property identifies the department and location of the sender or recipient. The property is identified in the Custom Properties.xml file and given the Enterprise Vault tag name, "Loc". The following example shows a filter that would match messages that have the value "Pittsburgh" or "Finance" set for the "Location" property. Any messages that match are archived with the retention category, "Confidential".

<!--Example: Archive items that have Pittsburgh or Finance as values
 for the Location property -->
<RULE NAME="Location rule" ACTION="ARCHIVE_ITEM"
  RETENTION="Confidential">
  <NAMEDPROP TAG="Loc" INCLUDES="ANY">
	<PROP VALUE="Pittsburgh" />
	<PROP VALUE="Finance" />
  </NAMEDPROP>
</RULE>

Searches could be performed for messages that have specific values set for that named property.

Instructions are provided on how to create and implement an example custom filter that uses named MAPI properties. The example custom filter assigns a different retention category to messages of a particular message class.

See Custom properties example.

For more information on named properties, see the Microsoft article:

http://msdn.microsoft.com/library/default.asp?url=/library/en-us/mapi/html/838aafb5-13d1-4ab9-860a-2398d885b5c7.asp