Email Processing
When a user sends an email to the inbox email address, the business object record (incident, problem, knowledge, or change) is automatically created. This section describes how these emails are processed within the application.
To ensure that outgoing emails reach their recipients during system exceptions, the email object includes the following:
- Outgoing emails are stored in the Email workspace.
- The Sent status for emails is set to yes or no.
- Information appears in the Last Error field if the email was not sent successfully.
- The number of attempts made to send an email appears in the Send Attempt field.
- The capability to resend any email through a Resend quick action appears on the workspace.
- Bounced emails are captured by creating an email object of type bounced.
- A timeout validation on save rule for emails is set to a value from 100 seconds (default) up to a maximum of 1000 seconds.
These enhancements appear on the Email workspace in HEAT application as shown:
The following flowchart shows how outgoing emails are processed by the Email Listener:
To prevent incorrectly configured processed incoming emails from being deleted, the Email Listener does the following:
- Moves the processed emails to an archive email folder within the same mailbox.
- Moves failed emails to an unprocessed or error folder, which allows verification of these emails and allows them to be reprocessed.
- Creates a link between failed emails and incidents that create an incident for failed emails.
- Captures unprocessed or failed emails in the logs, with more diagnostic messaging.
To prevent overloading the email server, the text size (not including images) going through the Email Listener is limited. When the size exceeds the allowed amount, the message body is replaced with the message "The email exceeds the allowed text processing size limit." This does not apply to images or HTML emails.
The following flowcharts shows how incoming emails are processed by the Email Listener:
Incoming Email Process - Step 1
When a task is assigned to a team, the entire team receives an email. One team member can then accept the task (via email) and become the owner.
A user can send an email to update a task if:
- The requested status is accepted, AND the current status is logged or assigned, AND the sender is a member of the team of this task. The task status becomes accepted and the owner becomes the sender.
- The requested status is accepted, AND the current status is accepted. A warning appears in the log file. In the Journal Email -> Sender info, an error message The task has already been accepted is stored.
For all other cases, if the sender is the owner, the status is updated.