Search <book_title>...

Enterprise Vault™ Setting up Exchange Server Archiving

Last Published: 2018-03-29

Product(s): Enterprise Vault (12.3)

Message subject filters for custom filtering

The <SUBJECTS></SUBJECTS> message attribute enables you to match messages on the subject text of the message. Within a <SUBJECTS> attribute, values to match can be defined as follows:

Match any message with a subject that is exactly the same as the specified string:
```
<SUBJ MATCH="EXACT">string</SUBJ>
```
Match any message with a subject that contains the specified string:
```
<SUBJ MATCH="CONTAINS">string</SUBJ>
```
Match any message with a subject that starts with the specified string:
```
<SUBJ MATCH="STARTS">string</SUBJ>
```
Match any message with a subject that ends with the specified string:
```
<SUBJ MATCH="ENDS">string</SUBJ>
```

Matching against attribute values is case-insensitive. Wildcards cannot be used.

In the following example, messages that have a subject of exactly "Welcome New Employee" or starts with "Salary Summary for" or ends with "Message Notification" will be deleted without being archived:

<RULE NAME="Delete" ACTION="HARD_DELETE">
   <SUBJECTS>
     <SUBJ MATCH="EXACT">Welcome New Employee</SUBJ>
     <SUBJ MATCH="STARTS">Salary Summary for</SUBJ>
     <SUBJ MATCH="ENDS">Message Notification</SUBJ>
   </SUBJECTS>
</RULE>

The INCLUDES="NONE" operator can be used to match messages with a subject that does not include particular strings. For example, the following rule will match messages that do not have any of the specified values in the message subject:

<RULE ... >
   <SUBJECTS INCLUDES="NONE">
     <SUBJ MATCH="EXACT">Welcome New Employee</SUBJ>
     <SUBJ MATCH="STARTS">Salary Summary for</SUBJ>
     <SUBJ MATCH="ENDS">Message Notification</SUBJ>
   </SUBJECTS>
</RULE>