--- .../html/web/tizen/social/contact_tutorial_w.htm | 8 +- .../html/device_api/mobile/tizen/contact.html | 364 ++++++++++++++++++--- 2 files changed, 321 insertions(+), 51 deletions(-) diff --git a/org.tizen.tutorials/html/web/tizen/social/contact_tutorial_w.htm b/org.tizen.tutorials/html/web/tizen/social/contact_tutorial_w.htm index 0ab35a9..0f5fb67 100644 --- a/org.tizen.tutorials/html/web/tizen/social/contact_tutorial_w.htm +++ b/org.tizen.tutorials/html/web/tizen/social/contact_tutorial_w.htm @@ -469,7 +469,11 @@ try

To manage a single person:
1. To retrieve persons, use the find() method of the ContactManager interface:
```
tizen.contact.find(personsFoundCB);
```
2. To retrieve persons, use the find() method of the ContactManager interface. You can retrieve the most frequently used persons using a SortMode with the attribute usageCount.
  +
```
+var sortMode = new tizen.SortMode("usageCount", "ASC");
+tizen.contact.find(personsFoundCB, personsErrorCB, null, sortMode);
+
```
3. Update or delete the found persons in the personsFoundCB() event handler. In this example, the favorite flag of the first person is changed and the contact is updated using the update() method. The second person is deleted using the remove() method.
```
/* Define the event success callback */
 function personsFoundCB(persons)
 {
@@ -520,4 +524,4 @@ var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga
 
 
 
-
\ No newline at end of file
+
diff --git a/org.tizen.web.apireference/html/device_api/mobile/tizen/contact.html b/org.tizen.web.apireference/html/device_api/mobile/tizen/contact.html
index be128ee..4d13efb 100644
--- a/org.tizen.web.apireference/html/device_api/mobile/tizen/contact.html
+++ b/org.tizen.web.apireference/html/device_api/mobile/tizen/contact.html
@@ -7,7 +7,6 @@
 
 
 
-
 Contact API
 
  The Contact API provides functionality for managing address books.
@@ -94,15 +93,19 @@ For more information on the Contact features, see ContactRelationship
 
```
4. 2.21. PersonArraySuccessCallback +
5. 2.21. ContactExtensionInit
6. 2.22. ContactArraySuccessCallback +
7. 2.22. ContactExtension
8. 2.23. AddressBookArraySuccessCallback +
9. 2.23. PersonArraySuccessCallback
10. 2.24. AddressBookChangeCallback +
11. 2.24. ContactArraySuccessCallback
12. 2.25. PersonsChangeCallback +
13. 2.25. AddressBookArraySuccessCallback +
14. 2.26. AddressBookChangeCallback +
15. 2.27. PersonsChangeCallback
16. + readonly +long usageCount
  +The number of contact usage. +
  +
  +
  +usage type refers to contacts_usage_type_e of native API +
  +
  +
  +Since: +3.0
17. +ContactExtension[] +extensions
  +The extended data of the contact. +
  +
  +
  +By default, this attribute is set to an empty array. +
  +
  +
  +Since: +3.0 +
  +
  +
  Code example:
```
+var contactInit = {};
+			var extension = new tizen.ContactExtension({ data1: 20, data2: 'Place of birth: ElblÄg' });
+			contactInit.extensions = [extension];
+ 
```
  +
  +
18. Date birthday [nullable]
  The birthday of the contact. @@ -5748,8 +5763,210 @@ By default, this attribute is initialized to null.
  +
  +
  2.21. ContactExtensionInit
  +
  +The ContactExtensionInit dictionary defines the properties of a ContactExtension to pass to the ContactExtension constructor. +
  +
```
 dictionary ContactExtensionInit
+  {
+    long data1;
+    DOMString data2;
+    DOMString data3;
+    DOMString data4;
+    DOMString data5;
+    DOMString data6;
+    DOMString data7;
+    DOMString data8;
+    DOMString data9;
+    DOMString data10;
+    DOMString data11;
+    DOMString data12;
+  };
```
  +
  +Since: +3.0 +
  +
  +
  +See ContactExtension interface for more information about the members. +
  +
  +
  +
  +
  2.22. ContactExtension
  +
  +The ContactExtension interface contains the extended data of the contact. +
  +
```
 [Constructor(optional ContactExtensionInit? extensionInitDict)]
+  interface ContactExtension
+  {
+    attribute long data1;
+
+    attribute DOMString? data2;
+
+    attribute DOMString? data3;
+
+    attribute DOMString? data4;
+
+    attribute DOMString? data5;
+
+    attribute DOMString? data6;
+
+    attribute DOMString? data7;
+
+    attribute DOMString? data8;
+
+    attribute DOMString? data9;
+
+    attribute DOMString? data10;
+
+    attribute DOMString? data11;
+
+    attribute DOMString? data12;
+  };
```
  +
  +Since: +3.0 +
  +
  +
  +See code example below. +
  +
  +
  +
  Code example:
```
 var name = new tizen.ContactName({ firstName: 'Anna' });
+
+  var contact_extension1 = new tizen.ContactExtension({ data1: 20, data2: 'Place of birth: ElblÄg' });
+  var contact_extension2 = new tizen.ContactExtension({ data3: 'Favourite color: green' });
+  var contact1 = new tizen.Contact({
+    name: name,
+    extensions: [ contact_extension1, contact_extension2 ]
+  });
+
+  console.log(contact1.extensions[1].data3); // It shows: 'Favourite color: green'
+
```
  +
  +
  +
  Constructors
  +
  ContactExtension(optional ContactExtensionInit? extensionInitDict);
  +
  +
  +
  Attributes
  +
  - +long data1
    +The extended data of a contact. +
    +
    +Since: +3.0 +
    +
  - +DOMString data2 [nullable]
    +The extended data of a contact. +
    +
    +Since: +3.0 +
    +
  - +DOMString data3 [nullable]
    +The extended data of a contact. +
    +
    +Since: +3.0 +
    +
  - +DOMString data4 [nullable]
    +The extended data of a contact. +
    +
    +Since: +3.0 +
    +
  - +DOMString data5 [nullable]
    +The extended data of a contact. +
    +
    +Since: +3.0 +
    +
  - +DOMString data6 [nullable]
    +The extended data of a contact. +
    +
    +Since: +3.0 +
    +
  - +DOMString data7 [nullable]
    +The extended data of a contact. +
    +
    +Since: +3.0 +
    +
  - +DOMString data8 [nullable]
    +The extended data of a contact. +
    +
    +Since: +3.0 +
    +
  - +DOMString data9 [nullable]
    +The extended data of a contact. +
    +
    +Since: +3.0 +
    +
  - +DOMString data10 [nullable]
    +The extended data of a contact. +
    +
    +Since: +3.0 +
    +
  - +DOMString data11 [nullable]
    +The extended data of a contact. +
    +
    +Since: +3.0 +
    +
  - +DOMString data12 [nullable]
    +The extended data of a contact. +
    +
    +Since: +3.0 +
    +
  +
  +
  -
  2.21. PersonArraySuccessCallback
  +
  2.23. PersonArraySuccessCallback
  
  The PersonArraySuccessCallback interface defines the success callback that is used for retrieving a list of persons. @@ -5798,7 +6015,7 @@ get or save a list of persons.
  
  -
  2.22. ContactArraySuccessCallback
  +
  2.24. ContactArraySuccessCallback
  
  The ContactArraySuccessCallback interface defines the success callback that is used for saving and retrieving a list of contacts. @@ -5848,7 +6065,7 @@ The Contacts that were successfully saved must have their identifiers set.
  
  -
  2.23. AddressBookArraySuccessCallback
  +
  2.25. AddressBookArraySuccessCallback
  
  The AddressBookArraySuccessCallback interface defines the success callback that is called when retrieving a list of AddressBooks.
  @@ -5896,7 +6113,7 @@ get address books.
  
  -
  2.24. AddressBookChangeCallback
  +
  2.26. AddressBookChangeCallback
  
  The AddressBookChangeCallback interface provides the methods to be called for address book change notifications. @@ -5994,7 +6211,7 @@ book change occurs (contact addition/update/deletion).
  
  -
  2.25. PersonsChangeCallback
  +
  2.27. PersonsChangeCallback
  
  The PersonsChangeCallback interface provides the methods to be called for change notifications.
  @@ -6226,6 +6443,8 @@ list change occurs (person addition/update/deletion). attribute ContactId displayContactId; + readonly attribute long usageCount; + void link(PersonId personId) raises(WebAPIException); Person unlink(ContactId contactId) raises(WebAPIException); @@ -6239,6 +6458,7 @@ list change occurs (person addition/update/deletion). ContactEmailAddress[] emails; ContactInstantMessenger[] messengers; ContactRelationship[] relationships; + ContactExtension[] extensions; Date birthday; ContactAnniversary[] anniversaries; ContactOrganization[] organizations; @@ -6277,6 +6497,8 @@ list change occurs (person addition/update/deletion). attribute ContactRelationship[] relationships; + attribute ContactExtension[] extensions; + attribute Date? birthday setraises(WebAPIException); attribute ContactAnniversary[] anniversaries setraises(WebAPIException); @@ -6474,6 +6696,50 @@ list change occurs (person addition/update/deletion). attribute DOMString? label; }; + dictionary ContactExtensionInit + { + long data1; + DOMString data2; + DOMString data3; + DOMString data4; + DOMString data5; + DOMString data6; + DOMString data7; + DOMString data8; + DOMString data9; + DOMString data10; + DOMString data11; + DOMString data12; + }; + + [Constructor(optional ContactExtensionInit? extensionInitDict)] + interface ContactExtension + { + attribute long data1; + + attribute DOMString? data2; + + attribute DOMString? data3; + + attribute DOMString? data4; + + attribute DOMString? data5; + + attribute DOMString? data6; + + attribute DOMString? data7; + + attribute DOMString? data8; + + attribute DOMString? data9; + + attribute DOMString? data10; + + attribute DOMString? data11; + + attribute DOMString? data12; + }; + [Callback=FunctionOnly, NoInterfaceObject] interface PersonArraySuccessCallback { void onsuccess(Person[] persons); }; -- 2.7.4

Contact API

2.21. ContactExtensionInit

2.22. ContactExtension

Constructors

Attributes

2.21. PersonArraySuccessCallback

2.23. PersonArraySuccessCallback

2.22. ContactArraySuccessCallback

2.24. ContactArraySuccessCallback

2.23. AddressBookArraySuccessCallback

2.25. AddressBookArraySuccessCallback

2.24. AddressBookChangeCallback

2.26. AddressBookChangeCallback

2.25. PersonsChangeCallback

2.27. PersonsChangeCallback