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.
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