E-mail event listeners enable Process Manager to use an e-mail application to initiate workflow processes. An e-mail event listener monitors a designated e-mail account and initiates the assigned workflow process as soon as the e-mail meeting the specified conditions arrives.
To set up an e-mail event listener, you need to select the workflow to initiate when the expected e-mail arrives. You also need to specify the e-mail account and the specific data you want the event listener to listen for. The e-mail account information includes the name of your e-mail server, the type of e-mail it supports, the specific mailbox (or folder) where the e-mails will be delivered, and the username and password needed to authenticate to the server. You should be able to get this information from your IT department.
Once you have provided the e-mail settings, you can test the connection to insure the listener can communicate with the specified server.
Next you need to specify the e-mail content with the values you want the listener to listen for. You do this by specifying a flat file, which consists of text that includes the values, separated by a delimiter. This could be a variety of file types, including .TXT, .XML, .RTF, and so on.
You also need to specify an external unique system identifier. You can autogenerate the identifier, or you can select a specific column from the flat file to serve as the external unique system identifier. The external system identifier pinpoints the application that initiated the workflow and serves as a reference number to the client application. The external unique system identifier is used within all Process Manager applications to tell the database where to look for new records, what specifically to look for, and what to do with new records. It is also used to locate, identify, and track workflow instances in reports and audit histories.
Finally, you need to provide the required field mappings for the e-mail content. These mappings tell Process Manager how to use (where to place) the specific values found in the e-mail.
Note: Whenever a new workflow is initiated, the e-mail that triggered the workflow is automatically moved to a folder named Archive to prevent the listener from continually triggering new workflow instances.
You can also use the Spin box to the indicate the interval (in minutes) at which you want the listener to poll the e-mail account.