Release Notes

Coded workflows support

• A Specified cast is not valid error occurred when the Get Outlook Mail Messages activity processed a recalled email.
• A Specified folder does not exist occurred when trying to retrieve emails from a shared mailbox using the Get Outlook Mail Messages activity.
• When you copied and pasted a Send Email activity inside a project, the HTML editor for the Body property was the same in the different instances of the activity and you could not add different content to the body of the activities.

• All Microsoft Exchange Server and IBM Notes activities are now available in Windows projects, enabling you to create new Windows projects and migrate existing Windows - Legacy projects that contain these activities to the Windows compatibility.

• Two new properties are available to enable better error management when using send email activities:
  • ContinueOnError - Specifies if the automation should continue even when the activity throws an error. This property is available for the following activities: Send Outlook Mail Message, Send SMTP Mail Message, and Send IBM Notes Mail Message.
  • StatusCode - The status code returned by the server. This property is available for the Send SMTP Mail Message activity.

• The Get IMAP Mail Messages activity failed to retrieve some email attachments from Gmail.
• The Save Attachments activity sometimes didn't identify attachments correctly, causing a Value cannot be null exception to be thrown.
• When using the Send Outlook Mail Message activity to send an email with images inside the body to SAP Shared Service Framework, the images were not displayed in the target application.

• You can now select connections from shared folders when you choose the account in Use Outlook 365 and Use Gmail activities configured to use the Integration Service.
• If the Use Desktop Outlook App activity is used in a project, this information is now included in the published package, and is then displayed in Orchestrator. This feature requires Studio 2023.4 or later.

• Mail activities didn’t retrieve attachments to Outlook emails. This issue occurred in version 1.18.1 of the Mail activities package.

• Several accessibility issues have been fixed.
• If the Send SMTP Mail Messsage activity was used to send an email with attachments, an error occurred when subsequent activities tried to access the files attached to the email. The issue only occurred in certain versions of Studio and the Mail activities package.

• The mail activities listed below have been updated with a new UseOAuth option that enables using an OAuth2 access token instead of a password. By default, this option is not selected.

  • Get IMAP Mail Messages
  • Move IMAP Mail Message
  • Send SMTP Mail Messsage
  • Get POP3 Mail Message

• IBM Notes and Exchange activities are not available in Studio projects that use .NET 5.
• Due to the change to Graph API, there may exist undocumented differences in behavior of Exchange Mail activities in Studio projects that use .NET 5.
• When using the For Each Email activity with the Use Outlook 365 activity on .NET 5 projects some filters are not supported.

• The mailMessage.Body object was coming up as empty in some cases when the Get IMAP Mail Messages activity was used.
• Get Outlook Mail Messages was not returning complete header information.

• Several accessibility issues have been fixed.

• Get Email By Id - Retrieves the email with the specified ID.

• The Use Outlook 365 and Use Gmail activities now allow you to use multiple account connections by accessing the UiPath Orchestrator through Integration Services. The Default option has been replaced by the connection name.
• The MailMessage object has been updated with two new headers (References and In-Reply-to) for the following activities:
  • Get Exchange Mail Messages
  • Get Outlook Mail Messages
  • Get IMAP Mail Messages
  • Get POP3 Mail Message
• The Use Desktop Outlook App activity has been updated with a new option in the properties panel called Account mismatch behavior. You can indicate how the activity should behave in case the specified email account cannot be matched by selecting one of the available options: UseDefaultEmailAccount and Fail.
• The For Each Email activity has been updated with a new option, Retrieve attachments. If selected, attachments are retrieved along with the email.
• The Uid and Message-ID headers are now available in the MailMessage object returned by the For Each Email activity when used inside Use Outlook 365 , Use Gmail , and Use Desktop Outlook App .
• The Save Attachments and Save Email Attachments activities have been updated with a new option, Exclude Inline Attachments. If selected, inline attachments (i.e. attachments embedded in the email body) are not saved.
• The Reply To Outlook Mail Message activity has been updated with the following new properties:
  • BCC - Additional hidden recipients of the email message.
  • CC - Additional secondary recipients of the email message.
  • To - Additional primary recipients of the email message.
  • NewSubject - The new subject of the email.
  • Importance - The importance of the email. The available options are Low, Normal, and High. The default value is Normal.
  • ReplyFrom - The email address from which the email is sent.
• The following activities have been updated with a new option, called Ignore CRL, which indicates whether the Certificate Revocation List validation should be ignored when connecting:
  • Get IMAP Mail Messages
  • Move IMAP Mail Message
  • Send SMTP Mail Message
  • Get POP3 Mail Message
• The following activities have been made compatible with cross-platform projects :
  • Get IMAP Mail Messages
  • Move IMAP Mail Message
  • Get POP3 Mail Message
  • Send SMTP Mail Message
  • Save Mail Message
  • Save Attachments
  • Create HTML Content
• The tooltip of the Save to field in the Read Range activity has been updated with additional information about pasting the data once copied to clipboard.
• The Mail Activities pack has been upgraded to use Google API version 1.55.0.
• You can now add UI Automation activities inside a Use Desktop Outlook App activity to quickly automate the interface of Outlook.
• Mail activities that have folder browsers now display the Drafts and Trash folders when used inside the Use Gmail activity.

• The Mail activities under the category are no longer available in cross-platform projects.

• IBM Notes and Exchange activities are not available in Studio projects that use .NET 5.
• Due to change to Graph API, there may exist undocumented differences in behavior of Exchange Mail activities in Studio projects that use .NET 5.

• Inline attachments were being removed and added as regular attachments when forwarding an email using the Send Exchange Mail Message activity.
• Inline attachments were not being retrieved in some cases when using the Get IMAP Mail Messages activity.
• The HTML Editor has been updated to correctly insert an image in the body of an email in .NET 5 cross-platform projects.
• Email attachments could not be retrieved from certain iPhone mail apps when the Save Attachments activity was used together with Get POP3 Mail Message and Get IMAP Mail Messages activities.
• Email attachments were not being retrieved correctly from emails sent from WinMentor platform.
• Unexpected validation errors were being generated in file path fields of mail activities used in C# projects.
• The Save Email Attachments activity was failing to filter attachments when two or more Save Email Attachments activities were used consecutively.

• Fixed a bug in the Use Gmail activity to allow entering a Client Secret with a length of 35 characters.
• An issue has been fixed that caused Save Mail Message activity to fail when the resulted file is in the project’s root folder.
• An issue has been fixed that caused Save Mail Message activity to fail when used in a .NET 5 Windows project.

• Starting with Studio v2021.10, the design experience that was previously available only in StudioX is also available in the Studio profile:

  • The are now available by default in the Activities panel under Integrations > Gmail and Outlook.
  • When you configure mail activities inside the Use Outlook 365, Use Gmail, or Use Desktop Outlook App scope activities, you can now browse the accounts and select data that matches the type of a property directly from the Plus menu of each property, without having to manually enter expressions. You can indicate Outlook folders, Gmail labels, the email selected in the Outlook desktop app when the project is executed, the current mail in an iteration, or message fields such as Subject, Body, Body as HTML, Bcc, Cc, To, From, Date (as text), and Priority.

• You can now easily authenticate to Outlook 365 and Gmail by using connections from the new Integration service in UiPath Automation Cloud.

  When the Integration service is enabled in your tenant, the Use Outlook 365 and Use Gmail activities enable you to quickly authenticate by creating a connection or selecting an existing connection from the service. To enable the use of the Integration service for managing the connection, select the Use Connections option in the Properties panel of the activities. If you select the global setting Default to managed connections in the Studio settings, the Use Connections option is selected by default in all the activities that support it. The global setting is selected by default if the Integration service is available in the Orchestrator tenant that Studio is connected to.

• Organizations can now use Robot governance policies deployed from Automation Ops to specify email addresses where automations are not allowed to send emails at runtime. The new Robot policy available in Automation Ops starting with Robot v2021.10 includes the Email Blocklist Runtime Analyzer rule that enables you to define email addresses or domains that Mail activities which can send emails are prohibited from using as recipients. The rule supports the use of regular expressions for defining patterns for email addresses to block.

• Outlook Mail Messages Trigger - Sets up a trigger to watch for incoming/outgoing mail messages that match a certain criteria.

• This activities package now supports .NET 5 projects. For more information about setting the project compatibility, see About Automation Projects.
• Desktop Outlook activities can now run in Picture in Picture mode while Microsoft Outlook is open when using UiPath Robot version 2021.10 or higher.

• The For Each Email activity has been updated with a new option:

  • Include subfolders - Select this option if you want to expand the iteration to include all subfolders of the selected mail folder. This option is not selected by default.

• IBM Notes and Exchange activities are not available in Studio projects that use .NET 5.
• Due to change to the Graph API, there may exist undocumented differences in behavior of Exchange Mail activities in Studio projects that use .NET 5.

• Emails sent using the Send Email activity added inside the Use Outlook 365) or Send Exchange Mail Message activities now appear as expected in the Sent Items share mailbox folder.
• Fixed an issue that caused the Exchange Mail activities to prompt the user for credentials each time the activity ran when used with Office 365 Interactive authentication.
• An update was made to make the Save Outlook Mail messages activity visible again in Studio.
• An issue has been fixed where mail date filters didn't work correctly when the Windows regional settings were set to English (India).
• The Send Outlook Mail Message activity has been updated to correctly handle inline attachments when the email message is forwarded.
• Fixed an issue that prevented several Mail activities to move, archive and delete messages when used with a shared mailbox.
• An issue has been fixed that sometimes caused the Send SMTP Email Message activity to throw an SMTP authentication error.

• Save Outlook Mail Message - Saves an Outlook mail message to the specified folder.

  Please note that this was incorrectly included in the 1.10.4 release notes.

• Delete Outlook Mail Message - Deletes an Outlook mail message.
• Mark Outlook Mail As Read/Unread - Marks the specified mail message as read or unread.
• Set Outlook Mail Categories - Assigns categories to a specified mail message.

• The Get Outlook Mail Messages activity has received the following updates:

  • The ability to filter by mail message IDs.
  • The ability to order mail messages by date.
  • The activity now retrieves Non-Delivery Reports and invite emails as well.
  • The MailMessage object now exposes the Categories field.

• The Get IMAP Mail Messages activity has received the following updates:

  • The ability to filter mail messages using filter expressions.
  • The ability to order mail messages by date.
  • The activity now retrieves Non-Delivery Reports and invite emails as well.

• You can now specify the reply-to addresses, importance, and sensitivity of an email when using the Send Outlook Mail Message activity using the following options:

  • ReplyTo - The email addresses used when replying.
  • Importance - The importance of the email.
  • Sensitivity - How sensitive the email is.

• The Get Exchange Mail Messages activity has received the following updates:

  • The ability to filter by mail message IDs and filter expressions.
  • The ability to order mail messages by date.
  • The activity now retrieves Non-Delivery Reports and invite emails as well.
  • The MailMessage object now exposes the Categories field.

• The following activities have been updated with a new option for the Body property, called HTML:

  • Reply to Email
  • Send Email
• When working with Mail activities, you can now retrieve the body of an email as HTML by selecting Body as HTML from the Plus menu.

• You can now specify the reply-to address, importance, and sensitivity of an email when using the Send Email activity using the following options:

  • Reply to - Email address used when replying.
  • Importance - The importance of the email.
  • Sensitivity - How sensitive the email is.
• You can now use shared mailboxes in automations involving Outlook 365 and the Outlook Desktop app. For Outlook desktop, select the shared mailbox to use from the Account drop-down in the Use Outlook Desktop App activity. For Outlook 365, enter the address of the shared mailbox in the Shared mailbox to use field that is available in the Use Outlook 365 activity.
• You can now choose to overwrite existing files when saving email attachments with the Save Email Attachments activity by selecting the Overwrite existing option.
• You can now save multiple attachment types using the Save Email Attachments activity in StudioX by adding multiple file extensions in the Filter by file name field. Example: “.xls|.pdf”.
• You can now also filter by category and date when using the Additional Filters feature in the For Each Email activity.

• Non-Delivery Report (NDR) support has been added to the following mail activities:

  • For Each Email
  • Archive Email
  • Delete Email
  • Forward Email
  • Mark Email as Read/Unread
  • Save Email
  • Save Email Attachments
  • Move Email
• Invites are now supported when using Mail activities.

• Fixed an issue for the Get Outlook Mail Message activity that in some cases would prevent attachments from being added to the email.
• An issue has been fixed for the Get Outlook Mail Messages activity that in some cases prevented the sender email address from being retrieved for a specific email message.
• Fixed an issue that caused the Get IMAP Mail Messages activity to fail when reading certain emails.
• Fixed an issue for the Get IMAP Mail Messages activity that in some cases prevented the sender email address from being retrieved for some email messages.
• An issue has been fixed for the Get Exchange Mail Messages that prevented the activity from working with public folders.

• Fixed an issue that caused the Use Outlook 365 activity to take too long to complete when retrieving emails using the For Each Email activity.
• All SMTP Mail activities now work when a value is set in the SecurePassword property.

• Mail activities that use credentials now support adding passwords securely with the addition of a SecurePassword property that accepts SecureString variables. If set, the SecurePassword property takes precedence over the Password property. The property has been added in the Logon category for the following activities:

  • Send SMTP Mail Message
  • Get POP3 Mail Messages
  • Get IMAP Mail Messages
  • Move IMAP Mail Message
  • Delete IBM Notes Mail Message
  • Get IBM Notes Mail Message
  • Move IBM Notes Mail Message
  • Send IBM Notes Mail Message
  • All that have the Password property.
• When working with StudioX activities, Outlook 365 and Gmail application credentials can now be automatically loaded from specific assets in a dedicated Orchestrator folder, enabling users to quickly connect to their accounts without having to provide the application and tenant IDs in the Use Outlook 365 activity, or the client ID and client secret in the Use Gmail activity. For more information, see Adding Application Credentials for Outlook 365 and Gmail in Orchestrator.
• Automations for Gmail and Outlook 365 now offer both plain text and HTML email bodies to ensure the recipient can view correctly regardless of their mail client.

• The Description property has been updated to allow the use of a Word document as input in addition to the current plain text option.
• The Attachments property has been added, offering the ability to attach files to a calendar event.

• If you execute a project with Outlook desktop activities when Microsoft Outlook and Studio are not running with the same privileges, the error message that is displayed now informs you that you must run the applications with the same privileges (either both as administrator or both not as administrator).
• Outlook folder names with Japanese characters are now displayed correctly in the Move to field of the Move Email activity. Characters in this field are no longer encoded, apart from \ and %. If you enter folder names in the Text Builder and the names contain the characters \ or %, the characters must be URL-encoded (%5C and %25 respectively).

• If the Word document you select to use as the body of an email in a Send Email, Forward Email, or Reply to Email activity contains pictures, some of the pictures may not appear in the body of the email that is sent.

• If a picture fails to appear in the email body, try one of the following workarounds:

  • Open the Word document, remove the picture, and then add the picture again.
  • Change the extension of the Word document to .zip, extract the archive, open the file document.xml located in the folder word, search for the attribute r:link, and remove it (for example, r:link="rId11"). Save the file, then zip the extracted files again and change the extension back to .docx.

• If you execute a project with activities designed for the StudioX profile when Microsoft Outlook and Studio are not running with the same privileges, the error message that is displayed now informs you that you must run the applications with the same privileges (either both as administrator or both not as administrator).

• The Send SMTP Mail Message activity threw an error when TLS was enabled in the SMTP server. This has been fixed by updating some internal dependencies.

• Delete Lotus Notes Mail Message
• Send Lotus Notes Mail Message
• Move Lotus Notes Mail Message
• Get Lotus Notes Mail Messages

• When forwarding mails with the Send SMTP Mail Message activity, mails were not sent to the target recipient.
• When Microsoft Outlook stopped responding, the Get Outlook Mail Messages, Move Outlook Mail Message, and Send Outlook Mail Message activities caused the Robot to freeze.
• In some cases, the Send SMTP Mail Message activity failed to authenticate and threw an error.
• Fixed an issue that did not allow users to send mails with the address of other users in their domain by using the From and Name properties in the Send Exchange Mail Message activity.
• Get Exchange Mail Messages was unable to retrieve emails from a shared account from a folder different than Inbox.

• When sending mails with the Send Outlook Mail Message activity, inline attachments are sent as normal attachments.
• The Send Outlook Mail Message activity can only save messages as drafts in the first Drafts folder found in Microsoft Outlook when the IsDraft check box is selected.
• The Get Outlook Mail Messages activity's ability to retrieve mails depends on how often Microsoft Outlook is configured to synchronize.

• The SharedMailbox property has been added to the Get Exchange Mail Messages activity. This property enables mail messages to be retrieved from a shared mailbox linked to an Exchange user account.
• If an email is retrieved as a System.Net.Mail.MailMessage object, its text content can be accessed by using the item.headers("PlainText") VB.NET expression. Also, the HTML content can be accessed by using the item.headers("HtmlBody") VB.NET expression. This only works with POP3, IMAP, and Outlook mail messages.

• The Delete activity can now be used to delete message attachments right after the Send Exchange Mail Message activity.
• Enabling the IsDraft property in the Send Outlook Mail Message activity now fills in the E-mail address field of the draft mail that is created. Thus, the mail can be sent without issues after being created.
• Email attachments are now properly identified by the Get Outlook Mail Messages activity even if they are placed after the signature.
• The Send SMTP Mail Message activity now correctly displays attachment filenames that contain Japanese characters.
• The Send Outlook Mail Message activity can now forward an email that contains attachments without throwing an error.