Тип ресурса 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"
}