查找会议时间

UiPath.MicrosoftOffice365.Activities.Calendar.FindMeetingTimes

描述

使用 Microsoft Graph查找会议时间API，根据组织者和与会者的空闲时间（参加者）以及您指定的希望举行的时间范围（ “间隔开始” 、 “间隔结束”和“会议持续时间”）建议会议时间和地点。

在分析了参加者的空闲时间后，该活动将返回在指定范围（可用时间段）内有空的时间、位置（如果适用）和参加者的数组。如果活动未找到任何可用的时间段，它会返回原因，以便您可以根据需要更改范围（空建议原因）。

备注：

“查找会议时间”不能与应用程序 ID 和密码身份验证一起使用，因为 Microsoft Graph查找会议次数API 不支持应用程序权限。

作用域

此活动需要以下作用域：

• Calendars.ReadWrite

或

• Calendars.ReadWrite.Shared

项目兼容性

Windows - Legacy | Windows

配置

属性

常见

• “显示名称”- 活动的显示名称。 此属性支持 String 变量和字符串格式的值。

输入

• 参加者- 参加者电子邮件地址的数组。此字段仅支持String[]变量。要输入一个电子邮件地址，请将其包含在 { } 之间，并用“<”声明（例如， {" [e-mail] "} ）。要输入多个电子邮件地址，请在 { } 之间加入所有电子邮件地址，用“ "声明每个电子邮件地址，并用逗号分隔每个电子邮件地址（例如， {" [e-mail] "," [e-mail] "} ）。
• Interval End - 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.
• Interval Start - 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.
  备注：

  • 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.
• 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).
• 时区- 用于解释“间隔开始时间”和“间隔结束时间”的时区。默认值为系统所在时区（不显示）。此属性支持String变量和字符串格式的值。

其他

• ContinueOnError - If set, continue executing the remaining activities even if the current activity has failed.
• “私有” - 选中后将不再以“Verbose”级别记录变量和参数的值。该字段仅支持“布尔值”。

选项

• 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.
• 必需组织者- 如果选中，则该用户为会议的必需参加者。该字段仅支持“布尔值”。
• Policy - Specifies the attendees' restrictions to abide by while searching for available meeting times. Select one of the four options:
  • Unknown - Do not use this value as it will be deprecated in the future. Currently, it behaves as same as Work.
  • 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.
  • 无限制- 建议的时间可以包括一周中的所有时间。默认值为Unrestricted 。用户的工作时间在其日历配置中定义，并且可以由用户或管理员自定义。

输出

• 可用时间段- 会议时间、可用参加者和地点（如适用）的数组。此字段仅支持MeetingTimeSuggestion[]变量。如果您计划在后续活动中使用输出数据，则为必填。MeetingTimeSuggestion对象包含多个您可以在其他活动中使用的属性。
• 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.

跨平台配置

属性

输入

• “必需组织者” - 指定组织者是否为必需参加者。默认情况下设置为True 。
• 约束条件- 与会者在查找可用会议时间时必须遵循的约束条件。选择以下选项之一：
  • 工作- 会议建议仅限在用户日历中设置的工作时间内（默认为：周一至周五上午 8 点至下午 5 点）。默认工作时间为星期一至星期五，上午 8 点至下午 5 点。
  • 个人- 根据您的日历设置在整周使用会议建议。默认工作时间为星期一至星期日，上午 8 点至下午 5 点。
  • 无限制- 会议建议无时间限制，全天候提供。
• 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.

输出

• “建议原因”为空- 不返回任何会议建议的原因。可能的值为attendeesUnavailable 、 attendeesUnavailableOrUnknown 、 locationsUnavailable 、 organizerUnavailable或unknown 。如果“可用的时间段”属性不包含任何会议建议，则此属性为空字符串。您也可以使用MeetingTimeSuggestion.SuggestionReason查看建议原因。
• 可用时间段- 一系列会议时间、可用的参加者以及地点（如果适用）。此字段仅支持MeetingTimeSuggestion[]变量。如果您计划在后续活动中使用输出数据，则该字段为必填项。MeetingTimeSuggestion对象包含多个您可以在其他活动中使用的属性。

工作方式

以下步骤和消息序列图是活动从设计时（即活动依赖项和输入/输出属性）到运行时如何工作的示例。

1. 完成步骤。
2. 将“Microsoft Office 365 作用域”活动添加到您的项目。
3. Add the Find Meeting Times activity inside the Microsoft Office 365 Scope activity.
4. 输入“输入”属性的值。
5. 为“输出”属性创建并输入MeetingTimeSuggestion[]和String变量。
6. 运行活动。
   • 您的输入属性值将发送到“查找会议次数”API。
   • API 将 MeetingTimeSuggestion[] 和 String 值返回到您的输出属性变量。