搜索活动

UiPath.MicrosoftOffice365.Activities.Calendar.SearchEvents

描述

使用 Microsoft Graph 列表事件 API 从指定日历 (日历) 中检索匹配的事件。 如果“ 日历 ” 属性留空，则活动将在您的默认日历中搜索事件。

执行搜索后，该活动将返回匹配的 Event[] 对象（事件），您可以在后续活动（修改事件、 添加位置等）中将其用作输入变量。

作用域

此活动需要以下作用域：

• Calendars.ReadWrite

或

• Calendars.ReadWrite.Shared

项目兼容性

Windows - Legacy | Windows

配置

属性

常见

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

输入

• “帐户 ” -（可选）要与之交互的电子邮件地址。 这可能包括当前用户有权访问的任何共享邮箱。 如果留空，则假定为当前用户的帐户。 此属性支持 String 变量和字符串格式的值。
  备注： 对于“ 应用程序 ID 和密码”身份验证类型，“帐户”字段是必填字段。
• 日历 - 要在其中搜索的日历。 可以使用“ 获取日历” 活动检索。 如果不提供值，则使用默认日历。 此字段仅支持 Calendar 变量。 如果输入值，请使用 获取日历 活动（日历 或 默认日历）中的输出属性变量。 如果您使用的是 日历 输出属性变量，请在数组中指定要使用的项目（例如， myCalendar(0)）。

其他

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

选项

• “结束日期 ” - 要搜索的事件的结束日期。 指定后，搜索将仅返回此日期之前发生的事件（不搜索在此日期发生的事件）。 此字段仅支持 DateTime 变量。 DateTime 值的格式必须为 MM/DD/YYYY（例如 11/01/2019）。
• 事件 ID - 要查找的事件的 ID。指定后，系统将考虑帐户参数，而忽略选项类别中的其他筛选器参数。如果找到具有指定 ID 的电子邮件，则输出数组仅包含一个元素。如果未找到，活动将引发异常。此属性支持 String 变量和字符串格式的值。
• “最大结果 ” - 要在搜索结果中返回的最大事件数。 此字段仅支持整数和 Int32 变量。 默认值为 50。
• “返回重复” - 如果选中，则还将返回系列中的事件。 此字段支持布尔值。
• 搜索查询 - 如果提供，则仅返回主题、正文、位置或与会者包含此字符串的事件。 使用 OData 查询参数 输入 String ，或输入事件的标题（例如， “Office365-Quickstart”）。
• 开始日期 - 要搜索的事件的开始日期。指定后，搜索将仅返回此日期之后发生的事件（不搜索在此日期发生的事件）。此字段仅支持 DateTime 变量。DateTime 值的格式必须为 MM/DD/YYYY（例如 10/30/2019）。

输出

• 事件 - 与“ 搜索查询” 值匹配的事件数组（Event 对象）。 此字段仅支持 Event[] 变量。 如果您计划在后续活动中使用输出数据，则为必填项。 您为此属性创建的变量可用作其他活动中的输入变量，例如 修改事件、 添加位置等。 将此变量用作输入属性值时，请务必在数组中指定要使用的项目（例如， myEvents(0)）。 Event 对象包含多个 属性 ，您可以在其他活动中使用这些属性；并非所有属性都受支持。 Body.Content 属性仅以 HTML 格式返回。

工作方式

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

1. 完成步骤。
2. 将“ Microsoft Office 365 作用域 ”活动添加到您的项目中。
3. （可选）添加活动或运行输出 Calendar 对象的外部流程（例如， 获取日历）。
4. 在 Microsoft Office 365 作用域活动中添加搜索事件活动。
5. 输入“输入”属性的值。
6. 为“输出”属性创建并输入 Event[] 变量。

7. 运行活动。

   • 您的输入属性值将发送到事件列表 API。
   • API 会将 Event[] 值返回到您的输出属性变量。