ForEachMail

This activity refers to a loop activity designed to perform actions on a collection of emails, such as reading, processing, or moving each email message individually within the loop based on specific conditions. It is integral to automating email-related tasks and streamlining processes involving bulk email handling. 

Properties

INPUT 

Limit: This parameter indicates the maximum number of emails to be looped through to perform a set of actions. This parameter accepts the value in “String” datatype. You can either hardcode the value in “String” datatype or provide the variables in “String” format.

MailsFrom: * This parameter specifies the “Folder” from which the set of actions will be performed. To choose the folder, click the “+” icon next to the box and select the required folder from the dropdown menu.

Alternatively, you can provide a variable of the “List of MailItem” datatype. Refer to the documentation below for more information.

MISC

DisplayName: Displays the name of the activity. The activity name can be customized, which aids in troubleshooting.

SkipOnError: Specify the “Boolean” value as “True” or “False.”
True: Continue executing the workflow regardless of any errors thrown.
False: Halt the workflow if it encounters any errors.
None: If the option is left blank, the activity will, by default, behave as if “False” were chosen.
Version: It indicates the version of the feature being used.

OUTPUT

List: This parameter allows you to view the output of the activity as a “MailItem” variable, which can be used as input in subsequent activities within the “For Each Mail” body. It returns values in the “MailItem” datatype.

Result: It provides the ability to view the execution status of the activity. It returns values in “Boolean.”

True: Indicates that the activity has been executed successfully without any errors.
False: Indicates that the activity has been unsuccessful due to an unexpected error being thrown.

* Represents mandatory fields to execute the workflow.

Setting up the activity

Let’s see how to set up and configure the fields in the activity.

1. For Each (Current MailItem): This represents the name used to reference each email within the body of the “For Each Mail” activity. By default, the value is “Current Mail.” You can customize this name as needed.

2. EmailsFrom: It indicates the folder from which emails should be read and processed in a loop for the specified actions. To choose the folder, click the “+” icon next to the box and select the required folder from the dropdown menu.

Alternatively, you can provide a variable of the “List of MailItem” datatype. This variable will be the output of the “Read Mail” activity.

3. Limit emails to first: This parameter sets the maximum number of emails to be looped through for performing a set of actions. You can select the number of emails from the provided dropdown.

4. Unread mails: Check this option to process only unread emails from the chosen folder and execute them in the loop.

5. Retrieve Attachments: Check this option to extract attachments along with the emails from the chosen folder.

6. With Attachments Only: Check this option to read and process only emails that contain attachments in the chosen folder.

7. Include subfolders: Check this option to include subfolders when reading and processing emails from within the chosen folder.

8. More Filters: Use this option to configure an advanced filter to specify any conditions for the emails to be read. Click on this to open the “Advanced Filter” wizard.
a. And / OR condition: The “AND” function returns results that meet all specified conditions, while the “OR” function returns results that meet any of the specified conditions.
b. The first dropdown lists the email fields to filter by: Bcc, Body, Cc, Date, From, To, Subject, or Categories.
c. The second dropdown lists the operators to evaluate the chosen fields. The available operators are:
     i. For the fields “Bcc, Body, Cc, From, To, Subject, and Categories,” the operators are contains, does not contain, ends with, starts with, equals, is empty, or is not empty.
     ii. For the “Date” field, the operators are older than, newer than, or equals, indicating the time period of the emails.
d. To include additional conditions, click the “Add” button.