plannerTask 资源类型

命名空间：microsoft.graph

表示 Microsoft 365 中的Planner任务。 Planner任务包含在计划中，可以分配给计划中的存储桶。 每个任务对象都有一个 details 对象，该对象可以包含有关该任务的详细信息。 有关组、计划和任务之间的关系的详细信息，请参阅使用Planner REST API。

方法

方法	返回类型	说明
获取 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	此为只读属性。 true如果任务的 details 对象具有非空说明false，则值为 ，否则为 。
id	String	只读。 任务的 ID。 长度为 28 个字符，区分大小写。 格式验证在服务上完成。
orderHint	String	用于在列表视图中对此类项进行排序的提示。 格式的定义如下所述。
percentComplete	Int32	任务完成百分比。 100设置为 时，任务被视为已完成。
planId	String	任务所属的计划 ID。
previewType	String	这将设置显示在任务上的预览类型。 可能的值包括 automatic、noPreview、checklist、description、reference。
priority	Int32	任务优先级。 有效值范围介于 0 和 10之间，优先级与递增数值成反比（0 优先级最高， 10 优先级最低）。 目前，Planner 将值 0 和 1 解释为“紧急”，值 2、3 和 4 为“重要”，值 5、6 和 7 为“中等”，值 8、 9 和 10 为“低”。 此外，Planner 将值 1 设置为“紧急”，值 3 为“重要”，值 5 为“中等”，值 9 为“低”。
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": "Boolean",
  "id": "String (identifier)",
  "orderHint": "String",
  "percentComplete": "Int32",
  "priority": "Int32",
  "planId": "String",
  "previewType": "String",
  "referenceCount": "Int32",
  "startDateTime": "String (timestamp)",
  "title": "String"
}