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