The Email Message Queue is a repository of emails generated by Approval Manager and waiting to be sent or that failed to send. Approval Manager attempts to send email in the Email Message Queue approximately every minute according to the following:
Approval Manager will attempt to send any email message in the queue with a status of "Pending".
Approval Manager will attempt to send any failed email message with an Attempt value less than 10 (each time Approval Manager attempts and fails to send a message, its Attempt value is incrimented by one).
It is important to know that some emails are sent immediately by Approval Manager, while others are sent only when the Email Message Queue is processed. Emails that are sent immediately are referred to as "On Demand Emails" and include password reset emails, new account emails, etc... Such emails do not appear in the Email Message Queue unless they fail to send. Emails that are queued are referred to as "Queued Emails" and include daily schedule emails, review status updates, etc.
Email Message Queue showing both Pending and Failed emails.
The Email Message Queue has several uses for the Administrator. Failed email messages can indicate improper configuration of the Email Settings, or other problems (outside the scope of Approval Manager) that prohibit Approval Manager from successfully sending email messages (for example, a stalled SMTP server). Furthermore, by storing failed email messages, the Administrator can resolve the underlying problem that prevented the emails from being sent and thereafter choose to resend failed messages (or delete them from the queue entirely without resending).
Email Message Queue Details
See detailed information on the Email Message Queue
Status (Display Restriction)
The status of email messages to display. One of three values may be selected:
Any - When selected, emails that have either a "Pending" or "Failed" status will be displayed in the queue.
Pending - Approval Manager is attempting to send the email, but has neither succeeded nor failed in doing so. When selected, only emails that have a status of "Pending" will be displayed in the Email Message Queue.
Failed - Approval Manager attempted to send the email, but was unable to do so. When selected, only emails that have a status of "Failed" will be displayed in the Email Message Queue.
Selecting a status will immediately refresh the page to display only those emails with the selected status.
Note: Emails that have been sent successfully are not shown in the Email Message Queue.
Filter
Restricts the display of emails in the Email Message Queue to those that match the text entered in the Filter field. Any email messages that include the filter text in their "From", "To", "Subject", or "Error" fields will be displayed.
Selection Controls
Selects messages in the email message queue according to the following:
All - All email messages in the queue will be selected. If the list of email messages spans multiple pages, selecting All will select email messages not currently displayed.
None - No email messages in the queue will be selected.
Page - All email messages on the current page will be selected.
Note: Messages may be manually selected by clicking with the mouse, using Shift-Click to select a sequential range of messages, and by using CTRL+Click to select multiple, non-sequential email messages.
Delete ( )
Deletes the selected emails from the Email Message Queue. See "Deleting queued emails" for more information.
Resend ( )
Resends the selected emails from the Email Message Queue. See "Resending queued emails" for more information.
Message Status
The current status of each email message. Email messages in the Email Message Queue can have one of the following statuses:
Pending - Approval Manager is attempting to send the email, but has neither succeeded or failed in doing so.
Failed - Approval Manager attempted to send the email, but was unable to do so.
Note: The display of email messages in the queue can be restricted by their status. See "Displaying queued emails by status" for additional details.
Last Attempt
The date and time that Approval Manager last attempted to send the email message.
Attempts
The number of times that Approval Manager has attempted to send the email message. Approval Manager will retry to send failing email messages 10 times. Approval Manager will not attempt to resend email messages that have failed 10 times unless the Administrator manually forces Approval Manager to resend the email (see "Resending queued emails" for additional details).
The To address (destination address) in the email message. This information is specific to each user and is defined in each user's user details page.
To information can also be used to filter the email messages displayed in the Email Message Queue. See "Filtering queued emails" for additional details.
Subject
The Subject line for each email message. This information is specific to the reason that the email was generation and is being sent, and is not user-configurable.
Subject information can also be used to filter the email messages displayed in the Email Message Queue. See "Filtering queued emails" for additional details.
Error
Emails that fail to send display an informative error message in the Email Message Queue. This information can be used to help the administrator diagnoses, troubleshoot, and resolve problems sending emails.
Error information can also be used to filter the email messages displayed in the Email Message Queue. See "Filtering queued emails" for additional details.
Procedures
Resending queued emails
Click Email Message Queue in the Administrator tab. The Email Message Queue page will open.
Select the emails you want to resend. Use Shift+Click to select a sequential range of emails. Use CTRL+Click to select multiple individual emails. ["Selection Controls"] can also be used for selecting email messages.
Note: You may want to filter the emails displayed in the Email Message Queue in order to more effectively select the email messages you want to resend.
Click Resend ( ). Approval Manager will attempt to resend all selected emails. Approval Manager will attempt to resend failed emails 10 times.
Deleting queued emails
Click Email Message Queue in the Administrator tab. The Email Message Queue page will open.
Select the emails you want to delete. Use Shift+Click to select a sequential range of emails. Use CTRL+Click to select multiple individual emails. ["Selection Controls"] can also be used for selecting email messages.
Note: You may want to filter the emails displayed in the Email Message Queue in order to more effectively select the email messages you want to delete. See [Filtering queued emails] for additional details.
Click Delete ( ). The selected emails will be removed from the Email Message Queue.
Displaying queued emails by status
Click Email Message Queue in the Administrator tab. The Email Message Queue page will open. By default, the Email Message Queue is set to display queued emails with any status; that is, it will show queued emails with either a status of Failed or of Pending.
Click the Status drop-down and select a status. The page will refresh to show only those emails with the selected status. A status of Failed will show only emails in the queue with a status of Failed. A status of Pending will show only emails in the queue with a status of Pending. A status of Any will show emails in the queue with either status.
Filtering queued emails
Click Email Message Queue in the Administrator tab. The Email Message Queue page will open.
Type the text you want to filter messages on in Filters field. Email messages can be filtered on failure text, From text, To text, and Subject text.
Click Go ( ). The page will refresh and only those messages that match the filter text will appear in the list.
Reviewing queued emails
Click Email Message Queue in the Administrator tab. The Email Message Queue page will open.
Select the emails you want to resend. Use Shift+Click to select a sequential range of emails. Use CTRL+Click to select multiple individual emails. ["Selection Controls"] can also be used for selecting email messages.
Note: You may want to filter the emails displayed in the Email Message Queue in order to more effectively select the email messages you want to resend.
Click Resend ( ). Approval Manager will attempt to resend all selected emails. Approval Manager will attempt to resend failed emails 10 times.
E-mail
