Type de ressource de l’objectif

Espace de noms: microsoft.graph

Importante

Les API sous la version /beta dans Microsoft Graph sont susceptibles d’être modifiées. L’utilisation de ces API dans des applications de production n’est pas prise en charge. Pour déterminer si une API est disponible dans v1.0, utilisez le sélecteur Version .

Un objectif Planificateur V4 associé à un ensemble de tâches dans un plan. status (par exemple, sur la piste, à risque, hors piste) est renvoyé par défaut ; Les mises à jour de description, de métriques et de narration nécessitent $select.

Hérite de plannerDelta.

Méthodes

Méthode Type de retour Description
List Ensemble d’objectifs Obtenir une liste des objets d’objectif et de leurs propriétés.
Create Objectif Créez un objet objectif.
Obtenir Objectif Lisez les propriétés et les relations de l’objet objectif .
Mettre à jour Objectif Mettre à jour les propriétés d’un objet objectif.
Supprimer Aucun Supprimer un objet objectif.
Répertorier les tâches Ensemble de tâches Obtenir une liste des objets de tâche et leurs propriétés.
Ajouter une tâche task Ajoutez des tâches en les publiant dans la collection des tâches.
Supprimer des tâches Aucun Supprimer un objet tâche .

Propriétés

Propriété Type Description
archivalInfo plannerArchivalInfo Informations indiquant si l’entité est archivée et quand elle l’a été.
fonctionnalités goalCapability Indicateurs de capacité en lecture seule calculés par le serveur indiquant les fonctionnalités facultatives activées pour l’entité.
createdBy identitySet Identité de l’utilisateur (ou de l’application) qui a créé l’entité. En lecture seule.
createdDateTime DateTimeOffset Date et heure de création de l’entité. La valeur est représentée au format ISO 8601 et se trouve toujours en heure UTC. En lecture seule.
displayName String Titre de l’objectif.
extensions extensionFieldCollection Valeurs de champ d’extension personnalisées définies sur l’entité. Prend en charge $select.
finishDate Date Date à laquelle l’objectif doit être atteint.
id String Identificateur unique de l’entité. En lecture seule. Hérité de l’entité
lastModifiedBy identitySet Identité de l’utilisateur (ou de l’application) qui a modifié l’entité en dernier. En lecture seule.
lastModifiedDateTime DateTimeOffset Date et heure de la dernière modification de l’entité. La valeur est représentée au format ISO 8601 et se trouve toujours en heure UTC. En lecture seule.
notes itemBody Détails ou remarques supplémentaires sur l’objectif.
planId Chaîne ID du plan qui contient l’objectif. Obligatoire et immuable après la création.
priorité Int32 Priorité de l’objectif.
startDate Date Date de début de l’objectif.
status plannerGoalStatus le status de progression de l’objectif. Les valeurs possibles sont notStarted, onTrack, behind, atRisk, closed, unknownFutureValue.

Relations

Relation Type Description
tasks Ensemble de tâches Ensemble des tâches associées à l’objectif. En lecture seule. Pouvant accepter la valeur Null.

Représentation JSON

La représentation JSON suivante montre le type de ressource.

{
  "@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"
  }
}