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:
- Hinzufügen ihrer Daten als benutzerdefinierte Eigenschaften in geöffneten Erweiterungen.
- Abonnieren von Änderungsbenachrichtigungen.
- 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 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)"
}