1 <?xml version="1.0" encoding="utf-8"?>

     2 <!-- Copyright (c) 2007-2010 Nokia Corporation and/or its subsidiary(-ies) All rights reserved. -->

     3 <!-- This component and the accompanying materials are made available under the terms of the License 

     4 "Eclipse Public License v1.0" which accompanies this distribution, 

     5 and is available at the URL "http://www.eclipse.org/legal/epl-v10.html". -->

     6 <!-- Initial Contributors:

     7     Nokia Corporation - initial contribution.

     8 Contributors: 

     9 -->

    10 <!DOCTYPE concept

    11   PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd">

    12 <concept id="GUID-F23BB1F1-CF90-597F-8410-34AB8B567501" xml:lang="en"><title>PIM

    13 Subsystem Overview</title><prolog><metadata><keywords/></metadata></prolog><conbody>

    14 <section id="GUID-201D8954-325A-422C-94D3-772274154AF9"><title>Purpose</title> <p>This

    15 document describes storage, organisation and utility functionalities within

    16 Symbian platform Personal Information Management (PIM) technology, as defined

    17 by its subsystems: Application Engines and Application Services. </p> </section>

    18 <section id="GUID-78706FAF-6F53-4DFD-B77B-BA44C5E087B2"><title>Key Concepts</title> <p> <i>Application

    19 Engines</i> - provide PIM data storage and manipulation. </p> <p> <i>Application

    20 Services</i> - provide a collection of utility components.</p> <p> Application

    21 Engines and Application Services enable user applications to acquire, organise,

    22 maintain, and retrieve personal information. </p> <p> <i>Subsystem</i> - a

    23 cohesive group of components within a single technology. </p> <p> <i>Component</i> -

    24 the smallest unit of architectural significance and the finest grained unit

    25 of description. </p> </section>

    26 <section id="GUID-A76EE4BC-565F-4F5E-8943-1F9BE03B4D07"><title>Architectural

    27 Relationships</title> <p>PIM <xref href="GUID-F43E458D-6650-5BB0-871D-2E4EB1353C48.dita">Application

    28 Services</xref> technology delivers high-level OS services for storage and

    29 manipulation of user data (such as a collection of Calendar and Contacts items).

    30 PIM subsystem components are part of Application Engines and Application Services.

    31 The Symbian platform Generic Middleware layer contains the following PIM components:

    32 Alarm Server, Time Zone Server and Help Model. </p> <p>All the components

    33 are contained between the OS Services layer and the User Interface layer. </p> <p>Key

    34 clients of these components are licensee applications that use subsystems

    35 such as Telephony, SyncML and Messaging. </p> <fig id="GUID-5335C9B9-5C4E-5673-AB93-59C921C3AC58">

    36 <title>PIM Subsystem components are part of the Application Services and Generic

    37 Middleware layers</title>

    38 <image href="GUID-1742B2A1-6EC1-5368-919B-362516A5D452_d0e347864_href.png" placement="inline"/>

    39 </fig> </section>

    40 <section id="GUID-AEA465F8-77B5-45A6-B5A4-12083A9008F4"><title>Application

    41 Engines</title> <p>Application Engines provide data storage and manipulation

    42 for user data. </p><ul>

    43 <li><p><xref href="GUID-A1227CAE-EE08-5EAF-8D15-81465467C0C0.dita#GUID-A1227CAE-EE08-5EAF-8D15-81465467C0C0/GUID-85D629ED-30D4-5608-A816-07BD375C6A76">Calendar</xref> enables

    44 management of calendar entries and provides access to calendar stores. The

    45 CalInterimAPI library is the Calendar data store. </p></li>

    46 <li><p>The <xref href="GUID-A1227CAE-EE08-5EAF-8D15-81465467C0C0.dita#GUID-A1227CAE-EE08-5EAF-8D15-81465467C0C0/GUID-5F20F757-46F6-5652-AB0F-6B22DBB61111">Contacts

    47 model</xref> provides a unified interface for managing contact information. </p></li>

    48 </ul> </section>

    49 <section id="GUID-D6AC13D1-3C9F-44B2-8691-3F4583E7D805"><title>Application

    50 Services</title> <p>Application Services are used by multiple application

    51 engines or applications running on Symbian OS. </p> <ul>

    52 <li><p><xref href="GUID-F43E458D-6650-5BB0-871D-2E4EB1353C48.dita#GUID-F43E458D-6650-5BB0-871D-2E4EB1353C48/GUID-8BD6CF61-80B6-5869-AB85-F572C590DB30">Alarm

    53 Server</xref> maintains a queue of system-wide alarms. </p></li>

    54 <li><p><xref href="GUID-F43E458D-6650-5BB0-871D-2E4EB1353C48.dita#GUID-F43E458D-6650-5BB0-871D-2E4EB1353C48/GUID-32519F1C-429A-59C9-B945-D0B1F81A0AA5">Calendar

    55 Conversion</xref> converts dates between Gregorian and Chinese lunar calendar

    56 dates for applications requiring Chinese date support. </p></li>

    57 <li><p><xref href="GUID-F43E458D-6650-5BB0-871D-2E4EB1353C48.dita#GUID-F43E458D-6650-5BB0-871D-2E4EB1353C48/GUID-6EB921E1-0048-5388-8983-87172763FAB3">Help

    58 model</xref> manages a collection of files that provide context-sensitive

    59 help information. </p></li>

    60 <li><p>Notepad API is a middleware tool that you can write simple text to

    61 and save for future reference. </p>  </li>

    62 <li><p>The Calendar Interim Utils2 is an Organizer API that provides methods

    63 you can use to keep track of your time, extending APIs from Symbian OS. It

    64 displays the individual days of a given time period. You can add notes and

    65 memos to these dates to organize your schedule.</p>  </li>

    66 <li><p>Phonebook APIs provide methods useful in creating a contacts database

    67 and performing various operations on it. These APIs expand on the Contact

    68 model.</p>  </li>

    69 <li><p><xref href="GUID-F43E458D-6650-5BB0-871D-2E4EB1353C48.dita#GUID-F43E458D-6650-5BB0-871D-2E4EB1353C48/GUID-4268D6AA-F468-5461-88A2-D6852D4AC69A">Time

    70 zone localization</xref> provides localized versions of time zone and city

    71 names. </p></li>

    72 <li><p><xref href="GUID-F43E458D-6650-5BB0-871D-2E4EB1353C48.dita#GUID-F43E458D-6650-5BB0-871D-2E4EB1353C48/GUID-D30706E5-7191-5349-A883-C200B73AFED1">Time

    73 zone server</xref> allows clients to obtain accurate conversion between any

    74 time expressed in UTC and local time for a user's time zone. </p></li>

    75 <li><p><xref href="GUID-F43E458D-6650-5BB0-871D-2E4EB1353C48.dita#GUID-F43E458D-6650-5BB0-871D-2E4EB1353C48/GUID-9DFB0954-9CDF-5DAF-BA7A-54A1D64833F7">Versit</xref> is

    76 a set of utility classes that support the import and export of data that is

    77 formatted according to a set of standards initially defined by the Versit

    78 consortium. </p></li>

    79 </ul><p>There are no strong relationships between any of the subsystem components.

    80 They are presented as a subsystem because they enable development of a set

    81 of related applications.</p></section>

    82 </conbody></concept>