Setting import mail project options

If you use a dedicated email address for customers to send issue reports to, you can import emails sent to that account to the Helix ALM project to track them as issues.

Helix ALM does not track bounced, automated, or mailing list generated emails as issues and deletes these emails from your dedicated account.

Helix ALM cannot determine which project an email should be imported into and cannot differentiate between personal and business email. Use a dedicated email account to ensure only emails that include issue information are imported to the project.

Issues added from email import contain the following information. The entire email is also added to the issue Email tab.

Part of email Added to Helix ALM issue
From user Found by customer
Subject Summary field
Body Description field
Attachments Attachments

1. Choose Tools > Administration > Project Options.

The Project Options dialog box opens.

2. Select Import Mail from the Issues category.

3. Select Enable importing issues via email to enable email import.

4. Select a Protocol to use to send tracked email. You can use POP, IMAP, or Exchange Online.

Exchange Online sends email via Microsoft Exchange Online. Additional configuration is required in Azure Active Directory before you can use the Exchange Online protocol with Helix ALM. See the server admin guide for information about setting up Azure Active Directory to use the Exchange Online protocol in Helix ALM.

If email tracking is configured to use the IMAP or POP protocol with an Exchange Online email address, we recommend changing it to use the Exchange Online protocol instead. Basic Authentication with the IMAP and POP protocols is deprecated with Exchange Online connections.

5. Enter the information about the email account.

6. Click Test Connection to validate the connection to the mail server. The Connection Test Results dialog box opens. If the test connection fails, you can copy and paste the text into an email or text file and send it to your system administrator for help. Click Close to close the dialog box.

7. Enter or select any additional options.

  • Time to wait for initial connection response specifies how many seconds the Helix ALM Server waits for an initial response from the email server. If a response is not received in the specified time, Helix ALM cannot import issues from the email server and reattempts the connection based on the Look for new emails value.
  • Time to wait for other connection responses specifies how many seconds the Helix ALM Server waits for connection responses from the email server after the initial connection. If a response is not received in the specified time, Helix ALM cannot import issues from the email server and reattempts the connection based on the Look for new emails value.
  • Look for new emails specifies how often to check for new emails to import. You can also choose File > Import > Perform Server Import to manually import email at any time.
  • Email an acknowledgment to the submitter automatically emails the issue submitter using the content of the selected email template.
  • Enter next sequence number in issue’s Reference field enters the next available sequence number in the issue Reference field. You can set the next available sequence number in the Issues project options. See Setting issue project options.

8. Click OK to save the changes.