You can create more complex filters by specifying several values for AUTHOR or RECIPIENTS message attributes and using the operators, INCLUDES= and ALLOWOTHERS= to define how the attribute values are to be matched. INCLUDES= can have the following values:
■ INCLUDES="NONE" means match messages that do not include the values specified for the attribute
■ INCLUDES="ANY" means match messages that include one or more of the values specified for the attribute
■ INCLUDES="ALL" means match messages that include all of the values specified for the attribute
If the INCLUDES= operator is not specified, INCLUDES="ANY" is assumed. ALLOWOTHERS= can have the following values:
■ ALLOWOTHERS="N" means match messages that include only the values specified in the filter and no others
■ ALLOWOTHERS="Y" means that matched messages can include attribute values other than those listed in the filter can be included
If the ALLOWOTHERS= operator is not specified, ALLOWOTHERS="Y" is assumed. In the following example, messages will match the rule if they have all three of the listed email addresses (INCLUDES="ALL"), and only these addresses (ALLOWOTHERS="N"), in the recipient list:
<RULE ... >
<RECIPIENTS INCLUDES="ALL" ALLOWOTHERS="N"> <EA>[email protected]</EA>
<EA>[email protected]</EA> <EA>[email protected]</EA> </RECIPIENTS>
</RULE>
In the next example, messages will match the rule if they have any of the listed email addresses (INCLUDES="ANY") but nothing else (ALLOWOTHERS="N"):
<RULE ... >
<RECIPIENTS INCLUDES="ANY" ALLOWOTHERS="N"> <EA>[email protected]</EA>
<EA>[email protected]</EA> <EA>[email protected]</EA> </RECIPIENTS>
</RULE>
In the next example, messages will match the rule if they do not include any of the listed email addresses in the recipient list (INCLUDES="NONE"). Matched messages can have other addresses in the recipient list (ALLOWOTHERS="Y"):
<RULE ... >
<RECIPIENTS INCLUDES="NONE" ALLOWOTHERS="Y"> <EA>[email protected]</EA>
<EA>[email protected]</EA> <EA>[email protected]</EA> </RECIPIENTS>
</RULE>
If you want to specify both positive and negative matches within a single rule, you can have multiple message attribute entries and use INCLUDES="NONE" or INCLUDES="ALL", as appropriate. For example:
<RULE ... > <RECIPIENTS INCLUDES="NONE"> <EA>[email protected]</EA> <EA>[email protected]</EA> </RECIPIENTS> <RECIPIENTS> INCLUDES="ALL"> <EA>[email protected]</EA> <EA>[email protected]</EA> </RECIPIENTS> </RULE>
In the above example, messages will match if they do not include
[email protected] or [email protected] in the recipient list:
<RECIPIENTS INCLUDES="NONE" ...</RECIPIENTS>
but do include both [email protected] and [email protected]
By using different combinations of INCLUDES= and ALLOWOTHERS= values, you can set fairly complex filters.
Table 6-1shows filter results for different messages when different combinations of values are set for the operators, INCLUDES= and ALLOWOTHERS=, in the following example filter:
<RULE ... ACTION="ARCHIVE_ITEM"> <RECIPIENTS INCLUDES="NONE|ANY|ALL" ALLOWOTHERS="N|Y"> <EA>[email protected]</EA> <EA>[email protected]</EA> </RECIPIENTS> </RULE>
[email protected] and [email protected] are the recipient addresses to match.
Table 6-1 Effect of using different operator value combinations
Msg 5: recipient is Colin Msg 4:
recipients are Bill & Colin Msg 3:
recipients are Ann, Bill & Colin Msg 2:
recipients are Ann & Bill Msg 1:
recipient is Ann Operator values set
match no match no match no match no match INCLUDES="NONE" + ALLOWOTHERS="Y" no match no match no match no match no match INCLUDES="NONE "+ ALLOWOTHERS="N" no match match match match match INCLUDES="ANY "+ ALLOWOTHERS="Y" no match no match no match match match INCLUDES="ANY" + ALLOWOTHERS="N" no match no match match match no match INCLUDES="ALL" + ALLOWOTHERS="Y" no match no match no match match no match INCLUDES="ALL" + ALLOWOTHERS="N"
In the table, the main column headings show the recipients in five different test messages. (For brevity, the recipients are called Ann, Bill, and Colin in the column headings.)
The first column shows different combinations of values set for the INCLUDES= and ALLOWOTHERS= operators.
"no match" means that, if the operator combination shown in the left column is set, a message sent to the recipients shown in the column heading would not satisfy the filter rule and would not be archived (that is, the rule action is not applied).
"match" means that, if the operator combination shown in the left column is set, a message sent to the recipients shown in the column heading would satisfy the filter rule and be archived.
Figure 6-2andFigure 6-3illustrate what happens in two of the scenarios in
Table 6-1.
Figure 6-3 Msg 1 with INCLUDES="ANY" and ALLOWOTHERS="Y"