Type de ressource de tâche

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 .

Une tâche Planificateur V4. planId achemine la tâche vers son plan parent. Contrairement au fractionnement V3 plannerTask/plannerTaskDetails , une tâche V4 n’a pas d’objet de détails séparé : la description, les notes, la liste de vérification, les devoirs et les liens sont des propriétés et des sous-collections directement sur la tâche.

Hérite de plannerDelta.

Méthodes

Méthode Type de retour Description
List Ensemble de tâches Obtenir une liste des objets de tâche et leurs propriétés.
Create task Créez un objet de tâche.
Obtenir task Lisez les propriétés et les relations de l’objet tâche .
Mettre à jour task Mettre à jour les propriétés d’un objet de tâche.
Supprimer Aucun Supprimer un objet tâche.
Liste de contrôle checklistCollection ItemV4 Obtenez une liste des objets checklistItemV4 et de leurs propriétés.
Créer une liste de contrôleItemV4 checklistItemV4 Créez un objet checklistItemV4.
List customFieldValues collection customFieldValue Obtenir une liste des objets customFieldValue et de leurs propriétés.
Créer une valeur customFieldValue customFieldValue Créez un objet FieldValue personnalisé.
Liens de la liste collection contentLink Obtenez une liste des objets contentLink et de leurs propriétés.
Créer un liencontenu Lien de contenu Créez un objet contentLink.
Répertorier des messages collection plannerChatMessage Obtenez une liste des objets plannerChatMessage et de leurs propriétés.
Créer plannerChatMessage plannerChatMessage Créez un objet plannerChatMessage.
List userAssignments La collection userAssignment Obtenez une liste des objets userAssignment et de leurs propriétés.
Créer une attribution d’utilisateur Attribution utilisateur Créez un objet userAssignment.

Propriétés

Propriété Type Description
archivalInfo plannerArchivalInfo Informations indiquant si l’entité est archivée et quand elle l’a été.
bucketId Chaîne ID du compartiment auquel la tâche appartient.
fonctionnalités taskCapability Indicateurs de capacité en lecture seule calculés par le serveur indiquant les fonctionnalités facultatives activées pour l’entité.
completedBy identitySet Identité de l’utilisateur qui a marqué la tâche comme terminée.
completedDateTime DateTimeOffset Date et heure auxquelles la tâche a été effectuée.
creationInfo creationInfo Métadonnées de création en lecture seule pour l’entité.
displayName Chaîne Titre de la tâche.
dueDateTime dateWithOptionalTime Date et, éventuellement, heure d’échéance de la tâche.
extensions extensionFieldCollection Valeurs de champ d’extension personnalisées définies sur l’entité. Prend en charge $select.
finishDateTime dateWithOptionalTime Date et, éventuellement, heure à laquelle la tâche était terminée.
goalIds String collection ID des objectifs auxquels la tâche est associée.
hasChat Booléen Indique si la tâche a une conversation associée.
hasChildren Booléen Indique si la tâche comporte des tâches secondaires.
id String Identificateur unique de l’entité. En lecture seule. Hérité de l’entité
isCritical Booléen Indique si la tâche se trouve sur le chemin critique, tel qu’il est calculé à partir de ses dépendances.
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 la tâche.
parentTaskId String ID de la tâche parente, si cette tâche est une tâche secondaire.
percentComplete Int32 Pourcentage d’achèvement de la tâche, compris entre 0 et 100.
personalView taskPersonalView Paramètres d’affichage personnel par utilisateur pour la tâche, tels que l’abonnement à Ma journée.
planId Chaîne ID du plan qui contient la tâche. Immuable après la création.
planView taskPlanView Paramètres d’affichage des tâches limités au plan, tels que les ID de catégorie appliqués.
priorité Int32 Priorité de la tâche. Les valeurs prises en charge sont comprises entre 0 (urgent) et 10 (faible).
recurrence plannerTaskRecurrence Modèle de périodicité de la tâche, si elle se répète.
startDateTime dateWithOptionalTime Date et, éventuellement, heure de début de la tâche.
status plannerTaskStatus Indique l’avancement de la tâche. Les valeurs possibles sont : notStarted, inProgress, completed, blocked, unknownFutureValue.

Relations

Relation Type Description
checklist checklistCollection ItemV4 Collection d’éléments de la liste de contrôle relative à la tâche. En lecture seule. Pouvant accepter la valeur Null.
customFieldValues collection customFieldValue L’ensemble des valeurs de champ personnalisé définies sur la tâche. En lecture seule. Pouvant accepter la valeur Null.
links collection contentLink Collection de liens de contenu joints à la tâche. En lecture seule. Peut avoir la valeur Null.
messages collection plannerChatMessage Ensemble des messages de conversation associés à la tâche. En lecture seule. Pouvant accepter la valeur Null.
Attributions d’utilisateur La collection userAssignment Ensemble des affectations des utilisateurs sur la tâche. 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.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"
  }
}
  • Dernière mise à jour :