Creating e-mail listener definitions

When you create an e-mail listener definition, the mail server polls the account that you specify in the e-mail listener definition for incoming e-mail messages. These e-mail messages are processed according to their content.

1. In the E-mail Listener application, click New Listener Definition.
2. Specify a value for the e-mail address.
3. Optional: Provide a description of the e-mail address.
4. Specify values for the e-mail password, the mail server, the e-mail folder on the mail server that will contain the e-mail messages, and the mail protocol used with the mail server.
   The port value is provided based on the protocol value. You can change the port value, if necessary.
5. Specify a value for the workflow process to use for the definition.
6. Specify a value for the schedule to set how often you want the server to be polled for incoming e-mail messages. The default frequency is every five minutes.
   The default values for preprocessor, object key delimiter, cron task name, and cron task instance are provided.
7. Optional: Complete the following steps:
   • To have e-mail messages deleted from the server after they are processed, select the E-mail Deleted option.
   • Specify a value for the Age Threshold field for the length of time that an e-mail message remains on the mail server before being deleted.
   • Specify a value for the age unit of measure.
   • If you configured a Java™ Messaging Service (JMS) queue to facilitate processing of e-mail messages, select the Queue Based Processing check box.
   • If necessary for your configuration, specify a value for the queue connection factory. Specify a value that represents the Java Name and Directory Interface (JNDI) name of the Java component that provides a connection to a queue.
   • If necessary for your configuration, specify a value for the processing queue. Specify a value that represents the name of the queue that is to be used to process e-mail messages for this account.
8. Save the e-mail listener definition.