Migrating to Exchange

Recurring Events, Appointments, and Tasks

Recurring events, appointments, and tasks share the same set of properties.

Example...
RecurringEvents:	
{
		Text:   "Yearly tax audit. Start preparations early."
		Ring:   T
		AlarmAmount:	21
		AlarmTypeUnit:  2
		StartDate:	3-4-1996
		EndDate:		3-4-1996
		RecurringType:  7
		YearInterval:   1
		DayOfMonthMask:		 8
		MonthOfYearMask:		4
}

RecurringAppointments:  
{
		Text:   "SATR meeting.\
\
Big Sale."
		Ring:   T
		AlarmAmount:	15
		DayOfWeekStart:		 0
		StartRecurringTime:	 12:00
		YearInterval:   1
		WeekInterval:   1
		BusyType:	 0
		RecurringType:  51
		StartRecurringDate:	 2-26-1996
		DayOfWeekMask:  32
		EndRecurringDate:	 3-4-2000
		DayOfMonthMask:		 8
		EndRecurringTime:	 13:00
		MonthOfYearMask:		4
		AlarmTypeUnit:  0
}

RecurringTasks:		 
{
		Text:   "Check online mailbox for new mail."
		Priority:	 8243
		TypeUnitActualEffort:   2
		AmountEstimatedEffort:  1
		TypeUnitEstimatedEffort:		2
		Billing:		"Billed at higher rate"
		BeforeEndOriginal:	F
		AmountStartWork:		0
		StartRecurringDate:	 3-2-1996
		RecurringType:  64
		WeekInterval:   1
		DayOfWeekMask:  16
		DayOfWeekStart:		 0
		DayInterval:	1
		EndRecurringDate:	 8-10-1996
		TypeUnitStartWork:	2
		Ring:   T
		AlarmAmount:	0
		AlarmTypeUnit:  2
		BeforeEnd:	F
		Exceptions:	 
		{
				InstanceDate:   3-3-1996
				StartDate: 3-3-1996
				EndDate:		 3-4-1996
				Deleted:		F
				Text: "Check online mailbox for new mail. Check for new rates."
				Priority:	 8241
				TypeUnitActualEffort:   2
				AmountEstimatedEffort:  1
				TypeUnitEstimatedEffort:		2
				BeforeEndOriginal:	F
				AmountStartWork:		0
				TypeUnitStartWork:	2
				Ring:   T
				AlarmAmount:	5
				AlarmTypeUnit:  2
				BeforeEnd:	F
	}
}

The following table describes the properties shared by recurring appointments, events, and tasks:

Property Values Description
DayInterval 1 through 999 Number of days between instances. Used only if RecurringType is 64.
DayOfMonthMask 1st day of month = bit 0
31st day of month = bit 30
Bit field indicating which days of the month are valid for recurrence pattern. Used only if RecurringType is 7 or 12.
DayOfWeekMask Sunday = bit 0
Saturday = bit 6
Bit field indicating which days of the week are valid for recurrence pattern. Used only if RecurringType is 48, 51, or 56.
DayOfWeekStart 0 through 6
Sunday = 0
Start of week preference. Used only if RecurringType is 48. For recalculating biweekly meetings.
EndRecurringDate mm-dd-yyyy End date for recurrence pattern.
EndRecurringTime (Required) hh:mm End time for a recurring item.
Exceptions See "Exceptions Property" section later in this chapter. Exceptions to a recurring item.
FirstRecurringAlarmDate Today's date in mm-dd-yyyy format. First recurring item with alarm. Recalculated during import into Outlook.
MonthInterval 1 through 99 Interval between months for recurrence pattern. Used only if RecurringType is 12 or 56.
MonthOfYearMask January = bit 0
December = bit 11
Bit field indicating which months of year are valid for recurrence pattern. Used only if RecurringType is 7 or 51.
RecurringType (Required) 7 = Yearly on specific day
12 = Monthly on specific day
48 = Weekly
51 = Yearly on a pattern
56 = Monthly on a pattern
64 = Daily
Type of recurrence pattern.
StartRecurringDate (Required) mm-dd-yyyy Start date for recurrence pattern.
StartRecurringTime (Required) hh:mm Start time for recurring item.
WeekInterval Positive integer Interval between weeks for recurrence pattern. Used only if RecurringType is 48, 51, or 56.
YearInterval Positive integer Interval between years for recurrence pattern. Used only if RecurringType is 7.

The following table describes additional values required for the RecurringType property:

RecurringType Required values
7 = Yearly on specific day DayOfMonthMask, MonthOfYearMask, YearInterval
12 = Monthly on specific day DayOfMonthMask, MonthInterval
48 = Weekly DayOfWeekMask, DayOfWeekStart, WeekInterval
51 = Yearly on a pattern DayOfWeekMask, MonthOfYearMask, WeekInterval
56 = Monthly on a pattern DayOfWeekMask, MonthInterval, WeekInterval
64 = Daily DayInterval

Exceptions Property

Exceptions are deleted or modified properties of a recurring appointment or task. To delete, only two properties are required: Deleted and InstanceDate. To modify, the appointment or task must be redefined as a single appointment or task, and you must redefine the StartDate and EndDate, even if only the Location property is modified.

Property Values Description
Deleted T or F Whether instance was marked "deleted." If FALSE, instance has been modified.
InstanceDate mm-dd-yyyy Date that original instance occurred.

Related Topics

Schedule Data Secondary Files Formatting the Migration Files