View source

__NOTOC__
__NOEDITSECTION__
{{KBCS}}
{{CodeSnippet
|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()
}}

==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.

To obtain access to the service object for the Contact Service API, the <tt>device.getServiceObject("Service.Contact", "IDataSource")</tt> 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.

==Source: phonebook.html==

<code xml>
<?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>
</code>

==Source: phonebook.js==

<code javascript>
// 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);
    }
}
</code>

==Postconditions==

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

==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]].

==See also==

* [[CS001235 - Retrieving contacts info in WRT]]
* [[CS001243 - Removing contacts in WRT]]

[[Category:Web Runtime (WRT)]][[Category:Code Examples]][[Category:PIM]][[Category:S60 5th Edition]]