Ressourcentyp der Aufgabe

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.

Eine Planner V4-Aufgabe. planId Leitet die Aufgabe zurück an den übergeordneten Plan. Im Gegensatz zum V3-PlanerTaskplanerTaskDetails-Aufteilung/ hat eine V4-Aufgabe kein separates Detailobjekt – Beschreibung, Notizen, Checkliste, Aufgaben und Links sind Eigenschaften und Untersammlungen direkt in der Aufgabe.

Erbt von plannerDelta.

Methoden

Methode	Rückgabetyp	Beschreibung
List	task-Sammlung	Rufen Sie eine Liste der Aufgabenobjekte und ihrer Eigenschaften ab.
Create	task	Erstellen Sie ein neues Aufgabenobjekt.
Get	task	Lesen Sie die Eigenschaften und Beziehungen des Aufgabenobjekts .
Update	task	Aktualisieren Sie die Eigenschaften eines Aufgabenobjekts.
Löschen	Keine	Löschen Sie ein Aufgabenobjekt.
Prüfliste	checklistItemV4 collection	Rufen Sie eine Liste der checklistItemV4-Objekte und deren Eigenschaften ab.
Prüfliste erstellenItemV4	checklistItemV4	Erstellen Sie ein neues checklistItemV4-Objekt.
Liste customFieldValues	customFieldValue-Auflistung	Rufen Sie eine Liste der customFieldValue-Objekte und ihrer Eigenschaften ab.
Erstellen von customFieldValue	customFieldValue	Erstellen Sie ein neues customFieldValue-Objekt.
Listenlinks	contentLink-Sammlung	Rufen Sie eine Liste der contentLink-Objekte und ihrer Eigenschaften ab.
ContentLink erstellen	contentLink	Erstellen Sie ein neues contentLink-Objekt.
Nachrichten auflisten	plannerChatMessage-Sammlung	Rufen Sie eine Liste der plannerChatMessage-Objekte und ihrer Eigenschaften ab.
plannerChatMessage erstellen	plannerChatMessage	Erstellen Sie ein neues plannerChatMessage-Objekt.
list userAssignments	userAssignment-Sammlung	Rufen Sie eine Liste der userAssignment-Objekte und ihrer Eigenschaften ab.
userAssignment erstellen	userAssignment	Erstellen Sie ein neues userAssignment-Objekt.

Eigenschaften

Eigenschaft	Typ	Beschreibung
archivalInfo	plannerArchivalInfo	Informationen darüber, ob und wann die Entität archiviert wurde.
bucketId	String	ID des Buckets, zu dem die Aufgabe gehört.
Fähigkeiten	taskCapability	Vom Server berechnete, schreibgeschützte Funktionsflags, die angeben, welche optionalen Features für die Entität aktiviert sind.
completedBy	identitySet	Identität des Benutzers, der die Aufgabe als erledigt markiert hat.
completedDateTime	DateTimeOffset	Datum und Uhrzeit der Beendigung der Aufgabe.
creationInfo	creationInfo	Schreibgeschützte Erstellungsmetadaten für die Entität.
displayName	String	Titel der Aufgabe.
dueDateTime	dateWithOptionalTime	Datum und optional Uhrzeit der Fälligkeit der Aufgabe.
Erweiterungen	extensionFieldCollection	Feldwerte für benutzerdefinierte Erweiterungen, die für die Entität festgelegt wurden. Unterstützt $select.
finishDateTime	dateWithOptionalTime	Datum und optional Uhrzeit der Beendigung der Aufgabe.
Ziel-IDs	Zeichenfolgensammlung	IDs der Ziele, die der Aufgabe zugeordnet ist.
hasChat	Boolean	Gibt an, ob der Aufgabe ein Chat zugeordnet ist.
hasChildren	Boolean	Gibt an, ob die Aufgabe Teilvorgänge enthält.
id	Zeichenfolge	Der eindeutige Bezeichner der Entität. Schreibgeschützt. Von Entität geerbt
isCritical	Boolean	Gibt an, ob sich die Aufgabe auf dem kritischen Pfad befindet, der aus seinen Abhängigkeiten berechnet wird.
lastModifiedBy	identitySet	Die Identität des Benutzers (oder der Anwendung), der die Entität zuletzt geändert hat. Schreibgeschützt.
lastModifiedDateTime	DateTimeOffset	Datum und Uhrzeit der letzten Änderung der Entität. Der Wert wird im ISO 8601-Format dargestellt und immer in UTC-Zeit angegeben. Schreibgeschützt.
notes	itemBody	Zusätzliche Details oder Notizen zur Aufgabe.
parentTaskId	Zeichenfolge	ID der übergeordneten Aufgabe, wenn diese Aufgabe eine Teilaufgabe ist.
percentComplete	Int32	Prozentsatz der erledigten Aufgabe im Bereich von 0 bis 100.
personalView	taskPersonalView	Benutzerspezifische Einstellungen für die persönliche Ansicht der Aufgabe, z. B. "Mein Tag"-Mitgliedschaft.
planId	String	ID des Plans, der die Aufgabe enthält. Unveränderlich nach der Erstellung.
planView	taskPlanView	Auf den Plan zugeschnittene Einstellungen für die Vorgangsansicht, z. B. angewendete Kategorie-IDs.
Priorität	Int32	Priorität der Aufgabe. Unterstützte Werte reichen von 0 (dringend) bis 10 (niedrig).
recurrence	plannerTaskRecurrence	Serienmuster für die Aufgabe, wenn sie sich wiederholt.
startDateTime	dateWithOptionalTime	Datum und optional Uhrzeit des geplanten Starts der Aufgabe.
status	plannerTaskStatus	Zeigt den Fortschritt der Aufgabe an. Mögliche Werte sind: notStarted, inProgress, completed, blocked, unknownFutureValue.

Beziehungen

Beziehung	Typ	Beschreibung
Prüfliste	checklistItemV4 collection	Die Sammlung der Checklistenelemente für die Aufgabe. Schreibgeschützt. Nullwerte zulassend.
customFieldValues	customFieldValue-Auflistung	Die Auflistung der benutzerdefinierten Feldwerte, die für die Aufgabe festgelegt wurden. Schreibgeschützt. Nullwerte zulassend.
Links	contentLink-Sammlung	Die Sammlung der Inhaltslinks, die der Aufgabe zugeordnet sind. Schreibgeschützt. Lässt NULL-Werte zu.
messages	plannerChatMessage-Sammlung	Die Sammlung der Chatnachrichten, die der Aufgabe zugeordnet sind. Schreibgeschützt. Nullwerte zulassend.
userAssignments	userAssignment-Sammlung	Die Auflistung der Benutzerzuweisungen für die Aufgabe. Schreibgeschützt. Nullwerte zulassend.

JSON-Darstellung

Die folgende JSON-Darstellung veranschaulicht den Ressourcentyp.

{
  "@odata.type": "#microsoft.graph.task",
  "id": "String (identifier)",
  "displayName": "String",
  "planId": "String",
  "bucketId": "String",
  "goalIds": [
    "String"
  ],
  "status": "String",
  "priority": "Int32",
  "percentComplete": "Int32",
  "startDateTime": {
    "@odata.type": "microsoft.graph.dateWithOptionalTime"
  },
  "dueDateTime": {
    "@odata.type": "microsoft.graph.dateWithOptionalTime"
  },
  "finishDateTime": {
    "@odata.type": "microsoft.graph.dateWithOptionalTime"
  },
  "notes": {
    "@odata.type": "microsoft.graph.itemBody"
  },
  "creationInfo": {
    "@odata.type": "microsoft.graph.creationInfo"
  },
  "lastModifiedBy": {
    "@odata.type": "microsoft.graph.identitySet"
  },
  "lastModifiedDateTime": "String (timestamp)",
  "completedBy": {
    "@odata.type": "microsoft.graph.identitySet"
  },
  "completedDateTime": "String (timestamp)",
  "recurrence": {
    "@odata.type": "microsoft.graph.plannerTaskRecurrence"
  },
  "archivalInfo": {
    "@odata.type": "microsoft.graph.plannerArchivalInfo"
  },
  "planView": {
    "@odata.type": "microsoft.graph.taskPlanView"
  },
  "personalView": {
    "@odata.type": "microsoft.graph.taskPersonalView"
  },
  "parentTaskId": "String",
  "hasChildren": "Boolean",
  "isCritical": "Boolean",
  "hasChat": "Boolean",
  "capabilities": {
    "@odata.type": "microsoft.graph.taskCapability"
  },
  "extensions": {
    "@odata.type": "microsoft.graph.extensionFieldCollection"
  }
}