EventList in Series 40

In both Series 40 and S60 the calendar has several different types of entries. There is no explicit field for the entry type in the PIM API; instead there must be a separate list for each type of calendar entry.

The Series 40 implementation supports five types of events:

In Series 40 the calendar contains “notes” that are mapped to PIM API Event objects as detailed in this section.

Meeting

The following table displays the available calendar note types and their associated native fields together with the corresponding PIM API field:

Table 41: The supported Meeting Event fields

PIM API field

Corresponding Calendar Appointment field

Event.SUMMARY

Subject

Event.LOCATION

Location

Event.START

Start date/time

Event.END

End date/time

Event.ALARM

Alarm

Event.UID

(Internal unique identifier)

Call

The following table displays the available calendar note types and their associated native fields together with the corresponding PIM API field:

Table 42: The supported Call Event fields

PIM API field

Corresponding Calendar Appointment field

Event.SUMMARY

Phone number

Event.NOTE

Name

Event.START

Start date/time

Event.ALARM

Alarm

Event.UID

(Internal unique identifier)

Birthday

The following table displays the available calendar note types and their associated native fields together with the corresponding PIM API field:

Table 43: The supported Birthday Event fields

PIM API field

Corresponding Calendar Appointment field

Event.SUMMARY

Name

Event.NOTE

Year of birth

Event.START

Time

Event.ALARM

Alarm

Event.UID

(Internal unique identifier)

Memo

The following table displays the available calendar note types and their associated native fields together with the corresponding PIM API field:

Table 44: The supported Memo Event fields

PIM API field

Corresponding Calendar Appointment field

Event.SUMMARY

Subject

Event.START

Start date/time

Event.END

End date/time

Event.ALARM

Alarm

Event.UID

(Internal unique identifier)

Reminder

The following table displays the available calendar note types and their associated native fields together with the corresponding PIM API field:

Table 45: The supported Reminder Event fields

PIM API field

Corresponding Calendar Appointment field

Event.SUMMARY

About

Event.START

Start date/time

Event.ALARM

Alarm

Event.UID

(Internal unique identifier)

Repeating Calendar Events

Calendar events can repeat according to repeat rules set by the user, with the exception of the Birthday type, which has a yearly repeat. In PIM API the Event instance can have an associated RepeatRule class instance that stores information about how and when the Event repeats.

Table 46: The supported repeat rules for Event instances

Repeat Type

RepeatRule Attributes

Never

No associated RepeatRule for Event

Every day

(FREQUENCY, DAILY)

Every week

(FREQUENCY, WEEKLY)

Every 2 weeks

(FREQUENCY, WEEKLY) + (INTERVAL, 2)

Every month

(FREQUENCY, MONTHLY)

Every year

(FREQUENCY, YEARLY)

The Series 40 implementation also supports the following RepeatRule fields:

  • RepeatRule.END

  • RepeatRule.DAY_IN_WEEK

  • RepeatRule.DAY_IN_MONTH

  • RepeatRule.MONTH_IN_YEAR