Тип ресурса plannerTaskRecurrence

Пространство имен: microsoft.graph

Важно!

API версии /beta в Microsoft Graph могут быть изменены. Использование этих API в производственных приложениях не поддерживается. Чтобы определить, доступен ли API в версии 1.0, используйте селектор версий.

Представляет повторение для задачи Планировщика в Microsoft 365, позволяя клиентам определять и изменять повторение для задачи Планировщика. Чтобы добавить или изменить повторение, клиенты указывают расписание. Дополнительные сведения см. в разделе plannerRecurrenceSchedule. Чтобы отменить повторение, клиенты устанавливают для одного и того же расписания значение null. Ресурс plannerTaskRecurrence также предоставляет созданные системой свойства и свойства только для чтения, которые полезны для отслеживания и понимания повторений. Для задачи Планировщика после определения повторения ей нельзя присвоить значение null. Для задач, для которых никогда не было определено повторение, повторение имеет значение null.

При использовании неповторяющейся задачи клиент может превратить ее в повторяющуюся задачу, указав расписание. При добавлении расписания Планировщик заполняет свойства seriesId и occurrenceId , а также другие свойства. Параметр occurrenceId1 указывает, что это первая задача в ряде. Вторая задача в серии имеет значение occurrenceId .2 SeriesId — это уникальная новая строка, созданная для первой задачи. Вторая задача и все будущие задачи ряда наследуют seriesId от первой задачи, указывая, что они являются частью одного повторяющегося ряда.

Когда задача с активным повторением помечена как завершенная (для параметра percentComplete задано значение 100), создается новая задача для продолжения ряда. Кроме того, если задача с активным повторением удаляется без отмены повторения, также создается новая задача для продолжения ряда. Если следует прекратить работу рядов, для расписания сначала следует задать nullзначение , а затем задачу можно удалить и повторение остановится.

Дополнительные сведения см . в разделе Настройка повторения задач в Планировщике.

Свойства

Свойство	Тип	Описание
nextInSeriesTaskId	String	TaskId следующей задачи в этом ряду. Это значение присваивается при создании следующей задачи в ряде и до null этого времени.
occurrenceId	Int32	Индекс этой задачи на основе 1 в цикле повторений. Первая задача в ряде имеет значение 1, следующая задача в ряде имеет значение 2и т. д.
previousInSeriesTaskId	String	TaskId предыдущей задачи в этом ряду. null для первой задачи в ряду, так как она не имеет предшественника. Все последующие задачи в серии имеют значение, соответствующее их предшественникам.
recurrenceStartDateTime	DateTimeOffset	Дата и время начала этого ряда повторения. Для первой задачи в ряду (occurrenceId = 1) это значение копируется из schedule.patternStartDateTime. Для последующих задач в ряду (occurrenceId>= 2) это значение копируется из предыдущей задачи и никогда не меняется; оно сохраняет дату начала повторяющегося ряда. Тип Timestamp представляет сведения о времени и дате с использованием формата ISO 8601 (всегда применяется формат UTC). Например, значение полуночи 1 января 2014 г. в формате UTC: 2014-01-01T00:00:00Z.
schedule	plannerRecurrenceSchedule	Расписание повторения. Клиенты определяют и редактируют повторение, указывая расписание. Если параметр nextInSeriesTaskId не назначен, клиенты могут завершить ряд, назначив null этому свойству.
seriesId	String	Ряд повторений, к которому принадлежит эта задача. Значение на основе GUID, которое служит уникальным идентификатором для ряда.

Связи

Отсутствуют.

Представление JSON

В следующем представлении JSON показан тип ресурса. Реальные примеры, которые включают этот ресурс, см. в разделе Настройка повторения задач в Планировщике.

{
  "@odata.type": "#microsoft.graph.plannerTaskRecurrence",
  "nextInSeriesTaskId": "String",
  "occurrenceId": "Int32",
  "previousInSeriesTaskId": "String",
  "recurrenceStartDateTime": "String (timestamp)",
  "schedule": { "@odata.type": "#microsoft.graph.plannerRecurrenceSchedule" },
  "seriesId": "String"
}