搜索活动

UiPath.MicrosoftOffice365.Activities.Calendar.SearchEvents

描述

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

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

项目兼容性

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-快速入门” ）。
• 开始日期 - 要搜索的事件的开始日期。指定后，搜索将仅返回此日期之后发生的事件（不搜索在此日期发生的事件）。此字段仅支持 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[] 值返回到您的输出属性变量。