todoTask-Ressourcentyp

Namespace: microsoft.graph

Ein todoTask stellt eine Aufgabe dar, z. B. ein Arbeitselement oder ein persönliches Element, das nachverfolgt und abgeschlossen werden kann.

TodoTask ist immer in einer todoTaskList enthalten. Sie enthält eine Beziehung zu einer Auflistung von linkedResource-Objekten und verfolgt eine oder mehrere Quellen der Aufgabe nach.

Diese Ressource unterstützt Folgendes:

• Hinzufügen ihrer Daten als benutzerdefinierte Eigenschaften in geöffneten Erweiterungen.
• Verwenden von Deltaabfragen zum Nachverfolgen von inkrementellen Ergänzungen, Löschungen und Updates.

Methoden

Methode	Rückgabetyp	Beschreibung
Aufgaben auflisten	todoTask-Sammlung	Rufen Sie alle todoTask-Ressourcen in der angegebenen Liste ab.
Aufgabe erstellen	todoTask	Erstellen eines todoTask in der angegebenen Aufgabenliste
Aufgabe abrufen	todoTask	Liest die Eigenschaften und Beziehungen eines todoTask-Objekts .
Aufgabe aktualisieren	todoTask	Aktualisieren sie die Eigenschaften eines todoTask-Objekts .
Aufgabe löschen	Keine	Löscht ein todoTask-Objekt .
ChecklistItems auflisten	checklistItem-Sammlung	Rufen Sie die checklistItem-Ressourcen aus der checklistItems-Navigationseigenschaft ab.
ChecklistItem erstellen	checklistItem	Erstellen Sie ein neues checklistItem-Objekt .
LinkedResources auflisten	linkedResource-Sammlung	Rufen Sie die linkedResources aus der linkedResources-Navigationseigenschaft ab.
Erstellen von linkedResources	linkedResource	Erstellen Sie ein neues linkedResources-Objekt.

Eigenschaften

Eigenschaft	Typ	Beschreibung
Text	itemBody	Der Aufgabentext, der in der Regel Informationen zu der Aufgabe enthält.
bodyLastModifiedDateTime	DateTimeOffset	Das Datum und die Uhrzeit der letzten Änderung des Aufgabentexts. Die Standardeinstellung ist UTC. Sie können eine benutzerdefinierte Zeitzone im Anforderungsheader bereitstellen. Der Eigenschaftswert verwendet das ISO 8601-Format, und die Angabe erfolgt immer in UTC-Zeit. Mitternacht UTC am 1. Januar 2020 würde beispielsweise wie folgt aussehen: '2020-01-01T00:00:00Z'.
categories	Zeichenfolgenauflistung	Die Kategorien, die mit der Aufgabe verknüpft sind. Jede Kategorie entspricht der displayName-Eigenschaft einer vom Benutzer definierten outlookCategory.
completedDateTime	dateTimeTimeZone	Das Datum und die Uhrzeit in der angegebenen Zeitzone, zu der die Aufgabe abgeschlossen wurde.
createdDateTime	DateTimeOffset	Das Datum und die Uhrzeit der Erstellung der Aufgabe. Die Standardeinstellung ist UTC. Sie können eine benutzerdefinierte Zeitzone im Anforderungsheader bereitstellen. Der Wert der Eigenschaft verwendet das ISO 8601-Format. Mitternacht UTC am 1. Januar 2020 würde beispielsweise wie folgt aussehen: '2020-01-01T00:00:00Z'.
dueDateTime	dateTimeTimeZone	Das Datum und die Uhrzeit in der angegebenen Zeitzone, zu der die Aufgabe abgeschlossen werden soll.
hasAttachments	Boolescher Wert	Gibt an, ob die Aufgabe Anlagen enthält.
id	Zeichenfolge	Eindeutiger Bezeichner des Vorgangs. Standardmäßig ändert sich dieser Wert, wenn das Element von einer Liste in eine andere verschoben wird.
Wichtigkeit	Wichtigkeit	Die Wichtigkeit der Aufgabe. Mögliche Werte sind: low, normal und high.
isReminderOn	Boolescher Wert	„true“, wenn eingestellt ist, dass der Benutzer an die Aufgabe erinnert werden soll.
lastModifiedDateTime	DateTimeOffset	Datum und Uhrzeit der letzten Änderung der Aufgabe. Die Standardeinstellung ist UTC. Sie können eine benutzerdefinierte Zeitzone im Anforderungsheader bereitstellen. Der Eigenschaftswert verwendet das ISO 8601-Format, und die Angabe erfolgt immer in UTC-Zeit. Mitternacht UTC am 1. Januar 2020 würde beispielsweise wie folgt aussehen: '2020-01-01T00:00:00Z'.
recurrence	patternedRecurrence	Das Serienmuster für die Aufgabe.
reminderDateTime	dateTimeTimeZone	Das Datum und die Uhrzeit in der angegebenen Zeitzone für eine Erinnerungswarnung für die Aufgabe, die ausgeführt werden soll.
startDateTime	dateTimeTimeZone	Das Datum und die Uhrzeit in der angegebenen Zeitzone, an der der Task gestartet werden soll.
status	taskStatus	Gibt den Status oder den Fortschritt der Aufgabe an. Mögliche Werte: notStarted, inProgress, completed, waitingOnOthers, deferred.
title	String	Eine kurze Beschreibung der Aufgabe.

Beziehungen

Beziehung	Typ	Beschreibung
Anlagen	taskFileAttachment-Auflistung	Eine Auflistung von Dateianlagen für die Aufgabe.
checklistItems	checklistItem-Sammlung	Eine Auflistung von checklistItems, die mit einer Aufgabe verknüpft sind.
Erweiterungen	extension-Sammlung	Die Auflistung der für den Task definierten offenen Erweiterungen. Nullwerte zulassend.
linkedResources	linkedResource-Sammlung	Eine Sammlung von Ressourcen, die mit der Aufgabe verknüpft sind.

JSON-Darstellung

Die folgende JSON-Darstellung zeigt den Ressourcentyp.

{
  "@odata.type": "#microsoft.graph.todoTask",
  "id": "String (identifier)",
  "body": {
    "@odata.type": "microsoft.graph.itemBody"
  },
  "categories": ["string"],
  "completedDateTime": {
    "@odata.type": "microsoft.graph.dateTimeTimeZone"
  },
  "dueDateTime": {
    "@odata.type": "microsoft.graph.dateTimeTimeZone"
  },
  "importance": "String",
  "isReminderOn": "Boolean",
  "recurrence": {
    "@odata.type": "microsoft.graph.patternedRecurrence"
  },
  "reminderDateTime": {
    "@odata.type": "microsoft.graph.dateTimeTimeZone"
  },
  "status": "String",
  "title": "String",
  "createdDateTime": "String (timestamp)",
  "lastModifiedDateTime": "String (timestamp)",
  "bodyLastModifiedDateTime": "String (timestamp)"
}