plannerTask-RessourcentypplannerTask resource type
Namespace: microsoft.graphNamespace: microsoft.graph
Wichtig
APIs unter der /beta Version in Microsoft Graph können geändert werden.APIs under the /beta version in Microsoft Graph are subject to change. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt.Use of these APIs in production applications is not supported. Verwenden Sie die Versionsauswahl, um zu ermitteln, ob eine API in Version 1.0 verfügbar ist.To determine whether an API is available in v1.0, use the Version selector.
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.The plannerTask resource represents a Planner task in Microsoft 365. A Planner task is contained in a plan and can be assigned to a bucket in a plan. Each task object has a details object which can contain more information about the task. See overview for more information regarding relationships between group, plan and task.
MethodenMethods
| MethodeMethod | RückgabetypReturn Type | BeschreibungDescription |
|---|---|---|
| plannerTask abrufenGet plannerTask | plannerTaskplannerTask | Dient zum Lesen der Eigenschaften und Beziehungen eines plannerTask-Objekts.Read properties and relationships of plannerTask object. |
| AktualisierenUpdate | plannerTaskplannerTask | Dient zum Aktualisieren des plannerTask-Objekts.Update plannerTask object. |
| LöschenDelete | KeineNone | Dient zum Löschen des plannerTask-Objekts.Delete plannerTask object. |
EigenschaftenProperties
| EigenschaftProperty | TypType | BeschreibungDescription |
|---|---|---|
| activeChecklistItemCountactiveChecklistItemCount | Int32Int32 | Anzahl der Prüflistenelemente, deren Wert auf false festgelegt ist, was unvollständige Elemente darstellt.Number of checklist items with value set to false, representing incomplete items. |
| appliedCategoriesappliedCategories | plannerAppliedCategoriesplannerAppliedCategories | Die Kategorien, auf die die Aufgabe angewendet wurde. Mögliche Werte finden Sie unter angewendete Kategorien.The categories to which the task has been applied. See applied Categories for possible values. |
| assigneePriorityassigneePriority | ZeichenfolgeString | Hinweis, der zum Anordnen von Elementen dieses Typs in einer Listenansicht verwendet wird. Das Format ist wie hier beschrieben definiert.Hint used to order items of this type in a list view. The format is defined as outlined here. |
| assignmentsassignments | plannerAssignmentsplannerAssignments | Der Satz von zugewiesenen Personen, denen die Aufgabe zugewiesen wurde.The set of assignees the task is assigned to. |
| bucketIdbucketId | StringString | Bucket-ID, zu der die Aufgabe gehört.Bucket ID to which the task belongs. Der Bucket muss in dem Plan enthalten sein, in dem sich die Aufgabe befindet.The bucket needs to be in the plan that the task is in. Sie ist 28 Zeichen lang und es wird zwischen Groß-und Kleinschreibung unterschieden.It is 28 characters long and case-sensitive. Für den Dienst wird eine Formatüberprüfung durchgeführt.Format validation is done on the service. |
| checklistItemCountchecklistItemCount | Int32Int32 | Anzahl der Prüflistenelemente, die für die Aufgabe vorhanden sind.Number of checklist items that are present on the task. |
| completedBycompletedBy | identitySetidentitySet | Die Identität des Benutzers, der die Aufgabe abgeschlossen hat.Identity of the user that completed the task. |
| completedDateTimecompletedDateTime | DateTimeOffsetDateTimeOffset | 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 würde z. B. wie folgt aussehen: '2014-01-01T00:00:00Z'Read-only. Date and time at which the 'percentComplete' of the task is set to '100'. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z' |
| conversationThreadIdconversationThreadId | ZeichenfolgeString | Thread-ID der Unterhaltung zur Aufgabe. Dies ist die ID des Unterhaltungsthreadobjekts, das in der Gruppe erstellt wurde.Thread ID of the conversation on the task. This is the ID of the conversation thread object created in the group. |
| createdBycreatedBy | identitySetidentitySet | Die Identität des Benutzers, der die Aufgabe erstellt hat.Identity of the user that created the task. |
| createdDateTimecreatedDateTime | DateTimeOffsetDateTimeOffset | 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. Mitternacht UTC-Zeit am 1. Januar 2014 würde z. B. wie folgt aussehen: '2014-01-01T00:00:00Z'Read-only. Date and time at which the task is created. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z' |
| creationSourcecreationSource | plannerTaskCreationplannerTaskCreation | Enthält Informationen zum Ursprung der Aufgabe.Contains information about the origin of the task. |
| dueDateTimedueDateTime | DateTimeOffsetDateTimeOffset | 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 würde z. B. wie folgt aussehen: '2014-01-01T00:00:00Z'Date and time at which the task is due. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z' |
| hasDescriptionhasDescription | Boolescher WertBoolean | Schreibgeschützt. Der Wert ist true, wenn das Detailobjekt der Aufgabe eine nicht leere Beschreibung und aufweist, andernfalls false.Read-only. Value is true if the details object of the task has a non-empty description and false otherwise. |
| idid | ZeichenfolgeString | Schreibgeschützt.Read-only. ID der Aufgabe.ID of the task. Sie ist 28 Zeichen lang und es wird zwischen Groß-und Kleinschreibung unterschieden.It is 28 characters long and case-sensitive. Für den Dienst wird eine Formatüberprüfung durchgeführt.Format validation is done on the service. |
| orderHintorderHint | ZeichenfolgeString | Hinweis, der zum Anordnen von Elementen dieses Typs in einer Listenansicht verwendet wird. Das Format ist wie hier beschrieben definiert.Hint used to order items of this type in a list view. The format is defined as outlined here. |
| percentCompletepercentComplete | Int32Int32 | Abgeschlossener Prozentsatz der Aufgabe. Bei Festlegung auf 100 wird die Aufgabe als abgeschlossen betrachtet.Percentage of task completion. When set to 100, the task is considered completed. |
| Prioritätpriority | Int32Int32 | Priorität des Vorgangs.Priority of the task. Der gültige Wertebereich liegt zwischen und (einschließlich), mit zunehmenden Werten mit niedrigerer Priorität ( hat die höchste Priorität und 0 10 die niedrigste 0 10 Priorität).Valid range of values is between 0 and 10 (inclusive), with increasing value being lower priority (0 has the highest priority and 10 has the lowest priority). Derzeit interpretiert Planner Werte und als 0 1 "dringend" und als "wichtig", und als "mittel" und , und als 2 3 4 5 6 7 8 9 10 "niedrig".Currently, Planner interprets values 0 and 1 as "urgent", 2 and 3 and 4 as "important", 5, 6, and 7 as "medium", and 8, 9, and 10 as "low". Derzeit legt Planner den Wert für 1 "dringend", 3 "wichtig", 5 "mittel" und 9 "niedrig" fest.Currently, Planner sets the value 1 for "urgent", 3 for "important", 5 for "medium", and 9 for "low". |
| planIdplanId | StringString | Plan-ID, zu der die Aufgabe gehört.Plan ID to which the task belongs. |
| previewTypepreviewType | ZeichenfolgeString | Hierdurch wird der Typ der Vorschau festgelegt, die für die Aufgabe angezeigt wird.This sets the type of preview that shows up on the task. Mögliche Werte: automatic, noPreview, checklist, description, reference.Possible values are: automatic, noPreview, checklist, description, reference. |
| referenceCountreferenceCount | Int32Int32 | Anzahl externer Bezüge, die für die Aufgabe vorhanden sind.Number of external references that exist on the task. |
| startDateTimestartDateTime | DateTimeOffsetDateTimeOffset | 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. Mitternacht UTC-Zeit am 1. Januar 2014 würde z. B. wie folgt aussehen: '2014-01-01T00:00:00Z'Date and time at which the task starts. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z' |
| titletitle | StringString | Titel der Aufgabe.Title of the task. |
BeziehungenRelationships
| BeziehungRelationship | TypType | BeschreibungDescription |
|---|---|---|
| assignedToTaskBoardFormatassignedToTaskBoardFormat | plannerAssignedToTaskBoardTaskFormatplannerAssignedToTaskBoardTaskFormat | Schreibgeschützt. Lässt Nullwerte zu. Wird zum korrekten Rendern der Task Board-Ansicht bei Gruppierung nach assignedTo verwendet.Read-only. Nullable. Used to render the task correctly in the task board view when grouped by assignedTo. |
| bucketTaskBoardFormatbucketTaskBoardFormat | plannerBucketTaskBoardTaskFormatplannerBucketTaskBoardTaskFormat | Schreibgeschützt. Lässt Nullwerte zu. Wird zum korrekten Rendern der Task Board-Ansicht bei Gruppierung nach Bucket verwendet.Read-only. Nullable. Used to render the task correctly in the task board view when grouped by bucket. |
| Detailsdetails | plannerTaskDetailsplannerTaskDetails | Schreibgeschützt. Lässt Nullwerte zu. Weitere Details über die Aufgabe.Read-only. Nullable. Additional details about the task. |
| progressTaskBoardFormatprogressTaskBoardFormat | plannerProgressTaskBoardTaskFormatplannerProgressTaskBoardTaskFormat | Schreibgeschützt. Lässt Nullwerte zu. Wird zum korrekten Rendern der Task Board-Ansicht bei Gruppierung nach Fortschritt verwendet.Read-only. Nullable. Used to render the task correctly in the task board view when grouped by progress. |
JSON-DarstellungJSON representation
Es folgt eine JSON-Darstellung der Ressource.Here is a JSON representation of the resource.
{
"activeChecklistItemCount": 1024,
"appliedCategories": {"@odata.type": "microsoft.graph.plannerAppliedCategories"},
"assigneePriority": "String",
"assignments": {"@odata.type": "microsoft.graph.plannerAssignments"},
"bucketId": "String",
"checklistItemCount": 1024,
"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": 1024,
"priority": 1024,
"planId": "String",
"previewType": "String",
"referenceCount": 1024,
"startDateTime": "String (timestamp)",
"title": "String"
}