Interchange Format Syntax

The Interchange format file begins with a header describing the owner of the file (the person to whom the schedule belongs) and when it was exported or created. The header is followed by descriptors for projects, tasks, notes, standard appointments, and recurring appointments. Although meetings are supported in the interchange format, they are not documented here. Meetings can be imported as standard appointments by the scheduling or calendar software that is exchanging data with Schedule+. The order of descriptors is not significant, except that projects must precede tasks.

The following section describes the syntax for individual descriptors.

If you export a Schedule+ calendar to the interchange format, you will find that each descriptor begins with a line defining a field called aid. This is an appointment ID defined and maintained by Schedule+; it should not be included in the import file.

Table 9.1 Key to Interchange Format Syntax

Header

SCHEDULE+ EXPORT BY mailbox name ON m/dd/yy AT hh:mm AM/PM

Nonprivate Project

FixedAppt:
àszText
project description
àfTask à à à à àT
àaidProject à à à à à àproject id # (integer, number in sequence)
End

Private Project

FixedAppt:
àszText
project description
àaaplWorld à à à à àRead
àfTask à à à à àT
àaidProject à à à à ààproject id # (integer, number in sequence)
End

Note The fTask line is present for all projects; other lines, like the aaplWorld line above, are present only for private projects.

Standard Task

FixedAppt:
àszText
task description
àfTask à à à à àT
àbpri à à à à à àpriority # (1–35, where 1–9 = priority 1–9 and 10–35 = priority A–Z)
àaidParent à à à à à àproject id # of associated project (integer)
End

Standard Private Task

FixedAppt:
àszText
task description
àaaplWorld à à à à àRead
àfTask à à à à àT
àbpri à à à à à àpriority # (1–35, where 1–9 = priority 1–9 and 10–35 = priority A–Z)
àaidParent à à à à ààproject id # of associated project (integer)
End

Task with Due Date and Start Work Date

FixedAppt:
àdateStart à à à à ààdue date in format m-d-yyyy hh:mm
àdateEnd à à à à ààdue date in format m-d-yyyy hh:mm
àszText
task description
àfTask à à à à àT
ànAmtBeforeDeadline à à à à àànteger # (with unit below, indicates start work before due date)
àtunitBeforeDeadline à à à à àunit: Day, Week, or Month (indicates start work before due date)
àbpri à à à à ààpriority # (1–35, where 1–9 = priority 1–9 and 10–35 = priority A–Z)
àaidParent à à à à ààproject id # of associated project
End

Note The dateStart and dateEnd lines ask for hh:mm. This must be supplied but won't be used for these date-oriented (rather than time-oriented) tasks. hh:mm should be 00:00.

Standard Appointment, Marked Private

FixedAppt:
àdateStart à à à à à àstart date and time in format m-d-yyyy hh:mm (time is 24 hour)
àdateEnd à à à à à àend date and time in format m-d-yyyy hh:mm (time is 24 hour)
àszText
appointment description
àaaplWorld à à à à àRead
End

Standard Appointment with Alarm

FixedAppt:
àdateStart à à à à à àstart date and time in format m-d-yyyy hh:mm (time is 24 hour)
àdateEnd à à à à à àend date and time in format m-d-yyyy hh:mm (time is 24 hour)
àszText
appointment description
àdateNotify à à à à à àspecification of alarm in format m-d-yyyy hh:mm (time is 24 hour)
ànAmt à à à à à àinteger defining how long before an appointment the alarm should go off
àtunit à à à à àthe unit (Minute, Hour, Day, Week, Month) defining the alarm
End

Note The dateNotify line asks for hh:mm. Place any time here; a value is required. The actual time used for the alarm is set in the nAmt and tunit lines.
If the alarm is in minutes, the tunit line is not required.

Recurring Appointment

RecurAppt:
àymdStart à à à à àstart date of recurrence pattern in format m-d-yyyy
àymdEnd à à à à àend date of recurrence pattern in format m-d-yyyy
àwgrfValidMonths à à à à àused to define recurrence pattern (see next section for detail)
àbgrfValidDows à à à à à àused to define recurrence pattern (see next section for detail)
àtrecur à à à à à àused to define recurrence pattern (see next section for detail)
àtimeStart à à à à àstart time in format hh:mm
àtimeEnd à à à à àend time in format hh:mm
àszText
Recurring appointment description
End

Note The ymdEnd line is required only if the recurring appointment has an end date. If it does not, omit the ymdEnd line. See the following section for more information about this type of entry.

Notes for One Month

MonthNotes:
àdate of Note in format m-d-yyyy
note #1 text
àdate of Note in format m-d-yyyy
note #2 text
End

Note All notes for the month are listed together in sequence.