Creating and Modifying a Recurring Appointment

Before You Begin

A recurring appointment is a special type of Appointment that is created from a base activity. You can create the Recurrence object either in code with the CreateRecurrence method or by using the Recurrence dialog box. Once a recurrence is created, you have the option of modifying either a single occurrence of the recurrence object or the entire series.

What You will Accomplish

This walkthrough will guide you through the steps that the end user will take in order to create and modify a recurring appointment. For more information on the options available in the Recurrence dialog box, see the topic Using the Recurrence Pattern Dialog Box.

Creating a Recurring Appointment

The end user opens the Appointment dialog box either through a button click via code or by double-clicking a view control. The Appointment dialog box displays.

WebSchedule Creating and Modifying a Recurring Appointment 01.png

The end user clicks Recurrence… on the Appointment dialog box’s toolbar. The Recurrence Pattern dialog box displays with default options.

Note	Note: The recurrence button will be available only if WebScheduleInfo’s™ EnableRecurringActivities property is set to True (by default, it is set to False).

WebSchedule Creating and Modifying a Recurring Appointment 02.png

If the end user clicks Cancel or Remove Recurrence at this point, the dialog box closes without adding a recurrence to the appointment.
If the end user clicks OK, WebScheduleInfo will validate the dialog box’s settings. If the settings are valid, the Recurrence dialog box will close and update the information in the Appointment dialog box.

Note	Note: The Appointment dialog box will no longer have a start time and end time section. Instead it will display text identifying it as a recurring appointment.

WebSchedule Creating and Modifying a Recurring Appointment 03.png

The end user clicks Save and Close on the toolbar and the information is sent to the WebScheduleInfo client-side object.

Updating a Single Occurrence of a Recurring Apointment

The end user opens the Appointment dialog box either through a button click via code or by double-clicking a view control. The Modify Recurrence dialog box displays.

WebSchedule Creating and Modifying a Recurring Appointment 04.png

The end user selects "Open this occurrence" and clicks OK. The Appointment dialog box opens.

Note	Note: The Recurrence… toolbar button no longer displays and there is a status bar above the Subject that reads: "This is a recurring appointment."

WebSchedule Creating and Modifying a Recurring Appointment 05.png

When finished modifying the appointment, the end user clicks Save and Close.
1. WebScheduleInfo checks to see if any modifications have been made to the appointment. If the appointment has not been modified, the Appointment dialog box is closed with no changes. If modifications have been made, WebScheduleInfo sends the information to the server where a new Variant is created for this recurrence.
2. WebScheduleInfo will not validate this information and will automatically update the appointment with the new values from the dialog box. The appointment will then be sent to the server where the data provider will do the validation. During validation, the data provider will check if any information differs from the original occurrence object.

Updating a Series of Recurring Appointments

The end user opens the Appointment dialog box either through a button click via code or by double-clicking a view control. The Modify Recurrence dialog box displays.

WebSchedule Creating and Modifying a Recurring Appointment 06.png

The end user selects "Open the series" and clicks OK. The Appointment dialog box opens.

Note	Note: The Recurrence… toolbar button is displayed (as opposed to when the end user selects "Open this occurrence"). The StartTime and EndTime fields are also replaced with text identifying the state of the recurrence.

WebSchedule Creating and Modifying a Recurring Appointment 07.png

After modifying the dialog box, the end user clicks Save and Close. The dialog box will notify WebScheduleInfo of the changes, which will then be sent to the server.
The WebScheduleInfo component on the server will then notify the data provider that a change has occurred in the recurrence object.