plannerTask-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.
Stellt eine Planeraufgabe in Microsoft 365 dar. Eine Planeraufgabe 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 ein plannerTask-Objekt . |
| Get | 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 falsefestgelegt ist, stellt unvollständige Elemente dar. |
| appliedCategories | plannerAppliedCategories | Die Kategorien, auf die die Aufgabe angewendet wird. Mögliche Werte finden Sie unter plannerAppliedCategories-Ressourcentyp . |
| archivalInfo | plannerArchivalInfo | Schreibgeschützt. Nullwerte zulassend. Enthält Informationen darüber, wer die Aufgabe archiviert oder nicht archiviert hat und warum. |
| 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 Zeitstempeltyp stellt Datums- und Uhrzeitinformationen im ISO 8601-Format dar und ist 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 | Zeichenfolge | 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. |
| isArchived | Boolesch | Schreibgeschützt. Bei Festlegung auf truewird die Aufgabe archiviert. Eine archivierte Aufgabe ist schreibgeschützt. |
| isOnMyDay | Boolesch | Gibt an, ob diese Aufgabe in der MyDay-Ansicht angezeigt werden soll. Bei truewird die Aufgabe angezeigt. |
| 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 Plannern. |
| percentComplete | Int32 | Der Prozentsatz des Vorgangsabschlusses. Wenn diese Einstellung auf 100festgelegt 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, 6und 7 als "mittel" und 8, 9und 10 als "niedrig". Derzeit legt Planner den Wert 1 für "dringend", 3 für "wichtig", 5 für "mittel" und 9 für "niedrig" 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"
}