Email package updates

Review the updates in released versions of the Email package such as new and enhanced features as well as fixes and limitations. The page also lists the release dates of each version, and the compatible Control Room and Bot Agent versions.

Versions summary

The following table lists the versions of Email package released either with an Automation 360 release or as a package-only release (in descending order of release dates). Click the version link for information about updates in that package version.

Version Release date Release type Bot Agent version Control Room build
3.21.1 22 March 2024 Package-only; post Automation 360 v.32 (Sandbox) release 21.210 or later 13980 or later
3.19.2 6 December 2023 With Automation 360 v.31 (Sandbox) release 21.210 or later 13980 or later
3.18.2 6 September 2023 With Automation 360 v.30 (Sandbox) release 21.210 or later 13980 or later
3.17.6 6 June 2023 With Automation 360 v.29 (Sandbox) release 21.210 or later 13980 or later
Note:
  • To download an individual package (updated in an Automation 360 release where you want only the package), use this URL:

    https://aai-artifacts.my.automationanywhere.digital/packages/<package-file-name>-<version.number>.jar

  • For Email package, the naming convention is: bot-command-email-<version.number>.jar

    For example, bot-command-email-3.19.2.jar

For detailed steps on downloading a package and manually adding it to the Control Room, see Add packages to the Control Room.

3.21.1

  • Compatible Bot Agent version: 21.210 or later
  • Compatible Control Room version: 13980 or later
Fix
When you establish a connection with Outlook, you can now use Move action to move emails from one folder to another in the mailbox, even if there is more than one account integrated into locally installed Outlook.

Service Cloud case ID: 02109373, 02109838, 02107612, 02112311

3.19.2

  • Compatible Bot Agent version: 21.210 or later
  • Compatible Control Room version: 13980 or later
Fix
When you create a bot using the Email package, establish a connection with the Outlook client, and use Move all action, the bot moves the emails to the correct destination folder even if the folder names are similar.

Service Cloud case ID: 01973624

3.18.2

  • Compatible Bot Agent version: 21.210 or later
  • Compatible Control Room version: 13980 or later
Fixes
Create a bot to read emails that have regular and embedded attachments in the message body and perform the following steps:
  1. Use the Save attachment action and select HTML or PLAIN TEXT format in the message body.
  2. Use the dictionary variable emailNoOfAttachments to retrieve the attachment count and print it in the message box.

    When you run the bot, it will display the correct attachment count.

Service Cloud case ID: 01971661
When you use actions such as Reply or Forward and connect to an email server with authentication type as Client credentials, the email shows the Sender address correctly.

Previously, the email displayed the Sender's address as unknown.

Service Cloud case ID: 01966831
A bot no longer displays an error and an email is sent in the following scenario: When you use actions such as Send, Forward, Reply, ReplyAll and connect to the EWS server, choose OAuth 2 (Client credentials or PKCE) authentication mode, and deselect the Raise error if the attachments are missing.

Service Cloud case ID: 01955838
Send email now works for locally hosted SMTP using the email server option.

Previously, if you used port 465 for a secured SMTP server and selected Use secure connection (SSL/TLS) option as False, the bot failed and displayed an error message.

Service Cloud case ID: 01961465
Known limitation
When you connect with the EWS server and use Loop action to retrieve all the emails from the email server, and if the email subject contains the following characters, the bot fails to execute and displays an error message.
  • Control characters
    • Range: 0x00 - 0x08 (except 0x09 - Horizontal Tab) and 0x0B - 0x0C (except 0x0A - Line Feed and 0x0D - Carriage Return)
    • Hexadecimal values: 0x00-0x08, 0x0B-0x0C, 0x0E-0x1F
  • High surrogate and low surrogate pairs
    • Range: 0xD800 - 0xDFFF
    • Hexadecimal values: 0xD800 - 0xDFFF
  • Non-character code points
    • Range: 0xFDD0 - 0xFDEF, 0xFFFE - 0xFFFF
    • Hexadecimal values: 0xFDD0 - 0xFDEF, 0xFFFE - 0xFFFF
  • Restricted ranges
    • Range: 0x1FFFE - 0x1FFFF, 0x2FFFE - 0x2FFFF, 0x3FFFE - 0x3FFFF, 0x4FFFE - 0x4FFFF, 0x5FFFE - 0x5FFFF, 0x6FFFE - 0x6FFFF, 0x7FFFE - 0x7FFFF, 0x8FFFE - 0x8FFFF, 0x9FFFE - 0x9FFFF, 0xAFFFE - 0xAFFFF, 0xBFFFE - 0xBFFFF, 0xCFFFE - 0xCFFFF, 0xDFFFE - 0xDFFFF, 0xEFFFE - 0xEFFFF, 0xFFFFE - 0xFFFFF, 0x10FFFE - 0x10FFFF
    • Hexadecimal values: 0x1FFFE - 0x1FFFF, 0x2FFFE - 0x2FFFF, 0x3FFFE - 0x3FFFF, 0x4FFFE - 0x4FFFF, 0x5FFFE - 0x5FFFF, 0x6FFFE - 0x6FFFF, 0x7FFFE - 0x7FFFF, 0x8FFFE - 0x8FFFF, 0x9FFFE - 0x9FFFF, 0xAFFFE - 0xAFFFF, 0xBFFFE - 0xBFFFF, 0xCFFFE - 0xCFFFF, 0xDFFFE - 0xDFFFF, 0xEFFFE - 0xEFFFF, 0xFFFFE - 0xFFFFF, 0x10FFFE - 0x10FFFF

Service Cloud case ID: 01983181

3.17.6

  • Compatible Bot Agent version: 21.210 or later
  • Compatible Control Room version: 13980 or later
What's new
Enhanced error messages displayed during bot execution (Service Cloud case ID: 01887882)

When you create a bot using the Send email action with incorrect attachment logic, the bot execution fails and displays the following more detailed error message: Incorrect inputs are specified for the Attachment field when bot execution fails.
Email ID invalid option added to Send email action (Service Cloud case ID:01823424)

A new Raise error if the email ids are invalid option has been added to the Send email action of the Email package. If you add multiple addresses in the To address section and if any of the user email addresses are deactivated or invalid, the bot will display an appropriate error message.

Using Send action
Fixes

You can create a bot using Email package > Connect > IMAP protocol with OAuth2 PKCE flow, then use Save attachment action in a Loop with an iterator as For each mail in mailbox.

Previously, when you used Save attachment action within a loop and if emails contained attachments with a colon character (:) in the attachment name, the bot failed at the loop action with an error.

Service Cloud case ID: 01937048, 01911264, 01938122, 01943463, 01952184, 01959982, 01964181

You no longer encounter any issues when you use the Email package > Connect action with the EWS option and can perform email-related operations such as reading or sending emails.

Previously, when you used actions from the Email package, it was not working and threw a connection timeout if the proxy was configured.

Service Cloud case ID: 01940196, 01937082, 01925438
You can now use the Connect action in the Email package along with other actions (such as Reply or Forward) from the same package in a bot without any issues.

Service Cloud Case ID: 01908595