update-recurring-appointment.md

title	description	ms.custom	ms.date	ms.reviewer	ms.suite	ms.tgt_pltfrm	ms.topic	applies_to	helpviewer_keywords	ms.assetid	caps.latest.revision	author	ms.author	search.audienceType
Update a recurring appointment (Developer Guide for Dynamics 365 Customer Engagement) | MicrosoftDocs	Update a recurring appointment series by using the IOrganizationService.Entity method or the UpdateRequest message on the RecurringAppointmentMaster entity.		10/31/2017	pehecke			article	Dynamics 365 Customer Engagement (on-premises)	updating recurring appointments and recurring appointment series updating basic information in a recurring appointment series schedule and appointment entities, updating recurring appointments and recurring appointment series	8b4e75d1-4d3e-4d93-b4c1-6223269c4d4b	24	JimDaly	jdaly	developer

Update a recurring appointment

You can either update the whole series or update an instance of a recurring appointment.

Update a recurring appointment series

You can update a recurring appointment series by using the xref:Microsoft.Xrm.Sdk.IOrganizationService.xref:Microsoft.Xrm.Sdk.IOrganizationService.Update* method or the xref:Microsoft.Xrm.Sdk.Messages.UpdateRequest message on the RecurringAppointmentMaster entity. You can update the basic or recurrence information.

Update basic information

When you update the basic information of a recurring appointment series, such as subject, location, or attendees, all instances in the recurring appointment series are updated except those that have exceptions on the same attribute.

Update recurrence information

When you update the recurring information of a recurring appointment series, such as pattern and range, the following things occur:

1. A new series with a new RecurringAppointmentMaster.ActivityId is created that has the same information as the original series, and the date in the RecurringAppointmentMaster.EffectiveEndDate attribute of the new series is set to the last occurring past instance of the original series. All the future instances of the original series are deleted. In this manner, the original series is ended, and the history of the past instances is preserved in the system by storing it in a new series.

2. The new information is used to create the future instances of the new series from the effective start date (RecurringAppointmentMaster.EffectiveStartDate).

   Also, the RecurringAppointmentMaster.GroupId attribute for both the original and the new series is populated with the same value. This implies that whenever you update the recurrence information in a recurring appointment series, all the new series’ that are created have the same value for the RecurringAppointmentMaster.GroupId attribute as the recurring appointment series that is updated, although each series has a unique series ID.

Note

When you update the recurrence information of a recurring appointment series that has all the instances slated to occur in future, all instances are deleted and new recurrence information is used to create or expand new instances.

To see the sample code for updating a recurring appointment series, see Sample: Update a Recurring Appointment.

Update a recurring appointment instance

Because the recurring appointment records are stored as appointment objects, you can use the xref:Microsoft.Xrm.Sdk.IOrganizationService.xref:Microsoft.Xrm.Sdk.IOrganizationService.Update* method on the Appointment entity to update a recurring appointment instance. When you update a recurring appointment instance, the instance is marked as an exception to the recurring appointment series. [!INCLUDEproc_more_information] Create a Recurring Appointment Exception

You can also use the xref:Microsoft.Crm.Sdk.Messages.CreateExceptionRequest class on the Appointment entity to update a recurring appointment instance.

Tip

Recurring appointment instances can be identified using the Appointment.InstanceTypeCode attribute, which will have a value of “2” (Recurring Instance). [!INCLUDEproc_more_information]Appointment Entity

See also

Recurring Appointment Entities
Delete or end a recurring appointment series or instance
Sample: Create, Retrieve, Update, and Delete (CRUD) a Recurring Appointment
Sample: Reschedule and Cancel Recurring Appointment

[!INCLUDEfooter-include]