plannerTask-Ressourcentyp

Namespace: microsoft.graph

Die plannerTask-Ressource stellt eine Planer-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 details-Objekt, das weitere Informationen über die Aufgabe enthalten kann. Weitere Informationen zu Beziehungen zwischen Gruppe, Plan und Aufgabe finden Sie in der Übersicht.

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 zum Anordnen von Elementen dieses Typs in einer Listenansicht verwendet wird. 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. Sie ist 28 Zeichen lang und es wird zwischen Groß-und Kleinschreibung unterschieden. 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. Mitternacht UTC-Zeit am 1. Januar 2014 ist beispielsweise 2014-01-01T00:00:00Z
conversationThreadId	Zeichenfolge	Thread-ID der Unterhaltung zur Aufgabe. Dies ist die ID des Unterhaltungsthreadobjekts, 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, zu dem die Aufgabe erstellt wird. Der Timestamp-Typ stellt die Datums- und Uhrzeitinformationen mithilfe des ISO 8601-Formats dar und wird immer in UTC-Zeit angegeben. Mitternacht UTC-Zeit am 1. Januar 2014 ist beispielsweise 2014-01-01T00:00:00Z
dueDateTime	DateTimeOffset	Datum und Uhrzeit der Fälligkeit der Aufgabe. Der Zeitstempeltyp stellt die Datums- und Uhrzeitinformationen im ISO 8601-Format dar und wird immer in UTC-Zeit angegeben. Mitternacht UTC-Zeit am 1. Januar 2014 ist beispielsweise 2014-01-01T00:00:00Z
hasDescription	Boolescher Wert	Schreibgeschützt. Der Wert ist true, wenn das Detailobjekt der Aufgabe eine nicht leere Beschreibung und aufweist, andernfalls false.
id	Zeichenfolge	Schreibgeschützt. ID der Aufgabe. Sie ist 28 Zeichen lang und es wird zwischen Groß-und Kleinschreibung unterschieden. Für den Dienst wird eine Formatüberprüfung durchgeführt.
orderHint	Zeichenfolge	Hinweis, der zum Anordnen von Elementen dieses Typs in einer Listenansicht verwendet wird. Das Format ist wie hier beschrieben definiert.
percentComplete	Int32	Abgeschlossener Prozentsatz der Aufgabe. Bei Festlegung auf 100 wird die Aufgabe als abgeschlossen betrachtet.
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.
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. Die möglichen Werte: automatic, noPreview, checklist, description, reference.
referenceCount	Int32	Anzahl externer Bezüge, die für die Aufgabe vorhanden sind.
startDateTime	DateTimeOffset	Datum und Uhrzeit, zu der die Aufgabe beginnt. Der Zeitstempeltyp stellt die Datums- und Uhrzeitinformationen im ISO 8601-Format dar und wird immer in UTC-Zeit angegeben. Mitternacht UTC-Zeit am 1. Januar 2014 ist beispielsweise 2014-01-01T00:00:00Z
title	String	Titel der Aufgabe.

Beziehungen

Beziehung	Typ	Beschreibung
assignedToTaskBoardFormat	plannerAssignedToTaskBoardTaskFormat	Schreibgeschützt. Lässt Nullwerte zu. Wird zum korrekten Rendern der Task Board-Ansicht bei Gruppierung nach assignedTo verwendet.
bucketTaskBoardFormat	plannerBucketTaskBoardTaskFormat	Schreibgeschützt. Lässt Nullwerte zu. Wird zum korrekten Rendern der Task Board-Ansicht bei Gruppierung nach Bucket verwendet.
Details	plannerTaskDetails	Schreibgeschützt. Lässt Nullwerte zu. Weitere Details über die Aufgabe.
progressTaskBoardFormat	plannerProgressTaskBoardTaskFormat	Schreibgeschützt. Lässt Nullwerte zu. Wird zum korrekten Rendern der Task Board-Ansicht bei Gruppierung nach Fortschritt verwendet.

JSON-Darstellung

Es folgt eine JSON-Darstellung der Ressource.

{
  "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": true,
  "id": "String (identifier)",
  "orderHint": "String",
  "percentComplete": "Int32",
  "priority": "Int32",
  "planId": "String",
  "previewType": "String",
  "referenceCount": "Int32",
  "startDateTime": "String (timestamp)",
  "title": "String"
}