Opération UpdateItem (tâche)
L’opération UpdateItem est utilisée pour mettre à jour les propriétés de l’élément de tâche dans le magasin Exchange.
Remarques
Vous ne pouvez pas utiliser les services web Exchange pour envoyer des demandes de tâche. Les services web Exchange peuvent retourner des demandes de tâches créées par MicrosoftOfficeOutlook. Si une demande de tâche a déjà été envoyée, une demande de mise à jour de la tâche renvoie une erreur.
Mise à jour de l’occurrence actuelle d’une tâche périodique
Le résultat d’une opération UpdateItem sur des tâches périodiques diffère du résultat de l’opération UpdateItem sur une seule tâche non récurrente. Les modifications apportées à une occurrence d’une tâche périodique entraînent la génération de tâches ponctuelles lorsque les mises à jour suivantes sont effectuées :
La propriété status d’une tâche récurrente régénérante ou non régénérative est définie sur Terminé.
La date de début ou de fin d’une tâche récurrente non régénérée est modifiée.
Par exemple, si une requête UpdateItem définit la valeur Completed d’une tâche périodique sur true, l’objet UpdateItemResponse inclut un nouvel Id et changeKey qui représentent une tâche unique nouvellement créée. L’ID qui a été inclus dans la demande est toujours valide et la tâche périodique représentée par cet ID a été mise à jour pour représenter l’occurrence suivante. La clé ChangeKey incluse dans la requête n’est plus valide, car la tâche périodique a été mise à jour.
Vous pouvez utiliser l’opération GetItem pour obtenir la dernière touche ChangeKey pour la tâche périodique.
Pour les tâches non récurrentes ou pour la dernière occurrence d’une tâche périodique, la réponse UpdateItem retourne le même ID que celui qui lui a été passé et retourne la clé ChangeKey mise à jour associée.