plannerTask 资源类型plannerTask resource type

plannerTask 资源表示 Office 365 中的规划器任务。规划器任务包含在计划内,可以分配给计划中的存储桶。每个任务对象具有可以包含此任务的更多信息的 details 对象。请参阅概述了解有关组、计划和任务之间的关系的详细信息。The plannerTask resource represents a Planner task in Office 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,否则为 falseRead-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. 可能的值包括 automaticnoPreviewchecklistdescriptionreferenceThe 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"
}