查找会议时间

UiPath.MicrosoftOffice365.Activities.Calendar.FindMeetingTimes

描述

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

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

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

作用域

此活动需要以下作用域：

• Calendars.ReadWrite

或

• Calendars.ReadWrite.Shared

项目兼容性

Windows - Legacy | Windows

配置

属性

常见

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

输入

• “与会者 ” - 与会者的电子邮件地址数组。 此字段仅支持 String[] 变量。 要输入一个电子邮件地址，请将其包含在 { } 之间，并用“ ”声明（例如 {"[e-mail]"}）。 要输入多个电子邮件地址，请在 { } 之间加入所有电子邮件地址，用“ ”声明每个电子邮件地址，并用逗号分隔每个电子邮件地址（例如 {"[e-mail]","[e-mail]"}）。
• “间隔结束” - 搜索开口的时间段结束。 此字段仅支持 DateTime 变量。 默认值为 “今天午夜” （未显示）。 您可以仅输入日期，也可以输入日期和时间。 如果仅输入日期，则搜索将限制为与会者日历指定的工作时间。
• “开始时间间隔 ” - 搜索开口的时间段的开始时间。 此字段仅支持 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。
• “会议持续时间 ” - 所需的会议持续时间（以分钟为单位）。 此字段仅支持整数和 Int32 变量。 默认值为 30（未显示）。
• “时区” - 解释“ 间隔开始 ”和 “间隔结束”时所处的时区。 默认值为 您系统的时区 （不显示）。 此属性支持 String 变量和字符串格式的值。

其他

• “私有”- 选中后将不再以“Verbose”级别记录变量和参数的值。该字段仅支持“布尔值”。

选项

• “位置 ” - 要搜索的房间或位置数组，按显示名称指定。 如果没有可用的位置，则选择另一个位置。 此字段仅支持 String[] 变量。 如果列出的会议室不可用，则活动不会返回会议时间建议。
• 需要组织者 - 如果选中，则用户是会议的必需与会者。 此字段支持布尔值。

• “策略” - 指定搜索可用会议时间时要遵守的与会者限制。 选择以下四个选项之一：

  • “未知” - 请勿使用此值，因为将来会弃用。 目前，它的行为与 Work相同。
  • “工作” - 建议的时间在用户的工作时间内。 默认时间为周一至周五上午 8 点至下午 5 点。
  • “个人 ” - 建议的时间在用户的工作时间内以及周六和周日。 默认时间为周一至周日上午 8 点至下午 5 点。

  • 不受限制 - 建议的时间可以包括一周中所有日子的所有时间。 默认值为“ 无限制”。 用户的工作时间在其日历配置中定义，并且可由用户或管理员自定义。

输出

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

工作方式

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

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

6. 运行活动。

   • 您的输入属性值将发送到“查找会议次数”API。
   • API 将 MeetingTimeSuggestion[] 和 String 值返回到您的输出属性变量。