A filter action is an event that occurs when a filter criteria is met.
To create a filter action,
1. Select the filter to create an action for.
2. Select the criteria to create an action for.
3. Select the 'Add action' button to add to the actions list. This will open an action list window.
4. Select the desired action and select the OK button.
Actions are performed in a prioritized list - first to last. To move a particular action in the list to a desired position, highlight the action to move and use the up and down arrows located to the right of the actions list. The following is a description of the possible actions that can be performed when criteria is met.
Copy to badmail
A copy of the message is sent to bad mail folder. The message will still be delivered to the destination mailbox as well. To send to bad mail, and not deliver to the mailbox, create a Delete Message action to occur after the Copy to BadMail.
Copy to quarantine
Copies the message to the Quarantine folder. The quarantine folder is global area that filters can place email messages so they can be viewed or processed later by an administrator.
Delete message
Deletes the message.
Notify sender
This action will send a notification message to the sender of the message. The message filter allows system tokens to be inserted into notification message templates. When defining an action to notify a user with a message, a message template for the notification can then be specified.
The following table lists the tokens that can be used in Message Templates when constructing a notification message. Tokens are populated based on the criteria of the filter. For example, criteria for a filter that was specified to scan for viruses, only the 'All' Tokens and 'Antivirus' tokens would be available within the notification template.
|
Token
Name |
Description |
Applicable
criteria |
|
ME_ FILTERNAME |
Contains the name of the filter
that executed the call |
All |
|
ME_ ACTIONDESC |
The description of the current
action that |
All |
|
ME_MSG |
The System Filename of the message |
All |
|
ME_CON |
The System Connector associated
with the message |
All |
|
ME_IP |
The originating IP Address of the
message |
All |
|
ME_ACCOUNT |
The Account or Post office
"owning the message" |
All |
|
ME_SENDER |
The sender of the message |
All |
|
ME_ AVRESULT |
The Antivirus Scanning Agent
return value |
Antivirus Scanning |
|
ME_AVACTION |
The action performed by the
Antivirus agent when scanning |
Antivirus Scanning |
|
ME_AVAGENT |
The System name of the AV Agent
that was used to scan the message |
Antivirus Scanning |
|
ME_BADMAILSENDER |
The System BadMail Sender as
defined under the SMTP connectors properties |
All |
|
ME_MID |
A System generated MessageID
appropriate for the MessageID header |
All |
|
ME_HEADERS |
The RFC 822 headers of the
original message |
All |
|
ME_SZ |
The Size of the Original Message |
Message Size Criteria |
|
ME_SZL |
The Size Limit of the Original
Message |
Message Size Criteria |
|
ME_BFV |
The Bayesian Filtering Value
resulting from the message |
Spam Probability |
|
ME_BFT |
The Bayesian Filtering Threshold
for the message |
Spam Probability |
Notify address
This will send a notification message to a specified address.
Forward to address
This filter action forwards the email to an email address.
Execute application
Execute an application on the email. Since the MTA may execute an action concurrently, make sure that the application specified can have multiple instances running. If not, it may be required to change the MTA service to only use one thread.
Add header
Adds a header line to the email. If the header line already exists it will be replaced.
Mark as spam
This will mark the message as spam, which will send the message to a users Junk E-mail folder if the post office option for this is set.
Stop processing filters
This action stops the processing of any more filter actions.