×
Namespaces

Variants
Actions
(Difference between revisions)

Adding contact in Symbian Web Runtime

From Nokia Developer Wiki
Jump to: navigation, search
hamishwillee (Talk | contribs)
m (Hamishwillee - Bot change of template (Template:CodeSnippet) - now using Template:ArticleMetaData)
hamishwillee (Talk | contribs)
m (Hamishwillee - Add Abstract. Tidy wiki text)
 
(6 intermediate revisions by one user not shown)
Line 1: Line 1:
__NOTOC__
+
[[Category:Symbian Web Runtime]][[Category:PIM]][[Category:S60 5th Edition]][[Category:Code Examples]]
__NOEDITSECTION__
+
{{Abstract|This code example shows how to add contacts to the device's default phone book in Symbian Web Runtime.}}
{{KBCS}}
+
{{ArticleMetaData
+
|id=CS001238
+
|platform=S60 5th Edition
+
|devices=Nokia 5800 XpressMusic
+
|category=Web Runtime (WRT)
+
|subcategory=PIM
+
|creationdate=December 18, 2008
+
|keywords=device.getServiceObject(), Service.Contact.Add()
+
  
|sourcecode= <!-- Link to example source code (e.g. [[Media:The Code Example ZIP.zip]]) -->
+
{{ArticleMetaData <!-- v1.2 -->
 +
|sourcecode= [[Media:Adding contact in WRT.zip]]
 
|installfile= <!-- Link to installation file (e.g. [[Media:The Installation File.sis]]) -->
 
|installfile= <!-- Link to installation file (e.g. [[Media:The Installation File.sis]]) -->
|sdk=<!-- SDK(s) built and tested against (e.g. [http://linktosdkdownload/ Nokia Qt SDK 1.1]) -->
+
|devices= Nokia 5800 XpressMusic
|devicecompatability=<!-- Compatible devices (e.g.: All* (must have GPS) ) -->
+
|sdk= <!-- SDK(s) built and tested against (e.g. [http://linktosdkdownload/ Nokia Qt SDK 1.1]) -->
|signing=<!-- Empty or one of Self-Signed, DevCert, Manufacturer -->
+
|platform= S60 5th Edition
|capabilities=<!-- Capabilities required (e.g. Location, NetworkServices. -->)
+
|devicecompatability= <!-- Compatible devices (e.g.: All* (must have GPS) ) -->
|author=[[User:MiGryz]]
+
|dependencies= <!-- Any other/external dependencies e.g.: Google Maps Api v1.0 -->
 +
|signing= <!-- Signing requirements - empty or one of: Self-Signed, DevCert, Manufacturer -->
 +
|capabilities= <!-- Capabilities required by the article/code example (e.g. Location, NetworkServices. -->
 +
|keywords= device.getServiceObject(), Service.Contact.Add()
 +
|language= <!-- Language category code for non-English topics - e.g. Lang-Chinese -->
 +
|translated-by= <!-- [[User:XXXX]] -->
 +
|translated-from-title= <!-- Title only -->
 +
|translated-from-id= <!-- Id of translated revision -->
 +
|review-by= <!-- After re-review: [[User:username]] -->
 +
|review-timestamp= <!-- After re-review: YYYYMMDD -->
 +
|update-by= <!-- After significant update: [[User:username]]-->
 +
|update-timestamp= <!-- After significant update: YYYYMMDD -->
 +
|creationdate= 20081210
 +
|author= [[User:MiGryz]]
 +
<!-- The following are not in current metadata -->
 +
|id= CS001238
 
}}
 
}}
  
 
==Overview==
 
==Overview==
  
This code snippet shows how to add contacts to the device's default phone book using the Contact Platform Service for S60 Web Runtime introduced in S60 5th Edition.
+
The example uses the Contact Platform Service, introduced in S60 5th Edition.
  
To obtain access to the service object for the Contact Service API, the <tt>device.getServiceObject("Service.Contact", "IDataSource")</tt> method is used.
+
To obtain access to the service object for the Contact Service API, the {{Icode|device.getServiceObject("Service.Contact", "IDataSource")}} method is used.
  
After setting the correct values for the criteria object (<tt>criteria.Type</tt> and <tt>criteria.Data</tt>), the <tt>IDataSource.Add(criteria)</tt> method is used to add the new contact.
+
After setting the correct values for the criteria object ({{Icode|criteria.Type}} and {{Icode|criteria.Data}}), the {{Icode|IDataSource.Add(criteria)}} method is used to add the new contact.
  
 
==Source: phonebook.html==
 
==Source: phonebook.html==
Line 126: Line 133:
 
==Supplementary material==
 
==Supplementary material==
  
You can view the source file and executable application in the attached ZIP archive. The archive is available for download at [[Media:Adding_contact_in_WRT.zip]].
+
You can view the source file and executable application in the attached ZIP archive. The archive is available for download at [[Media:Adding contact in WRT.zip]].
  
 
==See also==
 
==See also==
  
* [[CS001235 - Retrieving contacts info in WRT]]
+
* [[Retrieving contacts info in Symbian Web Runtime]]
* [[CS001243 - Removing contacts in WRT]]
+
* [[Removing contacts in Symbian Web Runtime]]
 
+
[[Category:Symbian Web Runtime]][[Category:Code Examples]][[Category:PIM]][[Category:S60 5th Edition]][[Category:Code Snippet]]
+

Latest revision as of 09:59, 5 October 2012

This code example shows how to add contacts to the device's default phone book in Symbian Web Runtime.

Article Metadata
Code ExampleTested with
Devices(s): Nokia 5800 XpressMusic
Compatibility
Platform(s): S60 5th Edition
S60 5th Edition
Article
Keywords: device.getServiceObject(), Service.Contact.Add()
Created: MiGryz (10 Dec 2008)
Last edited: hamishwillee (05 Oct 2012)

Contents

[edit] Overview

The example uses the Contact Platform Service, introduced in S60 5th Edition.

To obtain access to the service object for the Contact Service API, the device.getServiceObject("Service.Contact", "IDataSource") method is used.

After setting the correct values for the criteria object (criteria.Type and criteria.Data), the IDataSource.Add(criteria) method is used to add the new contact.

[edit] Source: phonebook.html

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
<script type="text/javascript" src="phonebook.js" />
<title></title>
</head>
<body onload="init()">
<div id="inputdata">
First Name: <input id="firstname" type="text"></input><br />
Last Name: <input id="lastname" type="text"></input><br />
Phone number: <input id="phonenumber" type="text"></input><br />
E-Mail: <input id="email" type="text"></input><br />
<input type="button" value="Add" onclick="doSave();" />
</div>
</body>
</html>

[edit] Source: phonebook.js

// contacts system service object
var phonebook;
 
/**
* Setting default data on application load
*/

function init() {
// getting contacts system service object
try {
phonebook = device.getServiceObject("Service.Contact", "IDataSource");
} catch(err) {
alert( "No Contact service available" );
return;
}
}
 
/**
* function adds an item to the default phonebook
*/

function doSave() {
// Criteria object for adding contacts
var criteria = new Object();
criteria.Type = 'Contact';
criteria.Data = new Object();
 
// demanding first name, but that is not essential
if(document.getElementById('firstname').value == "") {
alert("You should input firstname");
return;
}
 
// adding First Name parameter to new item
criteria.Data.FirstName = new Object();
criteria.Data.FirstName.Value =
document.getElementById('firstname').value;
// adding other parameters if present
if(document.getElementById('lastname').value != "") {
criteria.Data.LastName = new Object();
criteria.Data.LastName.Value =
document.getElementById('lastname').value;
}
if(document.getElementById('phonenumber').value != "") {
criteria.Data.MobilePhoneGen = new Object();
criteria.Data.MobilePhoneGen.Value =
document.getElementById('phonenumber').value;
}
if(document.getElementById('email').value != "") {
criteria.Data.EmailGen = new Object();
criteria.Data.EmailGen.Value =
document.getElementById('email').value;
}
 
var result = 0;
try {
result = phonebook.IDataSource.Add(criteria);
} catch(err) {
alert( "error saving data" );
return;
}
if(result.ErrorCode != 0) {
alert(result.ErrorMessage);
}
}

[edit] Postconditions

  • Filling in the fields and selecting "Add" will add a new item to the default phone book.

[edit] Supplementary material

You can view the source file and executable application in the attached ZIP archive. The archive is available for download at Media:Adding contact in WRT.zip.

[edit] See also

This page was last modified on 5 October 2012, at 09:59.
120 page views in the last 30 days.

Was this page helpful?

Your feedback about this content is important. Let us know what you think.

 

Thank you!

We appreciate your feedback.

×