Type de ressource plannerTask

Article
04/22/2024

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 Planificateur.

Méthodes

Méthode	Type renvoyé	Description
Obtenir un objet plannerTask	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 `100`valeur 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 `10`a 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"
}