查找会议时间

UiPath.MicrosoftOffice365.Activities.Calendar.FindMeetingTimesConnections

描述

使用 Microsoft Graph 查找会议时间 API，根据组织者和与会者的可用性 (Attendees) 以及您希望会议召开的指定时间范围 (IntervalStart、 IntervalEnd和 MeetingDuration) 来建议会议时间和地点。

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

备注： 查找会议时间 不能与 ApplicationIdAndSecret 身份验证一起使用，因为 Microsoft Graph FindMeetingTimes API 不支持应用程序权限。

作用域

此活动需要以下作用域：

• Calendars.ReadWrite

或

• Calendars.ReadWrite.Shared

项目兼容性

Windows | 跨平台

• Microsoft Outlook 365 - 要在活动中使用的 Microsoft 365 帐户的连接。
• 与会者电子邮件地址- 与会者电子邮件地址的数组。此字段仅支持String[]变量。要输入一个电子邮件地址，请将其包含在 { } 之间，并使用“”声明（例如{"[e-mail]"} ）。要输入多个电子邮件地址，请在 { } 之间加入所有电子邮件地址，用“”声明每个电子邮件地址，并用逗号分隔每个电子邮件地址（例如{"[e-mail]","[e-mail]"} ）。
• 开始间隔- 在其中搜索空缺职位的时间段的开始时间。此字段仅支持DateTime变量。默认值为“当前系统时间” （未显示）。您可以仅输入日期，也可以输入日期和时间。如果仅输入日期，该活动将按照“策略”属性中指定的方式搜索时间。
  备注：

  • 您的 DateTime 值必须采用 MM/DD/YYYY 或 MM/DD/YYYY 时:分:秒格式（例如 10/31/2019 12:00:00）。
  • 如果您输入足够的详细信息，系统会自动更正 DateTime 格式。 例如，如果您输入 10/31/19 3pm ，则系统会自动更正为 10/31/2019 15:00:00。
• 结束间隔- 用于搜索空缺项目的时间段的结束时间。此字段仅支持DateTime变量。默认值为今天午夜（未显示）。您可以仅输入日期，也可以输入日期和时间。如果仅输入日期，则搜索将限制在参加者日历指定的工作时间内。
• 时区- 在其中解释“间隔开始时间”和“间隔结束时间”的时区。默认值为您系统所在的时区（不显示）。此属性支持String变量和字符串格式的值。
• 会议持续时间- 会议的所需持续时间（以分钟为单位）。此字段仅支持整数和Int32变量。默认值为 30（未显示）。

配置

属性

输入

• 组织者为必需- 指定组织者是否为必需参加者。默认情况下，它设置为True 。
• 约束- 与会者在查找可用的会议时间时必须遵循的约束。选择以下选项之一：
  • 工作- 会议建议仅限于在用户日历中设置的用户工作时间。默认工作时间为星期一至星期五，上午 8 点至下午 5 点。
  • 个人- 根据您的日历设置建议跨越整周的会议。默认工作时间为星期一至星期日，上午 8 点至下午 5 点。
  • 无限制- 随时随地提供会议建议，不受限制。
• “位置 ” - 要搜索的房间或位置数组，按显示名称指定。 如果没有可用的位置，则选择另一个位置。 此字段仅支持 String[] 变量。 如果列出的会议室不可用，则活动不会返回会议时间建议。

输出

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

工作方式

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

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