Type de ressource plannerTask

Espace de noms: microsoft.graph

Représente une tâche planificateur dans Microsoft 365. Une tâche Planificateur est contenue dans un plan et peut être affectée à un compartiment dans un plan. Chaque objet de tâche a un objet de détails qui peut contenir plus d’informations sur la tâche. Pour plus d’informations sur les relations entre le groupe, le plan et la tâche, consultez Utiliser l’API REST du planificateur.

Méthodes

Méthode Type renvoyé Description
Créer plannerTask Créez un objet plannerTask .
Obtenir plannerTask Lisez les propriétés et les relations de l’objet plannerTask.
Mettre à jour plannerTask Mettez à jour l’objet plannerTask.
Supprimer Aucune Supprimez l’objet plannerTask.

Propriétés

Propriété Type Description
activeChecklistItemCount Int32 Nombre d’éléments de liste de vérification avec la valeur false, qui représente des éléments incomplets.
appliedCategories plannerAppliedCategories Catégories auxquelles la tâche a été appliquée. Consultez Catégories appliquées pour connaître les valeurs possibles.
assigneePriority String Indicateur utilisé pour trier les éléments de ce type dans un affichage de liste. Le format est défini comme indiqué ici.
affectations plannerAssignments Ensemble de cessionnaires auxquels la tâche est affectée.
bucketId Chaîne ID du compartiment auquel appartient la tâche. Le compartiment doit se trouver dans le plan où se trouve la tâche. Il contient 28 caractères et respecte la casse. Une validation du format est effectuée sur le service.
checklistItemCount Int32 Nombre d’éléments de liste de vérification présents sur la tâche.
completedBy identitySet Identité de l’utilisateur qui a effectué la tâche.
completedDateTime DateTimeOffset En lecture seule. Date et heure à laquelle le 'percentComplete' de la tâche est défini sur '100'. Le type d’horodatage représente les informations de date et d’heure au moyen du format ISO 8601. Il est toujours au format d’heure UTC. Par exemple, le 1er janvier 2014 à minuit UTC se présente comme suit : 2014-01-01T00:00:00Z.
conversationThreadId String ID de thread de la conversation sur la tâche. Il s’agit de l’ID de l’objet de thread de conversation créé dans le groupe.
createdBy identitySet Identité de l’utilisateur qui a créé la tâche.
createdDateTime DateTimeOffset En lecture seule. Date et heure auxquelles la tâche est créée. Le type d’horodatage représente les informations de date et d’heure au moyen du format ISO 8601. Il est toujours au format d’heure UTC. Par exemple, le 1er janvier 2014 à minuit UTC se présente comme suit : 2014-01-01T00:00:00Z.
dueDateTime DateTimeOffset Date et heure auxquelles la tâche doit être effectuée. Le type d’horodatage représente les informations de date et d’heure au moyen du format ISO 8601. Il est toujours au format d’heure UTC. Par exemple, le 1er janvier 2014 à minuit UTC se présente comme suit : 2014-01-01T00:00:00Z.
hasDescription Boolean En lecture seule. La valeur est true si l’objet de détails de la tâche a une description non vide et false sinon.
id Chaîne En lecture seule. ID de la tâche. Il contient 28 caractères et respecte la casse. Une validation du format est effectuée sur le service.
orderHint String Indicateur utilisé pour trier les éléments de ce type dans un affichage de liste. Le format est défini comme indiqué ici.
percentComplete Int32 Pourcentage d’achèvement de la tâche. Lorsque la 100valeur est définie sur , la tâche est considérée comme terminée.
planId Chaîne ID du plan auquel appartient la tâche.
previewType String Définit le type d’aperçu qui s’affiche sur la tâche. Les valeurs possibles sont : automatic, noPreview, checklist, description, reference.
priorité Int32 Priorité de la tâche. La plage de valeurs valide est comprise entre 0 et 10, avec une valeur croissante étant une priorité inférieure (0 a la priorité la plus élevée et 10a la priorité la plus basse). Actuellement, le Planificateur interprète les valeurs 0 et 1 comme « urgentes », 2, 3 et 4 comme « importantes», 5, 6 et 7 comme « moyennes », et 8, 9 et 10 comme « faibles ». En outre, le Planificateur définit la valeur 1 pour « urgent », 3 pour « important », 5 pour « moyen », et 9 pour « faible ».
referenceCount Int32 Nombre de références externes qui existent sur la tâche.
startDateTime DateTimeOffset Date et heure de début de la tâche. Le type d’horodatage représente les informations de date et d’heure au moyen du format ISO 8601. Il est toujours au format d’heure UTC. Par exemple, le 1er janvier 2014 à minuit UTC se présente comme suit : 2014-01-01T00:00:00Z.
title Chaîne Titre de la tâche.

Relations

Relation Type Description
assignedToTaskBoardFormat plannerAssignedToTaskBoardTaskFormat En lecture seule. Pouvant accepter la valeur Null. Permet d’afficher correctement la tâche dans l’affichage du tableau des tâches lorsqu’elle est regroupée par assignedTo.
bucketTaskBoardFormat plannerBucketTaskBoardTaskFormat En lecture seule. Pouvant accepter la valeur Null. Permet d’afficher correctement la tâche dans l’affichage du tableau des tâches lorsqu’elle est regroupée par compartiment.
détails plannerTaskDetails En lecture seule. Pouvant accepter la valeur Null. Plus d’informations sur la tâche.
progressTaskBoardFormat plannerProgressTaskBoardTaskFormat En lecture seule. Pouvant accepter la valeur Null. Permet d’afficher correctement la tâche dans la vue du tableau des tâches lorsqu’elle est regroupée par progression.

Représentation JSON

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

{
  "activeChecklistItemCount": "Int32",
  "appliedCategories": {"@odata.type": "microsoft.graph.plannerAppliedCategories"},
  "assigneePriority": "String",
  "assignments": {"@odata.type": "microsoft.graph.plannerAssignments"},
  "bucketId": "String",
  "checklistItemCount": "Int32",
  "completedBy": {"@odata.type": "microsoft.graph.identitySet"},
  "completedDateTime": "String (timestamp)",
  "conversationThreadId": "String",
  "createdBy": {"@odata.type": "microsoft.graph.identitySet"},
  "createdDateTime": "String (timestamp)",
  "dueDateTime": "String (timestamp)",
  "hasDescription": "Boolean",
  "id": "String (identifier)",
  "orderHint": "String",
  "percentComplete": "Int32",
  "priority": "Int32",
  "planId": "String",
  "previewType": "String",
  "referenceCount": "Int32",
  "startDateTime": "String (timestamp)",
  "title": "String"
}