plannerGoal-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 ein Ziel dar, das einer Reihe von Aufgaben in einem Planner-Plan zugeordnet ist.

Drittanbieteranwendungen können Ziele lesen, aber nicht erstellen, aktualisieren oder löschen.

Erbt von plannerDelta.

Methoden

Methode	Rückgabetyp	Beschreibung
Ziel erreichen	plannerGoal	Lesen der Eigenschaften und Beziehungen eines plannerGoal-Objekts .
Ziele auflisten	plannerGoal-Sammlung	Abrufen der einem plannerPlan-Objekt zugeordneten Ziele.

Eigenschaften

Eigenschaft	Typ	Beschreibung
displayName	Zeichenfolge	Erforderlich. Der Anzeigename des Ziels.
endDate	Datum	Nullwerte zulassend. Das Datum, an dem das Ziel beendet werden soll.
id	Zeichenfolge	Schreibgeschützt. Der eindeutige Bezeichner des Ziels. Geerbt von plannerDelta.
notes	itemBody	Nullwerte zulassend. Die mit dem Ziel verbundenen Notizen.
planId	String	Erforderlich. Die ID des Plans, der das Ziel enthält.
Priorität	Int32	Optional. Die relative Priorität des Ziels. Gültige Werte reichen von 0 bis 10einschließlich , Der Standardwert ist 5.
startDate	Datum	Nullwerte zulassend. Das Datum, an dem das Ziel beginnen soll.
status	plannerGoalStatus	Erforderlich. Der aktuelle Status des Ziels. Der Standardwert ist notStarted. Mögliche Werte sind: notStarted, onTrack, behind, atRisk, closed, unknownFutureValue.

Beziehungen

Beziehung	Typ	Beschreibung
tasks	plannerTask-Sammlung	Schreibgeschützt. Nullwerte zulassend. Die Aufgaben, die mit dem Ziel verbunden sind. Diese Beziehung unterstützt keinen direkten Abruf oder $expand. Um die Ziele zu identifizieren, die einer Aufgabe zugeordnet sind, lesen Sie die goalIds-Eigenschaft der plannerTask-Ressource .

JSON-Darstellung

Die folgende JSON-Darstellung veranschaulicht den Ressourcentyp.

{
  "@odata.type": "#microsoft.graph.plannerGoal",
  "displayName": "String",
  "finishDate": "Date",
  "id": "String (identifier)",
  "notes": {
    "@odata.type": "microsoft.graph.itemBody"
  },
  "planId": "String",
  "priority": "Int32",
  "startDate": "Date",
  "status": "String"
}