plannerTask-Ressourcentyp
Namespace: microsoft.graph
Stellt eine Planner-Aufgabe in Microsoft 365 dar. Eine Planner-Aufgabe ist in einem Plan enthalten und kann einem Bucket in einem Plan zugewiesen werden. Jedes Aufgabenobjekt verfügt über ein Detailobjekt , das weitere Informationen zur Aufgabe enthalten kann. Weitere Informationen zu Beziehungen zwischen Gruppe, Plan und Aufgabe finden Sie unter Verwenden der Planner-REST-API.
Methoden
| Methode | Rückgabetyp | Beschreibung |
|---|---|---|
| Create | plannerTask | Erstellen Sie das plannerTask-Objekt . |
| Get | plannerTask | Dient zum Lesen der Eigenschaften und Beziehungen eines plannerTask-Objekts. |
| Aktualisieren | plannerTask | Dient zum Aktualisieren des plannerTask-Objekts. |
| Löschen | Keine | Dient zum Löschen des plannerTask-Objekts. |
Eigenschaften
| Eigenschaft | Typ | Beschreibung |
|---|---|---|
| activeChecklistItemCount | Int32 | Anzahl der Prüflistenelemente, deren Wert auf false festgelegt ist, was unvollständige Elemente darstellt. |
| appliedCategories | plannerAppliedCategories | Die Kategorien, auf die die Aufgabe angewendet wurde. Mögliche Werte finden Sie unter Angewendete Kategorien . |
| assigneePriority | Zeichenfolge | Hinweis, der verwendet wird, um Elemente dieses Typs in einer Listenansicht zu sortieren. Das Format ist wie hier beschrieben definiert. |
| assignments | plannerAssignments | Der Satz von zugewiesenen Personen, denen die Aufgabe zugewiesen wurde. |
| bucketId | String | Bucket-ID, zu der die Aufgabe gehört. Der Bucket muss in dem Plan enthalten sein, in dem sich die Aufgabe befindet. Es ist 28 Zeichen lang, wobei die Groß-/Kleinschreibung beachtet wird. Für den Dienst wird eine Formatüberprüfung durchgeführt. |
| checklistItemCount | Int32 | Anzahl der Prüflistenelemente, die für die Aufgabe vorhanden sind. |
| completedBy | identitySet | Die Identität des Benutzers, der die Aufgabe abgeschlossen hat. |
| completedDateTime | DateTimeOffset | Schreibgeschützt. Datum und Uhrzeit, zu dem bzw. der die 'percentComplete' der Aufgabe auf '100' festgelegt ist. Der Timestamp-Typ stellt die Datums- und Uhrzeitinformationen mithilfe des ISO 8601-Formats dar und wird immer in UTC-Zeit angegeben. Zum Beispiel, Mitternacht UTC am 1. Januar 2014 ist 2014-01-01T00:00:00Z |
| conversationThreadId | Zeichenfolge | Thread-ID der Konversation für die Aufgabe. Dies ist die ID des Konversationsthreadobjekts, das in der Gruppe erstellt wurde. |
| createdBy | identitySet | Die Identität des Benutzers, der die Aufgabe erstellt hat. |
| createdDateTime | DateTimeOffset | Schreibgeschützt. Datum und Uhrzeit der Erstellung der Aufgabe. Der Timestamp-Typ stellt die Datums- und Uhrzeitinformationen mithilfe des ISO 8601-Formats dar und wird immer in UTC-Zeit angegeben. Zum Beispiel, Mitternacht UTC am 1. Januar 2014 ist 2014-01-01T00:00:00Z |
| dueDateTime | DateTimeOffset | Datum und Uhrzeit der Fälligkeit der Aufgabe. Der Timestamp-Typ stellt die Datums- und Uhrzeitinformationen mithilfe des ISO 8601-Formats dar und wird immer in UTC-Zeit angegeben. Zum Beispiel, Mitternacht UTC am 1. Januar 2014 ist 2014-01-01T00:00:00Z |
| hasDescription | Boolescher Wert | Schreibgeschützt. Der Wert ist true , wenn das Detailobjekt des Vorgangs eine nicht leere Beschreibung aufweist und andernfalls false . |
| id | Zeichenfolge | Schreibgeschützt. ID der Aufgabe. Es ist 28 Zeichen lang, wobei die Groß-/Kleinschreibung beachtet wird. Für den Dienst wird eine Formatüberprüfung durchgeführt. |
| orderHint | Zeichenfolge | Hinweis, der verwendet wird, um Elemente dieses Typs in einer Listenansicht zu sortieren. Das Format ist wie hier beschrieben definiert. |
| percentComplete | Int32 | Prozentsatz des Vorgangsabschlusses. Wenn diese Einstellung auf 100festgelegt ist, gilt die Aufgabe als abgeschlossen. |
| planId | String | Plan-ID, zu der die Aufgabe gehört. |
| previewType | Zeichenfolge | Hierdurch wird der Typ der Vorschau festgelegt, die für die Aufgabe angezeigt wird. Mögliche Werte sind: automatic, noPreview, checklist, description, reference. |
| Priorität | Int32 | Priorität der Aufgabe. Der gültige Wertebereich liegt zwischen 0 und 10, wobei ein steigender Wert eine niedrigere Priorität hat (0 hat die höchste Priorität und 10 die niedrigste Priorität). Derzeit interpretiert Planner die Werte 0 und 1 als „dringend“, 2, 3 und 4 als „wichtig“, 5, 6 und 7 als „mittel“, und 8, 9 und 10 als „tief“. Darüber hinaus legt Planner den Wert 1 als „dringend“, 3 als „wichtig“, 5 als „mittel“ und 9 als „tief“ fest. |
| referenceCount | Int32 | Anzahl externer Bezüge, die für die Aufgabe vorhanden sind. |
| startDateTime | DateTimeOffset | Datum und Uhrzeit des Aufgabenbeginns. Der Timestamp-Typ stellt die Datums- und Uhrzeitinformationen mithilfe des ISO 8601-Formats dar und wird immer in UTC-Zeit angegeben. Zum Beispiel, Mitternacht UTC am 1. Januar 2014 ist 2014-01-01T00:00:00Z |
| title | String | Titel der Aufgabe. |
Beziehungen
| Beziehung | Typ | Beschreibung |
|---|---|---|
| assignedToTaskBoardFormat | plannerAssignedToTaskBoardTaskFormat | Schreibgeschützt. Nullwerte zulassend. Wird verwendet, um die Aufgabe ordnungsgemäß in der Taskboardansicht zu rendern, wenn sie nach assignedTo gruppiert ist. |
| bucketTaskBoardFormat | plannerBucketTaskBoardTaskFormat | Schreibgeschützt. Nullwerte zulassend. Wird verwendet, um die Aufgabe ordnungsgemäß in der Taskboardansicht zu rendern, wenn sie nach Bucket gruppiert ist. |
| Details | plannerTaskDetails | Schreibgeschützt. Nullwerte zulassend. Weitere Details zur Aufgabe. |
| progressTaskBoardFormat | plannerProgressTaskBoardTaskFormat | Schreibgeschützt. Nullwerte zulassend. Wird verwendet, um die Aufgabe ordnungsgemäß in der Taskboardansicht zu rendern, wenn sie nach Fortschritt gruppiert ist. |
JSON-Darstellung
Die folgende JSON-Darstellung zeigt den Ressourcentyp.
{
"activeChecklistItemCount": "Int32",
"appliedCategories": {"@odata.type": "microsoft.graph.plannerAppliedCategories"},
"assigneePriority": "String",
"assignments": {"@odata.type": "microsoft.graph.plannerAssignments"},
"bucketId": "String",
"checklistItemCount": "Int32",
"completedBy": {"@odata.type": "microsoft.graph.identitySet"},
"completedDateTime": "String (timestamp)",
"conversationThreadId": "String",
"createdBy": {"@odata.type": "microsoft.graph.identitySet"},
"createdDateTime": "String (timestamp)",
"dueDateTime": "String (timestamp)",
"hasDescription": "Boolean",
"id": "String (identifier)",
"orderHint": "String",
"percentComplete": "Int32",
"priority": "Int32",
"planId": "String",
"previewType": "String",
"referenceCount": "Int32",
"startDateTime": "String (timestamp)",
"title": "String"
}