Previous Topic: General GuidelinesNext Topic: <Attribvalue>


<Who>

For userattr, msgattr, and mapi commands.

<who> determines whether the e-mail recipients or the sender are tested for characteristics that match the Data Lookup criteria. They are used with <stringoperator> to test for message from specific senders or sent to specific recipients.

The following <who> formats are supported:

%recipient%

The trigger activates if the user attributes, Address Book properties, e-mail addresses, or display names for the recipients match the Data Lookup criteria. Specifically, there must be a match for any recipient, or every recipient, depending on whether the ANY or ALL operator is used.

Data lookup commands that compare strings have either a positive or negative inference. The following lookup commands use IS and IS NOT operators to demonstrate a positive or negative inference respectively:

mapi with ANY %recipient% where department IS "Sales"
mapi with ALL %recipient% where department IS NOT "Sales"

To simplify matters, you can use %recipient% without actually specifying ANY or ALL. For example, in the ‘positive’ mapi command, there is an implicit ANY before %recipient%:

mapi with %recipient% where department IS "Sales"

In the ‘negative’ mapi command, there is an implicit ALL before %recipient%:

mapi with %recipient% where department IS NOT "Sales"
any %recipient%

The trigger activates if the user attributes or Address Book properties for any of the recipients match the Data Lookup criteria. If none of the recipients have matching user attributes or Address Book properties, the trigger does not activate.

all %recipient%

The trigger activates only if the user attributes or Address Book properties of every recipient match the Data Lookup criteria. If any of the recipients have user attributes or Address Book properties that do not match the Data Lookup criteria, the trigger does not activate.

%sender%

Only the sender’s user attributes or Address Book properties can activate the trigger.

Note: These formats can all be used in conjunction with <fallguy> subexpressions.

Internal and external recipients

Internal email addresses and, by inference, external addresses are defined by the Internal E-Mails setting in the Definitions folder of the user policy. The mechanism for matching email addresses against internal address patterns is the same as that used by CA DLP to match email addresses against lists of addresses defined in the capture or control triggers of a user policy.

More information:

Message Attribute Lookup

Address Book Lookup

User Attribute Lookup