type de ressource todoTask

Espace de noms: microsoft.graph

Une tâche à faire représente une tâche, telle qu’un élément de travail ou un élément personnel, qui peut être suivie et terminée.

Une todoTask est toujours contenue dans une todoTaskList. Il inclut une relation avec une collection d’objets linkedResource , effectuant le suivi d’une ou plusieurs sources de la tâche.

Cette ressource prend en charge les éléments suivants :

Méthodes

Méthode Type de retour Description
Répertorier les tâches Collection todoTask Obtenir toutes les ressources todoTask dans la liste spécifiée.
Créer une tâche todoTask Créer une tâche à faire dans la liste des tâches spécifiée
Obtenir une tâche todoTask Lire les propriétés et les relations d’un objet todoTask .
Mettre à jour une tâche todoTask Mettre à jour les propriétés d’un objet todoTask .
Supprimer une tâche Aucun Supprime un objet todoTask .
Liste de vérificationÉléments liste de contrôleCollection d’objets Obtenez les ressources checklistItem à partir de la propriété de navigation checklistItems.
Créer une liste de contrôleItem checklistItem Créez un objet checklistItem .
Liste des ressources liées collection linkedResource Obtenez linkedResources à partir de la propriété de navigation linkedResources.
Créer des ressources liées linkedResource Créez un objet linkedResources.
Propriétés étendues
Créer une propriété à valeur unique todoTask Créez une ou plusieurs propriétés étendues à valeur unique dans un objet todoTask nouveau ou existant.
Obtenir une propriété à valeur unique todoTask Obtenez les objets todoTask qui contiennent une propriété étendue à valeur unique en utilisant $expand ou $filter.

Propriétés

Propriété Type Description
corps itemBody Le corps de la tâche qui contient généralement des informations sur la tâche.
bodyLastModifiedDateTime DateTimeOffset Date et heure de la dernière modification du corps de la tâche. Par défaut, cette valeur est définie dans le fuseau horaire UTC. Vous pouvez fournir un fuseau horaire personnalisé dans l’en-tête de la demande. La valeur de la propriété utilise le format ISO 8601, toujours en heure UTC. Par exemple, minuit UTC le 1er janvier 2020 ressemblerait à ceci : « 2020-01-01T00:00:00Z ».
categories String collection Les catégories associées à la tâche. Chaque catégorie correspond à la propriétédisplayNamed’unoutlookCategory que l’utilisateur a définie.
completedDateTime dateTimeTimeZone Date et heure dans le fuseau horaire spécifié où la tâche a été terminée.
createdDateTime DateTimeOffset Date et heure de création de la tâche. Par défaut, cette valeur est définie dans le fuseau horaire UTC. Vous pouvez fournir un fuseau horaire personnalisé dans l’en-tête de la demande. La valeur de la propriété utilise le format ISO 8601. Par exemple, minuit UTC le 1er janvier 2020 ressemblerait à ceci : « 2020-01-01T00:00:00Z ».
dueDateTime dateTimeTimeZone Date et heure dans le fuseau horaire spécifié où la tâche doit être terminée.
hasAttachments Boolean Indique si la tâche comporte des pièces jointes.
id Chaîne Identificateur unique de la tâche. Par défaut, cette valeur change lorsque l’élément est déplacé d’une liste à une autre.
importance importance L’importance de la tâche. Les valeurs possibles sont low, normal, high.
isReminderOn Boolean Valeur True si une alerte est définie pour rappeler la true à l’utilisateur.
lastModifiedDateTime DateTimeOffset Date et heure de la dernière modification de la tâche. Par défaut, le fuseau est UTC. Vous pouvez fournir un fuseau horaire personnalisé dans l’en-tête de la demande. La valeur de la propriété utilise le format ISO 8601, toujours en heure UTC. Par exemple, minuit UTC le 1er janvier 2020 ressemblerait à ceci : « 2020-01-01T00:00:00Z ».
recurrence patternedRecurrence Modèle de périodicité pour la tâche.
reminderDateTime dateTimeTimeZone Date et heure dans le fuseau horaire spécifié pour qu’une alerte de rappel de la tâche se produise.
startDateTime dateTimeTimeZone Date et heure dans le fuseau horaire spécifié auxquelles la tâche doit commencer.
statut Statustâches Indique l’état ou la progression de la tâche. Les valeurs possibles sont : notStarted, inProgress, completed, waitingOnOthers, deferred.
title String Brève description de la tâche.

Les tâches peuvent être exportées à l’aide du téléchargement PST décrit dans Exporter les résultats de la recherche de contenu à partir du portail Microsoft Purview. Vous pouvez référencer le mappage entre todoTask les propriétés et les propriétés du fichier PST exporté dans la vue d’ensemble de l’API To Do.

Relations

Relation Type Description
pièces jointes taskFileAttachment, collection Une collection de pièces jointes pour la tâche.
Liste de contrôleItems liste de contrôleCollection d’objets Collection d’éléments de liste de contrôle liés à une tâche.
extensions collection extension Collection d’extensions ouvertes définie pour la tâche. Pouvant accepter la valeur Null.
linkedResources collection linkedResource Collection de ressources liées à la tâche.
singleValueExtendedProperties collection singleValueExtendedProperty Collection de champs personnalisés liés à la tâche.

Représentation JSON

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

{
  "@odata.type": "#microsoft.graph.todoTask",
  "id": "String (identifier)",
  "body": {
    "@odata.type": "microsoft.graph.itemBody"
  },
  "categories": ["string"],
  "completedDateTime": {
    "@odata.type": "microsoft.graph.dateTimeTimeZone"
  },
  "dueDateTime": {
    "@odata.type": "microsoft.graph.dateTimeTimeZone"
  },
  "importance": "String",
  "isReminderOn": "Boolean",
  "recurrence": {
    "@odata.type": "microsoft.graph.patternedRecurrence"
  },
  "reminderDateTime": {
    "@odata.type": "microsoft.graph.dateTimeTimeZone"
  },
  "status": "String",
  "title": "String",
  "createdDateTime": "String (timestamp)",
  "lastModifiedDateTime": "String (timestamp)",
  "bodyLastModifiedDateTime": "String (timestamp)"
}
  • Dernière mise à jour :