Microsoft Planner
Управление задачами, планами и группами в Microsoft Planner
Microsoft Planner — это инструмент управления задачами, который помогает командам визуально организовывать работу с помощью досок, задач и групп. Интегрированный с Microsoft 365, он предлагает простой и интуитивно понятный способ управления командными проектами, назначения обязанностей и отслеживания прогресса.
С помощью Microsoft Planner вы можете:
- Создавать и управлять задачами: Добавлять новые задачи со сроками выполнения, приоритетами и назначенными пользователями
- Организовывать с помощью групп: Группировать задачи по этапам, статусам или категориям, чтобы отразить рабочий процесс вашей команды
- Визуализировать статус проекта: Использовать доски, диаграммы и фильтры для мониторинга рабочей нагрузки и отслеживания прогресса
- Оставаться интегрированным с Microsoft 365: Бесшовно связывать задачи с Teams, Outlook и другими инструментами Microsoft
В AACFlow интеграция с Microsoft Planner позволяет вашим агентам программно создавать, читать и управлять задачами в рамках своих рабочих процессов. Агенты могут генерировать новые задачи на основе входящих запросов, получать детали задач для принятия решений и отслеживать статус по проектам — все без вмешательства человека. Независимо от того, создаете ли вы рабочие процессы для адаптации клиентов, внутреннего отслеживания проектов или генерации задач для последующих действий, интеграция Microsoft Planner с AACFlow дает вашим агентам структурированный способ координации работы, автоматизации создания задач и поддержания согласованности команд.
Интегрируйте Microsoft Planner в рабочий процесс. Управляйте задачами, планами, группами и деталями задач, включая контрольные списки и ссылки.
Чтение задач из Microsoft Planner — получение всех задач пользователя или всех задач из конкретного плана
| Параметр | Тип | Обязательный | Описание |
|---|
planId | string | Нет | ID плана, из которого нужно получить задачи; если не указан, получает все задачи пользователя (например, "xqQg5FS2LkCe54tAMV_v2ZgADW2J") |
taskId | string | Нет | ID задачи для получения (например, "pbT5K2OVkkO1M7r5bfsJ6JgAGD5m") |
| Параметр | Тип | Описание |
|---|
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 плана, в котором будет создана задача (например, "xqQg5FS2LkCe54tAMV_v2ZgADW2J") |
title | string | Да | Заголовок задачи (например, "Просмотр квартального отчета") |
description | string | Нет | Описание задачи |
dueDateTime | string | Нет | Срок выполнения задачи в формате ISO 8601 (например, "2025-03-15T17:00:00Z") |
assigneeUserId | string | Нет | ID пользователя для назначения задачи (например, "e82f74c3-4d8a-4b5c-9f1e-2a6b8c9d0e3f") |
bucketId | string | Нет | ID группы для размещения задачи (например, "hsOf2dhOJkC6Fey9VjDg1JgAC9Rq") |
| Параметр | Тип | Описание |
|---|
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 задачи для обновления (например, "pbT5K2OVkkO1M7r5bfsJ6JgAGD5m") |
etag | string | Да | Значение ETag из задачи для обновления (заголовок If-Match) |
title | string | Нет | Новый заголовок задачи (например, "Просмотр квартального отчета") |
bucketId | string | Нет | ID группы для перемещения задачи (например, "hsOf2dhOJkC6Fey9VjDg1JgAC9Rq") |
dueDateTime | string | Нет | Срок выполнения задачи в формате ISO 8601 (например, "2025-03-15T17:00:00Z") |
startDateTime | string | Нет | Дата и время начала задачи (формат ISO 8601) |
percentComplete | number | Нет | Процент выполнения задачи (0-100) |
priority | number | Нет | Приоритет задачи (0-10) |
assigneeUserId | string | Нет | ID пользователя для назначения задачи (например, "e82f74c3-4d8a-4b5c-9f1e-2a6b8c9d0e3f") |
| Параметр | Тип | Описание |
|---|
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 задачи для удаления (например, "pbT5K2OVkkO1M7r5bfsJ6JgAGD5m") |
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 плана для получения (например, "xqQg5FS2LkCe54tAMV_v2ZgADW2J") |
| Параметр | Тип | Описание |
|---|
success | boolean | Успешно ли получен план |
plan | object | Объект плана со всеми свойствами |
metadata | object | Метаданные, включая planId и planUrl |
↳ planId | string | ID плана |
↳ planUrl | string | URL Microsoft Graph API для плана |
Список всех групп в плане Microsoft Planner
| Параметр | Тип | Обязательный | Описание |
|---|
planId | string | Да | ID плана (например, "xqQg5FS2LkCe54tAMV_v2ZgADW2J") |
| Параметр | Тип | Описание |
|---|
success | boolean | Успешно ли получены группы |
buckets | array | Массив объектов групп |
metadata | object | Метаданные, включая planId и count |
↳ planId | string | ID плана |
↳ count | number | Количество возвращенных групп |
Получение деталей конкретной группы
| Параметр | Тип | Обязательный | Описание |
|---|
bucketId | string | Да | ID группы для получения (например, "hsOf2dhOJkC6Fey9VjDg1JgAC9Rq") |
| Параметр | Тип | Описание |
|---|
success | boolean | Успешно ли получена группа |
bucket | object | Объект группы со всеми свойствами |
metadata | object | Метаданные, включая bucketId и planId |
↳ bucketId | string | ID группы |
↳ planId | string | ID родительского плана |
Создание новой группы в плане Microsoft Planner
| Параметр | Тип | Обязательный | Описание |
|---|
planId | string | Да | ID плана, в котором будет создана группа (например, "xqQg5FS2LkCe54tAMV_v2ZgADW2J") |
name | string | Да | Название группы |
| Параметр | Тип | Описание |
|---|
success | boolean | Успешно ли создана группа |
bucket | object | Созданный объект группы со всеми свойствами |
metadata | object | Метаданные, включая bucketId и planId |
↳ bucketId | string | ID созданной группы |
↳ planId | string | ID родительского плана |
Обновление группы в Microsoft Planner
| Параметр | Тип | Обязательный | Описание |
|---|
bucketId | string | Да | ID группы для обновления (например, "hsOf2dhOJkC6Fey9VjDg1JgAC9Rq") |
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 группы для удаления (например, "hsOf2dhOJkC6Fey9VjDg1JgAC9Rq") |
etag | string | Да | Значение ETag из группы для удаления (заголовок If-Match) |
| Параметр | Тип | Описание |
|---|
success | boolean | Успешно ли удалена группа |
deleted | boolean | Подтверждение удаления |
metadata | object | Дополнительные метаданные |
Получение подробной информации о задаче, включая контрольный список и ссылки
| Параметр | Тип | Обязательный | Описание |
|---|
taskId | string | Да | ID задачи (например, "pbT5K2OVkkO1M7r5bfsJ6JgAGD5m") |
| Параметр | Тип | Описание |
|---|
success | boolean | Успешно ли получены детали задачи |
taskDetails | object | Детали задачи, включая описание, контрольный список и ссылки |
etag | string | Значение ETag для этих деталей задачи — используйте его для операций обновления |
metadata | object | Метаданные, включая taskId |
↳ taskId | string | ID задачи |
Обновление деталей задачи, включая описание, элементы контрольного списка и ссылки в Microsoft Planner
| Параметр | Тип | Обязательный | Описание |
|---|
taskId | string | Да | ID задачи (например, "pbT5K2OVkkO1M7r5bfsJ6JgAGD5m") |
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 задачи |
