获取日历

UiPath.MicrosoftOffice365.Activities.Calendar.GetCalendars

描述

使用 Microsoft Graph 获取日历 API 获取日历的属性和关系。 日历可以是用户的日历，也可以是 Office 365 组 (用户) 的默认日历。

检索日历后，该活动会输出表示用户默认日历的 Calendar 对象 (默认日历) 和表示所有用户日历 (日历) 的 Calendar[] 对象数组。 这些输出 Calendar 对象可用作 创建事件 和 搜索事件 活动中的输入属性变量。

此活动不仅限于检索您的日历。 如果 Microsoft Office 365 作用域 (应用程序 ID) 中的注册应用程序具有权限或用户授予的适当 权限 ，则您还可以检索其他用户的日历。

作用域

此活动需要以下作用域：

• 日历. 读取

或

• Calendars.Read.Shared

或

• Calendars.ReadWrite

或

• Calendars.ReadWrite.Shared

或

• Group.Read.All

或

• 组、读写、全部

项目兼容性

Windows - Legacy | Windows

配置

属性

常见

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

输入

• “帐户 ” -（可选）要与之交互的电子邮件地址。 这可能包括当前用户有权访问的任何共享邮箱。 如果留空，则假定为当前用户的帐户。 此属性支持 String 变量和字符串格式的值。
  备注： 对于 ApplicationIdAndSecret 和 ApplicationIdAndCertificate 身份验证类型，“帐户” 字段是必填字段。
• 用户 - 拥有所检索日历的人员的电子邮件地址。如果未提供日历，则使用用户自己的日历。用户必须拥有 API 权限才能读取日历。有关更多信息，请参阅设置指南中的。此属性支持 String 变量和字符串格式的值。

其他

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

输出

• 日历 - 用户日历的数组。 此字段仅支持 Calendar[] 变量。 如果您计划在后续活动中使用输出数据，则为必填项。 您也可以将此变量用作其他活动（例如， 创建活动 和 搜索活动）中的输入变量。
• 默认日历 - 经过身份验证的用户的默认日历，以防“ 用户 ”属性为空。 此字段仅支持 Calendar 变量。 如果您计划在后续活动中使用输出数据，则为必填项。 您也可以将此变量用作其他活动（例如， 创建活动 和 搜索活动）中的输入变量。

工作方式

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

1. 完成步骤。
2. 将“ Microsoft Office 365 作用域 ”活动添加到您的项目中。
3. 在 Microsoft Office 365 作用域活动中添加获取日历活动。
4. 输入“输入”属性的值。
5. 为“ 输出 ”属性创建并输入 Calendar 和 Calendar[] 变量。

6. 运行活动。

   • 您的输入属性值将发送到获取日历 API。
   • API 将 Calendar 和 Calendar[] 值返回到您的输出属性变量。