4 * Copyright (c) 2010 - 2015 Samsung Electronics Co., Ltd. All rights reserved.
6 * Licensed under the Apache License, Version 2.0 (the "License");
7 * you may not use this file except in compliance with the License.
8 * You may obtain a copy of the License at
10 * http://www.apache.org/licenses/LICENSE-2.0
12 * Unless required by applicable law or agreed to in writing, software
13 * distributed under the License is distributed on an "AS IS" BASIS,
14 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
15 * See the License for the specific language governing permissions and
16 * limitations under the License.
20 #ifndef __TIZEN_SOCIAL_CONTACTS_VIEWS_H__
21 #define __TIZEN_SOCIAL_CONTACTS_VIEWS_H__
23 #include "contacts_types.h"
31 * @file contacts_views.h
35 * @ingroup CAPI_SOCIAL_CONTACTS_SVC_MODULE
36 * @defgroup CAPI_SOCIAL_CONTACTS_SVC_VIEW_MODULE View/Property
38 * @brief This page provides information about views with properties.
40 * @section CAPI_SOCIAL_CONTACTS_SVC_VIEW_MODULE_HEADER Required Header
41 * \#include <contacts.h>
43 * @section CAPI_SOCIAL_CONTACTS_SVC_VIEW_MODULE_OVERVIEW Overview
44 * In this category, application developers can find tables with view properties.
46 * A view is a structure which describes properties of a record.
48 * A record can have basic properties of five types: integer, string, boolean, long integer, double. Each property
49 * of basic type has functions to operate on it:
53 * <th>Property type</th>
59 * <td> @ref contacts_record_set_str </td>
60 * <td> @ref contacts_record_get_str </td>
64 * <td> @ref contacts_record_set_int </td>
65 * <td> @ref contacts_record_get_int </td>
69 * <td> @ref contacts_record_set_bool </td>
70 * <td> @ref contacts_record_get_bool </td>
73 * <td> long integer </td>
74 * <td> @ref contacts_record_set_lli </td>
75 * <td> @ref contacts_record_get_lli </td>
79 * <td> @ref contacts_record_set_double </td>
80 * <td> @ref contacts_record_get_double </td>
84 * For long integer functions, "lli" stands for long long int, usually used to hold UTC time.
86 * Record types which have *_id as their properties, hold identifiers of other records - for example, name, number and email
87 * views hold ID of their corresponding contacts in contact_id property
88 * (as children of the corresponding contacts record).
90 * Properties of type 'record' are other records. For example, the _contacts_contact view
91 * has a 'name' property of type 'record'. This means that records of type name (_contacts_name view)
92 * can be children of the contact record. If a name record holds the identifier
93 * of a contact record in its 'contact_id' property, it is the child record of the corresponding
96 * Records can have many children of a given type.
98 * For a more detailed explanation and examples, see the main section of Contacts API.
105 * @addtogroup CAPI_SOCIAL_CONTACTS_SVC_VIEW_MODULE View/Property
106 * @section CAPI_SOCIAL_CONTACTS_SVC_VIEW_MODULE_contacts_address_book _contacts_address_book view
110 * <th>Property ID</th>
111 * <th>Read, Write</th>
112 * <th>Description</th>
114 * <tr><td>string</td><td>_uri</td><td>read only</td><td> Identifier of this contacts addressbook view </td></tr>
115 * <tr><td>integer</td><td> id </td><td>read only</td><td> DB record ID of the addressbook </td></tr>
116 * <tr><td>integer</td><td> account_id </td><td>read, write once</td><td> Account ID that the addressbook belongs to </td></tr>
117 * <tr><td>string</td><td> name </td><td>read, write</td><td> It cannot be @c NULL. Duplicate names are not allowed. </td></tr>
118 * <tr><td>integer</td><td> mode </td><td>read, write</td><td> Addressbook mode, refer to the @ref contacts_address_book_mode_e </td></tr>
121 _CONTACTS_BEGIN_VIEW()
122 _CONTACTS_PROPERTY_INT(id) /* read only */
123 _CONTACTS_PROPERTY_INT(account_id) /* read, write once */
124 _CONTACTS_PROPERTY_STR(name) /* read, write */
125 _CONTACTS_PROPERTY_INT(mode) /* read, write */
126 _CONTACTS_END_VIEW(_contacts_address_book)
129 * @addtogroup CAPI_SOCIAL_CONTACTS_SVC_VIEW_MODULE View/Property
130 * @section CAPI_SOCIAL_CONTACTS_SVC_VIEW_MODULE_contacts_group _contacts_group view
134 * <th>Property ID</th>
135 * <th>Read, Write</th>
136 * <th>Description</th>
138 * <tr><td>string</td><td>_uri</td><td>read only</td><td> Identifier of this contacts group view </td></tr>
139 * <tr><td>integer</td><td> id </td><td>read only</td><td> DB record ID of the group </td></tr>
140 * <tr><td>integer</td><td> address_book_id </td><td>read, write once</td><td> Addressbook ID that the group belongs to </td></tr>
141 * <tr><td>string</td><td> name </td><td>read, write</td><td> Group name </td></tr>
142 * <tr><td>string</td><td> ringtone_path </td><td>read, write</td><td> Ringtone path of the group </td></tr>
143 * <tr><td>string</td><td> image_path </td><td>read, write</td><td> Image path of the group </td></tr>
144 * <tr><td>string</td><td> vibration </td><td>read, write</td><td> Vibration path of the group </td></tr>
145 * <tr><td>string</td><td> extra_data </td><td>read, write</td><td> Extra data for default group name </td></tr>
146 * <tr><td>boolean</td><td> is_read_only </td><td>read, write once</td><td> The group is read only or not </td></tr>
147 * <tr><td>string</td><td> message_alert </td><td>read, write</td><td> Message alert path of the group </td></tr>
151 _CONTACTS_BEGIN_VIEW()
152 _CONTACTS_PROPERTY_INT(id) /* read only */
153 _CONTACTS_PROPERTY_INT(address_book_id) /* read, write once */
154 _CONTACTS_PROPERTY_STR(name) /* read, write */
155 _CONTACTS_PROPERTY_STR(ringtone_path) /* read, write */
156 _CONTACTS_PROPERTY_STR(image_path) /* read, write */
157 _CONTACTS_PROPERTY_STR(vibration) /* read, write */
158 _CONTACTS_PROPERTY_STR(extra_data) /* read, write, string */
159 _CONTACTS_PROPERTY_BOOL(is_read_only) /* read, write once */
160 _CONTACTS_PROPERTY_STR(message_alert) /* read, write */
161 _CONTACTS_END_VIEW(_contacts_group)
164 * @addtogroup CAPI_SOCIAL_CONTACTS_SVC_VIEW_MODULE View/Property
165 * @section CAPI_SOCIAL_CONTACTS_SVC_VIEW_MODULE_contacts_person _contacts_person view
169 * <th>Property ID</th>
170 * <th>Read, Write</th>
171 * <th>Description</th>
173 * <tr><td>string</td><td>_uri</td><td>read only</td><td> Identifier of this contacts person view </td></tr>
174 * <tr><td>integer</td><td> id </td><td>read only</td><td> DB record ID of the person </td></tr>
175 * <tr><td>string</td><td> display_name </td><td>read only</td><td> Display name of the person </td></tr>
176 * <tr><td>string</td><td> display_name_index </td><td>read only</td><td> The first character of first string for grouping. This is normalized using icu (projection) </td></tr>
177 * <tr><td>integer</td><td> display_contact_id </td><td>read only</td><td> Display contact ID that the person belongs to </td></tr>
178 * <tr><td>string</td><td> ringtone_path </td><td>read, write</td><td> Ringtone path of the person </td></tr>
179 * <tr><td>string</td><td> image_thumbnail_path </td><td>read only</td><td> Image thumbnail path of the person </td></tr>
180 * <tr><td>string</td><td> vibration </td><td>read, write</td><td> Vibration path of the person </td></tr>
181 * <tr><td>string</td><td> message_alert </td><td>read, write</td><td> Message alert path of the person </td></tr>
182 * <tr><td>string</td><td> status </td><td>read only</td><td> Status of social account </td></tr>
183 * <tr><td>boolean</td><td> is_favorite </td><td>read, write</td><td> The person is favorite or not </td></tr>
184 * <tr><td>double</td><td> favorite_priority </td><td> sort only </td><td> The priority of favorite contacts. You cannot get/set the value but you can use it as sorting key, see the @ref contacts_query_set_sort </td></tr>
185 * <tr><td>integer</td><td> link_count </td><td>read only</td><td> Link count of contact records (projection) </td></tr>
186 * <tr><td>string</td><td> addressbook_ids </td><td>read only</td><td> Addressbook IDs that the person belongs to (projection) </td></tr>
187 * <tr><td>boolean</td><td> has_phonenumber </td><td>read only</td><td> The person has phone number or not </td></tr>
188 * <tr><td>boolean</td><td> has_email </td><td>read only</td><td> The person has email or not </td></tr>
191 _CONTACTS_BEGIN_VIEW()
192 _CONTACTS_PROPERTY_INT(id) /* read only */
193 _CONTACTS_PROPERTY_STR(display_name) /* read only */
194 _CONTACTS_PROPERTY_STR(display_name_index) /* read only */
195 _CONTACTS_PROPERTY_INT(display_contact_id) /* read, write */
196 _CONTACTS_PROPERTY_STR(ringtone_path) /* read, write */
197 _CONTACTS_PROPERTY_STR(image_thumbnail_path) /* read only */
198 _CONTACTS_PROPERTY_STR(vibration) /* read, write */
199 _CONTACTS_PROPERTY_STR(status) /* read only */
200 _CONTACTS_PROPERTY_BOOL(is_favorite) /* read, write */
201 _CONTACTS_PROPERTY_DOUBLE(favorite_priority) /* sort only */
202 _CONTACTS_PROPERTY_INT(link_count) /* read only */
203 _CONTACTS_PROPERTY_STR(addressbook_ids) /* read only */
204 _CONTACTS_PROPERTY_BOOL(has_phonenumber) /* read only */
205 _CONTACTS_PROPERTY_BOOL(has_email) /* read only */
206 _CONTACTS_PROPERTY_STR(message_alert) /* read, write */
207 _CONTACTS_END_VIEW(_contacts_person)
210 * @addtogroup CAPI_SOCIAL_CONTACTS_SVC_VIEW_MODULE View/Property
211 * @section CAPI_SOCIAL_CONTACTS_SVC_VIEW_MODULE_contacts_simple_contact _contacts_simple_contact view
212 * You can only get simple contact using this view.
216 * <th>Property ID</th>
217 * <th>Description</th>
219 * <tr><td>string</td><td>_uri</td><td> Identifier of this simple contact view </td></tr>
220 * <tr><td>integer</td><td>id</td><td> DB record ID of the contact </td></tr>
221 * <tr><td>string</td><td>display_name</td><td> Display name of the contact </td></tr>
222 * <tr><td>integer</td><td>display_source_id</td><td> The source type of display name, refer to the @ref contacts_display_name_source_type_e </td></tr>
223 * <tr><td>integer</td><td>address_book_id</td><td> Addressbook that the contact belongs to </td></tr>
224 * <tr><td>string</td><td>ringtone_path</td><td> Ringtone path of the contact </td></tr>
225 * <tr><td>string</td><td>image_thumbnail_path</td><td> Image thumbnail path of the contact </td></tr>
226 * <tr><td>boolean</td><td>is_favorite</td><td> The contact is favorite or not </td></tr>
227 * <tr><td>boolean</td><td>has_phonenumber</td><td> The contact has phone number or not </td></tr>
228 * <tr><td>boolean</td><td>has_email</td><td> The contact has email or not </td></tr>
229 * <tr><td>integer</td><td>person_id</td><td> Person ID that the contact belongs to </td></tr>
230 * <tr><td>string</td><td>uid</td><td> Unique identifier </td></tr>
231 * <tr><td>string</td><td>vibration</td><td> Vibration path of the contact </td></tr>
232 * <tr><td>string</td><td>message_alert</td><td> Message alert path of the contact </td></tr>
233 * <tr><td>integer</td><td>changed_time</td><td> Last changed contact time </td></tr>
237 _CONTACTS_BEGIN_READ_ONLY_VIEW()
238 _CONTACTS_PROPERTY_INT(id) /* read only */
239 _CONTACTS_PROPERTY_STR(display_name) /* read only */
240 _CONTACTS_PROPERTY_INT(display_source_type) /* read only */
241 _CONTACTS_PROPERTY_INT(address_book_id) /* read only */
242 _CONTACTS_PROPERTY_STR(ringtone_path) /* read only */
243 _CONTACTS_PROPERTY_STR(image_thumbnail_path) /* read only */
244 _CONTACTS_PROPERTY_BOOL(is_favorite) /* read only */
245 _CONTACTS_PROPERTY_BOOL(has_phonenumber) /* read only */
246 _CONTACTS_PROPERTY_BOOL(has_email) /* read only */
247 _CONTACTS_PROPERTY_INT(person_id) /* read only */
248 _CONTACTS_PROPERTY_STR(uid) /* read only */
249 _CONTACTS_PROPERTY_STR(vibration) /* read only */
250 _CONTACTS_PROPERTY_INT(changed_time) /* read only */
251 _CONTACTS_PROPERTY_STR(message_alert) /* read only */
252 _CONTACTS_END_READ_ONLY_VIEW(_contacts_simple_contact)
255 * @addtogroup CAPI_SOCIAL_CONTACTS_SVC_VIEW_MODULE View/Property
256 * @section CAPI_SOCIAL_CONTACTS_SVC_VIEW_MODULE_contacts_contact _contacts_contact view
260 * <th>Property ID</th>
261 * <th>Read, Write</th>
262 * <th>Description</th>
264 * <tr><td>string</td><td>_uri</td><td>read only</td><td> Identifier of this contact view </td></tr>
265 * <tr><td>integer</td><td>id</td><td>read only</td><td> DB record ID of the contact </td></tr>
266 * <tr><td>string</td><td>display_name</td><td>read only</td><td> Display name of the contact </td></tr>
267 * <tr><td>integer</td><td>display_source_id</td><td>read only</td><td> The source type of display name, refer to the @ref contacts_display_name_source_type_e </td></tr>
268 * <tr><td>integer</td><td>address_book_id</td><td>read, write once</td><td> Addressbook ID that the contact belongs to </td></tr>
269 * <tr><td>string</td><td>ringtone_path</td><td>read, write</td><td> Ringtone path of the contact </td></tr>
270 * <tr><td>string</td><td>image_thumbnail_path</td><td>read only</td><td> Image thumbnail path of the contact </td></tr>
271 * <tr><td>boolean</td><td>is_favorite</td><td>read, write</td><td> The contact is favorite or not </td></tr>
272 * <tr><td>boolean</td><td>has_phonenumber</td><td>read only</td><td> The contact has phone number or not </td></tr>
273 * <tr><td>boolean</td><td>has_email</td><td>read only</td><td> The contact has email or not </td></tr>
274 * <tr><td>integer</td><td>person_id</td><td>read, write once</td><td> Person ID that the contact belongs to. If set when inserting, a contact will be linked to person </td></tr>
275 * <tr><td>string</td><td>uid</td><td>read, write</td><td> Unique identifier </td></tr>
276 * <tr><td>string</td><td>vibration</td><td>read, write</td><td> Vibration path of the contact </td></tr>
277 * <tr><td>string</td><td>message_alert</td><td>read, write</td><td> Message alert path of the contact </td></tr>
278 * <tr><td>integer</td><td>changed_time</td><td>read only</td><td> Last changed contact time </td></tr>
279 * <tr><td>integer</td><td>link_mode</td><td>read, write once</td><td> The link mode, refer to the @ref contacts_contact_link_mode_e. If the person_id was set, this value will be ignored </td></tr>
280 * <tr><td>record</td><td>name</td><td>read, write</td><td> _contacts_name child record (single) </td></tr>
281 * <tr><td>record</td><td>company</td><td>read, write</td><td> _contacts_company child record (multiple) </td></tr>
282 * <tr><td>record</td><td>note</td><td>read, write</td><td> _contacts_note child record (multiple) </td></tr>
283 * <tr><td>record</td><td>number</td><td>read, write</td><td> _contacts_number child record (multiple) </td></tr>
284 * <tr><td>record</td><td>email</td><td>read, write</td><td> _contacts_email child record (multiple) </td></tr>
285 * <tr><td>record</td><td>event</td><td>read, write</td><td> _contacts_event child record (multiple) </td></tr>
286 * <tr><td>record</td><td>messenger</td><td>read, write</td><td> _contacts_messenger child record (multiple) </td></tr>
287 * <tr><td>record</td><td>address</td><td>read, write</td><td> _contacts_address child record (multiple) </td></tr>
288 * <tr><td>record</td><td>url</td><td>read, write</td><td> _contacts_url child record (multiple) </td></tr>
289 * <tr><td>record</td><td>nickname</td><td>read, write</td><td> _contacts_nickname child record (multiple) </td></tr>
290 * <tr><td>record</td><td>profile</td><td>read, write</td><td> _contacts_profile child record (multiple) </td></tr>
291 * <tr><td>record</td><td>relationship</td><td>read, write</td><td> _contacts_relationship child record (multiple)</td></tr>
292 * <tr><td>record</td><td>image</td><td>read, write</td><td> _contacts_image child record (multiple)</td></tr>
293 * <tr><td>record</td><td>group_relation</td><td>read, write</td><td> _contacts_group_relation child record (multiple)</td></tr>
294 * <tr><td>record</td><td>sip</td><td>read, write</td><td> _contacts_sip child record (multiple) </td></tr>
297 _CONTACTS_BEGIN_VIEW()
298 _CONTACTS_PROPERTY_INT(id) /* read only */
299 _CONTACTS_PROPERTY_STR(display_name) /* read only */
300 _CONTACTS_PROPERTY_INT(display_source_type) /* read only */
301 _CONTACTS_PROPERTY_INT(address_book_id) /* read, write once */
302 _CONTACTS_PROPERTY_STR(ringtone_path) /* read, write */
303 _CONTACTS_PROPERTY_STR(image_thumbnail_path) /* read only */
304 _CONTACTS_PROPERTY_BOOL(is_favorite) /* read, write */
305 _CONTACTS_PROPERTY_BOOL(has_phonenumber) /* read only */
306 _CONTACTS_PROPERTY_BOOL(has_email) /* read only */
307 _CONTACTS_PROPERTY_INT(person_id) /* read, write once */
308 _CONTACTS_PROPERTY_STR(uid) /* read, write */
309 _CONTACTS_PROPERTY_STR(vibration) /* read, write */
310 _CONTACTS_PROPERTY_INT(changed_time) /* read only */
311 _CONTACTS_PROPERTY_INT(link_mode) /* read, write */
312 _CONTACTS_PROPERTY_CHILD_SINGLE(name) /* read, write */
313 _CONTACTS_PROPERTY_CHILD_MULTIPLE(image) /* read, write */
314 _CONTACTS_PROPERTY_CHILD_MULTIPLE(company) /* read, write */
315 _CONTACTS_PROPERTY_CHILD_MULTIPLE(note) /* read, write */
316 _CONTACTS_PROPERTY_CHILD_MULTIPLE(number) /* read, write */
317 _CONTACTS_PROPERTY_CHILD_MULTIPLE(email) /* read, write */
318 _CONTACTS_PROPERTY_CHILD_MULTIPLE(event) /* read, write */
319 _CONTACTS_PROPERTY_CHILD_MULTIPLE(messenger) /* read, write */
320 _CONTACTS_PROPERTY_CHILD_MULTIPLE(address) /* read, write */
321 _CONTACTS_PROPERTY_CHILD_MULTIPLE(url) /* read, write */
322 _CONTACTS_PROPERTY_CHILD_MULTIPLE(nickname) /* read, write */
323 _CONTACTS_PROPERTY_CHILD_MULTIPLE(profile) /* read, write */
324 _CONTACTS_PROPERTY_CHILD_MULTIPLE(relationship) /* read, write */
325 _CONTACTS_PROPERTY_CHILD_MULTIPLE(group_relation) /* read, write */
326 _CONTACTS_PROPERTY_CHILD_MULTIPLE(extension) /* read, write */
327 _CONTACTS_PROPERTY_CHILD_MULTIPLE(sip) /* read, write (Since 3.0) */
328 _CONTACTS_PROPERTY_STR(message_alert) /* read, write */
329 _CONTACTS_END_VIEW(_contacts_contact)
332 * @addtogroup CAPI_SOCIAL_CONTACTS_SVC_VIEW_MODULE View/Property
333 * @section CAPI_SOCIAL_CONTACTS_SVC_VIEW_MODULE_contacts_my_profile _contacts_my_profile view
337 * <th>Property ID</th>
338 * <th>Read, Write</th>
339 * <th>Description</th>
341 * <tr><td>string</td><td>_uri</td><td>read only</td><td> Identifier of this my profile view </td></tr>
342 * <tr><td>integer</td><td>id</td><td>read only</td><td> DB record ID of the my profile </td></tr>
343 * <tr><td>string</td><td>display_name</td><td>read only</td><td> Display name of the profile </td></tr>
344 * <tr><td>integer</td><td>address_book_id</td><td>read, write once</td><td> Addressbook ID that the profile belongs to </td></tr>
345 * <tr><td>string</td><td>image_thumbnail_path</td><td>read only</td><td> Image thumbnail path of the profile </td></tr>
346 * <tr><td>string</td><td>uid</td><td>read, write</td><td> Unique identifier </td></tr>
347 * <tr><td>integer</td><td>changed_time</td><td>read only</td><td> Last changed profile time </td></tr>
348 * <tr><td>record</td><td>name</td><td>read, write</td><td> _contacts_name child record (single) </td></tr>
349 * <tr><td>record</td><td>company</td><td>read, write</td><td> _contacts_company child record (multiple) </td></tr>
350 * <tr><td>record</td><td>note</td><td>read, write</td><td> _contacts_note child record (multiple) </td></tr>
351 * <tr><td>record</td><td>number</td><td>read, write</td><td> _contacts_number child record (multiple) </td></tr>
352 * <tr><td>record</td><td>email</td><td>read, write</td><td> _contacts_email child record (multiple) </td></tr>
353 * <tr><td>record</td><td>event</td><td>read, write</td><td> _contacts_event child record (multiple) </td></tr>
354 * <tr><td>record</td><td>messenger</td><td>read, write</td><td> _contacts_messenger child record (multiple) </td></tr>
355 * <tr><td>record</td><td>address</td><td>read, write</td><td> _contacts_address child record (multiple) </td></tr>
356 * <tr><td>record</td><td>url</td><td>read, write</td><td> _contacts_url child record (multiple) </td></tr>
357 * <tr><td>record</td><td>nickname</td><td>read, write</td><td> _contacts_nickname child record (multiple) </td></tr>
358 * <tr><td>record</td><td>profile</td><td>read, write</td><td> _contacts_profile child record (multiple) </td></tr>
359 * <tr><td>record</td><td>relationship</td><td>read, write</td><td> _contacts_relationship child record (multiple) </td></tr>
360 * <tr><td>record</td><td>image</td><td>read, write</td><td> _contacts_image child record (multiple) </td></tr>
361 * <tr><td>record</td><td>sip</td><td>read, write</td><td> _contacts_sip child record (multiple) </td></tr>
364 _CONTACTS_BEGIN_VIEW()
365 _CONTACTS_PROPERTY_INT(id) /* read only */
366 _CONTACTS_PROPERTY_STR(display_name) /* read only */
367 _CONTACTS_PROPERTY_INT(address_book_id) /* read, write once */
368 _CONTACTS_PROPERTY_STR(image_thumbnail_path) /* read only */
369 _CONTACTS_PROPERTY_STR(uid) /* read, write */
370 _CONTACTS_PROPERTY_INT(changed_time) /* read only */
371 _CONTACTS_PROPERTY_CHILD_SINGLE(name) /* read, write */
372 _CONTACTS_PROPERTY_CHILD_MULTIPLE(image) /* read, write */
373 _CONTACTS_PROPERTY_CHILD_MULTIPLE(company) /* read, write */
374 _CONTACTS_PROPERTY_CHILD_MULTIPLE(note) /* read, write */
375 _CONTACTS_PROPERTY_CHILD_MULTIPLE(number) /* read, write */
376 _CONTACTS_PROPERTY_CHILD_MULTIPLE(email) /* read, write */
377 _CONTACTS_PROPERTY_CHILD_MULTIPLE(event) /* read, write */
378 _CONTACTS_PROPERTY_CHILD_MULTIPLE(messenger) /* read, write */
379 _CONTACTS_PROPERTY_CHILD_MULTIPLE(address) /* read, write */
380 _CONTACTS_PROPERTY_CHILD_MULTIPLE(url) /* read, write */
381 _CONTACTS_PROPERTY_CHILD_MULTIPLE(nickname) /* read, write */
382 _CONTACTS_PROPERTY_CHILD_MULTIPLE(profile) /* read, write */
383 _CONTACTS_PROPERTY_CHILD_MULTIPLE(relationship) /* read, write */
384 _CONTACTS_PROPERTY_CHILD_MULTIPLE(extension) /* read, write */
385 _CONTACTS_PROPERTY_CHILD_MULTIPLE(sip) /* read, write (Since 3.0) */
386 _CONTACTS_END_VIEW(_contacts_my_profile)
390 * @addtogroup CAPI_SOCIAL_CONTACTS_SVC_VIEW_MODULE View/Property
391 * @section CAPI_SOCIAL_CONTACTS_SVC_VIEW_MODULE_contacts_name _contacts_name view
395 * <th>Property ID</th>
396 * <th>Read, Write</th>
397 * <th>Description</th>
399 * <tr><td>string</td><td>_uri</td><td>read only</td><td> Identifier of this contacts name view </td></tr>
400 * <tr><td>integer</td><td> id </td><td>read only</td><td> DB record ID of the name </td></tr>
401 * <tr><td>integer</td><td> contact_id </td><td>read, write once</td><td> Contacts ID that the name record belongs to </td></tr>
402 * <tr><td>string</td><td> first </td><td>read, write</td><td> First name </td></tr>
403 * <tr><td>string</td><td> last </td><td>read, write</td><td> Last name </td></tr>
404 * <tr><td>string</td><td> addition </td><td>read, write</td><td> Middle name </td></tr>
405 * <tr><td>string</td><td> suffix </td><td>read, write</td><td> Suffix </td></tr>
406 * <tr><td>string</td><td> prefix </td><td>read, write</td><td> Prefix </td></tr>
407 * <tr><td>string</td><td> phonetic_first </td><td>read, write</td><td> Pronounce the first name </td></tr>
408 * <tr><td>string</td><td> phonetic_middle </td><td>read, write</td><td> Pronounce the middle name </td></tr>
409 * <tr><td>string</td><td> phonetic_last </td><td>read, write</td><td> Pronounce the last name </td></tr>
412 _CONTACTS_BEGIN_VIEW()
413 _CONTACTS_PROPERTY_INT(id) /* read only */
414 _CONTACTS_PROPERTY_INT(contact_id) /* read, write once */
415 _CONTACTS_PROPERTY_STR(first) /* read, write */
416 _CONTACTS_PROPERTY_STR(last) /* read, write */
417 _CONTACTS_PROPERTY_STR(addition) /* read, write */
418 _CONTACTS_PROPERTY_STR(suffix) /* read, write */
419 _CONTACTS_PROPERTY_STR(prefix) /* read, write */
420 _CONTACTS_PROPERTY_STR(phonetic_first) /* read, write */
421 _CONTACTS_PROPERTY_STR(phonetic_middle) /* read, write */
422 _CONTACTS_PROPERTY_STR(phonetic_last) /* read, write */
423 _CONTACTS_END_VIEW(_contacts_name)
426 * @addtogroup CAPI_SOCIAL_CONTACTS_SVC_VIEW_MODULE View/Property
428 * @section CAPI_SOCIAL_CONTACTS_SVC_VIEW_MODULE_contacts_number _contacts_number view
432 * <th>Property ID</th>
433 * <th>Read, Write</th>
434 * <th>Description</th>
436 * <tr><td>string</td><td>_uri</td><td>read only</td><td> Identifier of this contacts number view </td></tr>
437 * <tr><td>integer</td><td> id </td><td>read only</td><td> DB record ID of the number </td></tr>
438 * <tr><td>integer</td><td> contact_id </td><td>read, write once</td><td> Contact ID that the number belongs to</td></tr>
439 * <tr><td>integer</td><td> type </td><td>read, write</td><td> Number type, refer to the @ref contacts_number_type_e </td></tr>
440 * <tr><td>string</td><td> label </td><td>read, write</td><td> Custom number type label, when the number type is #CONTACTS_NUMBER_TYPE_CUSTOM </td></tr>
441 * <tr><td>boolean</td><td> is_default </td><td>read, write</td><td> The number is default number or not </td></tr>
442 * <tr><td>string</td><td> number </td><td>read, write</td><td> Number </td></tr>
443 * <tr><td>string</td><td> normalized_number </td><td> filter only </td><td> You can only use this property for search filter. </td></tr>
444 * <tr><td>string</td><td> cleaned_number </td><td> filter only </td><td> You can only use this property for search filter. </td></tr>
445 * <tr><td>string</td><td> number_filter </td><td> filter only </td><td> You can only use this property for search filter. </td></tr>
448 _CONTACTS_BEGIN_VIEW()
449 _CONTACTS_PROPERTY_INT(id) /* read only */
450 _CONTACTS_PROPERTY_INT(contact_id) /* read, write once */
451 _CONTACTS_PROPERTY_INT(type) /* read, write */
452 _CONTACTS_PROPERTY_STR(label) /* read, write */
453 _CONTACTS_PROPERTY_BOOL(is_default) /* read, write */
454 _CONTACTS_PROPERTY_STR(number) /* read, write */
455 _CONTACTS_PROPERTY_STR(normalized_number) /* filter only */
456 _CONTACTS_PROPERTY_STR(cleaned_number) /* filter only */
457 _CONTACTS_PROPERTY_STR(number_filter) /* filter only */
458 _CONTACTS_END_VIEW(_contacts_number)
461 * @addtogroup CAPI_SOCIAL_CONTACTS_SVC_VIEW_MODULE View/Property
462 * @section CAPI_SOCIAL_CONTACTS_SVC_VIEW_MODULE_contacts_email _contacts_email view
466 * <th>Property ID</th>
467 * <th>Read, Write</th>
468 * <th>Description</th>
470 * <tr><td>string</td><td>_uri</td><td>read only</td><td> Identifier of this contacts email view </td></tr>
471 * <tr><td>integer</td><td> id </td><td>read only</td><td> DB record ID of the email </td></tr>
472 * <tr><td>integer</td><td> contact_id </td><td>read, write once</td><td> Contact ID that the email belongs to </td></tr>
473 * <tr><td>integer</td><td> type </td><td>read, write</td><td> Email type, refer to the @ref contacts_email_type_e </td></tr>
474 * <tr><td>string</td><td> label </td><td>read, write</td><td> Custom mail type label, when the email type is #CONTACTS_EMAIL_TYPE_CUSTOM </td></tr>
475 * <tr><td>boolean</td><td> is_default </td><td>read, write</td><td> The email is default email or not </td></tr>
476 * <tr><td>string</td><td> email </td><td>read, write</td><td> Email address</td></tr>
479 _CONTACTS_BEGIN_VIEW()
480 _CONTACTS_PROPERTY_INT(id) /* read only */
481 _CONTACTS_PROPERTY_INT(contact_id) /* read, write once */
482 _CONTACTS_PROPERTY_INT(type) /* read, write */
483 _CONTACTS_PROPERTY_STR(label) /* read, write */
484 _CONTACTS_PROPERTY_BOOL(is_default) /* read, write */
485 _CONTACTS_PROPERTY_STR(email) /* read, write */
486 _CONTACTS_END_VIEW(_contacts_email)
489 * @addtogroup CAPI_SOCIAL_CONTACTS_SVC_VIEW_MODULE View/Property
490 * @section CAPI_SOCIAL_CONTACTS_SVC_VIEW_MODULE_contacts_address _contacts_address view
494 * <th>Property ID</th>
495 * <th>Read, Write</th>
496 * <th>Description</th>
498 * <tr><td>string</td><td>_uri</td><td>read only</td><td> Identifier of this contacts address view </td></tr>
499 * <tr><td>integer</td><td> id </td><td>read only</td><td> DB record ID of the address </td></tr>
500 * <tr><td>integer</td><td> contact_id </td><td>read, write once</td><td> Contact ID that the address belongs to </td></tr>
501 * <tr><td>integer</td><td> type </td><td>read, write</td><td> Address type, refer to the @ref contacts_address_type_e </td></tr>
502 * <tr><td>string</td><td> label </td><td>read, write</td><td> Address type label, when the address type is #CONTACTS_ADDRESS_TYPE_CUSTOM </td></tr>
503 * <tr><td>string</td><td> postbox </td><td>read, write</td><td> Post office box </td></tr>
504 * <tr><td>string</td><td> postal_code </td><td>read, write</td><td> Postal code </td></tr>
505 * <tr><td>string</td><td> region </td><td>read, write</td><td> Region </td></tr>
506 * <tr><td>string</td><td> locality </td><td>read, write</td><td> Locality </td></tr>
507 * <tr><td>string</td><td> street </td><td>read, write</td><td> Street </td></tr>
508 * <tr><td>string</td><td> country </td><td>read, write</td><td> Country </td></tr>
509 * <tr><td>string</td><td> extended </td><td>read, write</td><td> Extended address </td></tr>
510 * <tr><td>boolean</td><td> is_default </td><td>read, write</td><td> The address is default or not </td></tr>
513 _CONTACTS_BEGIN_VIEW()
514 _CONTACTS_PROPERTY_INT(id) /* read only */
515 _CONTACTS_PROPERTY_INT(contact_id) /* read, write once */
516 _CONTACTS_PROPERTY_INT(type) /* read, write */
517 _CONTACTS_PROPERTY_STR(label) /* read, write */
518 _CONTACTS_PROPERTY_STR(postbox) /* read, write */
519 _CONTACTS_PROPERTY_STR(extended) /* read, write */
520 _CONTACTS_PROPERTY_STR(street) /* read, write */
521 _CONTACTS_PROPERTY_STR(locality) /* read, write */
522 _CONTACTS_PROPERTY_STR(region) /* read, write */
523 _CONTACTS_PROPERTY_STR(postal_code) /* read, write */
524 _CONTACTS_PROPERTY_STR(country) /* read, write */
525 _CONTACTS_PROPERTY_BOOL(is_default) /* read, write */
526 _CONTACTS_END_VIEW(_contacts_address)
529 * @addtogroup CAPI_SOCIAL_CONTACTS_SVC_VIEW_MODULE View/Property
530 * @section CAPI_SOCIAL_CONTACTS_SVC_VIEW_MODULE_contacts_note _contacts_note view
534 * <th>Property ID</th>
535 * <th>Read, Write</th>
536 * <th>Description</th>
538 * <tr><td>string</td><td>_uri</td><td>read only</td><td> Identifier of this contacts note view </td></tr>
539 * <tr><td>integer</td><td> id </td><td>read only</td><td> DB record ID of the note </td></tr>
540 * <tr><td>integer</td><td> contact_id </td><td>read, write once</td><td> Contact ID that the note belongs to </td></tr>
541 * <tr><td>string</td><td> note </td><td>read, write</td><td> Note contents </td></tr>
544 _CONTACTS_BEGIN_VIEW()
545 _CONTACTS_PROPERTY_INT(id) /* read only */
546 _CONTACTS_PROPERTY_INT(contact_id) /* read, write once */
547 _CONTACTS_PROPERTY_STR(note) /* read, write */
548 _CONTACTS_END_VIEW(_contacts_note)
551 * @addtogroup CAPI_SOCIAL_CONTACTS_SVC_VIEW_MODULE View/Property
552 * @section CAPI_SOCIAL_CONTACTS_SVC_VIEW_MODULE_contacts_url _contacts_url view
556 * <th>Property ID</th>
557 * <th>Read, Write</th>
558 * <th>Description</th>
560 * <tr><td>string</td><td>_uri</td><td>read only</td><td> Identifier of this contacts URL view </td></tr>
561 * <tr><td>integer</td><td> id </td><td>read only</td><td> DB record ID of the URL </td></tr>
562 * <tr><td>integer</td><td> contact_id </td><td>read, write once</td><td> Contact ID that the URL belongs to </td></tr>
563 * <tr><td>integer</td><td> type </td><td>read, write</td><td> URL type, refer to the @ref contacts_url_type_e </td></tr>
564 * <tr><td>string</td><td> label </td><td>read, write</td><td> Custom URL type label, when the URL type is #CONTACTS_URL_TYPE_CUSTOM </td></tr>
565 * <tr><td>string</td><td> url </td><td>read, write</td><td> URL </td></tr>
568 _CONTACTS_BEGIN_VIEW()
569 _CONTACTS_PROPERTY_INT(id) /* read only */
570 _CONTACTS_PROPERTY_INT(contact_id) /* read, write once */
571 _CONTACTS_PROPERTY_INT(type) /* read, write */
572 _CONTACTS_PROPERTY_STR(label) /* read, write */
573 _CONTACTS_PROPERTY_STR(url) /* read, write */
574 _CONTACTS_END_VIEW(_contacts_url)
577 * @addtogroup CAPI_SOCIAL_CONTACTS_SVC_VIEW_MODULE View/Property
578 * @section CAPI_SOCIAL_CONTACTS_SVC_VIEW_MODULE_contacts_event _contacts_event view
582 * <th>Property ID</th>
583 * <th>Read, Write</th>
584 * <th>Description</th>
586 * <tr><td>string</td><td>_uri</td><td>read only</td><td> Identifier of this contacts event view </td></tr>
587 * <tr><td>integer</td><td> id </td><td>read only</td><td> DB record ID of the event </td></tr>
588 * <tr><td>integer</td><td> contact_id </td><td>read, write once</td><td> Contact ID that the event belongs to </td></tr>
589 * <tr><td>integer</td><td> type </td><td>read, write</td><td> Event type, refer to the @ref contacts_event_type_e </td></tr>
590 * <tr><td>string</td><td> label </td><td>read, write</td><td> Custom event type label, when the event type is #CONTACTS_EVENT_TYPE_CUSTOM </td></tr>
591 * <tr><td>integer</td><td> date </td><td>read, write</td><td> Event date(YYYYMMDD). e.g. 2014/1/1 : 20140101. If the calendar_type is set as CONTACTS_EVENT_CALENDAR_TYPE_CHINESE, you SHOULD convert this value to lunar date </td></tr>
592 * <tr><td>integer</td><td> calendar_type </td><td>read, write</td><td> Calendar type, refer to the @ref contacts_event_calendar_type_e </td></tr>
593 * <tr><td>bool</td><td> is_leap_month (Deprecated) </td><td>read, write</td><td> The month is leap or not (valid on lunisolar calendar only) </td></tr>
596 _CONTACTS_BEGIN_VIEW()
597 _CONTACTS_PROPERTY_INT(id) /* read only */
598 _CONTACTS_PROPERTY_INT(contact_id) /* read, write once */
599 _CONTACTS_PROPERTY_INT(type) /* read, write */
600 _CONTACTS_PROPERTY_STR(label) /* read, write */
601 _CONTACTS_PROPERTY_INT(date) /* read, write */
602 _CONTACTS_PROPERTY_INT(calendar_type) /* read, write */
603 _CONTACTS_PROPERTY_BOOL(is_leap_month) /* read, write (Deprecated since 2.4) */
604 _CONTACTS_END_VIEW(_contacts_event)
607 * @addtogroup CAPI_SOCIAL_CONTACTS_SVC_VIEW_MODULE View/Property
608 * @section CAPI_SOCIAL_CONTACTS_SVC_VIEW_MODULE_contacts_group_relation _contacts_group_relation view
609 * Refer @ref contacts_group_add_contact, @ref contacts_group_remove_contact
613 * <th>Property ID</th>
614 * <th>Read, Write</th>
615 * <th>Description</th>
617 * <tr><td>string</td><td>_uri</td><td>read only</td><td> Identifier of this relationship view </td></tr>
618 * <tr><td>integer</td><td> id </td><td>read only</td><td> DB record ID of the group (can not be used as filter) </td></tr>
619 * <tr><td>integer</td><td> group_id </td><td>read, write once</td><td> DB record ID of the group </td></tr>
620 * <tr><td>integer</td><td> contact_id </td><td>read, write once</td><td> DB record ID of the contact </td></tr>
621 * <tr><td>string</td><td> name </td><td>read only</td><td> Group name </td></tr>
624 _CONTACTS_BEGIN_VIEW()
625 _CONTACTS_PROPERTY_INT(id) /* read only, can not be used as filter */
626 _CONTACTS_PROPERTY_INT(group_id) /* read, write once */
627 _CONTACTS_PROPERTY_INT(contact_id) /* read, write once */
628 _CONTACTS_PROPERTY_STR(name) /* read only */
629 _CONTACTS_END_VIEW(_contacts_group_relation)
632 * @addtogroup CAPI_SOCIAL_CONTACTS_SVC_VIEW_MODULE View/Property
633 * @section CAPI_SOCIAL_CONTACTS_SVC_VIEW_MODULE_contacts_relationship _contacts_relationship view
637 * <th>Property ID</th>
638 * <th>Read, Write</th>
639 * <th>Description</th>
641 * <tr><td>string</td><td>_uri</td><td>read only</td><td> Identifier of this relationship view </td></tr>
642 * <tr><td>integer</td><td> id </td><td>read only</td><td> DB record ID of the relationship </td></tr>
643 * <tr><td>integer</td><td> contact_id </td><td>read, write once</td><td> Contact ID that the relationship belongs to </td></tr>
644 * <tr><td>integer</td><td> type </td><td>read, write</td><td> Relationship type, refer to the @ref contacts_relationship_type_e </td></tr>
645 * <tr><td>string</td><td> label </td><td>read, write</td><td> Custom relationship type label, when the relationship type is CONTACTS_RELATIONSHIP_TYPE_CUSTOM </td></tr>
646 * <tr><td>string</td><td> name </td><td>read, write</td><td> Selected contact name that the relationship belongs to </td></tr>
650 _CONTACTS_BEGIN_VIEW()
651 _CONTACTS_PROPERTY_INT(id) /* read only */
652 _CONTACTS_PROPERTY_INT(contact_id) /* read, write once */
653 _CONTACTS_PROPERTY_INT(type) /* read, write */
654 _CONTACTS_PROPERTY_STR(label) /* read, write */
655 _CONTACTS_PROPERTY_STR(name) /* read, write */
656 _CONTACTS_END_VIEW(_contacts_relationship)
659 * @addtogroup CAPI_SOCIAL_CONTACTS_SVC_VIEW_MODULE View/Property
660 * @section CAPI_SOCIAL_CONTACTS_SVC_VIEW_MODULE_contacts_image _contacts_image view
664 * <th>Property ID</th>
665 * <th>Read, Write</th>
666 * <th>Description</th>
668 * <tr><td>string</td><td>_uri</td><td>read only</td><td> Identifier of this contacts image view </td></tr>
669 * <tr><td>integer</td><td> id </td><td>read only</td><td> DB record ID of the image </td></tr>
670 * <tr><td>integer</td><td> contact_id </td><td>read, write once</td><td> Contact ID that the image belongs to </td></tr>
671 * <tr><td>integer</td><td> type </td><td>read, write</td><td> Image type, refer to the @ref contacts_image_type_e </td></tr>
672 * <tr><td>string</td><td> label </td><td>read, write</td><td> Custom image type label, when the image type is #CONTACTS_IMAGE_TYPE_CUSTOM </td></tr>
673 * <tr><td>string</td><td> path </td><td>read, write</td><td> Image thumbnail path </td></tr>
676 _CONTACTS_BEGIN_VIEW()
677 _CONTACTS_PROPERTY_INT(id) /* read only */
678 _CONTACTS_PROPERTY_INT(contact_id) /* read, write once */
679 _CONTACTS_PROPERTY_INT(type) /* read, write */
680 _CONTACTS_PROPERTY_STR(label) /* read, write */
681 _CONTACTS_PROPERTY_STR(path) /* read, write */
682 _CONTACTS_PROPERTY_BOOL(is_default)
683 _CONTACTS_END_VIEW(_contacts_image)
686 * @addtogroup CAPI_SOCIAL_CONTACTS_SVC_VIEW_MODULE View/Property
687 * @section CAPI_SOCIAL_CONTACTS_SVC_VIEW_MODULE_contacts_company _contacts_company view
691 * <th>Property ID</th>
692 * <th>Read, Write</th>
693 * <th>Description</th>
695 * <tr><td>string</td><td>_uri</td><td>read only</td><td> Identifier of this contacts company view </td></tr>
696 * <tr><td>integer</td><td> id </td><td>read only</td><td> DB record ID of the company </td></tr>
697 * <tr><td>integer</td><td> contact_id </td><td>read, write once</td><td> Contact ID that the company belongs to </td></tr>
698 * <tr><td>integer</td><td> type </td><td>read, write</td><td> Company type, refer to the @ref contacts_company_type_e </td></tr>
699 * <tr><td>string</td><td> label </td><td>read, write</td><td> Custom company type label, when the company type is #CONTACTS_COMPANY_TYPE_CUSTOM </td></tr>
700 * <tr><td>string</td><td> name </td><td>read, write</td><td> Company name </td></tr>
701 * <tr><td>string</td><td> department </td><td>read, write</td><td> Department </td></tr>
702 * <tr><td>string</td><td> job_title </td><td>read, write</td><td> Job title </td></tr>
703 * <tr><td>string</td><td> assistant_name </td><td>read, write</td><td> Assistant name </td></tr>
704 * <tr><td>string</td><td> role </td><td>read, write</td><td> Role </td></tr>
705 * <tr><td>string</td><td> logo </td><td>read, write</td><td> Company logo image file path </td></tr>
706 * <tr><td>string</td><td> location </td><td>read, write</td><td> Company location </td></tr>
707 * <tr><td>string</td><td> description </td><td>read, write</td><td> Description </td></tr>
708 * <tr><td>string</td><td> phonetic_name </td><td>read, write</td><td> Pronounce the company name </td></tr>
711 _CONTACTS_BEGIN_VIEW()
712 _CONTACTS_PROPERTY_INT(id) /* read only */
713 _CONTACTS_PROPERTY_INT(contact_id) /* read, write once */
714 _CONTACTS_PROPERTY_INT(type) /* read, write */
715 _CONTACTS_PROPERTY_STR(label) /* read, write */
716 _CONTACTS_PROPERTY_STR(name) /* read, write */
717 _CONTACTS_PROPERTY_STR(department) /* read, write */
718 _CONTACTS_PROPERTY_STR(job_title) /* read, write */
719 _CONTACTS_PROPERTY_STR(assistant_name) /* read, write */
720 _CONTACTS_PROPERTY_STR(role) /* read, write */
721 _CONTACTS_PROPERTY_STR(logo) /* read, write */
722 _CONTACTS_PROPERTY_STR(location) /* read, write */
723 _CONTACTS_PROPERTY_STR(description) /* read, write */
724 _CONTACTS_PROPERTY_STR(phonetic_name) /* read, write */
725 _CONTACTS_END_VIEW(_contacts_company)
728 * @addtogroup CAPI_SOCIAL_CONTACTS_SVC_VIEW_MODULE View/Property
729 * @section CAPI_SOCIAL_CONTACTS_SVC_VIEW_MODULE_contacts_nickname _contacts_nickname view
733 * <th>Property ID</th>
734 * <th>Read, Write</th>
735 * <th>Description</th>
737 * <tr><td>string</td><td>_uri</td><td>read only</td><td> Identifier of this contacts nickname view </td></tr>
738 * <tr><td>integer</td><td> id </td><td>read only</td><td> DB record ID of the nickname </td></tr>
739 * <tr><td>integer</td><td> contact_id </td><td>read, write once</td><td> Contact ID that the nickname belongs to </td></tr>
740 * <tr><td>string</td><td> name </td><td>read, write</td><td> Nickname </td></tr>
743 _CONTACTS_BEGIN_VIEW()
744 _CONTACTS_PROPERTY_INT(id) /* read only */
745 _CONTACTS_PROPERTY_INT(contact_id) /* read, write once */
746 _CONTACTS_PROPERTY_STR(name) /* read, write */
747 _CONTACTS_END_VIEW(_contacts_nickname)
750 * @addtogroup CAPI_SOCIAL_CONTACTS_SVC_VIEW_MODULE View/Property
751 * @section CAPI_SOCIAL_CONTACTS_SVC_VIEW_MODULE_contacts_messenger _contacts_messenger view
755 * <th>Property ID</th>
756 * <th>Read, Write</th>
757 * <th>Description</th>
759 * <tr><td>string</td><td>_uri</td><td>read only</td><td> Identifier of this contacts messenger view </td></tr>
760 * <tr><td>integer</td><td> id </td><td>read only</td><td> DB record ID of the messenger </td></tr>
761 * <tr><td>integer</td><td> contact_id </td><td>read, write once</td><td> Contact ID that the messenger belongs to </td></tr>
762 * <tr><td>integer</td><td> type </td><td>read, write</td><td> Messenger type, refer to the @ref contacts_messenger_type_e </td></tr>
763 * <tr><td>string</td><td> label </td><td>read, write</td><td> Custom messenger type label, when the messenger type is #CONTACTS_MESSENGER_TYPE_CUSTOM </td></tr>
764 * <tr><td>string</td><td> im_id </td><td>read, write</td><td> Messenger ID (email address or email ID...) </td></tr>
767 _CONTACTS_BEGIN_VIEW()
768 _CONTACTS_PROPERTY_INT(id) /* read only */
769 _CONTACTS_PROPERTY_INT(contact_id) /* read, write once */
770 _CONTACTS_PROPERTY_INT(type) /* read, write */
771 _CONTACTS_PROPERTY_STR(label) /* read, write */
772 _CONTACTS_PROPERTY_STR(im_id) /* read, write */
773 _CONTACTS_END_VIEW(_contacts_messenger)
776 * @addtogroup CAPI_SOCIAL_CONTACTS_SVC_VIEW_MODULE View/Property
777 * @section CAPI_SOCIAL_CONTACTS_SVC_VIEW_MODULE_contacts_extension _contacts_extension view
781 * <th>Property ID</th>
782 * <th>Read, Write</th>
783 * <th>Description</th>
785 * <tr><td>string</td><td>_uri</td><td>read only</td><td> Identifier of this contacts extension view </td></tr>
786 * <tr><td>integer</td><td> id </td><td>read only</td><td> DB record ID of the contact extension </td></tr>
787 * <tr><td>integer</td><td> contact_id </td><td>read, write once</td><td> Contact ID that the contact extension belongs to </td></tr>
788 * <tr><td>integer</td><td> data1 </td><td>read, write</td><td> The extra child record format for non-provided from contacts-service </td></tr>
789 * <tr><td>string</td><td> data2 </td><td>read, write</td><td> The extra child record format for non-provided from contacts-service </td></tr>
790 * <tr><td>string</td><td> data3 </td><td>read, write</td><td> The extra child record format for non-provided from contacts-service </td></tr>
791 * <tr><td>string</td><td> data4 </td><td>read, write</td><td> The extra child record format for non-provided from contacts-service </td></tr>
792 * <tr><td>string</td><td> data5 </td><td>read, write</td><td> The extra child record format for non-provided from contacts-service </td></tr>
793 * <tr><td>string</td><td> data6 </td><td>read, write</td><td> The extra child record format for non-provided from contacts-service </td></tr>
794 * <tr><td>string</td><td> data7 </td><td>read, write</td><td> The extra child record format for non-provided from contacts-service </td></tr>
795 * <tr><td>string</td><td> data8 </td><td>read, write</td><td> The extra child record format for non-provided from contacts-service </td></tr>
796 * <tr><td>string</td><td> data9 </td><td>read, write</td><td> The extra child record format for non-provided from contacts-service </td></tr>
797 * <tr><td>string</td><td> data10 </td><td>read, write</td><td> The extra child record format for non-provided from contacts-service </td></tr>
798 * <tr><td>string</td><td> data11 </td><td>read, write</td><td> The extra child record format for non-provided from contacts-service </td></tr>
799 * <tr><td>string</td><td> data12 </td><td>read, write</td><td> The extra child record format for non-provided from contacts-service </td></tr>
802 _CONTACTS_BEGIN_VIEW()
803 _CONTACTS_PROPERTY_INT(id) /* read only */
804 _CONTACTS_PROPERTY_INT(contact_id) /* read, write once */
805 _CONTACTS_PROPERTY_INT(data1) /* read, write */
806 _CONTACTS_PROPERTY_STR(data2) /* read, write */
807 _CONTACTS_PROPERTY_STR(data3) /* read, write */
808 _CONTACTS_PROPERTY_STR(data4) /* read, write */
809 _CONTACTS_PROPERTY_STR(data5) /* read, write */
810 _CONTACTS_PROPERTY_STR(data6) /* read, write */
811 _CONTACTS_PROPERTY_STR(data7) /* read, write */
812 _CONTACTS_PROPERTY_STR(data8) /* read, write */
813 _CONTACTS_PROPERTY_STR(data9) /* read, write */
814 _CONTACTS_PROPERTY_STR(data10) /* read, write */
815 _CONTACTS_PROPERTY_STR(data11) /* read, write */
816 _CONTACTS_PROPERTY_STR(data12) /* read, write */
817 _CONTACTS_END_VIEW(_contacts_extension)
820 * @addtogroup CAPI_SOCIAL_CONTACTS_SVC_VIEW_MODULE View/Property
821 * @section CAPI_SOCIAL_CONTACTS_SVC_VIEW_MODULE_contacts_sdn _contacts_sdn view
825 * <th>Property ID</th>
826 * <th>Read, Write</th>
827 * <th>Description</th>
829 * <tr><td>string</td><td>_uri</td><td>read only</td><td> Identifier of this contacts sdn view </td></tr>
830 * <tr><td>integer</td><td> id </td><td>read only</td><td> DB record ID of the sdn </td></tr>
831 * <tr><td>string</td><td> name </td><td>read only</td><td> Provided name of sdn </td></tr>
832 * <tr><td>string</td><td> number </td><td>read only</td><td> Provided number of sdn </td></tr>
833 * <tr><td>integer</td><td> sim_slot_no </td><td>read only</td><td>It is related to the SIM slot number. sim_slot_no 0 means first SIM card, sim_slot_no 1 means second SIM. It is same with handle index of telephony handle list. Refer to the telephony_init() </td></tr>
836 _CONTACTS_BEGIN_VIEW()
837 _CONTACTS_PROPERTY_INT(id) /* read only */
838 _CONTACTS_PROPERTY_STR(name) /* read only */
839 _CONTACTS_PROPERTY_STR(number) /* read only */
840 _CONTACTS_PROPERTY_INT(sim_slot_no) /* read only */
841 _CONTACTS_END_VIEW(_contacts_sdn)
844 * @addtogroup CAPI_SOCIAL_CONTACTS_SVC_VIEW_MODULE View/Property
845 * @section CAPI_SOCIAL_CONTACTS_SVC_VIEW_MODULE_contacts_profile _contacts_profile view
849 * <th>Property ID</th>
850 * <th>Read, Write</th>
851 * <th>Description</th>
853 * <tr><td>string</td><td>_uri</td><td>read only</td><td> Identifier of this contacts profile view </td></tr>
854 * <tr><td>integer</td><td> id </td><td>read only</td><td> DB record ID of profile </td></tr>
855 * <tr><td>integer</td><td> contact_id </td><td>read, write once</td><td> Contacts ID that the profile belongs to </td></tr>
856 * <tr><td>string</td><td> uid </td><td>read, write</td><td> Unique identifier </td></tr>
857 * <tr><td>string</td><td> text </td><td>read, write</td><td> Profile contents </td></tr>
858 * <tr><td>integer</td><td> order </td><td>read, write</td><td> Priority to display the profile </td></tr>
859 * <tr><td>string</td><td> service_operation </td><td>read, write</td><td> Data for app_control_set_operation </td></tr>
860 * <tr><td>string</td><td> mime </td><td>read, write</td><td> Data for app_control_set_mime </td></tr>
861 * <tr><td>string</td><td> app_id </td><td>read, write</td><td> Data for app_control_set_app_id </td></tr>
862 * <tr><td>string</td><td> uri </td><td>read, write</td><td> Data for app_control_set_uri </td></tr>
863 * <tr><td>string</td><td> catagory </td><td>read, write</td><td> Data for app_control_set_category </td></tr>
864 * <tr><td>string</td><td> extra_data </td><td>read, write</td><td> It includes "key:value,key:value," pairs. You should parse it. And you must base64 encode each key and value</td></tr>
867 _CONTACTS_BEGIN_VIEW()
868 _CONTACTS_PROPERTY_INT(id) /* read only */
869 _CONTACTS_PROPERTY_STR(uid) /* read, write */
870 _CONTACTS_PROPERTY_STR(text) /* read, write */
871 _CONTACTS_PROPERTY_INT(order) /* read, write */
872 _CONTACTS_PROPERTY_STR(service_operation) /* read, write */
873 _CONTACTS_PROPERTY_STR(mime) /* read, write */
874 _CONTACTS_PROPERTY_STR(app_id) /* read, write */
875 _CONTACTS_PROPERTY_STR(uri) /* read, write */
876 _CONTACTS_PROPERTY_STR(category) /* read, write */
877 _CONTACTS_PROPERTY_STR(extra_data) /* read, write */
878 _CONTACTS_PROPERTY_INT(contact_id) /* read, write once */
879 _CONTACTS_END_VIEW(_contacts_profile)
882 * @addtogroup CAPI_SOCIAL_CONTACTS_SVC_VIEW_MODULE View/Property
883 * @section CAPI_SOCIAL_CONTACTS_SVC_VIEW_MODULE_contacts_activity_photo _contacts_activity_photo view
887 * <th>Property ID</th>
888 * <th>Read, Write</th>
889 * <th>Description</th>
891 * <tr><td>string</td><td>_uri</td><td>read only</td><td> Identifier of this contact activity photo view </td></tr>
892 * <tr><td>integer</td><td> id </td><td>read only</td><td> DB record ID of activity photo </td></tr>
893 * <tr><td>integer</td><td> activity_id </td><td>read, write once</td><td> Activity ID that the activity photo belongs to </td></tr>
894 * <tr><td>string</td><td> photo_url </td><td>read, write</td><td> Photo URL </td></tr>
895 * <tr><td>integer</td><td> sort_index </td><td>read, write</td><td> Sorted photo index </td></tr>
898 _CONTACTS_BEGIN_VIEW()
899 _CONTACTS_PROPERTY_INT(id) /* read only */
900 _CONTACTS_PROPERTY_INT(activity_id) /* read, write once */
901 _CONTACTS_PROPERTY_STR(photo_url) /* read, write */
902 _CONTACTS_PROPERTY_INT(sort_index) /* read, write */
903 _CONTACTS_END_VIEW(_contacts_activity_photo)
906 * @addtogroup CAPI_SOCIAL_CONTACTS_SVC_VIEW_MODULE View/Property
907 * @section CAPI_SOCIAL_CONTACTS_SVC_VIEW_MODULE_contacts_activity _contacts_activity view
911 * <th>Property ID</th>
912 * <th>Read, Write</th>
913 * <th>Description</th>
915 * <tr><td>string</td><td>_uri</td><td>read only</td><td> Identifier of this activity view </td></tr>
916 * <tr><td>integer</td><td> id </td><td>read only</td><td> DB record ID of activity </td></tr>
917 * <tr><td>integer</td><td> contact_id </td><td>read, write once</td><td> Contact ID that the activity belongs to </td></tr>
918 * <tr><td>string</td><td> source_name </td><td>read, write</td><td> Account name that the activity belongs to </td></tr>
919 * <tr><td>int</td><td> timestamp </td><td>read, write</td><td> Published time of activity </td></tr>
920 * <tr><td>string</td><td> status </td><td>read, write</td><td> Activity status </td></tr>
921 * <tr><td>string</td><td> service_operation </td><td>read, write</td><td> Data for app_control_set_operation </td></tr>
922 * <tr><td>string</td><td> uri </td><td>read, write</td><td> Data for app_control_set_uri </td></tr>
923 * <tr><td>record</td><td> photo </td><td>read, write</td><td> _contacts_activity_photo child record (multiple) </td></tr>
926 _CONTACTS_BEGIN_VIEW()
927 _CONTACTS_PROPERTY_INT(id) /* read only */
928 _CONTACTS_PROPERTY_INT(contact_id) /* read, write once */
929 _CONTACTS_PROPERTY_STR(source_name) /* read, write */
930 _CONTACTS_PROPERTY_STR(status) /* read, write */
931 _CONTACTS_PROPERTY_INT(timestamp) /* read, write */
932 _CONTACTS_PROPERTY_STR(service_operation) /* read, write */
933 _CONTACTS_PROPERTY_STR(uri) /* read, write */
934 _CONTACTS_PROPERTY_CHILD_MULTIPLE(photo) /* read, write */
935 _CONTACTS_END_VIEW(_contacts_activity)
938 * @addtogroup CAPI_SOCIAL_CONTACTS_SVC_VIEW_MODULE View/Property
939 * @section CAPI_SOCIAL_CONTACTS_SVC_VIEW_MODULE_contacts_speeddial _contacts_speeddial view
943 * <th>Property ID</th>
944 * <th>Read, Write</th>
945 * <th>Description</th>
947 * <tr><td>string</td><td>_uri</td><td>read only</td><td> Identifier of this contact speed dial view </td></tr>
948 * <tr><td>integer</td><td> speeddial_number </td><td>read, write once</td><td> Stored speed dial number </td></tr>
949 * <tr><td>integer</td><td> number_id </td><td>read, write</td><td> Number ID that the speed dial belongs to </td></tr>
950 * <tr><td>string</td><td> number </td><td>read only</td><td> Contact number of specified speed dial </td></tr>
951 * <tr><td>string</td><td> number_label </td><td>read only</td><td> Contact number label of specified speed dial, when the number type is CONTACTS_NUMBER_TYPE_CUSTOM </td></tr>
952 * <tr><td>integer</td><td> number_type </td><td>read only</td><td> Contact number type, refer to the @ref contacts_number_type_e </td></tr>
953 * <tr><td>integer</td><td> person_id </td><td>read only</td><td> Person ID that the speed dial belongs to </td></tr>
954 * <tr><td>string</td><td> display_name </td><td>read only</td><td> Display name that the speed dial belongs to </td></tr>
955 * <tr><td>string</td><td> image_thumbnail_path </td><td>read only</td><td> Image thumbnail path that the speed dial belongs to </td></tr>
956 * <tr><td>string</td><td> normalized_number </td><td>filter only</td><td> You can only use this property for search filter </td></tr>
957 * <tr><td>string</td><td> cleaned_number </td><td>filter only</td><td> You can only use this property for search filter </td></tr>
958 * <tr><td>string</td><td> number_filter </td><td>filter only</td><td> If you add filter with this property, the string will be normalized as minmatch length internally and the match rule will be applied CONTACTS_MATCH_EXACTLY </td></tr>
961 _CONTACTS_BEGIN_VIEW()
962 _CONTACTS_PROPERTY_INT(speeddial_number) /* read, write once */
963 _CONTACTS_PROPERTY_INT(number_id) /* read, write */
964 _CONTACTS_PROPERTY_STR(number) /* read only */
965 _CONTACTS_PROPERTY_STR(number_label) /* read only */
966 _CONTACTS_PROPERTY_INT(number_type) /* read only */
967 _CONTACTS_PROPERTY_INT(person_id) /* read only */
968 _CONTACTS_PROPERTY_STR(display_name) /* read only */
969 _CONTACTS_PROPERTY_STR(image_thumbnail_path) /* read only */
970 _CONTACTS_PROPERTY_STR(normalized_number) /* filter only */
971 _CONTACTS_PROPERTY_STR(cleaned_number) /* filter only */
972 _CONTACTS_PROPERTY_STR(number_filter) /* filter only */
973 _CONTACTS_END_VIEW(_contacts_speeddial)
976 * @addtogroup CAPI_SOCIAL_CONTACTS_SVC_VIEW_MODULE View/Property
977 * @section CAPI_SOCIAL_CONTACTS_SVC_VIEW_MODULE_contacts_phone_log _contacts_phone_log view
981 * <th>Property ID</th>
982 * <th>Read, Write</th>
983 * <th>Description</th>
985 * <tr><td>string</td><td>_uri</td><td>read only</td><td> Identifier of this phone log view </td></tr>
986 * <tr><td>integer</td><td> id </td><td>read only</td><td> DB record ID of phone log </td></tr>
987 * <tr><td>integer</td><td> person_id </td><td>read, write once </td><td> Person ID that the phone log belongs to </td></tr>
988 * <tr><td>string</td><td> address </td><td>read, write once </td><td> Number or Email that the phone log displays </td></tr>
989 * <tr><td>integer</td><td> log_time </td><td>read, write once</td><td> Call end time. The value means number of seconds since 1970-01-01 00:00:00 (UTC) </td></tr>
990 * <tr><td>integer</td><td> log_type </td><td>read, write</td><td> Log type, refer to the @ref contacts_phone_log_type_e </td></tr>
991 * <tr><td>integer</td><td> extra_data1 </td><td>read, write once</td><td> You can set the related integer data (e.g. message_id, email_id or duration(seconds) of call) </td></tr>
992 * <tr><td>string</td><td> extra_data2 </td><td>read, write once</td><td> You can set the related string data (e.g. short message, subject) </td></tr>
993 * <tr><td>string</td><td> normalized_address </td><td> filter only</td><td> You can only use this property for search filter</td></tr>
994 * <tr><td>string</td><td> cleaned_address </td><td> filter only</td><td> You can only use this property for search filter</td></tr>
995 * <tr><td>string</td><td> address_filter </td><td> filter only</td><td> You can only use this property for search filter</td></tr>
996 * <tr><td>integer</td><td> sim_slot_no </td><td>read, write once</td><td> You can set the related SIM slot number. sim_slot_no 0 means first SIM card, sim_slot_no 1 means second SIM. It is same with handle index of telephony handle list. Refer to the telephony_init() </td></tr>
999 _CONTACTS_BEGIN_VIEW()
1000 _CONTACTS_PROPERTY_INT(id) /* read only */
1001 _CONTACTS_PROPERTY_INT(person_id) /* read, write once */
1002 _CONTACTS_PROPERTY_STR(address) /* read, write once, number or email */
1003 _CONTACTS_PROPERTY_INT(log_time) /* read, write once */
1004 _CONTACTS_PROPERTY_INT(log_type) /* read, write */
1005 _CONTACTS_PROPERTY_INT(extra_data1) /* read, write once : message or email ID, duration(seconds) */
1006 _CONTACTS_PROPERTY_STR(extra_data2) /* read, write once : shortmsg, subject */
1007 _CONTACTS_PROPERTY_STR(normalized_address) /* filter only */
1008 _CONTACTS_PROPERTY_STR(cleaned_address) /* filter only */
1009 _CONTACTS_PROPERTY_STR(address_filter) /* filter only */
1010 _CONTACTS_PROPERTY_INT(sim_slot_no) /* read, write once */
1011 _CONTACTS_END_VIEW(_contacts_phone_log)
1014 * @addtogroup CAPI_SOCIAL_CONTACTS_SVC_VIEW_MODULE View/Property
1015 * @section CAPI_SOCIAL_CONTACTS_SVC_VIEW_MODULE_contacts_contact_updated_info _contacts_contact_updated_info view (read only)
1019 * <th>Property ID</th>
1020 * <th>Description</th>
1022 * <tr><td>string</td><td>_uri</td><td> Identifier of this contact updated info view </td></tr>
1023 * <tr><td>integer</td><td> contact_id </td><td> Updated contact ID </td></tr>
1024 * <tr><td>integer</td><td> address_book_id </td><td> Addressbook ID that the updated contact belongs to </td></tr>
1025 * <tr><td>integer</td><td> type </td><td> Contact updated type, refer to the @ref contacts_changed_e </td></tr>
1026 * <tr><td>integer</td><td> version </td><td> Updated version </td></tr>
1027 * <tr><td>boolean</td><td> image_changed </td><td> Contact image is changed or not </td></tr>
1030 _CONTACTS_BEGIN_READ_ONLY_VIEW()
1031 _CONTACTS_PROPERTY_INT(contact_id)
1032 _CONTACTS_PROPERTY_INT(address_book_id)
1033 _CONTACTS_PROPERTY_INT(type) /* insert/update/delete */
1034 _CONTACTS_PROPERTY_INT(version)
1035 _CONTACTS_PROPERTY_BOOL(image_changed)
1036 _CONTACTS_END_READ_ONLY_VIEW(_contacts_contact_updated_info)
1039 * @addtogroup CAPI_SOCIAL_CONTACTS_SVC_VIEW_MODULE View/Property
1040 * @section CAPI_SOCIAL_CONTACTS_SVC_VIEW_MODULE_contacts_my_profile_updated_info _contacts_my_profile_updated_info view (read only)
1044 * <th>Property ID</th>
1045 * <th>Description</th>
1047 * <tr><td>string</td><td>_uri</td><td> Identifier of this my profile updated info view </td></tr>
1048 * <tr><td>integer</td><td> address_book_id </td><td> Address book ID that the updated my profile belongs to </td></tr>
1049 * <tr><td>integer</td><td> last_changed_type </td><td> Changed update type, refer to the @ref contacts_changed_e </td></tr>
1050 * <tr><td>integer</td><td> version </td><td> Updated version </td></tr>
1053 _CONTACTS_BEGIN_READ_ONLY_VIEW()
1054 _CONTACTS_PROPERTY_INT(address_book_id)
1055 _CONTACTS_PROPERTY_INT(last_changed_type)
1056 _CONTACTS_PROPERTY_INT(version)
1057 _CONTACTS_END_READ_ONLY_VIEW(_contacts_my_profile_updated_info)
1060 * @addtogroup CAPI_SOCIAL_CONTACTS_SVC_VIEW_MODULE View/Property
1061 * @section CAPI_SOCIAL_CONTACTS_SVC_VIEW_MODULE_contacts_group_updated_info _contacts_group_updated_info view (read only)
1065 * <th>Property ID</th>
1066 * <th>Description</th>
1068 * <tr><td>string</td><td>_uri</td><td> Identifier of this group updated info view </td></tr>
1069 * <tr><td>integer</td><td> group_id </td><td> Updated group ID </td></tr>
1070 * <tr><td>integer</td><td> address_book_id </td><td> Address book ID that the updated group belongs to </td></tr>
1071 * <tr><td>integer</td><td> type </td><td> Changed update type, refer to the @ref contacts_changed_e </td></tr>
1072 * <tr><td>integer</td><td> version </td><td> Updated version </td></tr>
1075 _CONTACTS_BEGIN_READ_ONLY_VIEW()
1076 _CONTACTS_PROPERTY_INT(group_id)
1077 _CONTACTS_PROPERTY_INT(address_book_id)
1078 _CONTACTS_PROPERTY_INT(type) /* insert/update/delete */
1079 _CONTACTS_PROPERTY_INT(version)
1080 _CONTACTS_END_READ_ONLY_VIEW(_contacts_group_updated_info)
1084 * @addtogroup CAPI_SOCIAL_CONTACTS_SVC_VIEW_MODULE View/Property
1085 * @section CAPI_SOCIAL_CONTACTS_SVC_VIEW_MODULE_contacts_group_member_updated_info _contacts_group_member_updated_info view (read only)
1089 * <th>Property ID</th>
1090 * <th>Description</th>
1092 * <tr><td>string</td><td>_uri</td><td> Identifier of this group member updated info view </td></tr>
1093 * <tr><td>integer</td><td> group_id </td><td> Updated group ID </td></tr>
1094 * <tr><td>integer</td><td> address_book_id </td><td> Address book ID that the updated group belongs to </td></tr>
1095 * <tr><td>integer</td><td> version </td><td> Updated version </td></tr>
1098 _CONTACTS_BEGIN_READ_ONLY_VIEW()
1099 _CONTACTS_PROPERTY_INT(group_id)
1100 _CONTACTS_PROPERTY_INT(address_book_id)
1101 _CONTACTS_PROPERTY_INT(version)
1102 _CONTACTS_END_READ_ONLY_VIEW(_contacts_group_member_updated_info)
1105 * @addtogroup CAPI_SOCIAL_CONTACTS_SVC_VIEW_MODULE View/Property
1106 * @section CAPI_SOCIAL_CONTACTS_SVC_VIEW_MODULE_contacts_grouprel_updated_info _contacts_grouprel_updated_info view (read only)
1110 * <th>Property ID</th>
1111 * <th>Description</th>
1113 * <tr><td>string</td><td>_uri</td><td> Identifier of this group relation updated info view </td></tr>
1114 * <tr><td>integer</td><td> group_id </td><td> Group ID of group relation </td></tr>
1115 * <tr><td>integer</td><td> contact_id </td><td> Contact ID of the updated group relation </td></tr>
1116 * <tr><td>integer</td><td> address_book_id </td><td> Address book ID of contact that the updated group relation </td></tr>
1117 * <tr><td>integer</td><td> type </td><td> Changed update type, refer to the @ref contacts_changed_e </td></tr>
1118 * <tr><td>integer</td><td> version </td><td> Updated version </td></tr>
1121 _CONTACTS_BEGIN_READ_ONLY_VIEW()
1122 _CONTACTS_PROPERTY_INT(group_id)
1123 _CONTACTS_PROPERTY_INT(contact_id)
1124 _CONTACTS_PROPERTY_INT(address_book_id)
1125 _CONTACTS_PROPERTY_INT(type) /* insert/delete */
1126 _CONTACTS_PROPERTY_INT(version)
1127 _CONTACTS_END_READ_ONLY_VIEW(_contacts_grouprel_updated_info)
1130 * @addtogroup CAPI_SOCIAL_CONTACTS_SVC_VIEW_MODULE View/Property
1131 * @section CAPI_SOCIAL_CONTACTS_SVC_VIEW_MODULE_contacts_person_contact _contacts_person_contact view (read only)
1135 * <th>Property ID</th>
1136 * <th>Description</th>
1138 * <tr><td>string</td><td>_uri</td><td> Identifier of this person contact view </td></tr>
1139 * <tr><td>integer</td><td> person_id </td><td> DB record ID of the person </td></tr>
1140 * <tr><td>string</td><td> display_name </td><td> Display name of the person</td></tr>
1141 * <tr><td>string</td><td> display_name_index </td><td> The first character of first string for grouping. This is normalized using icu (projection) </td></tr>
1142 * <tr><td>integer</td><td> display_contact_id </td><td> Display contact ID that the person belongs to (projection) </td></tr>
1143 * <tr><td>string</td><td> ringtone_path </td><td> Ringtone path of the person (projection) </td></tr>
1144 * <tr><td>string</td><td> image_thumbnail_path </td><td> Image thumbnail path of the person (projection) </td></tr>
1145 * <tr><td>string</td><td> vibration </td><td> Vibration path of the person (projection) </td></tr>
1146 * <tr><td>string</td><td> message_alert </td><td> Message alert path of the person (projection) </td></tr>
1147 * <tr><td>string</td><td> status </td><td> Status of social account (projection) </td></tr>
1148 * <tr><td>boolean</td><td> is_favorite </td><td> The person is favorite or not </td></tr>
1149 * <tr><td>integer</td><td> link_count </td><td> Link count of contact records (projection) </td></tr>
1150 * <tr><td>integer</td><td> contact_id </td><td> Contact ID that the person belongs to </td></tr>
1151 * <tr><td>string</td><td> addressbook_ids </td><td> Addressbook IDs that the person belongs to (projection) </td></tr>
1152 * <tr><td>boolean</td><td> has_phonenumber </td><td> The person has phone number or not </td></tr>
1153 * <tr><td>boolean</td><td> has_email </td><td> The person has email or not </td></tr>
1154 * <tr><td>integer</td><td> address_book_id </td><td> Addressbook ID that the person belongs to </td></tr>
1155 * <tr><td>integer</td><td> address_book_mode </td><td> Addressbook mode, refer to the @ref contacts_address_book_mode_e </td></tr>
1156 * <tr><td>string</td><td> address_book_name </td><td> Addressbook name that the person belongs to </td></tr>
1159 _CONTACTS_BEGIN_READ_ONLY_VIEW()
1160 _CONTACTS_PROPERTY_INT(person_id)
1161 _CONTACTS_PROPERTY_STR(display_name)
1162 _CONTACTS_PROPERTY_PROJECTION_STR(display_name_index)
1163 _CONTACTS_PROPERTY_PROJECTION_INT(display_contact_id)
1164 _CONTACTS_PROPERTY_PROJECTION_STR(ringtone_path)
1165 _CONTACTS_PROPERTY_PROJECTION_STR(image_thumbnail_path)
1166 _CONTACTS_PROPERTY_PROJECTION_STR(vibration)
1167 _CONTACTS_PROPERTY_PROJECTION_STR(status)
1168 _CONTACTS_PROPERTY_BOOL(is_favorite)
1169 _CONTACTS_PROPERTY_PROJECTION_INT(link_count)
1170 _CONTACTS_PROPERTY_PROJECTION_STR(addressbook_ids)
1171 _CONTACTS_PROPERTY_BOOL(has_phonenumber)
1172 _CONTACTS_PROPERTY_BOOL(has_email)
1173 _CONTACTS_PROPERTY_INT(contact_id)
1174 _CONTACTS_PROPERTY_INT(address_book_id)
1175 _CONTACTS_PROPERTY_STR(address_book_name)
1176 _CONTACTS_PROPERTY_INT(address_book_mode)
1177 _CONTACTS_PROPERTY_PROJECTION_STR(message_alert)
1178 _CONTACTS_END_READ_ONLY_VIEW(_contacts_person_contact)
1181 * @addtogroup CAPI_SOCIAL_CONTACTS_SVC_VIEW_MODULE View/Property
1182 * @section CAPI_SOCIAL_CONTACTS_SVC_VIEW_MODULE_contacts_person_number _contacts_person_number view (read only)
1186 * <th>Property ID</th>
1187 * <th>Description</th>
1189 * <tr><td>string</td><td>_uri</td><td> Identifier of this person number view </td></tr>
1190 * <tr><td>integer</td><td> person_id </td><td> DB record ID of the person </td></tr>
1191 * <tr><td>string</td><td> display_name </td><td> Display name of the person</td></tr>
1192 * <tr><td>string</td><td> display_name_index </td><td> The first character of first string for grouping. This is normalized using icu (projection) </td></tr>
1193 * <tr><td>integer</td><td> display_contact_id </td><td> Display contact ID that the person belongs to (projection) </td></tr>
1194 * <tr><td>string</td><td> ringtone_path </td><td> Ringtone path of the person (projection) </td></tr>
1195 * <tr><td>string</td><td> image_thumbnail_path </td><td> Image thumbnail path of the person (projection) </td></tr>
1196 * <tr><td>string</td><td> vibration </td><td> Vibration path of the person (projection) </td></tr>
1197 * <tr><td>string</td><td> message_alert </td><td> Message alert path of the person (projection) </td></tr>
1198 * <tr><td>boolean</td><td> is_favorite </td><td> The person is favorite or not </td></tr>
1199 * <tr><td>boolean</td><td> has_phonenumber </td><td> The person has phone number or not </td></tr>
1200 * <tr><td>boolean</td><td> has_email </td><td> The person has email or not </td></tr>
1201 * <tr><td>integer</td><td> number_id </td><td> Number ID that the person belongs to </td></tr>
1202 * <tr><td>integer</td><td> type </td><td> Number type, refer to the @ref contacts_number_type_e (projection) </td></tr>
1203 * <tr><td>string</td><td> label </td><td> Custom number type label, when the number type is #CONTACTS_NUMBER_TYPE_CUSTOM (projection) </td></tr>
1204 * <tr><td>boolean</td><td> is_primary_default </td><td> The number is default number or not </td></tr>
1205 * <tr><td>string</td><td> number </td><td> Number </td></tr>
1206 * <tr><td>string</td><td> number_filter </td><td> If you add filter with this property, the string will be normalized as minmatch length internally and the match rule will be applied CONTACTS_MATCH_EXACTLY </td></tr>
1207 * <tr><td>string</td><td> normalized_number </td><td> You can only use this property for search filter</td></tr>
1208 * <tr><td>string</td><td> cleaned_number </td><td>You can only use this property for search filter </td></tr>
1212 _CONTACTS_BEGIN_READ_ONLY_VIEW()
1213 _CONTACTS_PROPERTY_INT(person_id)
1214 _CONTACTS_PROPERTY_STR(display_name)
1215 _CONTACTS_PROPERTY_PROJECTION_STR(display_name_index)
1216 _CONTACTS_PROPERTY_PROJECTION_INT(display_contact_id)
1217 _CONTACTS_PROPERTY_PROJECTION_STR(ringtone_path)
1218 _CONTACTS_PROPERTY_PROJECTION_STR(image_thumbnail_path)
1219 _CONTACTS_PROPERTY_PROJECTION_STR(vibration)
1220 _CONTACTS_PROPERTY_BOOL(is_favorite)
1221 _CONTACTS_PROPERTY_BOOL(has_phonenumber)
1222 _CONTACTS_PROPERTY_BOOL(has_email)
1223 _CONTACTS_PROPERTY_INT(number_id)
1224 _CONTACTS_PROPERTY_PROJECTION_INT(type)
1225 _CONTACTS_PROPERTY_PROJECTION_STR(label)
1226 _CONTACTS_PROPERTY_BOOL(is_primary_default)
1227 _CONTACTS_PROPERTY_STR(number)
1228 _CONTACTS_PROPERTY_FILTER_STR(number_filter)
1229 _CONTACTS_PROPERTY_FILTER_STR(normalized_number)
1230 _CONTACTS_PROPERTY_PROJECTION_STR(message_alert)
1231 _CONTACTS_PROPERTY_FILTER_STR(cleaned_number)
1232 _CONTACTS_END_READ_ONLY_VIEW(_contacts_person_number)
1235 * @addtogroup CAPI_SOCIAL_CONTACTS_SVC_VIEW_MODULE View/Property
1236 * @section CAPI_SOCIAL_CONTACTS_SVC_VIEW_MODULE_contacts_person_email _contacts_person_email view (read only)
1240 * <th>Property ID</th>
1241 * <th>Description</th>
1243 * <tr><td>string</td><td>_uri</td><td> Identifier of this person email view </td></tr>
1244 * <tr><td>integer</td><td> person_id </td><td> DB record ID of the person </td></tr>
1245 * <tr><td>string</td><td> display_name </td><td> Display name of the person </td></tr>
1246 * <tr><td>string</td><td> display_name_index </td><td> The first character of first string for grouping. This is normalized using icu (projection) </td></tr>
1247 * <tr><td>integer</td><td> display_contact_id </td><td> Display contact ID that the person belongs to (projection) </td></tr>
1248 * <tr><td>string</td><td> ringtone_path </td><td> Ringtone path of the person (projection) </td></tr>
1249 * <tr><td>string</td><td> image_thumbnail_path </td><td> Image thumbnail path of the person (projection) </td></tr>
1250 * <tr><td>string</td><td> vibration </td><td> Vibration path of the person (projection) </td></tr>
1251 * <tr><td>string</td><td> message_alert </td><td> Message alert path of the person (projection) </td></tr>
1252 * <tr><td>boolean</td><td> is_favorite </td><td> The person is favorite or not </td></tr>
1253 * <tr><td>boolean</td><td> has_phonenumber </td><td> The person has phone number or not </td></tr>
1254 * <tr><td>boolean</td><td> has_email </td><td> The person has email or not </td></tr>
1255 * <tr><td>integer</td><td> email_id </td><td> Email ID that the person belongs to </td></tr>
1256 * <tr><td>integer</td><td> type </td><td> Email type, refer to the @ref contacts_email_type_e (projection) </td></tr>
1257 * <tr><td>string</td><td> label </td><td> Custom mail type label, when the email type is #CONTACTS_EMAIL_TYPE_CUSTOM (projection) </td></tr>
1258 * <tr><td>boolean</td><td> is_primary_default </td><td> The email is default email or not </td></tr>
1259 * <tr><td>string</td><td> email </td><td> Email address</td></tr>
1262 _CONTACTS_BEGIN_READ_ONLY_VIEW()
1263 _CONTACTS_PROPERTY_INT(person_id)
1264 _CONTACTS_PROPERTY_STR(display_name)
1265 _CONTACTS_PROPERTY_PROJECTION_STR(display_name_index)
1266 _CONTACTS_PROPERTY_PROJECTION_INT(display_contact_id)
1267 _CONTACTS_PROPERTY_PROJECTION_STR(ringtone_path)
1268 _CONTACTS_PROPERTY_PROJECTION_STR(image_thumbnail_path)
1269 _CONTACTS_PROPERTY_PROJECTION_STR(vibration)
1270 _CONTACTS_PROPERTY_BOOL(is_favorite)
1271 _CONTACTS_PROPERTY_BOOL(has_phonenumber)
1272 _CONTACTS_PROPERTY_BOOL(has_email)
1273 _CONTACTS_PROPERTY_INT(email_id)
1274 _CONTACTS_PROPERTY_PROJECTION_INT(type)
1275 _CONTACTS_PROPERTY_PROJECTION_STR(label)
1276 _CONTACTS_PROPERTY_BOOL(is_primary_default)
1277 _CONTACTS_PROPERTY_STR(email)
1278 _CONTACTS_PROPERTY_PROJECTION_STR(message_alert)
1279 _CONTACTS_END_READ_ONLY_VIEW(_contacts_person_email)
1282 * @addtogroup CAPI_SOCIAL_CONTACTS_SVC_VIEW_MODULE View/Property
1283 * @section CAPI_SOCIAL_CONTACTS_SVC_VIEW_MODULE_contacts_person_grouprel _contacts_person_grouprel view (read only)
1287 * <th>Property ID</th>
1288 * <th>Description</th>
1290 * <tr><td>string</td><td>_uri</td><td> Identifier of this person group relation view </td></tr>
1291 * <tr><td>integer</td><td> person_id </td><td> DB record ID of the person </td></tr>
1292 * <tr><td>string</td><td> display_name </td><td> Display name of the person </td></tr>
1293 * <tr><td>string</td><td> display_name_index </td><td> The first character of first string for grouping. This is normalized using icu (projection) </td></tr>
1294 * <tr><td>integer</td><td> display_contact_id </td><td> Display contact ID that the person belongs to (projection) </td></tr>
1295 * <tr><td>string</td><td> ringtone_path </td><td> Ringtone path of the person (projection) </td></tr>
1296 * <tr><td>string</td><td> image_thumbnail_path </td><td> Image thumbnail path of the person (projection) </td></tr>
1297 * <tr><td>string</td><td> vibration </td><td> Vibration path of the person (projection) </td></tr>
1298 * <tr><td>string</td><td> message_alert </td><td> Message alert path of the person (projection) </td></tr>
1299 * <tr><td>string</td><td> status </td><td> Status of social account (projection) </td></tr>
1300 * <tr><td>boolean</td><td> is_favorite </td><td> The person is favorite or not </td></tr>
1301 * <tr><td>integer</td><td> link_count </td><td> Link count of contat records (projection) </td></tr>
1302 * <tr><td>string</td><td> addressbook_ids </td><td> Addressbook IDs that the person belongs to (projection) </td></tr>
1303 * <tr><td>boolean</td><td> has_phonenumber </td><td> The person has phone number or not </td></tr>
1304 * <tr><td>boolean</td><td> has_email </td><td> The person has email or not </td></tr>
1305 * <tr><td>integer</td><td> address_book_id </td><td> Addressbook ID that the person belongs to </td></tr>
1306 * <tr><td>integer</td><td> address_book_mode </td><td> Addressbook mode, refer to the @ref contacts_address_book_mode_e </td></tr>
1307 * <tr><td>string</td><td> address_book_name </td><td> Addressbook name that the person belongs to </td></tr>
1308 * <tr><td>integer</td><td> group_id </td><td> Group ID that the person belongs to </td></tr>
1309 * <tr><td>integer</td><td> contact_id </td><td> Contact ID that the person belongs to (projection) </td></tr>
1312 _CONTACTS_BEGIN_READ_ONLY_VIEW()
1313 _CONTACTS_PROPERTY_INT(person_id)
1314 _CONTACTS_PROPERTY_STR(display_name)
1315 _CONTACTS_PROPERTY_PROJECTION_STR(display_name_index)
1316 _CONTACTS_PROPERTY_PROJECTION_INT(display_contact_id)
1317 _CONTACTS_PROPERTY_PROJECTION_STR(ringtone_path)
1318 _CONTACTS_PROPERTY_PROJECTION_STR(image_thumbnail_path)
1319 _CONTACTS_PROPERTY_PROJECTION_STR(vibration)
1320 _CONTACTS_PROPERTY_PROJECTION_STR(status)
1321 _CONTACTS_PROPERTY_BOOL(is_favorite)
1322 _CONTACTS_PROPERTY_PROJECTION_INT(link_count)
1323 _CONTACTS_PROPERTY_PROJECTION_STR(addressbook_ids)
1324 _CONTACTS_PROPERTY_BOOL(has_phonenumber)
1325 _CONTACTS_PROPERTY_BOOL(has_email)
1326 _CONTACTS_PROPERTY_INT(address_book_id)
1327 _CONTACTS_PROPERTY_INT(group_id)
1328 _CONTACTS_PROPERTY_STR(address_book_name)
1329 _CONTACTS_PROPERTY_INT(address_book_mode)
1330 _CONTACTS_PROPERTY_PROJECTION_INT(contact_id)
1331 _CONTACTS_PROPERTY_PROJECTION_STR(message_alert)
1332 _CONTACTS_END_READ_ONLY_VIEW(_contacts_person_grouprel)
1335 * @addtogroup CAPI_SOCIAL_CONTACTS_SVC_VIEW_MODULE View/Property
1336 * @section CAPI_SOCIAL_CONTACTS_SVC_VIEW_MODULE_contacts_person_group_assigned _contacts_person_group_assigned view (read only)
1340 * <th>Property ID</th>
1341 * <th>Description</th>
1343 * <tr><td>string</td><td>_uri</td><td> Identifier of this person group assigned view </td></tr>
1344 * <tr><td>integer</td><td> person_id </td><td> DB record ID of the person </td></tr>
1345 * <tr><td>string</td><td> display_name </td><td> Display name of the person </td></tr>
1346 * <tr><td>string</td><td> display_name_index </td><td> The first character of first string for grouping. This is normalized using icu (projection) </td></tr>
1347 * <tr><td>integer</td><td> display_contact_id </td><td> Display contact ID that the person belongs to (projection) </td></tr>
1348 * <tr><td>string</td><td> ringtone_path </td><td> Ringtone path of the person (projection) </td></tr>
1349 * <tr><td>string</td><td> image_thumbnail_path </td><td> Image thumbnail path of the person (projection) </td></tr>
1350 * <tr><td>string</td><td> vibration </td><td> Vibration path of the person (projection) </td></tr>
1351 * <tr><td>string</td><td> message_alert </td><td> Message alert path of the person (projection) </td></tr>
1352 * <tr><td>string</td><td> status </td><td> Status of social account (projection) </td></tr>
1353 * <tr><td>boolean</td><td> is_favorite </td><td> The person is favorite or not </td></tr>
1354 * <tr><td>integer</td><td> link_count </td><td> Link count of contact records (projection) </td></tr>
1355 * <tr><td>string</td><td> linked_address_book_ids </td><td> Addressbook IDs that the linked person belongs to (projection) </td></tr>
1356 * <tr><td>boolean</td><td> has_phonenumber </td><td> The person has phone number or not </td></tr>
1357 * <tr><td>boolean</td><td> has_email </td><td> The person has email or not </td></tr>
1358 * <tr><td>integer</td><td> address_book_id </td><td> Addressbook ID that the person belongs to </td></tr>
1359 * <tr><td>integer</td><td> address_book_mode </td><td> Addressbook mode, refer to the @ref contacts_address_book_mode_e </td></tr>
1360 * <tr><td>integer</td><td> group_id </td><td> Group ID that the person belongs to </td></tr>
1361 * <tr><td>integer</td><td> contact_id </td><td> Contact ID that the person belongs to (projection) </td></tr>
1364 _CONTACTS_BEGIN_READ_ONLY_VIEW()
1365 _CONTACTS_PROPERTY_INT(person_id)
1366 _CONTACTS_PROPERTY_STR(display_name)
1367 _CONTACTS_PROPERTY_PROJECTION_STR(display_name_index)
1368 _CONTACTS_PROPERTY_PROJECTION_INT(display_contact_id)
1369 _CONTACTS_PROPERTY_PROJECTION_STR(ringtone_path)
1370 _CONTACTS_PROPERTY_PROJECTION_STR(image_thumbnail_path)
1371 _CONTACTS_PROPERTY_PROJECTION_STR(vibration)
1372 _CONTACTS_PROPERTY_PROJECTION_STR(status)
1373 _CONTACTS_PROPERTY_BOOL(is_favorite)
1374 _CONTACTS_PROPERTY_PROJECTION_INT(link_count)
1375 _CONTACTS_PROPERTY_PROJECTION_STR(linked_address_book_ids)
1376 _CONTACTS_PROPERTY_BOOL(has_phonenumber)
1377 _CONTACTS_PROPERTY_BOOL(has_email)
1378 _CONTACTS_PROPERTY_INT(address_book_id)
1379 _CONTACTS_PROPERTY_INT(group_id)
1380 _CONTACTS_PROPERTY_INT(address_book_mode)
1381 _CONTACTS_PROPERTY_PROJECTION_INT(contact_id)
1382 _CONTACTS_PROPERTY_PROJECTION_STR(message_alert)
1383 _CONTACTS_END_READ_ONLY_VIEW(_contacts_person_group_assigned)
1386 * @addtogroup CAPI_SOCIAL_CONTACTS_SVC_VIEW_MODULE View/Property
1387 * @section CAPI_SOCIAL_CONTACTS_SVC_VIEW_MODULE_contacts_person_group_not_assigned _contacts_person_group_not_assigned view (read only)
1391 * <th>Property ID</th>
1392 * <th>Description</th>
1394 * <tr><td>string</td><td>_uri</td><td> Identifier of this person group not assigned view </td></tr>
1395 * <tr><td>integer</td><td> person_id </td><td> DB record ID of the person </td></tr>
1396 * <tr><td>string</td><td> display_name </td><td> Display name of the person </td></tr>
1397 * <tr><td>string</td><td> display_name_index </td><td> The first character of first string for grouping. This is normalized using icu (projection) </td></tr>
1398 * <tr><td>integer</td><td> display_contact_id </td><td> Display contact ID that the person belongs to (projection) </td></tr>
1399 * <tr><td>string</td><td> ringtone_path </td><td> Ringtone path of the person (projection) </td></tr>
1400 * <tr><td>string</td><td> image_thumbnail_path </td><td> Image thumbnail path of the person (projection) </td></tr>
1401 * <tr><td>string</td><td> vibration </td><td> Vibration path of the person (projection) </td></tr>
1402 * <tr><td>string</td><td> message_alert </td><td> Message alert path of the person (projection) </td></tr>
1403 * <tr><td>string</td><td> status </td><td> Status of social account (projection) </td></tr>
1404 * <tr><td>boolean</td><td> is_favorite </td><td> The person is favorite or not </td></tr>
1405 * <tr><td>integer</td><td> link_count </td><td> Link count of contact records (projection) </td></tr>
1406 * <tr><td>string</td><td> linked_address_book_ids </td><td> Addressbook IDs that the linked person belongs to (projection) </td></tr>
1407 * <tr><td>boolean</td><td> has_phonenumber </td><td> The person has phone number or not </td></tr>
1408 * <tr><td>boolean</td><td> has_email </td><td> The person has email or not </td></tr>
1409 * <tr><td>integer</td><td> address_book_id </td><td> Addressbook ID that the person belongs to </td></tr>
1410 * <tr><td>integer</td><td> address_book_mode </td><td> Addressbook mode, refer to the @ref contacts_address_book_mode_e </td></tr>
1411 * <tr><td>integer</td><td> contact_id </td><td> Contact ID that the person belongs to (projection) </td></tr>
1414 _CONTACTS_BEGIN_READ_ONLY_VIEW()
1415 _CONTACTS_PROPERTY_INT(person_id)
1416 _CONTACTS_PROPERTY_STR(display_name)
1417 _CONTACTS_PROPERTY_PROJECTION_STR(display_name_index)
1418 _CONTACTS_PROPERTY_PROJECTION_INT(display_contact_id)
1419 _CONTACTS_PROPERTY_PROJECTION_STR(ringtone_path)
1420 _CONTACTS_PROPERTY_PROJECTION_STR(image_thumbnail_path)
1421 _CONTACTS_PROPERTY_PROJECTION_STR(vibration)
1422 _CONTACTS_PROPERTY_PROJECTION_STR(status)
1423 _CONTACTS_PROPERTY_BOOL(is_favorite)
1424 _CONTACTS_PROPERTY_PROJECTION_INT(link_count)
1425 _CONTACTS_PROPERTY_PROJECTION_STR(linked_address_book_ids)
1426 _CONTACTS_PROPERTY_BOOL(has_phonenumber)
1427 _CONTACTS_PROPERTY_BOOL(has_email)
1428 _CONTACTS_PROPERTY_INT(address_book_id)
1429 _CONTACTS_PROPERTY_INT(address_book_mode)
1430 _CONTACTS_PROPERTY_PROJECTION_INT(contact_id)
1431 _CONTACTS_PROPERTY_PROJECTION_STR(message_alert)
1432 _CONTACTS_END_READ_ONLY_VIEW(_contacts_person_group_not_assigned)
1435 * @addtogroup CAPI_SOCIAL_CONTACTS_SVC_VIEW_MODULE View/Property
1436 * @section CAPI_SOCIAL_CONTACTS_SVC_VIEW_MODULE_contacts_person_phone_log _contacts_person_phone_log view (read only)
1440 * <th>Property ID</th>
1441 * <th>Description</th>
1443 * <tr><td>string</td><td>_uri</td><td> Identifier of this phone log view </td></tr>
1444 * <tr><td>integer</td><td> person_id </td><td> DB record ID of person </td></tr>
1445 * <tr><td>string</td><td> display_name </td><td> Display name of the person </td></tr>
1446 * <tr><td>string</td><td> image_thumbnail_path </td><td> Image thumbnail path of the person (projection) </td></tr>
1447 * <tr><td>integer</td><td> log_id </td><td> DB record ID of phone log </td></tr>
1448 * <tr><td>string</td><td> address </td><td> Number or Email that the phone log displays </td></tr>
1449 * <tr><td>integer</td><td> address_type </td><td> Number or Email type (projection)</td></tr>
1450 * <tr><td>integer</td><td> log_time </td><td> Call end time. The value means number of seconds since 1970-01-01 00:00:00 (UTC) </td></tr>
1451 * <tr><td>integer</td><td> log_type </td><td> Log type, refer to the @ref contacts_phone_log_type_e </td></tr>
1452 * <tr><td>integer</td><td> extra_data1 </td><td> You can set the related integer data (e.g. message_id, email_id or duration(seconds) of call) (projection) </td></tr>
1453 * <tr><td>string</td><td> extra_data2 </td><td> You can set the related string data (e.g. short message, subject) (projection) </td></tr>
1454 * <tr><td>string</td><td> normalized_address </td><td> You can only use this property for search filter </td></tr>
1455 * <tr><td>string</td><td> cleaned_address </td><td> You can only use this property for search filter </td></tr>
1456 * <tr><td>string</td><td> address_filter </td><td> You can only use this property for search filter </td></tr>
1457 * <tr><td>integer</td><td> sim_slot_no </td><td>It is related to the SIM slot number. sim_slot_no 0 means first SIM card, sim_slot_no 1 means second SIM. It is same with handle index of telephony handle list. Refer to the telephony_init() </td></tr>
1460 _CONTACTS_BEGIN_READ_ONLY_VIEW()
1461 _CONTACTS_PROPERTY_INT(person_id)
1462 _CONTACTS_PROPERTY_STR(display_name)
1463 _CONTACTS_PROPERTY_PROJECTION_STR(image_thumbnail_path)
1464 _CONTACTS_PROPERTY_INT(log_id)
1465 _CONTACTS_PROPERTY_STR(address)
1466 _CONTACTS_PROPERTY_PROJECTION_INT(address_type)
1467 _CONTACTS_PROPERTY_INT(log_time)
1468 _CONTACTS_PROPERTY_INT(log_type)
1469 _CONTACTS_PROPERTY_PROJECTION_INT(extra_data1)
1470 _CONTACTS_PROPERTY_PROJECTION_STR(extra_data2)
1471 _CONTACTS_PROPERTY_FILTER_STR(normalized_address)
1472 _CONTACTS_PROPERTY_FILTER_STR(cleaned_address)
1473 _CONTACTS_PROPERTY_FILTER_STR(address_filter)
1474 _CONTACTS_PROPERTY_INT(sim_slot_no)
1475 _CONTACTS_END_READ_ONLY_VIEW(_contacts_person_phone_log)
1478 * @addtogroup CAPI_SOCIAL_CONTACTS_SVC_VIEW_MODULE View/Property
1479 * @section CAPI_SOCIAL_CONTACTS_SVC_VIEW_MODULE_contacts_person_usage _contacts_person_usage view (read only)
1483 * <th>Property ID</th>
1484 * <th>Description</th>
1486 * <tr><td>string</td><td>_uri</td><td> Identifier of this person usage view </td></tr>
1487 * <tr><td>integer</td><td> person_id </td><td> DB record ID of the person </td></tr>
1488 * <tr><td>string</td><td> display_name </td><td> Display name of the person </td></tr>
1489 * <tr><td>string</td><td> display_name_index </td><td> The first character of first string for grouping. This is normalized using icu (projection) </td></tr>
1490 * <tr><td>integer</td><td> display_contact_id </td><td> Display contact ID that the person belongs to (projection) </td></tr>
1491 * <tr><td>string</td><td> ringtone_path </td><td> Ringtone path of the person (projection) </td></tr>
1492 * <tr><td>string</td><td> image_thumbnail_path </td><td> Image thumbnail path of the person (projection)</td></tr>
1493 * <tr><td>string</td><td> vibration </td><td> Vibration path of the person (projection) </td></tr>
1494 * <tr><td>string</td><td> message_alert </td><td> Message alert path of the person (projection) </td></tr>
1495 * <tr><td>boolean</td><td> is_favorite </td><td> The person is favorite or not </td></tr>
1496 * <tr><td>boolean</td><td> has_phonenumber </td><td> The person has phone number or not </td></tr>
1497 * <tr><td>boolean</td><td> has_email </td><td> The person has email or not </td></tr>
1498 * <tr><td>integer</td><td> usage_type </td><td> Usage type, refer to the @ref contacts_usage_type_e </td></tr>
1499 * <tr><td>integer</td><td> times_used </td><td> Usage number of person </td></tr>
1502 _CONTACTS_BEGIN_READ_ONLY_VIEW()
1503 _CONTACTS_PROPERTY_INT(person_id)
1504 _CONTACTS_PROPERTY_STR(display_name)
1505 _CONTACTS_PROPERTY_PROJECTION_STR(display_name_index)
1506 _CONTACTS_PROPERTY_PROJECTION_INT(display_contact_id)
1507 _CONTACTS_PROPERTY_PROJECTION_STR(ringtone_path)
1508 _CONTACTS_PROPERTY_PROJECTION_STR(image_thumbnail_path)
1509 _CONTACTS_PROPERTY_PROJECTION_STR(vibration)
1510 _CONTACTS_PROPERTY_BOOL(is_favorite)
1511 _CONTACTS_PROPERTY_BOOL(has_phonenumber)
1512 _CONTACTS_PROPERTY_BOOL(has_email)
1513 _CONTACTS_PROPERTY_INT(usage_type)
1514 _CONTACTS_PROPERTY_INT(times_used)
1515 _CONTACTS_PROPERTY_PROJECTION_STR(message_alert)
1516 _CONTACTS_END_READ_ONLY_VIEW(_contacts_person_usage)
1519 * @addtogroup CAPI_SOCIAL_CONTACTS_SVC_VIEW_MODULE View/Property
1520 * @section CAPI_SOCIAL_CONTACTS_SVC_VIEW_MODULE_contacts_contact_number _contacts_contact_number view (read only)
1524 * <th>Property ID</th>
1525 * <th>Description</th>
1527 * <tr><td>string</td><td>_uri</td><td> Identifier of this contacts number view </td></tr>
1528 * <tr><td>integer</td><td>contact_id</td><td> Contact ID that the number belongs to </td></tr>
1529 * <tr><td>string</td><td>display_name</td><td> Display name of contact that the number belongs to</td></tr>
1530 * <tr><td>integer</td><td>display_source_type</td><td> The source type of display name, refer to the @ref contacts_display_name_source_type_e (projection) </td></tr>
1531 * <tr><td>integer</td><td>address_book_id</td><td> Addressbook ID that the number belongs to </td></tr>
1532 * <tr><td>integer</td><td>person_id</td><td> Person ID that the number belongs to </td></tr>
1533 * <tr><td>string</td><td>ringtone_path</td><td> Ringtone path that the number belongs to (projection) </td></tr>
1534 * <tr><td>string</td><td>image_thumbnail_path</td><td> Image thumbnail path that the number belongs to (projection) </td></tr>
1535 * <tr><td>integer</td><td> number_id </td><td> DB record ID of the number </td></tr>
1536 * <tr><td>integer</td><td> type </td><td> Number type, refer to the @ref contacts_number_type_e (projection) </td></tr>
1537 * <tr><td>string</td><td> label </td><td> Custom number type label, when the number type is #CONTACTS_NUMBER_TYPE_CUSTOM (projection) </td></tr>
1538 * <tr><td>boolean</td><td> is_default </td><td> The number is default number or not </td></tr>
1539 * <tr><td>string</td><td> number </td><td> Number </td></tr>
1540 * <tr><td>string</td><td> number_filter </td><td> If you add filter with this property, the string will be normalized as minmatch length internally and the match rule will be applied CONTACTS_MATCH_EXACTLY </td></tr>
1541 * <tr><td>string</td><td> normalized_number </td><td>You can only use this property for search filter </td></tr>
1542 * <tr><td>string</td><td> cleaned_number </td><td>You can only use this property for search filter </td></tr>
1545 _CONTACTS_BEGIN_READ_ONLY_VIEW()
1546 _CONTACTS_PROPERTY_INT(contact_id)
1547 _CONTACTS_PROPERTY_STR(display_name)
1548 _CONTACTS_PROPERTY_PROJECTION_INT(display_source_type)
1549 _CONTACTS_PROPERTY_INT(address_book_id)
1550 _CONTACTS_PROPERTY_INT(person_id)
1551 _CONTACTS_PROPERTY_PROJECTION_STR(ringtone_path)
1552 _CONTACTS_PROPERTY_PROJECTION_STR(image_thumbnail_path)
1553 _CONTACTS_PROPERTY_INT(number_id)
1554 _CONTACTS_PROPERTY_PROJECTION_INT(type)
1555 _CONTACTS_PROPERTY_PROJECTION_STR(label)
1556 _CONTACTS_PROPERTY_BOOL(is_default)
1557 _CONTACTS_PROPERTY_STR(number)
1558 _CONTACTS_PROPERTY_FILTER_STR(number_filter)
1559 _CONTACTS_PROPERTY_FILTER_STR(normalized_number)
1560 _CONTACTS_PROPERTY_FILTER_STR(cleaned_number)
1561 _CONTACTS_END_READ_ONLY_VIEW(_contacts_contact_number)
1564 * @addtogroup CAPI_SOCIAL_CONTACTS_SVC_VIEW_MODULE View/Property
1565 * @section CAPI_SOCIAL_CONTACTS_SVC_VIEW_MODULE_contacts_contact_email _contacts_contact_email view (read only)
1569 * <th>Property ID</th>
1570 * <th>Description</th>
1572 * <tr><td>string</td><td>_uri</td><td> Identifier of this contacts email view </td></tr>
1573 * <tr><td>integer</td><td>contact_id</td><td> Contact ID that the email belongs to </td></tr>
1574 * <tr><td>string</td><td>display_name</td><td> Display name that the email belongs to </td></tr>
1575 * <tr><td>integer</td><td>display_source_type</td><td> The source type of display name that the email belongs to (projection) </td></tr>
1576 * <tr><td>integer</td><td>address_book_id</td><td> Addressbook ID that the email belongs to </td></tr>
1577 * <tr><td>integer</td><td>person_id</td><td> Person ID that the email belongs to </td></tr>
1578 * <tr><td>string</td><td>ringtone_path</td><td> Ringtone path that the email belongs to (projection) </td></tr>
1579 * <tr><td>string</td><td>image_thumbnail_path</td><td> Image thumbnail path that the email belongs to (projection) </td></tr>
1580 * <tr><td>integer</td><td> email_id </td><td> DB record ID of the email </td></tr>
1581 * <tr><td>integer</td><td> type </td><td> Email type, refer to the @ref contacts_email_type_e (projection) </td></tr>
1582 * <tr><td>string</td><td> label </td><td> Custom mail type label, when the email type is #CONTACTS_EMAIL_TYPE_CUSTOM (projection) </td></tr>
1583 * <tr><td>boolean</td><td> is_default </td><td> Email is default email or not </td></tr>
1584 * <tr><td>string</td><td> email </td><td> Email address </td></tr>
1587 _CONTACTS_BEGIN_READ_ONLY_VIEW()
1588 _CONTACTS_PROPERTY_INT(contact_id)
1589 _CONTACTS_PROPERTY_STR(display_name)
1590 _CONTACTS_PROPERTY_PROJECTION_INT(display_source_type)
1591 _CONTACTS_PROPERTY_INT(address_book_id)
1592 _CONTACTS_PROPERTY_INT(person_id)
1593 _CONTACTS_PROPERTY_PROJECTION_STR(ringtone_path)
1594 _CONTACTS_PROPERTY_PROJECTION_STR(image_thumbnail_path)
1595 _CONTACTS_PROPERTY_INT(email_id)
1596 _CONTACTS_PROPERTY_PROJECTION_INT(type)
1597 _CONTACTS_PROPERTY_PROJECTION_STR(label)
1598 _CONTACTS_PROPERTY_BOOL(is_default)
1599 _CONTACTS_PROPERTY_STR(email)
1600 _CONTACTS_END_READ_ONLY_VIEW(_contacts_contact_email)
1603 * @addtogroup CAPI_SOCIAL_CONTACTS_SVC_VIEW_MODULE View/Property
1604 * @section CAPI_SOCIAL_CONTACTS_SVC_VIEW_MODULE_contacts_contact_grouprel _contacts_contact_grouprel view (read only)
1608 * <th>Property ID</th>
1609 * <th>Description</th>
1611 * <tr><td>string</td><td>_uri</td><td> Identifier of this contact grouprel view </td></tr>
1612 * <tr><td>integer</td><td>contact_id</td><td> Contact ID that the contact group relation belongs to </td></tr>
1613 * <tr><td>string</td><td>display_name</td><td> Display name of the group relation </td></tr>
1614 * <tr><td>integer</td><td>display_source_type</td><td> The source type of display name (projection) </td></tr>
1615 * <tr><td>integer</td><td>address_book_id</td><td> Addressbook ID that the group relation belongs to </td></tr>
1616 * <tr><td>integer</td><td>person_id</td><td> Person ID that the group relation belongs to </td></tr>
1617 * <tr><td>string</td><td>ringtone_path</td><td> Ringtone path of the group relation (projection) </td></tr>
1618 * <tr><td>string</td><td>image_thumbnail_path</td><td> Image thumbnail path of the group relation (projection) </td></tr>
1619 * <tr><td>integer</td><td> group_id </td><td> DB record ID of the group relation </td></tr>
1620 * <tr><td>string</td><td> group_name </td><td> Group name (projection) </td></tr>
1623 _CONTACTS_BEGIN_READ_ONLY_VIEW()
1624 _CONTACTS_PROPERTY_INT(contact_id)
1625 _CONTACTS_PROPERTY_STR(display_name)
1626 _CONTACTS_PROPERTY_PROJECTION_INT(display_source_type)
1627 _CONTACTS_PROPERTY_INT(address_book_id)
1628 _CONTACTS_PROPERTY_INT(person_id)
1629 _CONTACTS_PROPERTY_PROJECTION_STR(ringtone_path)
1630 _CONTACTS_PROPERTY_PROJECTION_STR(image_thumbnail_path)
1631 _CONTACTS_PROPERTY_INT(group_id)
1632 _CONTACTS_PROPERTY_PROJECTION_STR(group_name)
1633 _CONTACTS_END_READ_ONLY_VIEW(_contacts_contact_grouprel)
1636 * @addtogroup CAPI_SOCIAL_CONTACTS_SVC_VIEW_MODULE View/Property
1637 * @section CAPI_SOCIAL_CONTACTS_SVC_VIEW_MODULE_contacts_contact_activity _contacts_contact_activity view (read only)
1641 * <th>Property ID</th>
1642 * <th>Description</th>
1644 * <tr><td>string</td><td>_uri</td><td> Identifier of this contact activity view </td></tr>
1645 * <tr><td>integer</td><td>contact_id</td><td> Contact ID that the activity belongs to</td></tr>
1646 * <tr><td>string</td><td>display_name</td><td> Display name of the contact that the activity belongs to </td></tr>
1647 * <tr><td>integer</td><td>display_source_type</td><td> The source type of display name that the activity belongs to </td></tr>
1648 * <tr><td>integer</td><td>address_book_id</td><td> Addressbook that the activity belongs to </td></tr>
1649 * <tr><td>integer</td><td>person_id</td><td> Person ID that the activity belongs to </td></tr>
1650 * <tr><td>string</td><td>ringtone_path</td><td> Ringtone path of the contact that the activity belongs to (projection) </td></tr>
1651 * <tr><td>string</td><td>image_thumbnail_path</td><td> Image thumbnail path of the contact that the activity belongs to (projection) </td></tr>
1652 * <tr><td>integer</td><td> activity_id </td><td> DB record ID of the activity </td></tr>
1653 * <tr><td>string</td><td> source_name </td><td> Account name that the activity belongs to </td></tr>
1654 * <tr><td>string</td><td> status </td><td> Activity status (projection) </td></tr>
1655 * <tr><td>integer</td><td> timestamp </td><td> Published time of activity </td></tr>
1656 * <tr><td>string</td><td> service_operation </td><td> Data for service_set_operation </td></tr>
1657 * <tr><td>string</td><td> uri </td><td> Data for service_set_uri </td></tr>
1660 _CONTACTS_BEGIN_READ_ONLY_VIEW()
1661 _CONTACTS_PROPERTY_INT(contact_id)
1662 _CONTACTS_PROPERTY_STR(display_name)
1663 _CONTACTS_PROPERTY_PROJECTION_INT(display_source_type)
1664 _CONTACTS_PROPERTY_INT(address_book_id)
1665 _CONTACTS_PROPERTY_INT(account_id)
1666 _CONTACTS_PROPERTY_INT(person_id)
1667 _CONTACTS_PROPERTY_PROJECTION_STR(ringtone_path)
1668 _CONTACTS_PROPERTY_PROJECTION_STR(image_thumbnail_path)
1669 _CONTACTS_PROPERTY_INT(activity_id)
1670 _CONTACTS_PROPERTY_STR(source_name)
1671 _CONTACTS_PROPERTY_PROJECTION_STR(status)
1672 _CONTACTS_PROPERTY_INT(timestamp)
1673 _CONTACTS_PROPERTY_STR(service_operation)
1674 _CONTACTS_PROPERTY_STR(uri)
1675 _CONTACTS_END_READ_ONLY_VIEW(_contacts_contact_activity)
1678 * @addtogroup CAPI_SOCIAL_CONTACTS_SVC_VIEW_MODULE View/Property
1679 * @section CAPI_SOCIAL_CONTACTS_SVC_VIEW_MODULE_contacts_phone_log_stat _contacts_phone_log_stat view (read only)
1683 * <th>Property ID</th>
1684 * <th>Description</th>
1686 * <tr><td>string</td><td>_uri</td><td> Identifier of this log stat view </td></tr>
1687 * <tr><td>integer</td><td> log_count </td><td>Log count (projection) </td></tr>
1688 * <tr><td>integer</td><td> log_type </td><td> Log type, see the @ref contacts_phone_log_type_e </td></tr>
1691 _CONTACTS_BEGIN_READ_ONLY_VIEW()
1692 _CONTACTS_PROPERTY_PROJECTION_INT(log_count)
1693 _CONTACTS_PROPERTY_INT(log_type)
1694 _CONTACTS_END_READ_ONLY_VIEW(_contacts_phone_log_stat)
1697 * @addtogroup CAPI_SOCIAL_CONTACTS_SVC_VIEW_MODULE View/Property
1698 * @section CAPI_SOCIAL_CONTACTS_SVC_VIEW_MODULE_contacts_sip _contacts_sip view
1702 * <th>Property ID</th>
1703 * <th>Read, Write</th>
1704 * <th>Description</th>
1706 * <tr><td>string</td><td>_uri</td><td>read only</td><td> Identifier of this contacts sip view </td></tr>
1707 * <tr><td>integer</td><td> id </td><td>read only</td><td> DB record ID of the sip </td></tr>
1708 * <tr><td>integer</td><td> contact_id </td><td>read, write once</td><td> Contact ID that the sip belongs to </td></tr>
1709 * <tr><td>string</td><td> address </td><td>read, write</td><td> SIP address </td></tr>
1710 * <tr><td>integer</td><td> type </td><td>read, write</td><td> sip type, refer to the @ref contacts_sip_type_e </td></tr>
1711 * <tr><td>string</td><td> label </td><td>read, write</td><td> Custom sip type label, when the sip type is #CONTACTS_SIP_TYPE_CUSTOM </td></tr>
1714 _CONTACTS_BEGIN_VIEW() /* (Since 3.0) */
1715 _CONTACTS_PROPERTY_INT(id) /* read only */
1716 _CONTACTS_PROPERTY_INT(contact_id) /* read, write once */
1717 _CONTACTS_PROPERTY_STR(address) /* read, write */
1718 _CONTACTS_PROPERTY_INT(type) /* read, write */
1719 _CONTACTS_PROPERTY_STR(label) /* read, write */
1720 _CONTACTS_END_VIEW(_contacts_sip)
1726 #endif /* __TIZEN_SOCIAL_CONTACTS_VIEWS_H__ */