plannerTask-RessourcentypplannerTask resource type

Wichtig

APIs unter der /beta Version in Microsoft Graph können Änderungen unterworfen 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.

Die plannerTask-Ressource stellt eine Planer-Aufgabe in Office 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 Office 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'
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 StringString 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.
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,
  "planId": "String",
  "previewType": "String",
  "referenceCount": 1024,
  "startDateTime": "String (timestamp)",
  "title": "String"
}