plannerTask-Ressourcentyp

Artikel
04/16/2024

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.

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	Liest die Eigenschaften und Beziehungen des plannerTask-Objekts .
Aktualisieren	plannerTask	Aktualisieren eines plannerTask-Objekts .
Delete	Keine	Löschen sie ein plannerTask-Objekt .
Delta abrufen	plannerTask-Sammlung	Rufen Sie neu erstellte, aktualisierte oder gelöschte plannerTask-Objekte entweder in einem plannerPlan ab oder werden dem angemeldeten Benutzer zugewiesen, ohne die gesamte Ressourcensammlung vollständig lesen zu müssen.

Eigenschaften

Eigenschaft	Typ	Beschreibung
activeChecklistItemCount	Int32	Die Anzahl der Prüflistenelemente, deren Wert auf `false`festgelegt ist, stellt unvollständige Elemente dar.
appliedCategories	plannerAppliedCategories	Die Kategorien, auf die die Aufgabe angewendet wird. Mögliche Werte finden Sie unter plannerAppliedCategories-Ressourcentyp .
assigneePriority	Zeichenfolge	Ein Hinweis, der verwendet wird, um Elemente dieses Typs in einer Listenansicht zu sortieren. Weitere Informationen finden Sie unter Verwenden von Bestellhinweisen in Planner.
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 sich im gleichen Plan wie die Aufgabe befinden. Der Wert der bucketId-Eigenschaft ist 28 Zeichen lang, wobei die Groß-/Kleinschreibung beachtet wird. Für den Dienst wird eine Formatüberprüfung durchgeführt.
checklistItemCount	Int32	Die Anzahl der Prüflistenelemente, die für den Vorgang vorhanden sind.
completedBy	identitySet	Die Identität des Benutzers, der die Aufgabe abgeschlossen hat.
completedDateTime	DateTimeOffset	Schreibgeschützt. Das Datum und die Uhrzeit, an dem der `'percentComplete'` Vorgang auf `'100'`festgelegt wird. 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	Die 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. Das Datum und die 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. Zum Beispiel, Mitternacht UTC am 1. Januar 2014 ist `2014-01-01T00:00:00Z`
creationSource	plannerTaskCreation	Informationen zum Ursprung der Aufgabe.
dueDateTime	DateTimeOffset	Das Datum und die Uhrzeit, zu dem die Aufgabe fällig 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`
hasDescription	Boolescher Wert	Schreibgeschützt. Dieser Wert ist `true` , wenn das Detailobjekt des Vorgangs eine nicht leere Beschreibung aufweist. Andernfalls.`false`
id	String	Schreibgeschützt. Der eindeutige Bezeichner der Aufgabe. Der Wert dieser Eigenschaft ist 28 Zeichen lang, wobei die Groß-/Kleinschreibung beachtet wird. Für den Dienst wird eine Formatüberprüfung durchgeführt.
isOnMyDay	Boolesch	Ein boolescher Wert, der angibt, ob diese Aufgabe in der Ansicht MyDay angezeigt werden soll. `true` , um die Aufgabe anzuzeigen. `false`Andernfalls .
isOnMyDayLastModifiedDate	Datum	Schreibgeschützt. Das Datum, an dem die Aufgabe zu MyDay hinzugefügt oder daraus entfernt wird.
orderHint	Zeichenfolge	Der Hinweis, der zum Sortieren von Elementen dieses Typs in einer Listenansicht verwendet wird. Weitere Informationen finden Sie unter Verwenden von Bestellhinweisen in Planner n.
percentComplete	Int32	Der Prozentsatz des Vorgangsabschlusses. Wenn diese Einstellung auf `100`festgelegt ist, wird die Aufgabe abgeschlossen.
Priorität	Int32	Die Priorität des Vorgangs. Gültige Werte sind zwischen `0` und `10`, einschließlich. Größere Werte weisen auf eine niedrigere Priorität hin. hat beispielsweise `0` die höchste Priorität und `10` die niedrigste Priorität. Derzeit interpretiert Planner Werte `0` und `1` als "dringend", `2` und `3` als `4` "wichtig", `5`, `6`und `7` als "mittel" und `8`, `9`und `10` als "niedrig". Derzeit legt Planner den Wert `1` für "urgent", `3` für "important", `5` "medium" und `9` für "low" fest.
planId	String	Plan-ID, zu der die Aufgabe gehört.
previewType	Zeichenfolge	Der Vorschautyp, der für die Aufgabe angezeigt wird. Mögliche Werte: `automatic`, `noPreview`, `checklist`, `description`, `reference`.
recurrence	plannerTaskRecurrence	Definiert die aktive oder inaktive Wiederholung für die Aufgabe. `null` , wenn die Wiederholung noch nie für die Aufgabe definiert wurde.
referenceCount	Int32	Anzahl externer Bezüge, die für die Aufgabe vorhanden sind.
specifiedCompletionRequirements	plannerTaskCompletionRequirements	Gibt alle anforderungen an, die für plannerTask angegeben sind. Mögliche Werte: `none`, `checklistCompletion`, `unknownFutureValue`, `formCompletion`, `approvalCompletion`. Schreibgeschützt. Sie müssen den Anforderungsheader `Prefer: include-unknown-enum-members` verwenden, um die folgenden Werte in dieser verteilbaren Enumeration abzurufen: `formCompletion`, `approvalCompletion`. PlannerTaskCompletionRequirementDetails in plannerTaskDetails enthält Details der angegebenen Anforderungen, falls vorhanden.
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.

plannerTaskCompletionRequirements-Werte

Member	Beschreibung
keine	Keine Anforderung.
checklistCompletion	Einige oder alle Prüflistenelemente müssen überprüft werden.
unknownFutureValue	Wert des Sentinelwerts für die vervolvbare Enumeration. Nicht verwenden.
formCompletion	Einige oder alle Formulare müssen eingereicht werden, um die Planeraufgabe abzuschließen.
approvalCompletion	Eine Genehmigung ist erforderlich.

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)",
  "isOnMyDay": "Boolean",
  "isOnMyDayLastModifiedDate": "Date",
  "orderHint": "String",
  "percentComplete": "Int32",
  "planId": "String",
  "previewType": "String",
  "priority": "Int32",
  "recurrence": {"@odata.type": "microsoft.graph.plannerTaskRecurrence"},
  "referenceCount": "Int32",
  "specifiedCompletionRequirements": "String",
  "startDateTime": "String (timestamp)",
  "title": "String"
}