Help files

Exchange Email Monitor Trigger

The Exchange Email Monitor Trigger periodically checks an Exchange email account and executes a Process when an email that meets the specified criteria arrives.

Exchange_Email_Monitor_Trigger_Image.png

Custom Description

Add a custom description to the trigger which will be shown in the Triggers tab under "Description".

Check Email Every

In the trigger's configuration dialog you specify how often the trigger should check for new emails. The default value is every 5 minutes.

Email Account Settings

For WinAutomation, to monitor the email messages on an email server (as also to retrieve and process them), it must be able to access the Exchange server. For more information you may check the corresponding session at the Connect To Exchange Server action.

Therefore, in order set an Exchange Email Monitor Trigger, it is necessary that you enter the Exchange Server Connection properties, consisting of:

  • the Exchange Version property, where you enter the Exchange Server Version.

  • the Connection Type, where you specify whether Autodiscover will be used, or the Exchange Server Address will be provided. If Autodiscover is used, an Email Address will have to be provided; if not, then the Exchange Server Address is required.

  • Whether the credentials to be used will be the default Exchange credentials, or user-defined; in the latter case, the Domain, Username and Password will have to be provided.

  • Whether the mailbox is personal or shared.

Check for Emails Where...

In the next group of fields, you need to specify the values of the email properties that will fire the trigger. Leaving all the fields of this group empty will cause the trigger to fire and the Process will be executed for every email that arrives into the mailbox.

In order to restrict the type emails that will fire the trigger you should enter specific values in the appropriate fields defining that you want to check:

  • all emails or only for unread (Retrieve property field)

  • for emails that end up into a specific folder (Mailbox Folder is: property field)

  • for emails coming from a specific sender (“From” Field Contains: property field)

  • for emails being addressed to a specific recipient (“To” Field Contains: property field)

  • for emails that contains specific keywords in the subject (Subject Contains: property field)

  • for emails that contains specific keywords in the body (Body Contains: property field)

Of course you may enter your preferences for more than one of the above properties and combine trigger firing criteria.

On trigger failure retry every

Optionally set a time period after which the Trigger will attempt to resume monitoring after encountering an error.

Note that the Exchange Email Monitor Trigger will only check for the specified email types and not retrieve them from the email server (where they will consequently remain marked as “unread”).

So, if in the Process that is executed by the trigger you need to process the email(s) that caused the Process to run, you should use the Retrieve Exchange Email Messages and the Process Exchange Email Messages actions.