Поделиться через


Тип ресурса plannerTask

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

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

Методы

Метод Возвращаемый тип Описание
Создание plannerTask; Создайте объект 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"
}