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


Тип ресурса plannerTask

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

Важно!

API версии /beta в Microsoft Graph могут быть изменены. Использование этих API в производственных приложениях не поддерживается. Чтобы определить, доступен ли API в версии 1.0, используйте селектор версий.

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

Методы

Метод Возвращаемый тип Описание
Создание plannerTask; Создайте объект plannerTask .
Получение plannerTask; Чтение свойств и связей объекта plannerTask .
Обновление plannerTask Обновление объекта plannerTask .
удаление; Нет Удаление объекта plannerTask .
Получение дельты Коллекция plannerTask Получение вновь созданных, обновленных или удаленных объектов plannerTask в plannerPlan или назначенных пользователю, выполнившим вход, без необходимости выполнять полное считывание всей коллекции ресурсов.

Свойства

Свойство Тип Описание
activeChecklistItemCount Int32 Количество элементов контрольного списка со значением false, представляющее неполные элементы.
appliedCategories plannerAppliedCategories Категории, к которым применяется задача. Возможные значения см. в разделе Тип ресурса plannerAppliedCategories .
archivalInfo plannerArchivalInfo Только для чтения. Допускается значение null. Содержит сведения о том, кто заархивировали или разархивировали задачу и почему.
assigneePriority String Указание, используемое для упорядочивания элементов этого типа в представлении списка. Дополнительные сведения см. в разделе Использование подсказок заказа в планировщике.
assignments plannerAssignments Список исполнителей, которым назначена задача.
bucketId Строка Идентификатор сегмента, к которому относится задача. Контейнер должен находиться в том же плане, что и задача. Значение свойства 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.
creationSource plannerTaskCreation Сведения о происхождении задачи.
dueDateTime DateTimeOffset Дата и время выполнения задачи. Тип метки времени представляет сведения о дате и времени в формате ISO 8601 и всегда находится в формате UTC. Например, значение полуночи 1 января 2014 г. в формате UTC: 2014-01-01T00:00:00Z.
hasDescription Boolean Только для чтения. Это значение имеет значение , true если объект details задачи имеет непустое описание. В противном случае.false
id String Только для чтения. Уникальный идентификатор задачи. Значение этого свойства равно 28 символам и учитывает регистр. Проверка формата проводится для службы.
isArchived Boolean Только для чтения. Если задано значение true, задача архивируется. Архивная задача доступна только для чтения.
isOnMyDay Логический Указывает, должна ли отображаться эта задача в представлении MyDay. Если trueзадано значение , отображается задача.
isOnMyDayLastModifiedDate Date Только для чтения. Дата добавления задачи в MyDay или удаления из нее.
orderHint String Указание, используемое для упорядочивания элементов этого типа в представлении списка. Дополнительные сведения см. в разделе Использование подсказок заказа в планировщикеn.
percentComplete Int32 Процент завершения задачи. Если задано значение 100, задача завершается.
priority Int32 Приоритет задачи. Допустимые значения: между 0 и 10, включительно. Большие значения указывают на более низкий приоритет. Например, 0 имеет наивысший приоритет и 10 самый низкий приоритет. В настоящее время планировщик интерпретирует значения 0 и 1 как "срочное", 2 и 43 как "важно", 5, 6и 7 как "средний", а 8, 9, и 10 как "низкий". В настоящее время планировщик задает значение 1 "срочно", 3 "важно", 5 "средний" и 9 "низкий".
planId Строка Идентификатор плана, к которому относится задача.
previewType String Тип предварительного просмотра, который отображается в задаче. Возможные значения: automatic, noPreview, checklist, description, reference.
recurrence plannerTaskRecurrence Определяет активное или неактивное повторение для задачи. null значение , если повторение никогда не было определено для задачи.
referenceCount Int32 Количество внешних ссылок на задачу.
specifiedCompletionRequirements plannerTaskCompletionRequirements Указывает все требования, указанные в plannerTask. Возможные значения: none, checklistCompletion, unknownFutureValue, formCompletion, approvalCompletion. Только для чтения. Чтобы получить следующие значения в этой развиваемой перечислении, необходимо использовать Prefer: include-unknown-enum-members заголовок запроса: formCompletion, approvalCompletion. PlannerTaskCompletionRequirementDetails в plannerTaskDetails содержит подробные сведения об указанных требованиях, если таковые имеются.
startDateTime DateTimeOffset Дата и время начала задачи. Тип Timestamp представляет сведения о времени и дате с использованием формата ISO 8601 (всегда применяется формат UTC). Например, значение полуночи 1 января 2014 г. в формате UTC: 2014-01-01T00:00:00Z.
title Строка Название задачи.

значения plannerTaskCompletionRequirements

Member Описание
none Нет обязательных требований.
checklistCompletion Необходимо проверить некоторые или все элементы контрольного списка.
unknownFutureValue Изменяемое значение перечисления sentinel. Не используйте.
formCompletion Для выполнения задачи планировщика необходимо отправить некоторые или все формы.
approvalCompletion Требуется утверждение.

Связи

Связь Тип Описание
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)",
  "isOnMyDay": "Boolean",
  "isOnMyDayLastModifiedDate": "Date",
  "orderHint": "String",
  "percentComplete": "Int32",
  "planId": "String",
  "previewType": "String",
  "priority": "Int32",
  "recurrence": {"@odata.type": "microsoft.graph.plannerTaskRecurrence"},
  "referenceCount": "Int32",
  "specifiedCompletionRequirements": "String",
  "startDateTime": "String (timestamp)",
  "title": "String"
}