Créer une série, une instance ou une exception de rendez-vous périodique
Date de publication : janvier 2017
S’applique à : Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online
Lorsque vous créez un rendez-vous périodique principal (série), Microsoft Dynamics 365 crée des instances de rendez-vous en fonction des informations de périodicité spécifiées. Vous pouvez également créer des instances de rendez-vous périodiques individuelles et des exceptions à ces instances. Vous pouvez convertir un simple rendez-vous en un rendez-vous périodique.
Contenu de la rubrique
Créer une série de rendez-vous périodiques
Créer une instance de rendez-vous périodique
Créer une exception de rendez-vous périodique
Convertir un rendez-vous en rendez-vous périodique
Créer une série de rendez-vous périodiques
Pour créer une série de rendez-vous périodiques (enregistrement RecurringAppointmentMaster), vous pouvez utiliser le message BookRequest, le message CreateRequest ou la méthode IOrganizationService.Create.
Lorsque vous créez une série de rendez-vous périodiques, les éléments suivants surviennent :
Un enregistrement RecurringAppointmentMaster (série de rendez-vous périodiques) est créé contenant des données de base et de périodicité sur la série des rendez-vous périodiques. Chaque enregistrement peut être identifié à l’aide de la propriété RecurringAppointmentMaster.ActivityId. De plus, la série de rendez-vous périodiques est également créée et stockée sous forme d’enregistrement d’activité (ActivityPointer). L’enregistrement d’activité peut être identifiée de manière unique à l’aide de la propriété ActivityPointer.ActivityId.
Chaque instance de rendez-vous périodique est créée en fonction des informations de périodicité et est stockée sous la forme d’un enregistrement Appointment. Ces objets de rendez-vous sont associés à la série de rendez-vous périodiques parents avec la propriété Appointment.SeriesId et dispose de la même valeur que l’ID de série de rendez-vous périodiques parents (ActivityPointer.SeriesId).
La valeur de la propriété Appointment.InstanceTypeCode est définie sur Instance périodique (valeur de liste déroulante 2) pour ces objets de rendez-vous.
Notes
Les instances de rendez-vous périodiques sont créées en fonction du modèle d’expansion et des paramètres qui les définissent.Pour plus d'informations :Modèle partiel d’expansion de rendez-vous périodique.
Pour obtenir un exemple de code qui montre comment créer une série de rendez-vous périodiques, voir Exemple : Créer, récupérer, mettre à jour et supprimer un rendez-vous périodique.
Créer une instance de rendez-vous périodique
Pour créer une instance de rendez-vous périodique (enregistrement RecurringAppointmentMaster ), vous pouvez utiliser CreateInstanceRequest. Ce message prend deux paramètres : le nombre d’instances à créer et la série de rendez-vous périodiques pour lesquels les instances doivent être créées.
Les instances sont créées après la dernière instance de la série de rendez-vous périodiques. En outre, les instances sont créées uniquement avant la date limite de la prochaine instance, indépendamment du nombre d’instances que vous avez spécifié pour la création.
Créer une exception de rendez-vous périodique
Une exception est créée lorsque vous mettez à jour ou supprimez une instance du rendez-vous périodique. Les instances de rendez-vous périodiques sont stockées sous forme de rendez-vous avec les autres rendez-vous, et vous pouvez identifier une instance de rendez-vous périodique à l’aide de l’attribut Appointment.InstanceTypeCode d’un enregistrement de rendez-vous, ce qui fournira une valeur d’instance périodique (valeur de liste déroulante 2).
Vous pouvez créer des exceptions de l’une des méthodes suivantes :
Utilisez la classe UpdateRequest sur l’entité Appointment pour mettre à jour une instance de rendez-vous périodique, ainsi que la valeur de l’attribut Appointment.InstanceTypeCode sur Exception périodique (valeur de liste déroulante 3).
Utilisez la classe DeleteRequest sur l’entité Appointment pour supprimer une instance d’un rendez-vous périodique. La suppression d’une instance de rendez-vous la marque en tant qu’exception en créant une entrée pour l’instance dans l’attribut RecurringAppointmentMaster.DeletedExceptionsList de l’objet de la série de rendez-vous parents.
Utilisez la classe CreateExceptionRequest sur l’entité Appointment.
Convertir un rendez-vous en rendez-vous périodique
Un rendez-vous périodique est un rendez-vous contenant des informations de périodicité. Vous pouvez convertir un rendez-vous existant dans Microsoft Dynamics 365 en un rendez-vous périodique en utilisant AddRecurrenceRequest. Lorsque vous convertissez un rendez-vous existant en un rendez-vous périodique, les données du rendez-vous existant sont copiées dans une nouvelle instance de rendez-vous périodique principal et le rendez-vous existant est supprimé.
Voir aussi
Entités de rendez-vous périodique
Mettre à jour un rendez-vous périodique
Exemple : Créer, récupérer, mettre à jour et supprimer un rendez-vous périodique
Exemple : Convertir un rendez-vous en rendez-vous périodique
Microsoft Dynamics 365
© 2017 Microsoft. Tous droits réservés. Copyright