Enterprise Vault™ Setting up Domino Server Archiving

Domino named property filters for custom filtering

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

In the Notes client, you can view Domino named properties on a message as shown in Figure: Viewing Domino message properties.

Figure: Viewing Domino message properties

A named property filter takes the following general format:

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

The value of the TAG attribute is the field name of the property in Domino document properties.

The INCLUDES= operator value can be "ANY", "NONE" or "ALL". You can also use the operator, ALLOWOTHERS=, to create complex filters.

See About creating complex filters using the INCLUDES and ALLOWOTHERS operators.

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, Domino named property called "Location" to messages. This property identifies the department and location of the sender or recipient. The following example rule shows a filter that matches 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="Location" INCLUDES="ANY">
    <PROP VALUE="Pittsburgh" />
    <PROP VALUE="Finance" />
  </NAMEDPROP>
</RULE>