Редактировать задачу

Элемент изменяет задачу Planner: название, даты, исполнителей и процент выполнения. Для корректной работы следует поместить элемент в контейнер Microsoft 365.

Свойства

Описание общих свойств элемента см. в разделе Свойства элемента . Символ * в названии свойства указывает на обязательность его заполнения.

Свойство	Тип	Описание
Параметры:
Задача*	PlannerTask	Изменяемая задача
Название	String	Новое название. Если не заполнено — не меняется
Перезаписать адресатов	Boolean	Если включено — исполнители из свойства Адресаты заменяют текущих, иначе добавляются к ним. По умолчанию выключено
Адресаты	List<String>	Идентификаторы пользователей-исполнителей (Object ID из Microsoft Entra ID)
Начало	DateTime	Дата начала задачи
Конец	DateTime	Дата завершения задачи
Завершение	Int32	Процент выполнения: `0` — не начата, `50` — выполняется, `100` — завершена
Результат:
Результат	PlannerTask	Переменная для сохранения измененной задачи

Важно: В свойстве Адресаты указываются идентификаторы пользователей (GUID), а не адреса электронной почты. Идентификатор пользователя указан в Microsoft Entra ID: Users → пользователь → Object ID.

Примечание: Для последующих действий с задачей используйте объект из свойства Результат — исходный объект после изменения устаревает.

Практические примеры

Пример 1: назначение исполнителя и срока

Задача: task
Адресаты: new List<string> { "3f2504e0-4f89-11d3-9a0c-0305e82c3301" }
Конец: DateTime.Today.AddDays(3)
Результат: task

Пример 2: отметка о выполнении

Задача: task
Завершение: 100

Возможные ошибки

Ошибка	Причина и решение
`Не указана задача`	Не заполнено свойство Задача
`PreconditionFailed` / `412`	Задача изменена после получения объекта — получите ее заново элементом Получить задачу
`BadRequest`	В Адресатах указаны адреса почты вместо идентификаторов пользователей