Mettre à jour un rendez-vous périodique
Date de publication : janvier 2017
S’applique à : Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online
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.
Notes
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 l’exemple de code permettant de mettre à jour une série de rendez-vous périodiques, voir Exemple : Replanifier et annuler un rendez-vous périodique.
Mettre à jour une instance d’un rendez-vous périodique
Étant donné que les enregistrements de rendez-vous périodique sont enregistrés en tant qu’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.
Conseil
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 :Messages et méthodes de l’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 un rendez-vous périodique
Exemple : Replanifier et annuler un rendez-vous périodique
Microsoft Dynamics 365
© 2017 Microsoft. Tous droits réservés. Copyright