To match message sender ("From" address) and recipient addresses ("To", "cc", "Bcc" and "Undisclosed" addresses), you can use the message attributes <AUTHOR> </AUTHOR> and <RECIPIENTS></RECIPIENTS>; in the ruleset file outline, message attributes are shown as:
<message_attribute> ...</message_attribute>
You can specify the actual addresses to match as SMTP email addresses, display names or SMTP domains using the following XML elements (these are represented by the <attribute_value> lines in the ruleset file outline):
This form can be used to specify SMTP addresses. The value specified must be the complete SMTP email address; if the value specified here is only part of an address, the message will not match. Wildcard characters cannot be used.
If the character '&' is included in an SMTP address, the character must be replaced with
&
as '&' is a special character in XML. For example, the SMTP address admin&finance@ourcompany.com should be specified in the XML file as:
admin&finance@ourcompany.com
This form can be used to specify display names. As with the SMTP address, the value must be the full display name, without wildcard characters. As display names can take many different forms, it is advisable to include a filter for the associated SMTP address.
An example display name for Domino server messages is:
<DISPN>Kevin Smith/exampleorg</DISPN>
To match all required messages, ensure that you include all possible variations for a display name. If Organizational Units are included in display names, these must also be specified. For example,
<DISPN>Kevin Smith/Sales/exampleorg</DISPN>
<DOMAIN>exampledomain.com</DOMAIN>
This form can be used to specify SMTP domains. The value specified can be the full domain or a subdomain. For example, if the following domain value is specified:
<DOMAIN>ourcompany.com</DOMAIN>
<DL>distribution list name</DL>
Use this form when you want to match messages that have been sent to any members of the specified distribution list or group. For example, if a rule contains the following line:
<DL>ALL SALES</DL>
Then messages sent to any member of the distribution list or group called ALL SALES will match, irrespective of whether the member's name is shown as the Display Name or SMTP address on the message.
The following example shows how you can specify a simple rule to archive and set the retention category "Legal" on any messages sent from anyone in the domain, ourcompany.com, with legal@ourcompany.com or the Lotus Notes user, Greg Court, in the recipient list:
<RULE ... ACTION='ARCHIVE_ITEM' RETENTION='legal'> <AUTHOR> <DOMAIN>ourcompany.com</DOMAIN> </AUTHOR> <RECIPIENTS> <EA>legal@ourcompany.com</EA> <DISPN>Greg Court/ourorg</DISPN> </RECIPIENTS> </RULE>
The attribute value operators, INCLUDES= and ALLOWOTHERS=, enable you to define complex filters.