Type de ressource plannerTask

Article
04/16/2024

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 .

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	Mettre à jour un objet plannerTask .
Supprimer	Aucune	Supprimer un objet plannerTask .
Obtenir delta	collection plannerTask	Obtenez les nouveaux objets plannerTask créés, mis à jour ou supprimés dans un plannerPlan ou affectés à l’utilisateur connecté sans avoir à effectuer une lecture complète de l’ensemble de la collection de ressources.

Propriétés

Propriété	Type	Description
activeChecklistItemCount	Int32	Nombre d’éléments de liste de contrôle dont la valeur est définie `false`sur , représentant des éléments incomplets.
appliedCategories	plannerAppliedCategories	Catégories auxquelles la tâche est appliquée. Consultez le type de ressource plannerAppliedCategories pour connaître les valeurs possibles.
assigneePriority	String	Indicateur utilisé pour classer les éléments de ce type dans un affichage liste. Pour plus d’informations, consultez Utilisation d’indicateurs d’ordre dans Planificateur.
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 même plan que la tâche. La valeur de la propriété bucketId est de 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 contrôle présents sur la tâche.
completedBy	identitySet	Identité de l’utilisateur qui a terminé la tâche.
completedDateTime	DateTimeOffset	En lecture seule. Date et heure auxquelles 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 de création 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`.
creationSource	plannerTaskCreation	Informations sur l’origine de la tâche.
dueDateTime	DateTimeOffset	Date et heure d’échéance 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`.
hasDescription	Boolean	En lecture seule. Cette valeur est `true` si l’objet de détails de la tâche a une description non vide. Sinon, .`false`
id	Chaîne	En lecture seule. Identificateur unique de la tâche. La valeur de cette propriété est de 28 caractères et respecte la casse. Une validation du format est effectuée sur le service.
isOnMyDay	Valeur booléenne	Valeur booléenne qui indique s’il faut afficher cette tâche dans la vue MyDay. `true` pour afficher la tâche. Sinon, `false`.
isOnMyDayLastModifiedDate	Date	En lecture seule. Date à laquelle la tâche est ajoutée ou supprimée de MyDay.
orderHint	String	Indicateur utilisé pour trier les éléments de ce type dans un affichage de liste. Pour plus d’informations, consultez Utilisation d’indicateurs d’ordre dans Planificateur n.
percentComplete	Int32	Pourcentage d’achèvement de la tâche. Lorsque la `100`valeur est définie sur , la tâche est terminée.
priorité	Int32	Priorité de la tâche. Les valeurs valides sont comprises entre `0` et `10`, inclus. Des valeurs plus grandes indiquent une priorité inférieure. Par exemple, `0` a la priorité la plus élevée et `10` la priorité la plus basse. Actuellement, Planificateur interprète les valeurs `0` et `1` comme « urgent », `2` et `3` comme `4` « important », `5`, `6`et `7` comme « moyen », et `8`, `9`et `10` comme « faible ». Actuellement, Planificateur définit la valeur `1` pour « urgent », `3` pour « important », `5` pour « moyen » et `9` pour « faible ».
planId	Chaîne	ID du plan auquel appartient la tâche.
previewType	String	Type d’aperçu qui s’affiche sur la tâche. Les valeurs possibles sont les suivantes : `automatic`, `noPreview`, `checklist`, `description`, `reference`.
recurrence	plannerTaskRecurrence	Définit la périodicité active ou inactive de la tâche. `null` lorsque la périodicité n’a jamais été définie pour la tâche.
referenceCount	Int32	Nombre de références externes qui existent sur la tâche.
specifiedCompletionRequirements	plannerTaskCompletionRequirements	Indique toutes les exigences spécifiées dans plannerTask. Les valeurs possibles sont les suivantes : `none`, `checklistCompletion`, `unknownFutureValue`, `formCompletion`, `approvalCompletion`. En lecture seule. Vous devez utiliser l’en-tête `Prefer: include-unknown-enum-members` de requête pour obtenir les valeurs suivantes dans cette énumération évolutive : `formCompletion`, `approvalCompletion`. Le plannerTaskCompletionRequirementDetails dans plannerTaskDetails contient les détails des exigences spécifiées, le cas échéant.
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.

Valeurs plannerTaskCompletionRequirements

Member	Description
none	Aucune exigence.
checklistCompletion	Une partie ou la totalité des éléments de la liste de contrôle doivent être vérifiés.
unknownFutureValue	Valeur sentinel de l’énumération évolutive. Ne pas utiliser.
formCompletion	Une partie ou la totalité des formulaires doivent être envoyés pour effectuer la tâche du planificateur.
approvalCompletion	L’approbation est requise.

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)",
  "isOnMyDay": "Boolean",
  "isOnMyDayLastModifiedDate": "Date",
  "orderHint": "String",
  "percentComplete": "Int32",
  "planId": "String",
  "previewType": "String",
  "priority": "Int32",
  "recurrence": {"@odata.type": "microsoft.graph.plannerTaskRecurrence"},
  "referenceCount": "Int32",
  "specifiedCompletionRequirements": "String",
  "startDateTime": "String (timestamp)",
  "title": "String"
}