Feedback Bearbeiten

Vorgangsressourcentyp (veraltet)

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

Achtung

Der auf baseTask basierende Aufgaben-API-Satz ist ab dem 31. Mai 2022 veraltet und gibt am 31. August 2022 keine Daten mehr zurück. Verwenden Sie den API-Satz, der auf todoTask basiert.

Stellt eine Aufgabe dar, z. B. eine Arbeit oder ein persönliches Element, die nachverfolgt und abgeschlossen werden kann. Eine Aufgabe ist immer in einer Basisaufgabenliste enthalten.

Diese Ressource unterstützt Folgendes:

Erbt von baseTask.

Methoden

Methode Rückgabetyp Beschreibung
Aufgaben auflisten task-Sammlung Dient zum Abrufen einer Liste der Aufgabenobjekte und deren Eigenschaften.
Aufgabe abrufen task Lesen sie die Eigenschaften und Beziehungen eines Aufgabenobjekts .
Aufgabe aktualisieren task Dient zum Aktualisieren der Eigenschaften eines Aufgabenobjekts .
Aufgabe löschen Keine Löscht ein Aufgabenobjekt .
move baseTask Verschieben Sie die Nachricht in eine andere Liste.
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_v2 Sammlung Rufen Sie die linkedResource_v2 Ressourcen aus der linkedResources-Navigationseigenschaft ab.
linkedResource erstellen linkedResource_v2 Erstellen Sie ein neues linkedResource_v2-Objekt.

Eigenschaften

Eigenschaft Typ Beschreibung
textbody itemBody Der Aufgabentext im Textformat, der in der Regel Informationen zu der Aufgabe enthält. Geerbt von baseTask.
bodyLastModifiedDateTime 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". Geerbt von baseTask.
completedDateTime DateTimeOffset Das Datum, an dem der Vorgang abgeschlossen wurde. Geerbt von baseTask.
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". Geerbt von baseTask.
displayName Zeichenfolge Der Name des Tasks. Geerbt von baseTask.
dueDateTime dateTimeTimeZone Das Datum in der angegebenen Zeitzone, in der die Aufgabe abgeschlossen werden soll. Geerbt von baseTask.
id Zeichenfolge Eindeutiger Bezeichner des Vorgangs. Standardmäßig ändert sich dieser Wert nicht, wenn eine Aufgabe von einer Liste in eine andere verschoben wird. Geerbt von baseTask.
Wichtigkeit Wichtigkeit Die Bedeutung der Aufgabe. Mögliche Werte sind: low, normal und high. Geerbt von baseTask. Die möglichen Werte sind: low, normal, high.
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". Geerbt von baseTask.
Sicht taskViewpoint Eigenschaften, die für einen Benutzer persönlich sind, z. B . reminderDateTime und Kategorien. Geerbt von baseTask.
recurrence patternedRecurrence Das Serienmuster für die Aufgabe. Geerbt von baseTask.
startDateTime dateTimeTimeZone Das Datum in der angegebenen Zeitzone, an dem die Aufgabe begonnen werden soll. Geerbt von baseTask.
status taskStatus_v2 Gibt den Status oder den Fortschritt der Aufgabe an. Mögliche Werte sind: notStarted, inProgress, completed,unknownFutureValue. Geerbt von baseTask.

Beziehungen

Beziehung Typ Beschreibung
checklistItems checklistItem-Sammlung Eine Sammlung von checklistItems, die mit einer Aufgabe verknüpft sind. Geerbt von baseTask
Erweiterungen extension-Sammlung Die Sammlung der für die Aufgabe definierten offenen Erweiterungen. Geerbt von baseTask
linkedResources linkedResource_v2 Sammlung Eine Sammlung von Ressourcen, die mit dem Vorgang verknüpft sind. Geerbt von baseTask
parentList baseTaskList Die Liste, die die Aufgabe enthält. Geerbt von baseTask

JSON-Darstellung

Es folgt eine JSON-Darstellung der Ressource.

{
  "@odata.type": "#microsoft.graph.task",
  "textBody": "String",
  "createdDateTime": "String (timestamp)",
  "lastModifiedDateTime": "String (timestamp)",
  "bodyLastModifiedDateTime": "String (timestamp)",
  "completedDateTime": "String (timestamp)",
  "dueDateTime": {
    "@odata.type": "microsoft.graph.dateTimeTimeZone"
  },
  "startDateTime": {
    "@odata.type": "microsoft.graph.dateTimeTimeZone"
  },
  "importance": "String",
  "recurrence": {
    "@odata.type": "microsoft.graph.patternedRecurrence"
  },
  "displayName": "String",
  "status": "String",
  "viewpoint": {
    "@odata.type": "microsoft.graph.taskViewpoint"
  },
  "id": "String (identifier)"
}