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"
  }
}
  • Zuletzt aktualisiert um