Development Project Status: Completed

A recurring appointment repeats one or more times, but has the same start and end time, appointment type, customer, patient, reason, notes and clinician fields from the first appointment.

To support recurrence, appointments will have a Repeat field which may be one of the following options:

• None
• Daily
• Weekly
• Monthly
• Yearly

It will default to "None".

Appointments will also have a Repeat Period, which determines how often the appointment repeats. This may be one of:

• N times
• until a certain date

Daily Appointments

When "Daily" recurrence is selected, then appointments are scheduled to occur daily at the same time.

This may be changed to:

• Every N Days     - where N is any value > 0. Defaults to 1; or
• Every weekday  

Weekly Appointments

When "Weekly" recurrence is selected, then appointments are scheduled to occur weekly at the same time.

This may be changed to:

• Every N Weeks    - where N is any value > 0. Defaults to 1; and/or
• On Mon/Tue/Wed/Thu/Fri/Sat/Sun. Each day may be selected. Defaults to the appointment day.

Monthly Appointments

When "Monthly" recurrence is selected, then appointments are scheduled to occur monthly at the same time. Note that if the date is not available in subsequent calendar months (e.g 31st), then that month will be skipped.

This may be changed to:

• Every N Months = where N is any value > 0. Defaults to 1; and
• On Every/First/Second/First/Fourth/Fifth/Last Sun-Sat day of month; or
• On 1-31 day. Each day may be selected. Defaults to the appointment day.

E.g.

• Every 3 Months on the First Wednesday
• Every month of the 14th of the month

Yearly Appointments

When "Yearly" recurrence is selected, then appointments are scheduled to occur yearly at the same time.

Note that if the date is not available in subsequent calendar years (e.g 29th Feb), then that year will be skipped.

This may be changed to:

• Every N Years = where N is any value > 0. Defaults to 1; and
• Every N of Jan-Dec where N is any valid day for that month; or
• Every/First/Second/First/Fourth/Fifth/Last Sun-Sat day of Jan-Dec

E.g,

• Every year on 31st August
• Every Friday of May
• Second Monday of December every year
• Every 3 years on 12th June

Editing Recurrent Appointments

If an appointment is recurrent, editing will display a dialog with the options "Edit this appointment?" and "Edit the appointment series?". If the former is selected, then any changes occur on the single appointment, and repeat options cannot be changed. If the latter, then changes are applied to all appointments in the series.

If a recurrent appointment is changed to non-recurrent, then all of the other appointments in the series are removed (provided they haven't been completed).

Deleting Recurrent Appointments

If an appointment is recurrent, deleting it will display a dialog with the options "Delete this appointment?" and "Delete the appointment series?". If the former, is selected then only the single appointment is deleted. If the latter, then all appointments that haven't been completed will be deleted.

Overlapping Appointments

If a recurring appointment overlaps another appointment, and the schedule doesn't allow double booking, the recurring appointment cannot be made.

Copying and Pasting Recurrent Appointments

If an appointment is recurrent, copying and pasting it will display a dialog with the options "Copy this appointment?" and "Copy the appointment series?".

If the forrmer, then only the single appointment is copied. It does not become part of the series.

If the latter, then the series will copied, subject to double booking contraints.

JIRA: https://openvpms.atlassian.net/browse/OVPMS-1093