Contacts Service API - Example Widget Documentation

About this document

This document describes the ContactSample Example Widget application for S60 5th Edition SDK . Read this document if you are a web developer, testing professional, or the product manager working on this product.

About this Product

Widgets are lightweight Web applications developed using the same well-known standards-based Web technologies – AJAX, CSS, HTML and JavaScript – used to create Web pages. Developers can use it as a reference and testers can use it to test the relevant functionality. widget is intended for S60 5th Edition SDK . Developers should be able to develop professional applications.

Product intent

Example Widget Application is designed to run on S60 5th Edition SDK. It will be designed such that a developer takes it as a reference to create useful applications for any functionality supported on SDK. It will be designed to let the testers to test the functionality

Product limitations

Example widget is not intended to give full featured implementation. This example will implement the WRT 1.0 APIs. It runs a javascript with errors and shows the error either on console or log to a file depending on the option set in browser

Specification

The example widget uses the WRT 1.0 API. The Web Runtime (WRT) environment supports the following Internet technology standards:

HTML 4.01
The basic HTML standards are supported.

XHTML 1.0
The basic XHTML standards are supported.

CSS Level 2 revision 1 (CSS 2.1)

JavaScript 1.5 (ECMA-262 3rd Edition)
The standard JavaScript features are supported. The WRT environment also provides some additional features that are mobile device specific.
The following additional JavaScript features are supported in the WRT environment:

• Utilizing the underlying user input features of the mobile device to interact with the user
• Self-updating widgets
• UI navigation using either a cursor or tabs
• Rotating the screen: portrait and landscape orientation
• Launching S60 mobile applications
• Localization framework with automatic detection of the device language settings
• Getting information on physical device functionality and controlling such features.

Example Description

The Contact API Sample widget demonstrates the Contact API support given by the SDK. The widget opens up with some options with following USE CASES.

Use Cases

• Add Contact
• DeleteContact
• GetContactList
• ImportContact
• Export Contact
• AddGroup
• DeleteGroup
• GetGroupList
• OrganiseGroup

Installing and Running the Widget

1. Use the file - Open option to open the widget under <Installed-5th-Edition-SDK>\S60WidgetExamples\ContactWidget.wgz



2. The SDK recognises and installs the widget. Run the widget from the installations folder.



3. Start the Widget from the installed folder i.e., Menu >> Application.
4. Once the widget is started we get to see the following options.



5. Clicking on the "AddContact" button will add a dummy contact to the phone book. That can be viewed by either going to Phone Book application of the emulator application or by clicking on the "GetContactlist" button.



6. Use the option "DeleteContact" to delete any entry in the contact. To make sure weather the contact has been deleted or not we can verify anytime by using "GetContact" option.
7. We can even import contact from any text file by using the "ImportContact" button. This option prompts for a Dialogue box which ask for the file from which a contact has to be imported.
8. The sameway we can export a contact to a file using the option "ExportContact".
9. Similar to contacts we have functionalities for groups also like.
   1. AddGroup - to add a new group.
   2. DeleteGroup - To delete a already created group.
   3. GetGroupList - to fetch the group list.
   4. OrganiseGroup - to Organise a group.

Example Widget Application does not support internationalization