UiPath Integrations

The UiPath Integrations Guide

Welcome to the UiPath Integrations guide. You will find comprehensive guides and documentation to help you start working with UiPath Integrations, as well as support if you get stuck.

In order to download the solutions mentioned here please visit the official UiPath Go! Marketplace here.

*Note that only integrations built in-house at UiPath are detailed below. For a complete list of UiPath's technology partners, see here.

Find Meeting Times

Overview

The Find Meeting Times activity uses the Microsoft Graph FindMeetingTimes 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 attendee's availability, 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).

How it works

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

  1. Complete the Setup steps.
  2. Add the Microsoft Office 365 Scope activity to your project.
  3. Add the Find Meeting Times activity inside the Microsoft Teams 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.

Properties

The values for the following properties are specified when adding this activity to your project in UiPath Studio.

Common

DisplayName

The display name of the activity.

Attributes
Details

Type

String

Required

Yes

Default value

Find Meeting Times

Allowed values

Enter a String or String variable.

Notes

N/A


Input

Attendees

The list of attendee email addresses that you want to check for availability.

Attributes
Details

Type

String[]

Required

Yes

Default value

Empty

Allowed values

Enter a String[] or String[] variable.

Notes

  • To enter one email address, include it between { } and declare it with " " (e.g., {"[email protected]"})
  • To enter multiple email addresses, include all between { }, declare each with " ", and separate each by a comma (e.g., {"[email protected]","[email protected]"}).

IntervalEnd

The latest time period to search for availability.

Attributes
Details

Type

DateTime

Required

Yes

Default value

Today at midnight (not shown)

Allowed values

Enter a DateTime or DateTime variable.

Notes

  • 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.
  • Your DateTime value 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.

IntervalStart

The earliest time period to search for availability.

Attributes
Details

Type

DateTime

Required

Yes

Default value

Current system time (not shown)

Allowed values

Enter a DateTime or DateTime variable.

Notes

  • 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.
  • Your DateTime value 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.

MeetingDuration

The length of time that you want to check for attendee availability (i.e., the length of your planned meeting).

Attributes
Details

Type

Int32

Required

Yes

Default value

30 (not shown)

Allowed values

Enter a Int32 or Int32 variable.

Notes

N/A


Time Zone

The time zone of the event's IntervalStart and IntervalEnd.

Attributes
Details

Type

Drop-down list (String)

Required

Yes

Default value

Your system's time zone (not displayed).

Allowed values

Select a time zone from the drop-down list or enter a valid String (e.g., "Pacific Standard Time").

Notes

N/A


Misc

Private

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

Attributes
Details

Type

Checkbox

Required

No

Default value

Not Selected

Allowed values

Selected or Not Selected

Notes

N/A


Options

Locations

A list of meeting room email addresses that you want to check for availability.

Attributes
Details

Type

String[]

Required

No

Default value

Empty

Allowed values

Enter a String[] or String[] variable.

Notes

  • If the listed meeting rooms are not available, the activity does not return meeting time suggestions.

OrganizerRequired

If selected, the user is a required attendee for the meeting.

Attributes
Details

Type

Checkbox

Required

No

Default value

Selected

Allowed values

Selected or Not Selected

Notes

N/A


Policy

Specifies the range of times to search in the attendee's calendar.

Attributes
Details

Type

Drop-down selection

Required

Yes

Default value

Unrestricted

Allowed values

Select one of the three options:

  • Unrestricted - Suggested times can include all hours of all days of the week.
  • Work - Suggested times are within the users' work hours. Default hours are Mon-Fri, 8am to 5pm.
  • Personal - Suggested times are within the users' work hours and Saturday and Sunday. Default hours are Mon-Sun, 8am to 5pm.

Notes

  • A user's work hours are defined in their calendar configuration and can be customized by the user or administrator.

Output

AvailableTimeslots

An array of suggested meeting times according to your input property values.

Attributes
Details

Type

MeetingTimeSuggestion[]

Micrsoft.Graph.MeetingTimeSuggestion

Required

No (required if you plan to use the output data in subsequent activities)

Default value

Empty

Allowed values

Enter a MeetingTimeSuggestion[] variable.

Notes

  • The MeetingTimeSuggestion object includes multiple properties that you can use in other activities. The example image below shows some of the properties that you can return.

EmptySuggestionReason

Explains the cases where no meeting times are returned in colloquial English.

Attributes
Details

Type

String

Required

No (required if you plan to use the output data in subsequent activities)

Default value

Empty

Allowed values

Enter a String variable.

Notes

*You can also use MeetingTimeSuggestion.SuggestionReason to see the suggestion reason (shown in the example image below).


Example

The following image shows an example of the activity dependency relationship and input/output property values.

For step-by-step instructions and examples, see the Quickstart guides.

Updated 3 months ago


Find Meeting Times


Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.