Find Meeting Times

UiPath.MicrosoftOffice365.Activities.Calendar.FindMeetingTimesConnections

Description

Uses the Microsoft Graph Find meeting times API to suggest meeting times and locations based on organizer and attendee availability (Attendees) and your specified range of time that you want the meeting to occur (IntervalStart, IntervalEnd, and MeetingDuration).

After analyzing the availability of the attendees, the activity returns an array of times, locations (if applicable), and attendees that are available during your specified range (AvailableTimeslots). If the activity does not find any available time slots, it returns a reason so that you can alter your range as needed (EmptySuggestionReason).

Note: Find Meeting Times cannot be used with ApplicationIdAndSecret authentication because the Microsoft Graph FindMeetingTimes API does not support application permissions.

Scopes

This activity requires the following scopes:

• Calendars.ReadWrite

OR

• Calendars.ReadWrite.Shared

Project compatibility

Windows | Cross-platform

• Microsoft Outlook 365 - The connection for the Microsoft 365 account to use in the activity.
• Attendees email address - An array of attendees' email addresses. This field supports only String[] variables. To enter one email address, include it between { } and declare it with " " (e.g., {"[e-mail]"}). To enter multiple email addresses, include all between { }, declare each with " ", and separate each by a comma (e.g., {"[e-mail]","[e-mail]"}).
• Start interval - The beginning of the time period in which to search for openings. This field supports only DateTime variables. The default value is Current system time (not shown). You may enter the date only or the date and time. If you enter a date only, the activity searches for times as specified in the Policy property.
  Note:

  • Your DateTime values must be formatted as MM/DD/YYYY or MM/DD/YYYY Hour:Minute:Seconds (e.g., 10/31/2019 12:00:00).
  • The DateTime format is auto-corrected if you enter enough details. For example, if you enter 10/31/19 3pm it auto-corrects to 10/31/2019 15:00:00.
• End interval - The end of the time period in which to search for openings. This field supports only DateTime variables. The default value is Today at midnight (not shown). You may enter the date only or the date and time. If you enter a date only, the search is limited to the working hours specified by the attendee calendars.
• Timezone - The time zone in which to interpret Interval Start and Interval End. The default value is Your system's time zone (not displayed). This property supports String variables and string formatted values.
• Meeting duration - The desired duration for the meeting in minutes. This field supports only integer and Int32 variables. The default value is 30 (not shown).

Configuration

Properties

Input

• Organizer Required - Specifies if the organizer is a required attendee. It is set to True by default.
• Constraints - The constraints attendees must follow when looking for available meeting times. Select one of the following options:
  • Work - Meeting suggestions are limited to the work hours of the user as set in their calendar. The default hours are Monday to Friday, from 8AM to 5PM.
  • Personal - Meeting suggestions span the full week based on your calendar settings. The default hours are Monday to Sunday, from 8AM to 5PM.
  • Unrestricted - Meeting suggestions are available at any time and any day without limitations.
• Locations - An array of rooms or locations, given by their display names, to search. If no locations are available, another is selected. This field supports only String[] variables. If the listed meeting rooms are not available, the activity does not return meeting time suggestions.

Output

• Empty Suggestion Reason - A reason for not returning any meeting suggestions. The possible values are attendeesUnavailable, attendeesUnavailableOrUnknown, locationsUnavailable, organizerUnavailable, or unknown. This property is an empty string if the Available Timeslots property does not include any meeting suggestions. You can also use MeetingTimeSuggestion.SuggestionReason to see the suggestion reason.
• Available Timeslots - An array of meeting times, available attendees, and, if applicable, locations. This field supports only MeetingTimeSuggestion[] variables. The field is required if you plan to use the output data in subsequent activities. The MeetingTimeSuggestion object includes multiple properties that you can use in other activities.

How it works

The following steps and message sequence diagram is an example of how the activity works from design time (i.e., the activity dependencies and input/output properties) to run time.

1. Complete the steps.
2. Add the Microsoft Office 365 Scope activity to your project.
3. Add the Find Meeting Times activity inside the Microsoft Office 365 Scope activity.
4. Enter values for the Input properties.
5. Create and enter MeetingTimeSuggestion[] and String variables for your Output property.
6. Run the activity.
   • Your input property values are sent to the FindMeetingTimes API.
   • The API returns the MeetingTimeSuggestion[] and String values to your output property variable.