plannerTask 资源类型plannerTask resource type
命名空间：microsoft.graphNamespace: microsoft.graph
plannerTask 资源表示 Microsoft 365 中的规划器任务。规划器任务包含在计划内，可以分配给计划中的存储桶。每个任务对象具有可以包含此任务的更多信息的 details 对象。请参阅概述了解有关组、计划和任务之间的关系的详细信息。The plannerTask resource represents a Planner task in Microsoft 365. A Planner task is contained in a plan and can be assigned to a bucket in a plan. Each task object has a details object which can contain more information about the task. See overview for more information regarding relationships between group, plan and task.
方法Methods
| 方法Method | 返回类型Return Type | 说明Description |
|---|---|---|
| 获取 plannerTaskGet plannerTask | plannerTaskplannerTask | 读取 plannerTask 对象的属性和关系。Read properties and relationships of plannerTask object. |
| 更新Update | plannerTaskplannerTask | 更新 plannerTask 对象。Update plannerTask object. |
| 删除Delete | 无None | 删除 plannerTask 对象。Delete plannerTask object. |
属性Properties
| 属性Property | 类型Type | 说明Description |
|---|---|---|
| activeChecklistItemCountactiveChecklistItemCount | Int32Int32 | 核对清单项的数量，其值设置为 false，表示项目不全。Number of checklist items with value set to false, representing incomplete items. |
| appliedCategoriesappliedCategories | plannerAppliedCategoriesplannerAppliedCategories | 此任务已应用的类别。有关可能的值，请参阅已应用的类别。The categories to which the task has been applied. See applied Categories for possible values. |
| assigneePriorityassigneePriority | StringString | 用于为列表视图中的此类型项目排序的提示。此处概述了此格式。Hint used to order items of this type in a list view. The format is defined as outlined here. |
| assignmentsassignments | plannerAssignmentsplannerAssignments | 被分配任务的接受者集合。The set of assignees the task is assigned to. |
| bucketIdbucketId | StringString | 此任务所属的存储桶 ID。Bucket ID to which the task belongs. 存储桶需要位于任务所在的计划中。The bucket needs to be in the plan that the task is in. 长度为 28 个字符，区分大小写。It is 28 characters long and case-sensitive. 格式验证在服务上完成。Format validation is done on the service. |
| checklistItemCountchecklistItemCount | Int32Int32 | 任务上存在的核对清单项的数目。Number of checklist items that are present on the task. |
| completedBycompletedBy | identitySetidentitySet | 完成任务的用户的身份。Identity of the user that completed the task. |
| completedDateTimecompletedDateTime | DateTimeOffsetDateTimeOffset | 只读。任务的 'percentComplete' 被设置为 '100' 的日期和时间。时间戳类型表示使用 ISO 8601 格式的日期和时间信息，并且始终处于 UTC 时间。例如，2014 年 1 月 1 日午夜 UTC 如下所示：'2014-01-01T00:00:00Z'Read-only. Date and time at which the 'percentComplete' of the task is set to '100'. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z' |
| conversationThreadIdconversationThreadId | 字符串String | 关于任务的对话的线程 ID。此为在组中创建的对话线程对象的 ID。Thread ID of the conversation on the task. This is the ID of the conversation thread object created in the group. |
| createdBycreatedBy | identitySetidentitySet | 创建任务的用户的身份Identity of the user that created the task. |
| createdDateTimecreatedDateTime | DateTimeOffsetDateTimeOffset | 只读。创建任务的日期和时间。时间戳类型表示使用 ISO 8601 格式的日期和时间信息，并且始终处于 UTC 时间。例如，2014 年 1 月 1 日午夜 UTC 如下所示：'2014-01-01T00:00:00Z'Read-only. Date and time at which the task is created. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z' |
| dueDateTimedueDateTime | DateTimeOffsetDateTimeOffset | 任务截止的日期和时间。时间戳类型表示使用 ISO 8601 格式的日期和时间信息，并且始终处于 UTC 时间。例如，2014 年 1 月 1 日午夜 UTC 如下所示：'2014-01-01T00:00:00Z'Date and time at which the task is due. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z' |
| hasDescriptionhasDescription | BooleanBoolean | 只读。如果任务的 details 对象具有非空的说明，则值为 true，否则为 false。Read-only. Value is true if the details object of the task has a non-empty description and false otherwise. |
| idid | StringString | 只读。Read-only. 任务的 ID。ID of the task. 长度为 28 个字符，区分大小写。It is 28 characters long and case-sensitive. 格式验证在服务上完成。Format validation is done on the service. |
| orderHintorderHint | StringString | 用于为列表视图中的此类型项目排序的提示。此处概述了此格式。Hint used to order items of this type in a list view. The format is defined as outlined here. |
| percentCompletepercentComplete | Int32Int32 | 任务完成的百分比。当设置为 100 时，任务被视为完成。Percentage of task completion. When set to 100, the task is considered completed. |
| planIdplanId | StringString | 任务所属的计划 ID。Plan ID to which the task belongs. |
| previewTypepreviewType | StringString | 这将设置显示在任务上的预览类型。This sets the type of preview that shows up on the task. 可能的值包括 automatic、noPreview、checklist、description、reference。The possible values are: automatic, noPreview, checklist, description, reference. |
| referenceCountreferenceCount | Int32Int32 | 任务上存在的外部引用的数量。Number of external references that exist on the task. |
| startDateTimestartDateTime | DateTimeOffsetDateTimeOffset | 任务开始的日期和时间。时间戳类型表示使用 ISO 8601 格式的日期和时间信息，并且始终处于 UTC 时间。例如，2014 年 1 月 1 日午夜 UTC 如下所示：'2014-01-01T00:00:00Z'Date and time at which the task starts. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z' |
| titletitle | StringString | 任务的标题。Title of the task. |
关系Relationships
| 关系Relationship | 类型Type | 说明Description |
|---|---|---|
| assignedToTaskBoardFormatassignedToTaskBoardFormat | plannerAssignedToTaskBoardTaskFormatplannerAssignedToTaskBoardTaskFormat | 只读。可为 NULL。用于在按 assignedTo 分组时在任务板视图中正确呈现任务。Read-only. Nullable. Used to render the task correctly in the task board view when grouped by assignedTo. |
| bucketTaskBoardFormatbucketTaskBoardFormat | plannerBucketTaskBoardTaskFormatplannerBucketTaskBoardTaskFormat | 只读。可为 NULL。用于在按存储桶分组时在任务板视图中正确呈现任务。Read-only. Nullable. Used to render the task correctly in the task board view when grouped by bucket. |
| 详细信息details | plannerTaskDetailsplannerTaskDetails | 只读。可为 NULL。关于任务的其他详细信息。Read-only. Nullable. Additional details about the task. |
| progressTaskBoardFormatprogressTaskBoardFormat | plannerProgressTaskBoardTaskFormatplannerProgressTaskBoardTaskFormat | 只读。可为 NULL。用于在按进度分组时在任务板视图中正确呈现任务。Read-only. Nullable. Used to render the task correctly in the task board view when grouped by progress. |
JSON 表示形式JSON representation
下面是资源的 JSON 表示形式。Here is a JSON representation of the resource.
{
"activeChecklistItemCount": 1024,
"appliedCategories": {"@odata.type": "microsoft.graph.plannerAppliedCategories"},
"assigneePriority": "String",
"assignments": {"@odata.type": "microsoft.graph.plannerAssignments"},
"bucketId": "String",
"checklistItemCount": 1024,
"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": 1024,
"planId": "String",
"previewType": "String",
"referenceCount": 1024,
"startDateTime": "String (timestamp)",
"title": "String"
}