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 .
Mettez à jour les propriétés de l’objet plannertask.
Dernière valeur ETag connue pour le plannerTask à mettre à jour. Obligatoire.
Corps de la demande
Dans le corps de la demande, fournissez uniquement les valeurs des propriétés à mettre à jour. Les propriétés existantes qui ne sont pas incluses dans le corps de la demande conservent leurs valeurs précédentes ou sont recalculées en fonction des modifications apportées à d’autres valeurs de propriété.
Le tableau suivant spécifie les propriétés qui peuvent être mises à jour.
Ensemble d’utilisateurs 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. Cette valeur de 28 caractères est longue et sensible à la casse.
Une validation du format est effectuée sur le service.
conversationThreadId
String
ID de thread de la conversation sur la tâche et est l’ID de l’objet de thread de conversation créé dans le groupe.
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.
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.
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.
priorité
Int32
Priorité de la tâche. La plage de valeurs valide est comprise entre 0 et 10 (inclusive), la valeur croissante étant de priorité inférieure (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, 6et 7 comme « moyen », et 8, 9et 10 comme « faible ». Actuellement, Planificateur définit la valeur 1 pour « urgent », 3 pour « important », 5 pour « moyen » et 9 pour « faible ».
Périodicité de la tâche, si elle est définie. Optional.
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.
Remarque
Pour les tâches project répliquées dans Planificateur, seule la propriété percentComplete peut être mise à jour.
Réponse
Si elle réussit, cette méthode renvoie un 204 No Content code de réponse et un contenu vide. Si la requête spécifie l’en-tête Prefer avec une return=representation préférence, cette méthode renvoie un 200 OK code de réponse et un objet plannerTask mis à jour dans le corps de la réponse.
Cette méthode peut retourner n’importe quel code de status HTTP. Les erreurs les plus courantes que les applications doivent gérer pour cette méthode sont les réponses 400, 403, 404, 409 et 412. Pour plus d’informations sur ces erreurs, consultez Conditions d’erreur courantes Planificateur.
// Code snippets are only available for the latest version. Current version is 5.x
// Dependencies
using Microsoft.Graph.Beta.Models;
var requestBody = new PlannerTask
{
Assignments = new PlannerAssignments
{
AdditionalData = new Dictionary<string, object>
{
{
"fbab97d0-4932-4511-b675-204639209557" , new PlannerAssignment
{
OdataType = "#microsoft.graph.plannerAssignment",
OrderHint = "N9917 U2883!",
}
},
},
},
AppliedCategories = new PlannerAppliedCategories
{
AdditionalData = new Dictionary<string, object>
{
{
"category3" , true
},
{
"category4" , false
},
},
},
Recurrence = new PlannerTaskRecurrence
{
Schedule = new PlannerRecurrenceSchedule
{
Pattern = new RecurrencePattern
{
Type = RecurrencePatternType.Daily,
Interval = 3,
},
PatternStartDateTime = DateTimeOffset.Parse("2022-02-22T02:10:33Z"),
},
},
};
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.Planner.Tasks["{plannerTask-id}"].PatchAsync(requestBody, (requestConfiguration) =>
{
requestConfiguration.Headers.Add("Prefer", "return=representation");
requestConfiguration.Headers.Add("If-Match", "W/\"JzEtVGFzayAgQEBAQEBAQEBAQEBAQEBAWCc=\"");
});