Zielressourcentyp

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.

Ein Planner V4-Ziel, das einer Reihe von Aufgaben in einem Plan zugeordnet ist. status (z. B. on-track, at-risk, off-track) wird standardmäßig zurückgegeben; Aktualisierungen von Beschreibung, Metriken und Erzählung erfordern $select.

Erbt von plannerDelta.

Methoden

Methode	Rückgabetyp	Beschreibung
List	Zielsammlung	Rufen Sie eine Liste der Zielobjekte und ihrer Eigenschaften ab.
Create	das Ziel	Erstellen Sie ein neues Zielobjekt.
Get	das Ziel	Lesen Sie die Eigenschaften und Beziehungen des Zielobjekts .
Update	das Ziel	Aktualisieren der Eigenschaften eines Zielobjekts.
Löschen	Keine	Löschen eines Zielobjekts.
Aufgaben auflisten	task-Sammlung	Rufen Sie eine Liste der Aufgabenobjekte und ihrer Eigenschaften ab.
Aufgabe hinzufügen	task	Hinzufügen von Aufgaben durch Posten in der Aufgabensammlung.
Aufgaben entfernen	Keine	Entfernen Sie ein Aufgabenobjekt .

Eigenschaften

Eigenschaft	Typ	Beschreibung
archivalInfo	plannerArchivalInfo	Informationen darüber, ob und wann die Entität archiviert wurde.
Fähigkeiten	goalCapability	Vom Server berechnete, schreibgeschützte Funktionsflags, die angeben, welche optionalen Features für die Entität aktiviert sind.
createdBy	identitySet	Identität des Benutzers (oder der Anwendung), der das Objekt erstellt hat. Schreibgeschützt.
createdDateTime	DateTimeOffset	Datum und Uhrzeit der Entität Der Wert wird im ISO 8601-Format dargestellt und immer in UTC-Zeit angegeben. Schreibgeschützt.
displayName	Zeichenfolge	Titel des Ziels.
Erweiterungen	extensionFieldCollection	Feldwerte für benutzerdefinierte Erweiterungen, die für die Entität festgelegt wurden. Unterstützt $select.
endDate	Datum	Datum, an dem das Ziel erreicht werden soll.
id	Zeichenfolge	Der eindeutige Bezeichner der Entität. Schreibgeschützt. Von Entität geerbt
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 Hinweise zum Ziel.
planId	String	ID des Plans, der das Ziel enthält. Erforderlich und nach der Erstellung unveränderlich.
Priorität	Int32	Priorität des Ziels.
startDate	Datum	Startdatum des Ziels.
status	plannerGoalStatus	Fortschritts-Status des Ziels. Mögliche Werte sind: notStarted, onTrack, behind, atRisk, closed, unknownFutureValue.

Beziehungen

Beziehung	Typ	Beschreibung
tasks	task-Sammlung	Die Sammlung der Aufgaben, die dem Ziel zugeordnet sind. Schreibgeschützt. Nullwerte zulassend.

JSON-Darstellung

Die folgende JSON-Darstellung veranschaulicht den Ressourcentyp.

{
  "@odata.type": "#microsoft.graph.goal",
  "id": "String (identifier)",
  "displayName": "String",
  "planId": "String",
  "status": "String",
  "priority": "Int32",
  "startDate": "Date",
  "finishDate": "Date",
  "notes": {
    "@odata.type": "microsoft.graph.itemBody"
  },
  "archivalInfo": {
    "@odata.type": "microsoft.graph.plannerArchivalInfo"
  },
  "createdBy": {
    "@odata.type": "microsoft.graph.identitySet"
  },
  "createdDateTime": "String (timestamp)",
  "lastModifiedBy": {
    "@odata.type": "microsoft.graph.identitySet"
  },
  "lastModifiedDateTime": "String (timestamp)",
  "capabilities": {
    "@odata.type": "microsoft.graph.goalCapability"
  },
  "extensions": {
    "@odata.type": "microsoft.graph.extensionFieldCollection"
  }
}