Bearbeiten

todoTask-Ressourcentyp

  • Artikel
  • 3 Minuten Lesedauer

Namespace: microsoft.graph

Wichtig

APIs unter der /beta Version in Microsoft Graph können geändert werden. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in Version 1.0 verfügbar ist, verwenden Sie die Versionsauswahl .

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

Ein todoTask ist immer in einer todoTaskList enthalten. Es enthält eine Beziehung zu einer Auflistung von linkedResource-Objekten , die eine oder mehrere Quellen der Aufgabe nachverfolgt.

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-Objekts in der angegebenen Aufgabenliste
Aufgabe abrufen todoTask Lesen sie die Eigenschaften und Beziehungen eines todoTask-Objekts .
Aufgabe aktualisieren todoTask Dient zum Aktualisieren der 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-Auflistung Rufen Sie die linkedResources aus der linkedResources-Navigationseigenschaft ab.
linkedResources erstellen Linkedresource Erstellen Sie ein neues linkedResources-Objekt.

Eigenschaften

Eigenschaft Typ Beschreibung
body itemBody Der Aufgabentext, der in der Regel Informationen zu der Aufgabe enthält.
bodyLastModifiedDateTime DateTimeOffset Datum und 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 in der angegebenen Zeitzone, an dem 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 in der angegebenen Zeitzone, in der die Aufgabe abgeschlossen werden soll.
hasAttachments Boolean 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 Bedeutung 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 Datum und Uhrzeit für eine Erinnerung der Aufgabe.
startDateTime dateTimeTimeZone Das Datum in der angegebenen Zeitzone, in der der Vorgang 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 Sammlung von Dateianlagen für die Aufgabe.
checklistItems checklistItem-Sammlung Eine Sammlung kleinerer Teilvorgänge, die mit der komplexeren übergeordneten Aufgabe verknüpft sind.
Erweiterungen extension-Sammlung Die Sammlung der für die Aufgabe definierten offenen Erweiterungen. Nullwerte zulassend.
linkedResources linkedResource-Auflistung Eine Sammlung von Ressourcen, die mit dem Vorgang verknüpft sind.

JSON-Darstellung

Es folgt eine JSON-Darstellung der Ressource.

{
  "@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)"
}