Mettre à jour un rendez-vous périodique

Vous pouvez mettre à jour la série de rendez-vous périodiques entière ou une instance d’un rendez-vous périodique.

Mettre à jour une série de rendez-vous périodiques

Vous pouvez mettre à jour une série de rendez-vous périodiques avec la méthode IOrganizationService.Update ou le message UpdateRequest sur l’entité RecurringAppointmentMaster. Vous pouvez mettre à jour les informations de base ou de périodicité.

Mettre à jour les informations de base

Lorsque vous mettez à jour les informations de base d’une série de rendez-vous périodiques, par exemple l’objet, l’emplacement ou les participants, toutes les instances de la série de rendez-vous périodiques sont mises à jour, excepté celles qui comportent des exceptions sur le même attribut.

Mettre à jour les informations de périodicité

Lorsque vous mettez à jour les informations de périodicité d’une série de rendez-vous périodiques, par exemple le critère et la plage, voici ce qui se produit :

1. Une série comportant un nouveau RecurringAppointmentMaster.ActivityId est créée. Elle contient les mêmes informations que la série d’origine, et la date dans l’attribut RecurringAppointmentMaster.EffectiveEndDate de la nouvelle série est définie sur la dernière instance passée de la série d’origine. Toutes les futures instances de la série d’origine sont supprimées. De cette manière, la série d’origine est terminée et l’historique des dernières instances est conservé dans le système car il est enregistré dans une nouvelle série.

2. Les nouvelles informations servent à créer de futures instances de la nouvelle série à partir de la date de début effective (RecurringAppointmentMaster.EffectiveStartDate).

   En outre, l’attribut RecurringAppointmentMaster.GroupId pour la série d’origine et la nouvelle série est rempli avec la même valeur. Cela signifie que lorsque vous mettez à jour les informations de périodicité d’une série de rendez-vous périodiques, toutes les nouvelles séries qui sont créées comportent la même valeur d’attribut RecurringAppointmentMaster.GroupId que la série de rendez-vous périodiques mise à jour, même si chacune des séries a un ID de série unique.

Note

Lorsque vous mettez à jour les informations de périodicité d’une série de rendez-vous périodiques dont toutes les instances doivent avoir lieu dans l’avenir, toutes les instances sont supprimées et la nouvelle information de périodicité est utilisée pour créer ou développer de nouvelles instances.

Pour voir un exemple de code qui montre comment mettre à jour une série de rendez-vous périodique, voir Exemple : Mettre à jour un rendez-vous périodique.

Mettre à jour une instance d’un rendez-vous périodique

Étant donné que les instances de rendez-vous récurrents sont stockées en tant qu’objets de rendez-vous, vous pouvez utiliser ma méthode IOrganizationService.Update sur l’entité Appointment pour mettre à jour une instance de rendez-vous périodique. Lorsque vous mettez à jour une instance d’un rendez-vous périodique, l’instance est marquée en tant qu’exception dans la série de rendez-vous périodiques. Pour plus d’informations, voir : Créer une exception de rendez-vous périodique

Vous pouvez également utiliser la classe CreateExceptionRequest sur l’entité Appointment pour mettre à jour une instance d’un rendez-vous périodique.

Pourboire

Les instances de rendez-vous périodique peuvent être identifiées à l’aide de l’attribut Appointment.InstanceTypeCode, qui aura la valeur « 2 » (instance périodique). Pour plus d’informations, voir : Entité Appointment

Voir aussi

Entités de rendez-vous périodique
Supprimer ou terminer une série ou une instance de rendez-vous périodique
Exemple : Créer, récupérer, mettre à jour et supprimer (CRUD) un rendez-vous périodique
Exemple : Replanifier et annuler un rendez-vous périodique