plannerTask 资源类型
命名空间：microsoft.graph
表示 Microsoft 365 中的 Planner 任务。 Planner 任务包含在 计划中 ，可以分配给计划中的 存储桶 。 每个任务对象都有一个 details 对象，该对象可以包含有关该任务的详细信息。 有关组、计划和任务之间的关系的详细信息，请参阅 使用 Planner REST API。
方法
| 方法 | 返回类型 | 说明 |
|---|---|---|
| 创建 | plannerTask | 创建 plannerTask 对象。 |
| Get | 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"
}