plannerTask 资源类型

命名空间：microsoft.graph

plannerTask 资源表示 Microsoft 365 中的规划器任务。规划器任务包含在 计划内，可以分配给计划中的 存储桶。每个任务对象具有可以包含此任务的更多信息的 details 对象。请参阅 概述了解有关组、计划和任务之间的关系的详细信息。

方法

方法	返回类型	说明
获取 plannerTask	plannerTask	读取 plannerTask 对象的属性和关系。
更新	plannerTask	更新 plannerTask 对象。
删除	无	删除 plannerTask 对象。

属性

属性	类型	说明
activeChecklistItemCount	Int32	核对清单项的数量，其值设置为 false，表示项目不全。
appliedCategories	plannerAppliedCategories	此任务已应用的类别。有关可能的值，请参阅已应用的类别。
assigneePriority	String	用于为列表视图中的此类型项目排序的提示。此处概述了此格式。
assignments	plannerAssignments	被分配任务的接受者集合。
bucketId	String	此任务所属的存储桶 id。存储桶需要位于任务所在的计划中。长度为 28 个字符，区分大小写。格式验证在服务上完成。
checklistItemCount	Int32	任务上存在的核对清单项的数目。
completedBy	identitySet	完成任务的用户的身份。
completedDateTime	DateTimeOffset	只读。任务的 'percentComplete' 被设置为 '100' 的日期和时间。时间戳类型表示使用 ISO 8601 格式的日期和时间信息，并且始终处于 UTC 时间。例如，2014 年 1 月 1 日午夜 UTC 如下所示：2014-01-01T00:00:00Z
conversationThreadId	字符串	关于任务的对话的线程 ID。此为在组中创建的对话线程对象的 ID。
createdBy	identitySet	创建任务的用户的身份
createdDateTime	DateTimeOffset	只读。创建任务的日期和时间。时间戳类型表示使用 ISO 8601 格式的日期和时间信息，并且始终处于 UTC 时间。例如，2014 年 1 月 1 日午夜 UTC 如下所示：2014-01-01T00:00:00Z
dueDateTime	DateTimeOffset	任务截止的日期和时间。时间戳类型表示使用 ISO 8601 格式的日期和时间信息，并且始终处于 UTC 时间。例如，2014 年 1 月 1 日午夜 UTC 如下所示：2014-01-01T00:00:00Z
hasDescription	Boolean	只读。如果任务的 details 对象具有非空的说明，则值为 true，否则为 false。
id	String	只读。计划的 ID。长度为 28 个字符，区分大小写。格式验证在服务上完成。
orderHint	String	用于为列表视图中的此类型项目排序的提示。此处概述了此格式。
percentComplete	Int32	任务完成的百分比。当设置为 100 时，任务被视为完成。
priority	Int32	任务优先级。 有效值范围介于 0 和 10之间，优先级与递增数值成反比（0 优先级最高， 10 优先级最低）。 目前，Planner 将值 0 和 1 解释为“紧急”，值 2、3 和 4 为“重要”，值 5、6 和 7 为“中等”，值 8、 9 和 10 为“低”。 此外，Planner 将值 1 设置为“紧急”，值 3 为“重要”，值 5 为“中等”，值 9 为“低”。
planId	String	任务所属的计划 ID。
previewType	String	这将设置显示在任务上的预览类型。可能的值为： automatic、 noPreview、 checklist、 description、 reference。
referenceCount	Int32	任务上存在的外部引用的数量。
startDateTime	DateTimeOffset	任务开始的日期和时间。时间戳类型表示使用 ISO 8601 格式的日期和时间信息，并且始终处于 UTC 时间。例如，2014 年 1 月 1 日午夜 UTC 如下所示：2014-01-01T00:00:00Z
title	String	任务的标题。

关系

关系	类型	说明
assignedToTaskBoardFormat	plannerAssignedToTaskBoardTaskFormat	只读。可为 NULL。用于在按 assignedTo 分组时在任务板视图中正确呈现任务。
bucketTaskBoardFormat	plannerBucketTaskBoardTaskFormat	只读。可为 NULL。用于在按存储桶分组时在任务板视图中正确呈现任务。
详细信息	plannerTaskDetails	只读。可为 NULL。关于任务的其他详细信息。
progressTaskBoardFormat	plannerProgressTaskBoardTaskFormat	只读。可为 NULL。用于在按进度分组时在任务板视图中正确呈现任务。

JSON 表示形式

下面是资源的 JSON 表示形式。

{
  "activeChecklistItemCount": "Int32",
  "appliedCategories": {"@odata.type": "microsoft.graph.plannerAppliedCategories"},
  "assigneePriority": "String",
  "assignments": {"@odata.type": "microsoft.graph.plannerAssignments"},
  "bucketId": "String",
  "checklistItemCount": "Int32",
  "completedBy": {"@odata.type": "microsoft.graph.identitySet"},
  "completedDateTime": "String (timestamp)",
  "conversationThreadId": "String",
  "createdBy": {"@odata.type": "microsoft.graph.identitySet"},
  "createdDateTime": "String (timestamp)",
  "dueDateTime": "String (timestamp)",
  "hasDescription": true,
  "id": "String (identifier)",
  "orderHint": "String",
  "percentComplete": "Int32",
  "priority": "Int32",
  "planId": "String",
  "previewType": "String",
  "referenceCount": "Int32",
  "startDateTime": "String (timestamp)",
  "title": "String"
}