Тип ресурса plannerTask

Статья
04/16/2024

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

Важно!

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

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

Методы

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

Свойства

Свойство	Тип	Описание
activeChecklistItemCount	Int32	Количество элементов контрольного списка со значением `false`, представляющее неполные элементы.
appliedCategories	plannerAppliedCategories	Категории, к которым применяется задача. Возможные значения см. в разделе Тип ресурса plannerAppliedCategories .
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	Дата и время выполнения задачи. Тип Timestamp представляет сведения о времени и дате с использованием формата ISO 8601 (всегда применяется формат UTC). Например, значение полуночи 1 января 2014 г. в формате UTC: `2014-01-01T00:00:00Z`.
hasDescription	Boolean	Только для чтения. Это значение имеет значение , `true` если объект details задачи имеет непустое описание. В противном случае.`false`
id	String	Только для чтения. Уникальный идентификатор задачи. Значение этого свойства равно 28 символам и учитывает регистр. Проверка формата проводится для службы.
isOnMyDay	Логический	Логическое значение, указывающее, следует ли отображать эту задачу в представлении MyDay. `true` , чтобы отобразить задачу. В противном случае — `false`значение .
isOnMyDayLastModifiedDate	Date	Только для чтения. Дата добавления задачи в MyDay или удаления из нее.
orderHint	String	Указание, используемое для упорядочивания элементов этого типа в представлении списка. Дополнительные сведения см. в разделе Использование подсказок заказа в Планировщик n.
percentComplete	Int32	Процент завершения задачи. Если задано значение `100`, задача завершается.
priority	Int32	Приоритет задачи. Допустимые значения: между `0` и `10`, включительно. Большие значения указывают на более низкий приоритет. Например, `0` имеет наивысший приоритет и `10` самый низкий приоритет. В настоящее время Планировщик интерпретирует значения `0` и как "срочно", `2` а `3` также `4` как "важный", `5`, `6`и `7` как "средний", а `8`, `9`, и `10` как "низкий`1`". В настоящее время Планировщик задает значение `1` "urgent", `3` "important", `5` "medium" и `9` "low".
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"
}