Freigeben über


todoTask-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.

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:

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 kleinerer Teilvorgänge, die mit der komplexeren übergeordneten 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"
  },
  "startDateTime": {
    "@odata.type": "microsoft.graph.dateTimeTimeZone"
  },
  "status": "String",
  "title": "String",
  "createdDateTime": "String (timestamp)",
  "lastModifiedDateTime": "String (timestamp)",
  "bodyLastModifiedDateTime": "String (timestamp)"
}