The NetIQ Mail Provider allows Workflow Automation to monitor specific email accounts for new messages. When a new email message arrives, the NetIQ Mail Provider sends an email event to Workflow Automation. If the email event meets defined trigger criteria, the trigger initiates a work item.
NOTE:The NetIQ Mail Provider monitors only the inbox for the specified email account. If you have message rules that move an incoming message to another folder, the NetIQ Mail Provider cannot send an event for that message.
Using the Aegis Adapter Configuration Utility, you can configure the NetIQ Mail provider to monitor email accounts on the following types of email servers:
Exchange Web Service Protocol (EWS)
Post Office Protocol version 3 (POP3)
Internet Message Access Protocol (IMAP)
NOTE:
The NetIQ Mail Provider supports Secure Socket Layer (SSL) for both EWS, POP3, and IMAP.
Ensure any application that accesses the email account, such as Microsoft Outlook, leaves a copy of incoming email messages on the server. If the application deletes email messages from the server, the NetIQ Mail Provider cannot effectively monitor for new email events.
The POP3 protocol allows only one active connection per email account. Depending on how you implement the POP3 server, additional connections might disconnect Workflow Automation from the mail server. If you want to configure another email client to connect to the email account, see your email administrator to determine the best alternative to the POP3 protocol.
Before configuring the EWS protocol, install the certificate used by the Exchange server on the Workflow Automation server in the Enterprise Trust store.
The EWS protocol supports auto discovery of Exchange Server. Clear the Email Server Host field, and then click Test Email Connection. If the Exchange server is found for the email account, the Email Server Host field will be populated with the Exchange server EWS URL.
The EWS protocol supports integrated Windows authentication. If the user ID and password is left blank, the Workflow Automation service account is going to be used as a monitored EWS account.
To monitor a POP3 or IMAP email account:
In the email account you want to monitor, ensure the account is empty or contains only emails for which you want the NetIQ Mail Provider to create events.
NOTE:When you configure the NetIQ Mail Provider to monitor an email account, the provider creates an event for each email in the account, and then sends them to Workflow Automation. If a Process Author has not created a workflow to match these events, the events do not initiate work items.
Log on to the Workflow Automation Server computer with an Administrator account.
In the program group, click Aegis > NetIQ Aegis Adapter Configuration Utility.
In the left pane, click Email Accounts.
On the Edit menu, click New Entry.
In the view pane, click Monitor an Internet email account.
Provide the appropriate information, and then click Exit.
Restart any open instances of the Configuration Console to see the changes.