plannerTask-Ressourcentyp

Artikel
10/07/2023

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
plannerTask abrufen	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	String	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 `100`festgelegt 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"
}