Forward Email

UiPath.Mail.Activities.Business.ForwardMailX

Forwards the specified email or invite. Should be used for the email or invite currently selected in the Outlook desktop app, or in a For Each Email activity when iterating through Gmail or Outlook emails. This activity must be added inside a Use Outlook 365, Use Gmail, or Use Desktop Outlook App activity.

Important: HTML emails may not look as expected when using the Use Desktop Outlook App activity. Using a Word document for the Body is recommended.

Configuring the Activity

In the Body of the Activity

• Email - Click Plus on the right side of the field and then, from the menu, select the email to forward. When the activity is inside a For Each Email activity, select CurrentMail to indicate the current mail in the iteration. When automating the Outlook desktop app, you can also select Selected Mail to use the message that is selected in Outlook when the project is executed. Alternatively, you can select Open in Advanced Editor and enter a VB expression.

• Add To recipients - Click Plus on the right side of the field, and then use one of the options in the menu to select where to forward the email:

  • Data from the Project Notebook, a parent Excel file or email account. For example, you can select a cell in an Excel file that contains email addresses separated by semicolon (;) to add multiple recipients, or, when automating the Outlook desktop app, use the email addresses from the To field of the email selected in Outlook when the project is executed.
  • Use Saved Value - Use data in the form of a list of email addresses that you previously saved for later use in the project.
  • Text - Enter one or more email addresses separated by semicolon (;) in the Text Builder.
  • Ask when run - Prompt for the recipients when the project is executed.
  • Paste from clipboard - Paste an email address that you previously copied to the clipboard in the project.
  • Open in Advanced Editor - Enter a VB expression.

• Add Cc recipients - Click Plus on the right side of the field, and then use one of the options in the menu to select the secondary recipients of the email:

  • Data from the Project Notebook, a parent Excel file or email account. For example, you can select a cell in Excel with email addresses separated by semicolon (;) to add multiple recipients, or, when automating the Outlook desktop app, use the email addresses from the Cc field of the email selected in Outlook when the project is executed.
  • Use Saved Value - Use data in the form of a list of email addresses that you previously saved for later use in the project.
  • Text - Enter one or more email addresses separated by semicolon (;) in the Text Builder.
  • Ask when run - Prompt for the recipients when the project is executed.
  • Paste from clipboard - Paste an email address that you previously copied to the clipboard in the project.
  • Open in Advanced Editor - Enter a VB expression.

• New subject - Optionally, you can add a new subject for the email. If a new subject is not provided, the default Outlook subject for forwarded emails is used. Click Plus on the right side of the field and then use one of the options in the menu to add a subject for the email:

  • Data from the Project Notebook, a parent Excel file or email account. For example, you can select a cell in an Excel file, or, when automating the Outlook desktop app, you can use the subject of the of the email selected in Outlook when the project is executed.
  • Use Saved Value - Use data that you previously saved for later use in the project.
  • Text - Enter a subject in the Text Builder.
  • Ask when run - Prompt for the subject when the project is executed.
  • Paste from clipboard - Paste a value that you previously copied to the clipboard in the project.
  • Open in Advanced Editor - Enter a VB expression.
• Body - You can add a plain text body, use HTML, or select a Word document to add the file in the email body.
  • If you select HTML, click Open Editor to start drafting your email using the WYSIWYG HTML editor.

  • If you select Text, click Plus on the right side of the field, and then select one of the options from the menu to add the text for the body of the email:

    • Data from the Project Notebook, a parent Excel file or email account.
    • Use Saved Value - Use data that you previously saved for later use in the project.
    • Text - Enter the body text in the Text Builder.
    • Ask when run - Prompt for the body text when the project is executed.
    • Paste from clipboard - Paste a value that you previously copied to the clipboard in the project.
    • Open in Advanced Editor - Enter a VB expression.

  • If you select Use Word Document, indicate a Word document with tables, images. text formatting to add in the body. The email body is formatted as HTML.

    Click Browse next to the field, and then browse to a Word file and select it. Alternatively, you can indicate the path to a Word file by selecting an option from the Plus menu on the right side of the field:

    • Data from the Project Notebook, a parent Excel file or email account. For example, you can select a cell in an Excel file that contains a path.
    • Use Saved Value - Use data in the form of a file path that you previously saved for later use in the project.
    • Text - Enter a path in the Text Builder.
    • Ask when run - Prompt for the path when the project is executed.
    • Paste from clipboard - Paste a value that you previously copied to the clipboard in the project.
    • Open in Advanced Editor - Enter a VB expression.
      Note:

      • The option Use Word Document can only be used with the Outlook desktop app.

      • If the Word document you select 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.
  • Save as draft - If selected, the email is saved in the Drafts folder instead of being sent directly to the selected recipients, giving you a chance to check the email before sending it. This option is selected by default.

• Attachments - Select Files to attach individual files or Folder to attach all the files in a folder. To select the file or folder, click Browse next to the field, and then browse to the file or folder and select it. Alternatively, you can indicate a file or folder path by selecting an option from the Plus menu on the right side of the field:

  • Data from the Project Notebook, a parent Excel file or email account. For example, you can select a cell in an Excel file that contains a path.
  • Use Saved Value - Use data in the form of a path that you previously saved for later use in the project.
  • Text - Enter a path in the Text Builder. You can combine text with a formula from an Excel file cell, for example to add a date to the file name using formulas in the Project Notebook.
  • Ask when run - Prompt for the path when the project is executed.
  • Paste from clipboard - Paste a value in the form of a path that you previously copied to the clipboard in the project.
  • Open in Advanced Editor - Enter a VB expression.

Properties Panel

Common

• DisplayName - The name displayed for the activity in the Designer panel.

Email

• Body - The plain text body of the email, if Text is selected as the body type.
• Body document path - The path to the Word document to use as the body of the email, if WordDocument is selected as the body type.
• New subject - See New subject in the body of the activity.

Input

• Email - See Email in the body of the activity.

Misc

• Private - If selected, the values of variables and arguments are no longer logged at Verbose level.

Options

• Body type - See Body in the body of the activity.
• HTML body from file - Specifies the HTML body of the email created using the HTML editor.
• HTML Template - Document which stores the HTML template. When blank, a new template will automatically be created when you use the editor.
• HTML body from text - Specifies the HTML body of the email loaded from a different source and saved as text.
• Max body document size - The maximum size (in MB) a Word document can have to be used as the email body. The default value is 2MB.
• Save as draft - See Save as draft in the body of the activity.

Receiver

• Add Bcc recipients - Add hidden recipients of the email in a similar way to how you add To and Cc recipients.
• Add Cc recipients - See Add Cc recipients in the body of the activity.
• Add To recipients - See Add To recipients in the body of the activity.

Sender

• Sent on behalf of - Another user with access to the mailbox on behalf of whom to send the message. Indicate the user in a similar way to how you indicate a To or Cc recipient.