ForEach Event

Estimated reading: 3 minutes

For Each Event

The For Each Event activity retrieves and iterates through events available in a Microsoft 365 calendar of the configured service account. It allows you to search for events within a specified date and time range, apply additional filters, and perform actions on each event individually.

Prerequisites

A valid Project Key is required in the Publish Console to access and publish workflows successfully.

Activity Details in Canvas

Microsoft 365: Select a Microsoft 365 account from the available connections. The selected account is used to authenticate and access the mailbox.

Calendar: Specifies the calendar folder from which events will be retrieved. You can either select a calendar folder from the drop-down list, enter the calendar folder name directly as text, or provide a String variable containing the calendar folder name.

Start Date & Time: Specifies the date and time from which events will be retrieved. You can select the date using the date picker, provide the value through a variable, and enter the time manually.

End Date & Time: Specifies the date and time until which events will be retrieved. You can select the date using the date picker, provide the value through a variable, and enter the time manually.

Note: The Start Date & Time and End Date & Time fields can be configured using either of the following options:

Use Variable: Select a variable that stores the required date and time value.
Deactivate Variable: Remove the variable and enter the date and time directly.

Supported DateTime Format: MM/DD/YYYY HH:mm:ss

Example: 01/10/2023 13:00:00

Add Filters using Filter Builder: Allows you to define additional filtering conditions to retrieve specific events based on event properties. For more information, refer to the Filter Builder.

Important: Values configured in the Canvas are automatically populated in the corresponding properties in the Properties panel and can be modified there if required.

Properties

MISC

DisplayName: Specifies the display name of the activity. This value can be customized to improve workflow readability and troubleshooting.

SkipOnError: Specifies whether the workflow execution should continue when the activity encounters an error.
True: The workflow continues execution even if an error occurs.
False: The workflow stops execution when an error occurs.
None: The default value is set to False.

Version: Displays the current version of the activity.

OPTIONS

ItemName: Specifies the name of the variable that stores the current event being processed during each iteration. This variable is generated by default and can be used in activities placed inside the Do section to access the details of the current event.

Limit: Specifies the maximum number of events to retrieve and process. The default value is 50.

Preferred Timezone: Specifies the preferred time zone used while retrieving events. You can enter the time zone directly as text or provide a String variable containing the required time zone value.
The recommended format is Indian Standard Time (IST).

OUTPUT

NumberOfEventProcessed: Stores the number of events processed by the activity in a variable.

Result: Returns a Boolean value indicating the execution status of the activity.
True: The activity executed successfully.
False: The activity failed due to an unexpected error.

ForEach Event

Prerequisites

Activity Details in Canvas

Properties

MISC

OPTIONS

OUTPUT

ForEach Event

CONTENTS