E-Mail Selection Filter

The E-Mail Selection Filter window defines a selection rule for processing e-mail messages with an E-Mail Trigger or E-Mail Processing Task.

Settings

Filter based on

Choose whether you will filter based on properties of the message (such as sender, subject, etc.) or of the message's attachments (file name, content, etc.)

Filter on property

Select the message or attachment property to search.

Message properties

• From Address. Searches the sender e-mail address (address part only; not the name)
• To Address. Searches all TO e-mail address (address part only; not the name)
• CC Address. Searches all CC e-mail address (address part only; not the name)
• To or CC Address. Searches all TO and CC e-mail addresses (address part only; not the name)
• Subject. Searches the message subject
• Message Body. Searches the message body (the message text)
• Message Header. Searches in the message header with the specified name.

Attachment properties

• File Name. Searches the names of all attachments to the message
• File Extension. Searches the file extensions of all attachments to the message. When entering the value to match, the "." at the beginning of the extension is optional (pdf and .pdf are equivalent)
• MIME Content Type. Searches the MIME content type of all attachments to the message.
• File Content. Searches the contents of all attachments.

Matching rule

Select the matching rule to apply:

• Contains. The selected property contains the specified value
• Does not contain. The selected property does not contain the specified value
• Equals. The selected property matches the specified value fully (no other text appears before or after the value)
• Does not equal. The selected property does not match the specified value fully (the value does not appear in the property, or appears with other text)
• Starts with. The selected property starts with the specified value

Value to match

Specify the text to search for. Job Variables can be used (variable tokens are expanded before matching). Matching is always case-insensitive ("This Value" will match "this value").

Use Regular Expressions

Check this option to use a Regular Expression for pattern matching. Use the Test Regular Expression button to test your Regular Expression and make sure it matches as you expect.

Examples

Select all messages that have one ore more PDF attachments: Attachment Properties/File Extension/Equals pdf

Select all messages from "[email protected]": Message Properties/From Address/Equals [email protected]