Actions

<< Click to Display Table of Contents >>

Navigation:  Mail Processing > Rules >

Actions

Add custom mail header*

Add a custom email header like ''XMyHeaderFieldName: my header field value".

 

Add text to mail body*

Adds a specifies text to the beginning or the end of the message body (plain-text as well as HTML).

 

Add text to the message subject*

     Adds a specified text to the beginning or the end of the message subject.

 

Change SCL value

    This action defines the spam confidence level (SCL) of the email. This value is used by Microsoft Exchange. By default a value of 5 or greater marks the email as spam.
This action does only work if you are using an Exchange Server and even then only if there is no other email server between the Exchange Server and the Exchange Server Toolbox setting the value.

If an Exchange Server recieves an email with Exchange Server specific header content it will automatically ignore and overwrite these values.

 

Decode body

Decodes the body of an encoded message.

 

Delete attachments

Deletes all attachments or attachments that fulfill a regular expression of the message.

 

Do not apply other rules

Use this action to prevent the Exchange Server Toolbox to apply other rules after this one.

 

Delete not archive mail

This action prevents the email from being backed up. - Use with caution! - using this rule may break German law.

 

Do not deliver mail

Marks the message to be not delivered. The Exchange Server will delete it.

 

Execute a file and pass the attachments as parameter.*
With this action you can call a file and pass on the directory of the saved attachments as parameter to that file. Each attachment will be saved as a temporary file which will then be passed on as a parameter to the executing file. You can directly execute VB and Powershell scripts without the need to create a custom batch files or calling other scripts.
If that file execution modifies the content of that directory you are even able to reload that changes into the email.
You can specify additional parameters that will be passed on along with the path to the email. These parameters can be user defined text or a template which will be evaluated at runtime.

For example you can extract all files from a ZIP archive attachment with the following batch file:
 
uinzip.exe %1 "%~dp1"

if NOT ERRORLEVEL 0 EXIT 1

cd %~dp1

del *.zip

if NOT ERRORLEVEL 0 EXIT 1
 

When you have two attached ZIP files, the batch-file would look like:
 

uinzip.exe %1 %2 "%~dp1"

[...]

 

Execute a file and pass the mail as parameter.*
With this action you can call a file and pass on the current email as parameter to that file. If that file execution modifies the email you are even able to reload that changes into the email. You can directly execute VB and Powershell scripts without the need to create a custom batch files or calling other scripts. You can specify additional parameters that will be passed on along with the path to the email. These parameters can be user defined text or a template which will be evaluated at runtime.

For example you can pass these additional parameters to another application to process the email.
 
       MyPDFCreatorSoftware.exe %2 %1
       FoxitReader.exe /t %1
       del %1

if NOT ERRORLEVEL 0 EXIT 1

 

Forward copy to SMTP server*

     This actions allows you to send a copy of emails directly to any SMTP server.

 

Modify recipients (SMTP)

This action can remove all recipients of the messages and/or add new recipients.
Use this action to redirect email by removing all recipients and adding the designated one.

 

Print mail
This actions prints the email.

 

Replace header field value*

Replaces an email header field including its value, e.g: "X-MakerHeader: My tag" may be replaced by "X-NewHeader: My value".

 

Replace text in header source*

Replaces any text in the email header source. Instead of working on a single header field this action acts on the whole message header. - Use with caution! - the replacement may break the email format. This does not re-encode the message.

 

Replace text in mail source*

Replaces any text in the entire email source including attachments. - Use with caution! - the replacement may break the email format. This does not re-encode the message.

 

Refuse mail

Use this action to reject email messages with a reason (error code) you can specify.

 

Save attachments to folder*

Saves all attachments or attachments that fulfill a regex from the email to specified folder.

 

Save mail to folder*

Saves the message in RFC822 compliant format as text file in the specified folder on your hard disk. These files can be viewed e.g. by MS Outlook Express, MS Outlook 2013/2016/2019 or Windows Mail.

 

Send auto reply message*
With this action you can let the Exchange Server Toolbox create an auto reply message with the text you specifed.
If an "unable to relay" error occurs, this can be due to configuration issues of the Exchange Server.

 

Send new mail

With this action you can generate and send emails, e.g. notification emails. You have to provide a 'From' and 'To' address, a subject and the content to send.

 

Skip the next X rules

This action skips the processing of the next X rules where X must be number starting with 0. If the given number is 0 all next rules are skipped.

 

Unzip all attachments

Extracts all zip attachments in the email and re-adds them as single attachments.
If an attachment with the same name exists more than once (in the email or a sub-folder inside the archive), the operation is canceled. This limitation is due to attachment name collisions in the email.
If the archive is not in the ZIP format, the file cannot be extracted and the operation is skipped.

 

Write specified text to file*

Writes user specified text to file. The text can be appended to the specified file or the file can be overwritten.

 

Zip all attachments

Compresses all attachments into a single ZIP file. You can choose to exclude ZIP attachments.

 


*Usage of variables is possible (see Template Engine for more information about each variable)