Feature description

The PIM API provides Java MIDP applications (MIDlets) access to the personal user data residing in the device’s native memory or the SIM card. In Nokia devices this means the contents of the Phonebook (in device memory or SIM), the Calendar entries, and the items on the To-Do list.

PIM data is accessed through PIM lists, represented by the PIMList interface. There are three sub-interfaces of PIMList: ContactList, EventList, and ToDoList used for Contact lists, the Calendar, and the To-Do list.

The PIM API also provides functionality for importing and exporting the data in vCard and vCalendar Personal Data Interchange formats as specified by Internet Mail Consortium.

The Personal Information Management API 1.0 (PIM API) is included in the implementation as defined in JSR 75: PDA Optional Packages for the J2ME Platform.

Symbian supported features

The following features are supported:

  • ContactList for Phonebook entries in the device memory

  • EventList for Calendar appointment, Day Note, and Calendar Anniversary entries

  • ToDoList for To-do list entries

  • Versit personal information exchange formats vCard 2.1 for Contacts and vCalendar for Events and To-Dos

  • From S60 3rd Edition FP 2 onwards, the API implementation supports the Mobile Service Architecture (MSA) as defined in JSR-248 Mobile Service Architecture.

Some items have been excluded from each feature in the Symbian implementation. These exclusions are detailed in subsections corresponding to the each feature in the section Class and interface support.

The PIM API S60 3rd Edition Feature Pack 1 implementation supports new Symbian-specific extended fields for ContactList and ToDoList. These fields do not belong to the standard JSR-75 PIM API fields and thus do not have their own definitions. The extended fields can be used with own unique identifiers. which are detailed in subsections ContactList and ToDoList.

Series 40 supported features

The following features are supported:

  • ContactList for Phonebook entries in the device memory. The Series 40 implementation also supports reading and writing phonebook entries on SIM cards.

  • EventList for Meeting, Call, Birthday, Memo and Reminder entries

  • ToDoList for To-do list entries

  • Versit personal information exchange formats vCard 2.1 and 3.0 for Contacts and vCalendar for Events and To-Dos

Some items have been excluded from each feature in the Series 40 implementation. These exclusions are detailed in subsections corresponding to the each feature in the section Class and interface support.