plannerTaskRecurrence 资源类型

命名空间：microsoft.graph

重要

Microsoft Graph /beta 版本下的 API 可能会发生更改。 不支持在生产应用程序中使用这些 API。 若要确定 API 是否在 v1.0 中可用，请使用 版本 选择器。

表示 Microsoft 365 中 Planner 任务的 重复周期，允许客户端定义和编辑 Planner 任务的重复周期。 若要添加或编辑重复周期，客户端会指定 计划。 有关详细信息，请参阅 plannerRecurrenceSchedule。 若要取消重复周期，客户端将相同的 计划 设置为 null。 plannerTaskRecurrence 资源还提供系统生成的只读属性，这些属性对跟踪和了解重复周期非常有用。 对于 Planner 任务，在定义重复周期后，无法将其设置为 null。 对于从未定义重复周期的任务，定期为 null。

给定非定期任务，客户端可以通过指定 计划将其转换为定期任务。 添加计划后，Planner 将填充 seriesId 和 occurrenceId 属性以及其他属性。 occurrenceId1 表示这是系列中的第一个任务。 系列中的第二个任务有一个 occurrenceId2。 seriesId 是为第一个任务创建的唯一新字符串。 第二个任务和系列中的所有未来任务从第一个任务继承 seriesId ，指示它们是同一 个重复序列的一部分。

当 具有活动重复周期的任务 标记为完成 (percentComplete 设置为 100) 时，将创建一个新任务以继续该系列。 或者，如果在不取消 定期的情况下删除具有活动重复周期 的任务，则还会创建一个新任务以继续该系列。 如果序列应停止，则 计划 应首先设置为 null，然后可以删除任务并停止定期。

有关详细信息，请参阅 在 Planner 中配置任务重复周期。

属性

属性	类型	说明
nextInSeriesTaskId	String	本系列中下一个任务的 taskId 。 此值是在创建系列中的下一个任务时分配的，并且是在 null 该时间之前分配的。
occurrenceId	Int32	定期系列中此任务的从 1 开始的索引。 序列中的第一个任务具有 值 1，系列中的下一个任务具有 值 2，依此类。
previousInSeriesTaskId	String	本系列中上一个任务的 taskId 。 null 对于系列中的第一个任务，因为它没有前置任务。 系列中的所有后续任务都有一个与其前置任务对应的值。
recurrenceStartDateTime	DateTimeOffset	此重复序列开始的日期和时间。 对于系列中的第一个任务， (occurrenceId = 1) 此值是从 schedule.patternStartDateTime 复制的。 对于系列中的后续任务， (occurrenceId>= 2) 此值从上一个任务复制，并且永远不会更改;它保留定期系列的开始日期。 时间戳类型表示采用 ISO 8601 格式的日期和时间信息，始终采用 UTC 时区。 例如，2014 年 1 月 1 日午夜 UTC 为 2014-01-01T00:00:00Z。
schedule	plannerRecurrenceSchedule	定期计划。 客户端通过指定计划来定义和编辑重复周期。 如果未分配 nextInSeriesTaskId ，则客户端可以通过将 分配给 null 此属性来终止序列。
seriesId	String	此任务所属的重复周期系列。 一个基于 GUID 的值，用作序列的唯一标识符。

关系

无。

JSON 表示形式

以下 JSON 表示形式显示了资源类型。 有关包含此资源的真实示例，请参阅 在 Planner 中配置任务重复周期。

{
  "@odata.type": "#microsoft.graph.plannerTaskRecurrence",
  "nextInSeriesTaskId": "String",
  "occurrenceId": "Int32",
  "previousInSeriesTaskId": "String",
  "recurrenceStartDateTime": "String (timestamp)",
  "schedule": { "@odata.type": "#microsoft.graph.plannerRecurrenceSchedule" },
  "seriesId": "String"
}