Mettre à jour un rendez-vous périodique

Article
03/10/2022
2 minutes de lecture

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 à l’aide de la méthode IOrganizationService.Update ou du 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 :

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.
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.

Hinweis

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 enregistrements de rendez-vous récurrents sont enregistrés comme des objets de rendez-vous, vous pouvez utiliser la méthode IOrganizationService.Update sur l’entité Appointment pour mettre à jour une instance d’un 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 : 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.

Tipp

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 :Entité Rendez-vous

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