Microsoft Planner
Задачи, планы и корзины Microsoft Planner в процессах Pailot
Microsoft Planner — доски задач в Microsoft 365: планы, корзины (buckets) и задачи с чек-листом и ссылками.
С Microsoft Planner в Pailot вы можете:
- Читать задачи пользователя или конкретного плана, создавать и обновлять их
- Удалять задачу (нужен ETag в заголовке If-Match)
- Смотреть планы, доступные пользователю, и карточку плана
- Создавать, читать, переименовывать и удалять корзины
- Читать и менять детали задачи: описание, чек-лист, ссылки
Нужен вход по OAuth (вход по разрешению сервиса) Microsoft 365. Обновление и удаление требуют актуальный ETag (метка версии записи).
Блок ставят на холст как отдельный шаг или прикрепляют к агенту.
Задачи Microsoft Planner: все задачи пользователя или все задачи плана.
| Параметр | Тип | Обязательный | Описание |
|---|
planId | string | Нет | ID плана (если не задан — все задачи пользователя) |
taskId | string | Нет | ID конкретной задачи |
| Параметр | Тип | Описание |
|---|
success | boolean | Удалось ли получить задачи |
tasks | array | Задачи с отфильтрованными свойствами |
metadata | object | Служебные данные: planId, userId и planUrl |
↳ planId | string | ID плана |
↳ userId | string | ID пользователя |
↳ planUrl | string | URL плана в Microsoft Graph API |
Создать задачу в Microsoft Planner.
| Параметр | Тип | Обязательный | Описание |
|---|
planId | string | Да | ID плана |
title | string | Да | Название задачи |
description | string | Нет | Описание |
dueDateTime | string | Нет | Срок в формате ISO 8601 |
assigneeUserId | string | Нет | ID пользователя-исполнителя |
bucketId | string | Нет | ID корзины |
| Параметр | Тип | Описание |
|---|
success | boolean | Удалось ли создать задачу |
task | object | Созданная задача со всеми свойствами |
metadata | object | Служебные данные: planId, taskId и taskUrl |
↳ planId | string | ID родительского плана |
↳ taskId | string | ID созданной задачи |
↳ taskUrl | string | URL задачи в Microsoft Graph API |
Обновить задачу в Microsoft Planner.
| Параметр | Тип | Обязательный | Описание |
|---|
taskId | string | Да | ID задачи |
etag | string | Да | ETag задачи (заголовок If-Match) |
title | string | Нет | Новое название |
bucketId | string | Нет | ID корзины, куда перенести задачу |
dueDateTime | string | Нет | Срок в формате ISO 8601 |
startDateTime | string | Нет | Дата начала в формате ISO 8601 |
percentComplete | number | Нет | Процент выполнения (0–100) |
priority | number | Нет | Приоритет (0–10) |
assigneeUserId | string | Нет | ID пользователя-исполнителя |
| Параметр | Тип | Описание |
|---|
success | boolean | Удалось ли обновить задачу |
message | string | Сообщение об успехе |
task | object | Обновлённая задача со всеми свойствами |
taskId | string | ID обновлённой задачи |
etag | string | Новый ETag — используйте его в следующих операциях |
metadata | object | Служебные данные: taskId, planId и taskUrl |
↳ taskId | string | ID задачи |
↳ planId | string | ID родительского плана |
↳ taskUrl | string | URL задачи в Microsoft Graph API |
Удалить задачу из Microsoft Planner.
| Параметр | Тип | Обязательный | Описание |
|---|
taskId | string | Да | ID задачи |
etag | string | Да | ETag задачи (заголовок If-Match) |
| Параметр | Тип | Описание |
|---|
success | boolean | Удалось ли удалить задачу |
deleted | boolean | Подтверждение удаления |
metadata | object | Дополнительные служебные данные |
Все планы, доступные текущему пользователю.
| Параметр | Тип | Обязательный | Описание |
|---|
| Параметр | Тип | Описание |
|---|
success | boolean | Удалось ли получить планы |
plans | array | Планы, доступные пользователю |
metadata | object | Служебные данные: userId и count |
↳ count | number | Сколько планов вернулось |
↳ userId | string | ID пользователя |
Карточка конкретного плана Microsoft Planner.
| Параметр | Тип | Обязательный | Описание |
|---|
planId | string | Да | ID плана |
| Параметр | Тип | Описание |
|---|
success | boolean | Удалось ли получить план |
plan | object | План со всеми свойствами |
metadata | object | Служебные данные: planId и planUrl |
↳ planId | string | ID плана |
↳ planUrl | string | URL плана в Microsoft Graph API |
Все корзины плана Microsoft Planner.
| Параметр | Тип | Обязательный | Описание |
|---|
planId | string | Да | ID плана |
| Параметр | Тип | Описание |
|---|
success | boolean | Удалось ли получить корзины |
buckets | array | Корзины плана |
metadata | object | Служебные данные: planId и count |
↳ planId | string | ID плана |
↳ count | number | Сколько корзин вернулось |
Карточка конкретной корзины.
| Параметр | Тип | Обязательный | Описание |
|---|
bucketId | string | Да | ID корзины |
| Параметр | Тип | Описание |
|---|
success | boolean | Удалось ли получить корзину |
bucket | object | Корзина со всеми свойствами |
metadata | object | Служебные данные: bucketId и planId |
↳ bucketId | string | ID корзины |
↳ planId | string | ID родительского плана |
Создать корзину в плане Microsoft Planner.
| Параметр | Тип | Обязательный | Описание |
|---|
planId | string | Да | ID плана |
name | string | Да | Название корзины |
| Параметр | Тип | Описание |
|---|
success | boolean | Удалось ли создать корзину |
bucket | object | Созданная корзина со всеми свойствами |
metadata | object | Служебные данные: bucketId и planId |
↳ bucketId | string | ID созданной корзины |
↳ planId | string | ID родительского плана |
Обновить корзину в Microsoft Planner.
| Параметр | Тип | Обязательный | Описание |
|---|
bucketId | string | Да | ID корзины |
name | string | Нет | Новое название |
etag | string | Да | ETag корзины (заголовок If-Match) |
| Параметр | Тип | Описание |
|---|
success | boolean | Удалось ли обновить корзину |
bucket | object | Обновлённая корзина со всеми свойствами |
metadata | object | Служебные данные: bucketId и planId |
↳ bucketId | string | ID корзины |
↳ planId | string | ID родительского плана |
Удалить корзину из Microsoft Planner.
| Параметр | Тип | Обязательный | Описание |
|---|
bucketId | string | Да | ID корзины |
etag | string | Да | ETag корзины (заголовок If-Match) |
| Параметр | Тип | Описание |
|---|
success | boolean | Удалось ли удалить корзину |
deleted | boolean | Подтверждение удаления |
metadata | object | Дополнительные служебные данные |
Подробности задачи: чек-лист и ссылки.
| Параметр | Тип | Обязательный | Описание |
|---|
taskId | string | Да | ID задачи |
| Параметр | Тип | Описание |
|---|
success | boolean | Удалось ли получить детали |
taskDetails | object | Детали: описание, чек-лист и ссылки |
etag | string | ETag деталей — нужен для обновления |
metadata | object | Служебные данные: taskId |
↳ taskId | string | ID задачи |
Обновить детали задачи: описание, пункты чек-листа и ссылки.
| Параметр | Тип | Обязательный | Описание |
|---|
taskId | string | Да | ID задачи |
etag | string | Да | ETag деталей (заголовок If-Match) |
description | string | Нет | Описание задачи |
checklist | object | Нет | Пункты чек-листа — JSON |
references | object | Нет | Ссылки — JSON |
previewType | string | Нет | Тип превью: automatic, noPreview, checklist, description или reference |
| Параметр | Тип | Описание |
|---|
success | boolean | Удалось ли обновить детали |
taskDetails | object | Обновлённые детали со всеми свойствами |
metadata | object | Служебные данные: taskId |
↳ taskId | string | ID задачи |
