plannerTaskRecurrence-Ressourcentyp

Namespace: microsoft.graph

Wichtig

Die APIs unter der /beta Version in Microsoft Graph können sich ändern. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in v1.0 verfügbar ist, verwenden Sie die Version Selektor.

Stellt die Wiederholung für eine Planner-Aufgabe in Microsoft 365 dar, sodass Clients die Wiederholung für eine Planner-Aufgabe definieren und bearbeiten können. Um die Wiederholung hinzuzufügen oder zu bearbeiten, geben Clients den Zeitplan an. Weitere Informationen finden Sie unter plannerRecurrenceSchedule. Um die Wiederholung abzubrechen, legen Clients denselben Zeitplan auf fest null. Die PlannerTaskRecurrence-Ressource bietet auch vom System generierte und schreibgeschützte Eigenschaften, die zum Nachverfolgen und Verstehen der Wiederholung nützlich sind. Für eine Planner-Aufgabe kann sie nach dem Definieren der Wiederholung nicht auf nullfestgelegt werden. Für Aufgaben, für die noch nie eine Wiederholung definiert wurde, ist nulldie Wiederholung .

Bei einer nicht wiederkehrenden Aufgabe kann ein Client ihn durch Angabe des Zeitplans zu einer wiederkehrenden Aufgabe machen. Wenn der Zeitplan hinzugefügt wird, füllt Planner die Eigenschaften seriesId und occurrenceId sowie andere Eigenschaften auf. Eine occurrenceId von 1 gibt an, dass dies die erste Aufgabe in der Reihe ist. Die zweite Aufgabe in der Reihe weist eine occurrenceId von auf 2. Die seriesId ist eine eindeutige neue Zeichenfolge, die für die erste Aufgabe erstellt wurde. Die zweite Aufgabe und alle zukünftigen Aufgaben in der Reihe erben die seriesId vom ersten Vorgang, was angibt, dass sie Teil derselben serie sind.

Wenn eine Aufgabe mit aktiver Wiederholung als abgeschlossen markiert wird (percentComplete auf 100festgelegt), wird eine neue Aufgabe erstellt, um die Reihe fortzusetzen. Wenn eine Aufgabe mit aktiver Wiederholung gelöscht wird, ohne dass die Wiederholung abgebrochen wird, wird auch eine neue Aufgabe erstellt, um die Reihe fortzusetzen. Wenn die Reihe abgebrochen werden soll, sollte der Zeitplan zuerst auf nullfestgelegt werden, dann kann die Aufgabe gelöscht werden, und die Wiederholung wird beendet.

Weitere Informationen finden Sie unter Konfigurieren der Aufgabenserie in Planner.

Eigenschaften

Eigenschaft	Typ	Beschreibung
nextInSeriesTaskId	Zeichenfolge	Die taskId der nächsten Aufgabe in dieser Reihe. Dieser Wert wird zu dem Zeitpunkt zugewiesen, zu dem die nächste Aufgabe in der Reihe erstellt wird, und liegt null vor diesem Zeitpunkt.
occurrenceId	Int32	Der 1-basierte Index dieser Aufgabe innerhalb der Serienreihe. Die erste Aufgabe in einer Reihe hat den Wert 1, die nächste Aufgabe in der Reihe hat den Wert 2usw.
previousInSeriesTaskId	Zeichenfolge	Die taskId der vorherigen Aufgabe in dieser Reihe. null für die erste Aufgabe in einer Reihe, da sie keinen Vorgänger hat. Alle nachfolgenden Vorgänge in der Reihe verfügen über einen Wert, der ihren Vorgängern entspricht.
recurrenceStartDateTime	DateTimeOffset	Das Datum und die Uhrzeit des Beginns dieser Serie. Für die erste Aufgabe in einer Reihe (occurrenceId = 1) wird dieser Wert aus schedule.patternStartDateTime kopiert. Bei nachfolgenden Vorgängen in der Reihe (occurrenceId>= 2) wird dieser Wert aus der vorherigen Aufgabe kopiert und ändert sich nie. Das Startdatum der serie wird beibehalten. Der Timestamp-Typ stellt die Datums- und Uhrzeitinformationen mithilfe des ISO 8601-Formats dar und wird immer in UTC-Zeit angegeben. Zum Beispiel, Mitternacht UTC am 1. Januar 2014 ist 2014-01-01T00:00:00Z.
Zeitplan	plannerRecurrenceSchedule	Der Zeitplan für die Wiederholung. Clients definieren und bearbeiten die Wiederholung, indem sie den Zeitplan angeben. Wenn nextInSeriesTaskId nicht zugewiesen ist, können Clients die Reihe beenden, indem sie null dieser Eigenschaft zuweisen.
seriesId	Zeichenfolge	Die Serienreihe, zu der diese Aufgabe gehört. Ein GUID-basierter Wert, der als eindeutiger Bezeichner für eine Reihe dient.

Beziehungen

Keine.

JSON-Darstellung

Die folgende JSON-Darstellung zeigt den Ressourcentyp. Beispiele, die diese Ressource enthalten, finden Sie unter Konfigurieren der Aufgabenserie in Planner.

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