创建活动

UiPath.MicrosoftOffice365.Activities.Calendar.CreateEvent

描述

使用 Microsoft Graph 创建事件 API 在指定日历 (日历) 中创建新事件。

创建活动时，请指定日期和时间（“开始时间”、 “结束时间”和 “时区”）以及要包含的内容（“正文” 和“ 主题”）。 此外，您还可以选择为此活动分配指定日历中的类别 (类别)。

创建活动后，该活动会输出一个 Event 对象，您可以在后续活动中将其用作输入变量（例如， 添加参加者、 添加地点等）。

作用域

此活动需要以下作用域：

• Calendars.ReadWrite

或

• Calendars.ReadWrite.Shared

项目兼容性

Windows - Legacy | Windows

配置

属性

常见

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

活动内容

• “正文 ” - 事件的正文。 如果选择了“为正文 HTML ” 选项，则需要以 HTML 格式指定正文。 此属性支持 String 变量和字符串格式的值。
• 正文是 HTML - 如果选中，正文将以 HTML 格式解读。该字段仅支持“布尔值”。
• 主题 - 事件的主题。此属性支持 String 变量和字符串格式的值。

事件计划

• “结束时间” - 事件的结束时间。 此字段仅支持 DateTime 变量。
• 开始时间 - 事件的开始时间。此字段仅支持 DateTime 变量。
  备注：

  • DateTime 值的格式必须为 MM/DD/YYYY Hour:Minute:Seconds（例如 10/31/2019 12:00:00）。
  • 如果您输入足够的详细信息，系统会自动更正 DateTime 格式。 例如，如果您输入 10/31/19 3pm ，则系统会自动更正为 10/31/2019 15:00:00。
• “时区” - 解释“ 开始时间” 和 “结束时间” 时 所处的时区。 默认值为 您系统的时区 （不显示）。 输入有效的 String （例如， “太平洋标准时间”）。

输入

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

其他

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

选项

• “类别 ” - 与事件关联的类别。 此字段仅支持 String[] 变量。 您的值必须与指定的 “日历 ”类别列表中的名称匹配（请参见下图示例）。 要输入一个类别，请将其包含在 { } 之间，并用“ ”声明（例如 {"Purple category"}）。 要输入多个类别，请在 { } 之间添加所有类别，用“ ”声明每个类别，并用逗号分隔每个类别（例如 {"A CustomCategory", "Purple category"}）。
  
  

  

  
  
• 全天 - 如果选中，则计划全天活动。 如果选中，则您在“ 开始时间” 和 “结束时间” 属性中输入的值将被覆盖。 即使选择此属性，也需要在“ 开始时间” 和 “结束时间” 属性中输入值。 此字段支持布尔值。
• “显示为 ” - 用户在活动期间的空闲状态。 选择以下六个选项之一： Unknown、 Free、 Tentative、 Busy、 Oof 或 WorkingElsewhere。 默认值为“ 免费”。

输出

• “事件 ” - 已创建的事件。 其他活动可以使用此对象来添加参加者或修改信息。 此字段仅支持 Event 变量。 如果您计划在后续活动中使用输出数据，则为必填项。 您可以将此变量用作其他活动中的输入变量，例如 添加参加者和 添加位置等。

工作方式

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

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

7. 运行活动。

   • 您的输入属性值将发送到创建事件 API。
   • API 会将 Event 值返回到您的输出属性变量。