Planner

Элементы группы Office 365 → Planner предназначены для работы с Microsoft Planner: планами, сегментами (колонками доски) и задачами. Все элементы размещаются внутри контейнера Microsoft 365.

Планы

• Создать план — создание плана в группе Microsoft 365.
• Получить план — получение плана по идентификатору.
• Получить список планов — получение планов группы.

Сегменты

• Создать сегмент — создание сегмента в плане.
• Получить список сегментов — получение сегментов плана.
• Получить задачи сегмента — получение задач сегмента.
• Удалить сегмент — удаление сегмента.

Задачи

• Создать задачу — создание задачи в сегменте.
• Получить задачу — получение задачи по идентификатору.
• Получить задачи — получение всех задач плана.
• Редактировать задачу — изменение названия, сроков, исполнителей и процента выполнения.
• Удалить задачу — удаление задачи.

Необходимые разрешения Microsoft Graph: Tasks.ReadWrite, Group.ReadWrite.All. Подробнее — в разделе Настройка доступа к Microsoft 365.

Структура Planner

Каждый план принадлежит группе Microsoft 365. План состоит из сегментов — колонок доски («К выполнению», «В работе», «Готово»), в сегментах находятся задачи.

Типовая цепочка: Получить группу → Получить список планов → Получить список сегментов → Создать задачу.

Важно: Элементы Редактировать задачу, Удалить задачу и Удалить сегмент принимают только объекты, полученные из Planner другими элементами пакета, — объект содержит отметку версии. Если задачу изменили после получения объекта, получите ее заново элементом Получить задачу.

Свойства объектов