MailEnable Enterprise Guide
Message Filtering / Postoffice Filtering / Filter Actions
In This Topic
    Filter Actions
    In This Topic

    A filter action is an event that occurs when a filter criteria is met. 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.

    Actions can be added to a postoffice filter by double clikcing on a filter within the filter list. Once in the criteria and actions window click on the Add Actions... button.

    The following is a description of the filter 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.

    Move message to public folder...

    Moves a message to the public folder, or a directory under the public folder. If the directory does not exist, it will be created.

    Copy message to public folder...

    Makes a copy of the inbound message and sends to the public folder, or a directory under the public folder. If the directory does not exist, it will be created.

    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


    Applicable criteria


    Contains the name of the filter that executed the call



    The description of the current action that



    The system filename of the message



    The system connector associated with the message



    The originating IP Address of the message



    The account or post office “owning the message”



    The sender of the message



    The antivirus agent return value

    Antivirus Scanning


    The action performed by the antivirus agent when scanning

    Antivirus Scanning


    The system name of the antivirus agent that was used to scan the message

    Antivirus Scanning


    The system BadMail Sender as defined under the SMTP connectors properties



    A system generated MessageID appropriate for the MessageID header



    The RFC 822 headers of the original message



    The size of the original message

    Message Size Criteria


    The size limit of the original message

    Message Size Criteria


    The Bayesian filtering value resulting from the message

    Spam Probability


    The Bayesian filtering threshold for the message

    Spam Probability

    Notify recipient

    Sends a notification email to the recipient to inform them that an action has occurred on an inbound email. For example, if a message is deleted because an attachment is an executable, this option will notify the recipient that this has happened.

    The same notification options as outlined can be used when performing the Notify Sender action (see table above).

    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 this application may be executed concurrently on inbound messages, make sure that the application specified can have multiple instances running. If not, it may be required to change the postoffice connector service to only use one thread.

    Add message 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.  See the Feature selection section for more information on this setting.

    Add Subject Prefix

    This action will add a prefix to the subject of the message. If the prefix already exists for the subject it will not be added.