Veritas Enterprise Vault™ Setting up Domino Server Archiving

About the general format of ruleset files for custom filtering

This section describes the required overall format of the XML ruleset files.

All ruleset files must be located in the Custom Filter Rules folder, in the main Enterprise Vault folder (for example C:\Program Files (x86)\Enterprise Vault) on the computer hosting the archiving tasks that are enabled for custom filtering.

Ruleset files have the following general format:

<?xml version="1.0"?>
<RULE_SET xmlns="x-schema:ruleset schema.xdr">

 <RULE [NAME="rule_name"] [ACTION="match_action"]
   [CONTENTCATEGORY="content_category"]
   [RETENTION="retention_category"]
   [ARCHIVEID="archiveid"]>

     <message_attribute [attribute_value_operators]>
       <attribute_value>
       [<attribute_value>]
     </message_attribute>

     [<message_attribute>... </message_attribute>]
     
 </RULE>

 [<RULE> ... </RULE>]
</RULE_SET>

The ruleset can contain one or more rules. Naming a rule (NAME="rule_name") is optional. It is advisable to include it for documentation purposes and to distinguish the rule in trace output.

Each rule contains one or more message attribute filters for evaluating messages. Attachment filtering is not currently available with Domino server filtering.

Table: Message attributes for custom filtering shows the message attributes that you can use to select messages.

Matching against attribute values is case-insensitive. All message attribute filters in a rule will be applied to a message, so the order of message attribute filters in a rule is not significant. A message matches a rule when it matches all the message attribute filters contained in that rule. When a message matches a rule, the action specified by ACTION= is applied to the message.

Each rule has a message action associated with it. ACTION="match_action" defines the action to be applied to the message when it matches a rule. For example, an action could be to mark the item as evaluated but not archive it (ACTION="MARK_DO_NOT_ARCHIVE"). If the action is to archive the item, additional actions can be specified, such as assigning a specific retention category (RETENTION="retention_category") or storing the item in a particular archive (ARCHIVEID="archive_ID"). If no action is specified, it defaults to "ARCHIVE_ITEM".

The preferred way to specify how messages that match a rule are to be archived is to assign a content category. A content category is a group of settings that are to be applied to an archived item. This can include a retention category, an archive ID and a list of the additional properties that are to be indexed by Enterprise Vault. You define content categories in the file custom properties.xml.