搜索活动

UiPath.MicrosoftOffice365.Activities.Calendar.SearchEvents

描述

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

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

作用域

此活动需要以下作用域：

• Calendars.ReadWrite

或

• Calendars.ReadWrite.Shared

项目兼容性

Windows - Legacy | Windows

配置

属性

常见

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

输入

• 帐户-（可选）要与之交互的电子邮件地址。这可能包括当前用户有权访问的任何共享邮箱。如果留空，则假定为当前用户的帐户。此属性支持String变量和字符串格式的值。

  备注：

  Account field is mandatory for ApplicationIdAndSecret authentication type.

• 日历- 要在其中搜索的日历。可以使用获取日历活动进行检索。如果不提供值，则使用默认日历。此字段仅支持Calendar变量。如果输入值，请使用获取日历活动（ Calendar或默认日历）中的输出属性变量。如果您使用的是日历输出属性变量，请在数组中指定要使用的项目（例如myCalendar(0) ）。

其他

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

选项

• End Date - The end date of the events that you want to search. When specified, the search only returns events that occur before this date (events occurring on this date are not searched). This field supports only DateTime variables. Your DateTime value must be formatted as MM/DD/YYYY (e.g., 11/01/2019).
• 事件 ID - 要查找的事件的 ID。指定后，系统将考虑帐户参数，而忽略选项类别中的其他筛选器参数。如果找到具有指定 ID 的电子邮件，则输出数组仅包含一个元素。如果未找到，活动将引发异常。此属性支持 String 变量和字符串格式的值。
• Max Results - The maximum amount of events that you want to be returned in your search results. This field supports only integer and Int32 variables. The default value is 50.
• “返回循环事件” - 选中此选项后，系统还将返回一系列连续事件。该字段仅支持“布尔值”。
• 搜索查询- 如果提供，则只返回主题、正文、地点或参加者包含此字符串的活动。使用OData 查询参数输入您的String ，或输入活动的标题（例如， "Office365-Quickstart" ）。
• Start Date - The start date of the events that you want to search. When specified, the search only returns events that occur after this date (events occurring on this date are not searched). This field supports only DateTime variables. Your DateTime value must be formatted as MM/DD/YYYY (e.g., 10/30/2019).

输出

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

工作方式

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

1. 完成步骤。
2. 将“Microsoft Office 365 作用域”活动添加到您的项目。
3. （可选）添加活动或运行输出Calendar对象（例如，获取日历）的外部流程。
4. Add the Search Events activity inside the Microsoft Office 365 Scope activity.
5. 输入“输入”属性的值。
6. 为“输出”属性创建并输入 Event[] 变量。
7. 运行活动。
   • 您的输入属性值将发送到事件列表API。
   • API 会将 Event[] 值返回到您的输出属性变量。