Тип ресурса plannerTask

Статья
03/15/2023

Пространство имен: microsoft.graph

Представляет задачу Планировщик в Microsoft 365. Задача Планировщик содержится в плане и может быть назначена контейнеру в плане. Каждый объект задачи содержит объект details , который может содержать дополнительные сведения о задаче. Дополнительные сведения о связях между группами, планами и задачами см. в статье Использование REST API Планировщик.

Методы

Метод	Возвращаемый тип	Описание
Получение объекта plannerTask	plannerTask	Чтение свойств и отношений объекта plannerTask.
Обновление	plannerTask	Обновление объекта plannerTask.
Удаление	Нет	Удаление объекта plannerTask.

Свойства

Свойство	Тип	Описание
activeChecklistItemCount	Int32	Количество элементов контрольного списка со значением `false`, указывающим, что задача не выполнена.
appliedCategories	plannerAppliedCategories	Категории, к которым применена задача. Возможные значения см. в разделе Примененные категории.
assigneePriority	String	Подсказка, используемая для упорядочивания элементов этого типа в представлении списка. Формат определен так, как описано здесь.
assignments	plannerAssignments	Список исполнителей, которым назначена задача.
bucketId	Строка	Идентификатор сегмента, к которому относится задача. Сегмент должен находиться в том же плане, что и задача. Он содержит 28 символов и учитывает регистр. Проверка формата проводится для службы.
checklistItemCount	Int32	Количество элементов контрольного списка, представленных в задаче.
completedBy	identitySet	Идентификатор пользователя, который выполнил задачу.
completedDateTime	DateTimeOffset	Только для чтения. Дата и время присвоения свойству задачи `'percentComplete'` значения `'100'`. Тип Timestamp представляет сведения о времени и дате с использованием формата ISO 8601 (всегда применяется формат UTC). Например, значение полуночи 1 января 2014 г. в формате UTC: `2014-01-01T00:00:00Z`.
conversationThreadId	Строка	Идентификатор потока беседы в задаче. Это идентификатор объекта потока беседы, созданного в группе.
createdBy	identitySet	Идентификатор пользователя, создавшего задачу.
createdDateTime	DateTimeOffset	Только для чтения. Дата и время создания задачи. Тип Timestamp представляет сведения о времени и дате с использованием формата ISO 8601 (всегда применяется формат UTC). Например, значение полуночи 1 января 2014 г. в формате UTC: `2014-01-01T00:00:00Z`.
dueDateTime	DateTimeOffset	Срок выполнения задачи. Тип Timestamp представляет сведения о времени и дате с использованием формата ISO 8601 (всегда применяется формат UTC). Например, значение полуночи 1 января 2014 г. в формате UTC: `2014-01-01T00:00:00Z`.
hasDescription	Boolean	Только для чтения. Значением является , `true` если объект details задачи имеет непустое описание и `false` в противном случае.
id	String	Только для чтения. Идентификатор задачи. Он содержит 28 символов и учитывает регистр. Проверка формата проводится для службы.
orderHint	String	Подсказка, используемая для упорядочивания элементов этого типа в представлении списка. Формат определен так, как описано здесь.
percentComplete	Int32	Процент завершения задачи. Если задано значение `100`, задача считается завершенной.
planId	Строка	Идентификатор плана, к которому относится задача.
previewType	String	Устанавливает тип предварительного просмотра задачи. Допустимые значения: `automatic`, `noPreview`, `checklist`, `description`, `reference`.
priority	Int32	Приоритет задачи. Допустимый диапазон значений находится между `0` и `10`, при этом возрастающее значение имеет более низкий приоритет (`0` имеет самый высокий приоритет, а `10` имеет самый низкий приоритет). В настоящее время Планировщик интерпретирует значения `0` и `1`как "срочно", `2`,`3` и `4` как "важно", `5`,`6` и `7` как "средние", а `8`,`9` и `10` как "низкие". Кроме того, Планировщик задает значение `1` для "срочно", `3` для "важно", `5` для "средний" и `9` для "низкий".
referenceCount	Int32	Количество внешних ссылок на задачу.
startDateTime	DateTimeOffset	Дата и время начала задачи. Тип Timestamp представляет сведения о времени и дате с использованием формата ISO 8601 (всегда применяется формат UTC). Например, значение полуночи 1 января 2014 г. в формате UTC: `2014-01-01T00:00:00Z`.
title	Строка	Название задачи.

Связи

Связь	Тип	Описание
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"
}