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 du 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, voir 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 un objet plannerTask .
Supprimer Aucun Supprimez un objet plannerTask .
Obtenir delta collection plannerTask Obtenez des objets plannerTask nouvellement créés, mis à jour ou supprimés dans un plannerPlan ou attribués à l’utilisateur connecté sans avoir à effectuer une lecture complète de la collection de ressources entière.
Répertorier des messages plannerTaskChatCollection de messages Obtenez les messages de conversation associés à une tâche de planificateur.
Créer un message plannerTaskChatMessage Créez un nouveau message de conversation sur une tâche du Planificateur.

Propriétés

Propriété Type Description
activeChecklistItemCount Int32 Nombre d’éléments de la liste de contrôle dont la valeur est définie sur false, représentant les éléments incomplets.
appliedCategories plannerAppliedCategories Catégories auxquelles la tâche est appliquée. Voir le type de ressource plannerAppliedCategories pour connaître les valeurs possibles.
archivalInfo plannerArchivalInfo En lecture seule. Pouvant accepter la valeur Null. Contient des informations sur qui a archivé ou désarchivé la tâche et pourquoi.
assigneePriority String Conseil utilisé pour ordonner des éléments de ce type dans un affichage de liste. Pour plus d’informations, voir Utilisation des conseils de commande 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 être dans le même plan que la tâche. La valeur de la propriété bucketId comporte 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 dans la tâche.
completedBy identitySet L’identité de l’utilisateur qui a terminé la tâche.
completedDateTime DateTimeOffset En lecture seule. Date et heure auxquelles la 'percentComplete' tâche est définie 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 fil de conversation créé dans le groupe.
createdBy identitySet Identité de l’utilisateur ayant 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.
goalIds String collection En lecture seule. ID des objectifs associés à la tâche.
hasChat Booléen En lecture seule. Cette valeur est true si des messages de conversation sont associés à la tâche. Sinon, false.
hasDescription Boolean En lecture seule. Cette valeur est si true l’objet details de la tâche a une description non vide. Sinon, false.
id String En lecture seule. Identificateur unique de la tâche. La valeur de cette propriété comporte 28 caractères et respecte la casse. Une validation du format est effectuée sur le service.
isArchived Boolean En lecture seule. Si la valeur est , truela tâche est archivée. Une tâche archivée est en lecture seule.
isOnMyDay Booléen Indique si cette tâche doit être affichée dans la vue MyDay. Si true, il affiche la tâche.
isOnMyDayLastModifiedDate Date En lecture seule. Date à laquelle la tâche est ajoutée ou supprimée de MyDay.
lastModifiedBy identitySet En lecture seule. Identifiant de la dernière modification.
lastModifiedDateTime DateTimeOffset En lecture seule. Date et heure de la dernière modification. 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.
orderHint String Conseil utilisé pour classer les éléments de ce type dans un affichage sous forme de liste. Pour plus d’informations, voir Utilisation des conseils de commande dans le Planificateur.
percentComplete Int32 Pourcentage d’achèvement de la tâche. Lorsque la valeur est , 100la tâche est terminée.
priorité Int32 Priorité de la tâche. Les valeurs valides sont comprises entre 0 et 10, inclus. Les valeurs plus élevées indiquent une priorité inférieure. Par exemple, 0 a la priorité la plus élevée et 10 la priorité la plus faible. Actuellement, planificateur interprète les valeurs 0 et 1 comme « urgentes 2 », et 3 et 4 comme « importantes », 5, 6et 7 comme « moyennes », et 8, 9et 10 comme « faibles ». Actuellement, le planificateur définit la valeur 1 pour « urgent », 3 « important », 5 « moyen » et 9 « 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 : 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 sur la tâche du planificateur. Les valeurs possibles sont : none, checklistCompletion, unknownFutureValue, formCompletion, approvalCompletion. En lecture seule. Utilisez l’en-tête de Prefer: include-unknown-enum-members requête pour obtenir les valeurs suivantes dans cette énumération évolutive : formCompletion, approvalCompletion. Le plannerTaskCompletionRequirementDetails dans plannerTaskDetails contient des détails sur les 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.

plannerTaskCompletionRequirements valeurs

Member Description
none Aucune exigence.
liste de vérificationachèvement Une partie ou la totalité des éléments de la liste de contrôle doivent être vérifiés.
unknownFutureValue Valeur sentinelle d’énumération évolutive. Ne pas utiliser.
formulaireSaisie semi-automatique Une partie ou la totalité des formulaires doivent être soumis pour terminer la tâche du planificateur.
approbationAchèvement L’approbation est requise.

Relations

Relation Type Description
assignedToTaskBoardFormat plannerAssignedToTaskBoardTaskFormat En lecture seule. Pouvant accepter la valeur Null. Utilisé pour afficher correctement la tâche dans l’affichage tableau de tâches lorsqu’elle est regroupée par assignedTo.
bucketTaskBoardFormat plannerBucketTaskBoardTaskFormat En lecture seule. Pouvant accepter la valeur Null. Utilisé pour afficher correctement la tâche dans l’affichage tableau de tâches lorsqu’elle est regroupée par compartiment.
détails plannerTaskDetails En lecture seule. Pouvant accepter la valeur Null. Plus de détails sur la tâche.
messages plannerTaskChatCollection de messages En lecture seule. Pouvant accepter la valeur Null. Messages de chat associés à la tâche.
progressTaskBoardFormat plannerProgressTaskBoardTaskFormat En lecture seule. Pouvant accepter la valeur Null. Utilisé pour afficher correctement la tâche dans l’affichage tableau de 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)",
  "goalIds": ["String"],
  "hasChat": "Boolean",
  "hasDescription": "Boolean",
  "id": "String (identifier)",
  "isOnMyDay": "Boolean",
  "isOnMyDayLastModifiedDate": "Date",
  "lastModifiedBy": {"@odata.type": "microsoft.graph.identitySet"},
  "lastModifiedDateTime": "String (timestamp)",
  "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"
}
  • Dernière mise à jour :