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"
}