Créer une série, une instance ou une exception de rendez-vous périodique

Lorsque vous créez un rendez-vous périodique principal (série), Dynamics 365 Customer Engagement (on-premises) 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.

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 :

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

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

   Note

   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 pour les rendez-vous périodiques.

   Pour obtenir un exemple de code qui montre comment créer une série de rendez-vous périodique, voir Exemple : créer 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 Dynamics 365 Customer Engagement (on-premises) pour applications 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 un rendez-vous périodique
Exemple : convertir un rendez-vous en rendez-vous périodique