Type de ressource plannerTask

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 de planificateur dans Microsoft 365. Une tâche de 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 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 falsesur , 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.
archiveInfo plannerArchivalInfo En lecture seule. Pouvant accepter la valeur Null. Contient des informations sur les personnes qui ont archivé ou désarchivé la tâche et pourquoi.
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 le 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 format ISO 8601 et est toujours en 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.
isArchived Boolean En lecture seule. Si la truevaleur est définie sur , la tâche est archivée. Une tâche archivée est en lecture seule.
isOnMyDay Valeur booléenne Indique s’il faut afficher cette tâche dans la vue MyDay. Si truela valeur est , elle affiche la tâche.
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 le planificateurn.
percentComplete Int32 Pourcentage d’achèvement de la tâche. Lorsque la 100valeur 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, le planificateur interprète les valeurs 0 et 1 comme « urgents », 2 et 3 comme 4 « important », 5, 6et 7 comme « moyen », et 8, 9et 10 comme « faible ». Actuellement, le 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"
}