Creating Mail Event

Mail Event allows you to schedule a process flow to be triggered when the specified mail arrives on the mail server.

Perform the following steps to create a mail event:

1. On the Develop tab, click Events > Mail.

2. Click Create New to view New Mail Event screen.
   
   

   Field Name	Description
   Name	Name of the new mail event.
   Description	Description of the new mail event.
   Protocol	Internet standard protocol to be used for retrieving incoming emails. The available options are POP3 and IMAP4. Based on the selected protocol, the default port number for that protocol is displayed in the Port text box.
   Incoming Mail Server	Incoming mail (SMTP) server address.
   Security Type	Protocol that provide data encryption and authentication between applications and servers in scenarios where that data is being sent across an insecure network. The available options are SSL, TLS, None. Supported TLS version is 1.2.
   Port	Port number of the incoming mail server.
   User Id	Username of the mail server.
   Password	Password of the mail server.
   Confirm Password	Password to confirm.
   Mail Search Criteria	Select any of the filter criteria: Sender E-mail, Mail Subject, Mail Content, File Attachment. You can select more than one filter criteria. Type either sender's email address, email subject, name of the attached file or email content in the Sender E-mail, Subject, File Attachment, Mail Content text boxes respectively. You can use asterisk and wild cards in the content of the email. Multiple email ids are separated by comma (,).
   Event Start Date	Date from which event will start triggering. The date must be in MM/dd/yyyy format.
   Time	Time when the event will start.
   Event End Date	Date on which event will stop triggering. The date must be in MM/dd/yyyy format.
   Time	Time when the event will stop.
   Polling Frequency	Time interval for the event to check the existence of the email. We recommended minimum Polling Frequency to be more than 60 seconds.

    

   For information about Advanced Properties, refer to Changing Advanced Properties. If in case, there are large number of emails in the mailbox meeting the search criteria then all the emails will be processed at a time. If you want to limit the number of emails to be process at a time with this event, type the appropriate value in the Mail Process Concurrency text box. Mail event will process only the specified number of emails at a time. Remaining emails will be processed at the next polling frequency. Emails are processed on First In First Out (FIFO) basis.

    

   

   
   

3. Click Save.

   If a mail event is deactivated and then activated again, it will trigger an event for an existing email. You can view the process flow by clicking View under PF column corresponding to the mail event. A mail event can trigger multiple process flows at a time. Each process flow uses a mail source. When multiple process flows use a mail source at a time, errors can occur. Therefore, it is advisable to limit the number of process flows triggered by a mail event. You can also set the number of retries and the sleep time between each retry, in case an error occurs when using a mail box. For more information, refer to Appendix A.