Tizen Native API  8.0
View/Property

This page provides information about views with properties.

Required Header

#include <contacts.h>

Overview

In this category, application developers can find tables with view properties. A view is a structure which describes properties of a record. A record can have basic properties of five types: integer, string, boolean, long integer, double. Each property of basic type has functions to operate on it:

Property type Setter Getter
string contacts_record_set_str contacts_record_get_str
integer contacts_record_set_int contacts_record_get_int
boolean contacts_record_set_bool contacts_record_get_bool
long integer contacts_record_set_lli contacts_record_get_lli
double contacts_record_set_double contacts_record_get_double

For long integer functions, "lli" stands for long long int, usually used to hold UTC time. Record types which have *_id as their properties, hold identifiers of other records - for example, name, number and email views hold ID of their corresponding contacts in contact_id property (as children of the corresponding contacts record). Properties of type 'record' are other records. For example, the _contacts_contact view has a 'name' property of type 'record'. This means that records of type name (_contacts_name view) can be children of the contact record. If a name record holds the identifier of a contact record in its 'contact_id' property, it is the child record of the corresponding contact record. Records can have many children of a given type. For a more detailed explanation and examples, see the main section of Contacts API.

_contacts_address_book view

Type Property ID Read, Write Description
string_uriread onlyIdentifier of this contacts addressbook view
integerid read onlyDB record ID of the addressbook
integeraccount_id read, write onceAccount ID that the addressbook belongs to
stringname read, writeIt cannot be NULL. Duplicate names are not allowed.
integermode read, writeAddressbook mode, refer to the contacts_address_book_mode_e

_contacts_group view

Type Property ID Read, Write Description
string_uriread onlyIdentifier of this contacts group view
integerid read onlyDB record ID of the group
integeraddress_book_id read, write onceAddressbook ID that the group belongs to
stringname read, writeGroup name
stringringtone_path read, writeRingtone path of the group
stringimage_path read, writeImage path of the group
stringvibration read, writeVibration path of the group
stringextra_data read, writeExtra data for default group name
booleanis_read_only read, write onceThe group is read only or not
stringmessage_alert read, writeMessage alert path of the group

_contacts_person view

Type Property ID Read, Write Description
string_uriread onlyIdentifier of this contacts person view
integerid read onlyDB record ID of the person
stringdisplay_name read onlyDisplay name of the person
stringdisplay_name_index read onlyThe first character of first string for grouping. This is normalized using icu (projection)
integerdisplay_contact_id read onlyDisplay contact ID that the person belongs to
stringringtone_path read, writeRingtone path of the person
stringimage_thumbnail_path read onlyImage thumbnail path of the person
stringvibration read, writeVibration path of the person
stringmessage_alert read, writeMessage alert path of the person
stringstatus read onlyStatus of social account
booleanis_favorite read, writeThe person is favorite or not
doublefavorite_priority read only The priority of favorite contacts. it can be used as sorting key, see the contacts_query_set_sort
integerlink_count read onlyLink count of contact records (projection)
stringaddressbook_ids read onlyAddressbook IDs that the person belongs to (projection)
booleanhas_phonenumber read onlyThe person has phone number or not
booleanhas_email read onlyThe person has email or not
integersnippet_type read onlykeyword matched data type, refer to they contacts_data_type_e (Since 3.0)
stringsnippet_string read onlykeyword matched data string (Since 3.0)

_contacts_simple_contact view

You can only get simple contact using this view.

Type Property ID Description
string_uriIdentifier of this simple contact view
integeridDB record ID of the contact
stringdisplay_nameDisplay name of the contact
integerdisplay_source_idThe source type of display name, refer to the contacts_display_name_source_type_e
integeraddress_book_idAddressbook that the contact belongs to
stringringtone_pathRingtone path of the contact
stringimage_thumbnail_pathImage thumbnail path of the contact
booleanis_favoriteThe contact is favorite or not
booleanhas_phonenumberThe contact has phone number or not
booleanhas_emailThe contact has email or not
integerperson_idPerson ID that the contact belongs to
stringuidUnique identifier
stringvibrationVibration path of the contact
stringmessage_alertMessage alert path of the contact
integerchanged_timeLast changed contact time

_contacts_contact view

Type Property ID Read, Write Description
string_uriread onlyIdentifier of this contact view
integeridread onlyDB record ID of the contact
stringdisplay_nameread onlyDisplay name of the contact
integerdisplay_source_idread onlyThe source type of display name, refer to the contacts_display_name_source_type_e
integeraddress_book_idread, write onceAddressbook ID that the contact belongs to
stringringtone_pathread, writeRingtone path of the contact
stringimage_thumbnail_pathread onlyImage thumbnail path of the contact
booleanis_favoriteread, writeThe contact is favorite or not
booleanhas_phonenumberread onlyThe contact has phone number or not
booleanhas_emailread onlyThe contact has email or not
integerperson_idread, write oncePerson ID that the contact belongs to. If set when inserting, a contact will be linked to person
stringuidread, writeUnique identifier
stringvibrationread, writeVibration path of the contact
stringmessage_alertread, writeMessage alert path of the contact
integerchanged_timeread onlyLast changed contact time
integerlink_moderead, write onceThe link mode, refer to the contacts_contact_link_mode_e. If the person_id was set, this value will be ignored
recordnameread, write_contacts_name child record (single)
recordcompanyread, write_contacts_company child record (multiple)
recordnoteread, write_contacts_note child record (multiple)
recordnumberread, write_contacts_number child record (multiple)
recordemailread, write_contacts_email child record (multiple)
recordeventread, write_contacts_event child record (multiple)
recordmessengerread, write_contacts_messenger child record (multiple)
recordaddressread, write_contacts_address child record (multiple)
recordurlread, write_contacts_url child record (multiple)
recordnicknameread, write_contacts_nickname child record (multiple)
recordprofileread, write_contacts_profile child record (multiple)
recordrelationshipread, write_contacts_relationship child record (multiple)
recordimageread, write_contacts_image child record (multiple)
recordgroup_relationread, write_contacts_group_relation child record (multiple)
recordsipread, write_contacts_sip child record (multiple) (Since 3.0)

_contacts_my_profile view

Type Property ID Read, Write Description
string_uriread onlyIdentifier of this my profile view
integeridread onlyDB record ID of the my profile
stringdisplay_nameread onlyDisplay name of the profile
integeraddress_book_idread, write onceAddressbook ID that the profile belongs to
stringimage_thumbnail_pathread onlyImage thumbnail path of the profile
stringuidread, writeUnique identifier
integerchanged_timeread onlyLast changed profile time
recordnameread, write_contacts_name child record (single)
recordcompanyread, write_contacts_company child record (multiple)
recordnoteread, write_contacts_note child record (multiple)
recordnumberread, write_contacts_number child record (multiple)
recordemailread, write_contacts_email child record (multiple)
recordeventread, write_contacts_event child record (multiple)
recordmessengerread, write_contacts_messenger child record (multiple)
recordaddressread, write_contacts_address child record (multiple)
recordurlread, write_contacts_url child record (multiple)
recordnicknameread, write_contacts_nickname child record (multiple)
recordprofileread, write_contacts_profile child record (multiple)
recordrelationshipread, write_contacts_relationship child record (multiple)
recordimageread, write_contacts_image child record (multiple)
recordsipread, write_contacts_sip child record (multiple) (Since 3.0)

_contacts_name view

Type Property ID Read, Write Description
string_uriread onlyIdentifier of this contacts name view
integerid read onlyDB record ID of the name
integercontact_id read, write onceContacts ID that the name record belongs to
stringfirst read, writeFirst name
stringlast read, writeLast name
stringaddition read, writeMiddle name
stringsuffix read, writeSuffix
stringprefix read, writePrefix
stringphonetic_first read, writePronounce the first name
stringphonetic_middle read, writePronounce the middle name
stringphonetic_last read, writePronounce the last name

_contacts_number view

Type Property ID Read, Write Description
string_uriread onlyIdentifier of this contacts number view
integerid read onlyDB record ID of the number
integercontact_id read, write onceContact ID that the number belongs to
integertype read, writeNumber type, refer to the contacts_number_type_e
stringlabel read, writeCustom number type label, when the number type is CONTACTS_NUMBER_TYPE_CUSTOM
booleanis_default read, writeThe number is default number or not
stringnumber read, writeNumber
stringnormalized_number filter only You can only use this property for search filter.
stringcleaned_number filter only You can only use this property for search filter.
stringnumber_filter filter only You can only use this property for search filter.

_contacts_email view

Type Property ID Read, Write Description
string_uriread onlyIdentifier of this contacts email view
integerid read onlyDB record ID of the email
integercontact_id read, write onceContact ID that the email belongs to
integertype read, writeEmail type, refer to the contacts_email_type_e
stringlabel read, writeCustom mail type label, when the email type is CONTACTS_EMAIL_TYPE_CUSTOM
booleanis_default read, writeThe email is default email or not
stringemail read, writeEmail address

_contacts_address view

Type Property ID Read, Write Description
string_uriread onlyIdentifier of this contacts address view
integerid read onlyDB record ID of the address
integercontact_id read, write onceContact ID that the address belongs to
integertype read, writeAddress type, refer to the contacts_address_type_e
stringlabel read, writeAddress type label, when the address type is CONTACTS_ADDRESS_TYPE_CUSTOM
stringpostbox read, writePost office box
stringpostal_code read, writePostal code
stringregion read, writeRegion
stringlocality read, writeLocality
stringstreet read, writeStreet
stringcountry read, writeCountry
stringextended read, writeExtended address
booleanis_default read, writeThe address is default or not

_contacts_note view

Type Property ID Read, Write Description
string_uriread onlyIdentifier of this contacts note view
integerid read onlyDB record ID of the note
integercontact_id read, write onceContact ID that the note belongs to
stringnote read, writeNote contents

_contacts_url view

Type Property ID Read, Write Description
string_uriread onlyIdentifier of this contacts URL view
integerid read onlyDB record ID of the URL
integercontact_id read, write onceContact ID that the URL belongs to
integertype read, writeURL type, refer to the contacts_url_type_e
stringlabel read, writeCustom URL type label, when the URL type is CONTACTS_URL_TYPE_CUSTOM
stringurl read, writeURL

_contacts_event view

Type Property ID Read, Write Description
string_uriread onlyIdentifier of this contacts event view
integerid read onlyDB record ID of the event
integercontact_id read, write onceContact ID that the event belongs to
integertype read, writeEvent type, refer to the contacts_event_type_e
stringlabel read, writeCustom event type label, when the event type is CONTACTS_EVENT_TYPE_CUSTOM
integerdate read, writeEvent date(YYYYMMDD). e.g. 2014/1/1 : 20140101. Even if the calendar_type is set as CONTACTS_EVENT_CALENDAR_TYPE_CHINESE, you SHOULD set Gregorian date
integercalendar_type read, writeCalendar type, refer to the contacts_event_calendar_type_e
boolis_leap_month (Deprecated) read, writeThe month is leap or not (valid on lunisolar calendar only)

_contacts_group_relation view

Refer contacts_group_add_contact, contacts_group_remove_contact

Type Property ID Read, Write Description
string_uriread onlyIdentifier of this relationship view
integerid read onlyDB record ID of the group (can not be used as filter)
integergroup_id read, write onceDB record ID of the group
integercontact_id read, write onceDB record ID of the contact
stringname read onlyGroup name

_contacts_relationship view

Type Property ID Read, Write Description
string_uriread onlyIdentifier of this relationship view
integerid read onlyDB record ID of the relationship
integercontact_id read, write onceContact ID that the relationship belongs to
integertype read, writeRelationship type, refer to the contacts_relationship_type_e
stringlabel read, writeCustom relationship type label, when the relationship type is CONTACTS_RELATIONSHIP_TYPE_CUSTOM
stringname read, writeSelected contact name that the relationship belongs to

_contacts_image view

Type Property ID Read, Write Description
string_uriread onlyIdentifier of this contacts image view
integerid read onlyDB record ID of the image
integercontact_id read, write onceContact ID that the image belongs to
integertype read, writeImage type, refer to the contacts_image_type_e
stringlabel read, writeCustom image type label, when the image type is CONTACTS_IMAGE_TYPE_CUSTOM
stringpath read, writeImage thumbnail path

_contacts_company view

Type Property ID Read, Write Description
string_uriread onlyIdentifier of this contacts company view
integerid read onlyDB record ID of the company
integercontact_id read, write onceContact ID that the company belongs to
integertype read, writeCompany type, refer to the contacts_company_type_e
stringlabel read, writeCustom company type label, when the company type is CONTACTS_COMPANY_TYPE_CUSTOM
stringname read, writeCompany name
stringdepartment read, writeDepartment
stringjob_title read, writeJob title
stringassistant_name read, writeAssistant name
stringrole read, writeRole
stringlogo read, writeCompany logo image file path
stringlocation read, writeCompany location
stringdescription read, writeDescription
stringphonetic_name read, writePronounce the company name

_contacts_nickname view

Type Property ID Read, Write Description
string_uriread onlyIdentifier of this contacts nickname view
integerid read onlyDB record ID of the nickname
integercontact_id read, write onceContact ID that the nickname belongs to
stringname read, writeNickname

_contacts_messenger view

Type Property ID Read, Write Description
string_uriread onlyIdentifier of this contacts messenger view
integerid read onlyDB record ID of the messenger
integercontact_id read, write onceContact ID that the messenger belongs to
integertype read, writeMessenger type, refer to the contacts_messenger_type_e
stringlabel read, writeCustom messenger type label, when the messenger type is CONTACTS_MESSENGER_TYPE_CUSTOM
stringim_id read, writeMessenger ID (email address or email ID...)

_contacts_extension view

Type Property ID Read, Write Description
string_uriread onlyIdentifier of this contacts extension view
integerid read onlyDB record ID of the contact extension
integercontact_id read, write onceContact ID that the contact extension belongs to
integerdata1 read, writeThe extra child record format for non-provided from contacts-service
stringdata2 read, writeThe extra child record format for non-provided from contacts-service
stringdata3 read, writeThe extra child record format for non-provided from contacts-service
stringdata4 read, writeThe extra child record format for non-provided from contacts-service
stringdata5 read, writeThe extra child record format for non-provided from contacts-service
stringdata6 read, writeThe extra child record format for non-provided from contacts-service
stringdata7 read, writeThe extra child record format for non-provided from contacts-service
stringdata8 read, writeThe extra child record format for non-provided from contacts-service
stringdata9 read, writeThe extra child record format for non-provided from contacts-service
stringdata10 read, writeThe extra child record format for non-provided from contacts-service
stringdata11 read, writeThe extra child record format for non-provided from contacts-service
stringdata12 read, writeThe extra child record format for non-provided from contacts-service

_contacts_sdn view

Type Property ID Read, Write Description
string_uriread onlyIdentifier of this contacts sdn view
integerid read onlyDB record ID of the sdn
stringname read onlyProvided name of sdn
stringnumber read onlyProvided number of sdn
integersim_slot_no read onlyIt 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()

_contacts_profile view

Type Property ID Read, Write Description
string_uriread onlyIdentifier of this contacts profile view
integerid read onlyDB record ID of profile
integercontact_id read, write onceContacts ID that the profile belongs to
stringuid read, writeUnique identifier
stringtext read, writeProfile contents
integerorder read, writePriority to display the profile
stringservice_operation read, writeData for app_control_set_operation
stringmime read, writeData for app_control_set_mime
stringapp_id read, writeData for app_control_set_app_id
stringuri read, writeData for app_control_set_uri
stringcategory read, writeData for app_control_set_category
stringextra_data read, writeIt includes "key:value,key:value," pairs. You should parse it. And you must base64 encode each key and value

_contacts_activity_photo view

Type Property ID Read, Write Description
string_uriread onlyIdentifier of this contact activity photo view
integerid read onlyDB record ID of activity photo
integeractivity_id read, write onceActivity ID that the activity photo belongs to
stringphoto_url read, writePhoto URL
integersort_index read, writeSorted photo index

_contacts_activity view

Type Property ID Read, Write Description
string_uriread onlyIdentifier of this activity view
integerid read onlyDB record ID of activity
integercontact_id read, write onceContact ID that the activity belongs to
stringsource_name read, writeAccount name that the activity belongs to
inttimestamp read, writePublished time of activity
stringstatus read, writeActivity status
stringservice_operation read, writeData for app_control_set_operation
stringuri read, writeData for app_control_set_uri
recordphoto read, write_contacts_activity_photo child record (multiple)

_contacts_speeddial view

Type Property ID Read, Write Description
string_uriread onlyIdentifier of this contact speed dial view
integerspeeddial_number read, write onceStored speed dial number
integernumber_id read, writeNumber ID that the speed dial belongs to
stringnumber read onlyContact number of specified speed dial
stringnumber_label read onlyContact number label of specified speed dial, when the number type is CONTACTS_NUMBER_TYPE_CUSTOM
integernumber_type read onlyContact number type, refer to the contacts_number_type_e
integerperson_id read onlyPerson ID that the speed dial belongs to
stringdisplay_name read onlyDisplay name that the speed dial belongs to
stringimage_thumbnail_path read onlyImage thumbnail path that the speed dial belongs to
stringnormalized_number filter onlyYou can only use this property for search filter
stringcleaned_number filter onlyYou can only use this property for search filter
stringnumber_filter filter onlyIf 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

_contacts_phone_log view

Type Property ID Read, Write Description
string_uriread onlyIdentifier of this phone log view
integerid read onlyDB record ID of phone log
integerperson_id read, write once Person ID that the phone log belongs to
stringaddress read, write once Number or Email that the phone log displays
integerlog_time read, write onceCall end time. The value means number of seconds since 1970-01-01 00:00:00 (UTC)
integerlog_type read, writeLog type, refer to the contacts_phone_log_type_e
integerextra_data1 read, write onceYou can set the related integer data (e.g. message_id, email_id or duration(seconds) of call)
stringextra_data2 read, write onceYou can set the related string data (e.g. short message, subject)
stringnormalized_address filter onlyYou can only use this property for search filter
stringcleaned_address filter onlyYou can only use this property for search filter
stringaddress_filter filter onlyYou can only use this property for search filter
integersim_slot_no read, write onceYou 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()

_contacts_contact_updated_info view (read only)

Type Property ID Description
string_uriIdentifier of this contact updated info view
integercontact_id Updated contact ID
integeraddress_book_id Addressbook ID that the updated contact belongs to
integertype Contact updated type, refer to the contacts_changed_e
integerversion Updated version
booleanimage_changed Contact image is changed or not

_contacts_my_profile_updated_info view (read only)

Type Property ID Description
string_uriIdentifier of this my profile updated info view
integeraddress_book_id Address book ID that the updated my profile belongs to
integerlast_changed_type Changed update type, refer to the contacts_changed_e
integerversion Updated version

_contacts_group_updated_info view (read only)

Type Property ID Description
string_uriIdentifier of this group updated info view
integergroup_id Updated group ID
integeraddress_book_id Address book ID that the updated group belongs to
integertype Changed update type, refer to the contacts_changed_e
integerversion Updated version

_contacts_group_member_updated_info view (read only)

Type Property ID Description
string_uriIdentifier of this group member updated info view
integergroup_id Updated group ID
integeraddress_book_id Address book ID that the updated group belongs to
integerversion Updated version

_contacts_grouprel_updated_info view (read only)

Type Property ID Description
string_uriIdentifier of this group relation updated info view
integergroup_id Group ID of group relation
integercontact_id Contact ID of the updated group relation
integeraddress_book_id Address book ID of contact that the updated group relation
integertype Changed update type, refer to the contacts_changed_e
integerversion Updated version

_contacts_person_contact view (read only)

Type Property ID Description
string_uriIdentifier of this person contact view
integerperson_id DB record ID of the person
stringdisplay_name Display name of the person
stringdisplay_name_index The first character of first string for grouping. This is normalized using icu (projection)
integerdisplay_contact_id Display contact ID that the person belongs to (projection)
stringringtone_path Ringtone path of the person (projection)
stringimage_thumbnail_path Image thumbnail path of the person (projection)
stringvibration Vibration path of the person (projection)
stringmessage_alert Message alert path of the person (projection)
stringstatus Status of social account (projection)
booleanis_favorite The person is favorite or not
integerlink_count Link count of contact records (projection)
integercontact_id Contact ID that the person belongs to
stringaddressbook_ids Addressbook IDs that the person belongs to (projection)
booleanhas_phonenumber The person has phone number or not
booleanhas_email The person has email or not
integeraddress_book_id Addressbook ID that the person belongs to
integeraddress_book_mode Addressbook mode, refer to the contacts_address_book_mode_e
stringaddress_book_name Addressbook name that the person belongs to
integersnippet_type keyword matched data type, refer to they contacts_data_type_e (Since 3.0)
stringsnippet_string keyword matched data string (Since 3.0)

_contacts_person_number view (read only)

Type Property ID Description
string_uriIdentifier of this person number view
integerperson_id DB record ID of the person
stringdisplay_name Display name of the person
stringdisplay_name_index The first character of first string for grouping. This is normalized using icu (projection)
integerdisplay_contact_id Display contact ID that the person belongs to (projection)
stringringtone_path Ringtone path of the person (projection)
stringimage_thumbnail_path Image thumbnail path of the person (projection)
stringvibration Vibration path of the person (projection)
stringmessage_alert Message alert path of the person (projection)
booleanis_favorite The person is favorite or not
booleanhas_phonenumber The person has phone number or not
booleanhas_email The person has email or not
integernumber_id Number ID that the person belongs to
integertype Number type, refer to the contacts_number_type_e (projection)
stringlabel Custom number type label, when the number type is CONTACTS_NUMBER_TYPE_CUSTOM (projection)
booleanis_primary_default The number is default number or not
stringnumber Number
stringnumber_filter 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
stringnormalized_number You can only use this property for search filter
stringcleaned_number You can only use this property for search filter
integersnippet_type keyword matched data type, refer to they contacts_data_type_e (Since 3.0)
stringsnippet_string keyword matched data string (Since 3.0)

_contacts_person_email view (read only)

Type Property ID Description
string_uriIdentifier of this person email view
integerperson_id DB record ID of the person
stringdisplay_name Display name of the person
stringdisplay_name_index The first character of first string for grouping. This is normalized using icu (projection)
integerdisplay_contact_id Display contact ID that the person belongs to (projection)
stringringtone_path Ringtone path of the person (projection)
stringimage_thumbnail_path Image thumbnail path of the person (projection)
stringvibration Vibration path of the person (projection)
stringmessage_alert Message alert path of the person (projection)
booleanis_favorite The person is favorite or not
booleanhas_phonenumber The person has phone number or not
booleanhas_email The person has email or not
integeremail_id Email ID that the person belongs to
integertype Email type, refer to the contacts_email_type_e (projection)
stringlabel Custom mail type label, when the email type is CONTACTS_EMAIL_TYPE_CUSTOM (projection)
booleanis_primary_default The email is default email or not
stringemail Email address
integersnippet_type keyword matched data type, refer to they contacts_data_type_e (Since 3.0)
stringsnippet_string keyword matched data string (Since 3.0)

_contacts_person_grouprel view (read only)

Type Property ID Description
string_uriIdentifier of this person group relation view
integerperson_id DB record ID of the person
stringdisplay_name Display name of the person
stringdisplay_name_index The first character of first string for grouping. This is normalized using icu (projection)
integerdisplay_contact_id Display contact ID that the person belongs to (projection)
stringringtone_path Ringtone path of the person (projection)
stringimage_thumbnail_path Image thumbnail path of the person (projection)
stringvibration Vibration path of the person (projection)
stringmessage_alert Message alert path of the person (projection)
stringstatus Status of social account (projection)
booleanis_favorite The person is favorite or not
integerlink_count Link count of contact records (projection)
stringaddressbook_ids Addressbook IDs that the person belongs to (projection)
booleanhas_phonenumber The person has phone number or not
booleanhas_email The person has email or not
integeraddress_book_id Addressbook ID that the person belongs to
integeraddress_book_mode Addressbook mode, refer to the contacts_address_book_mode_e
stringaddress_book_name Addressbook name that the person belongs to
integergroup_id Group ID that the person belongs to
integercontact_id Contact ID that the person belongs to (projection)
integersnippet_type keyword matched data type, refer to they contacts_data_type_e (Since 3.0)
stringsnippet_string keyword matched data string (Since 3.0)

_contacts_person_group_assigned view (read only)

Type Property ID Description
string_uriIdentifier of this person group assigned view
integerperson_id DB record ID of the person
stringdisplay_name Display name of the person
stringdisplay_name_index The first character of first string for grouping. This is normalized using icu (projection)
integerdisplay_contact_id Display contact ID that the person belongs to (projection)
stringringtone_path Ringtone path of the person (projection)
stringimage_thumbnail_path Image thumbnail path of the person (projection)
stringvibration Vibration path of the person (projection)
stringmessage_alert Message alert path of the person (projection)
stringstatus Status of social account (projection)
booleanis_favorite The person is favorite or not
integerlink_count Link count of contact records (projection)
stringlinked_address_book_ids Addressbook IDs that the linked person belongs to (projection)
booleanhas_phonenumber The person has phone number or not
booleanhas_email The person has email or not
integeraddress_book_id Addressbook ID that the person belongs to
integeraddress_book_mode Addressbook mode, refer to the contacts_address_book_mode_e
integergroup_id Group ID that the person belongs to
integer<dtd>contact_id Contact ID that the person belongs to (projection)
integersnippet_type keyword matched data type, refer to they contacts_data_type_e (Since 3.0)
stringsnippet_string keyword matched data string (Since 3.0)

_contacts_person_group_not_assigned view (read only)

Type Property ID Description
string_uriIdentifier of this person group not assigned view
integerperson_id DB record ID of the person
stringdisplay_name Display name of the person
stringdisplay_name_index The first character of first string for grouping. This is normalized using icu (projection)
integerdisplay_contact_id Display contact ID that the person belongs to (projection)
stringringtone_path Ringtone path of the person (projection)
stringimage_thumbnail_path Image thumbnail path of the person (projection)
stringvibration Vibration path of the person (projection)
stringmessage_alert Message alert path of the person (projection)
stringstatus Status of social account (projection)
booleanis_favorite The person is favorite or not
integerlink_count Link count of contact records (projection)
stringlinked_address_book_ids Addressbook IDs that the linked person belongs to (projection)
booleanhas_phonenumber The person has phone number or not
booleanhas_email The person has email or not
integeraddress_book_id Addressbook ID that the person belongs to
integeraddress_book_mode Addressbook mode, refer to the contacts_address_book_mode_e
integercontact_id Contact ID that the person belongs to (projection)
integersnippet_type keyword matched data type, refer to they contacts_data_type_e (Since 3.0)
stringsnippet_string keyword matched data string (Since 3.0)

_contacts_person_phone_log view (read only)

Type Property ID Description
string_uriIdentifier of this phone log view
integerperson_id DB record ID of person
stringdisplay_name Display name of the person
stringimage_thumbnail_path Image thumbnail path of the person (projection)
integerlog_id DB record ID of phone log
stringaddress Number or Email that the phone log displays
integeraddress_type Number or Email type (projection)
integerlog_time Call end time. The value means number of seconds since 1970-01-01 00:00:00 (UTC)
integerlog_type Log type, refer to the contacts_phone_log_type_e
integerextra_data1 You can set the related integer data (e.g. message_id, email_id or duration(seconds) of call) (projection)
stringextra_data2 You can set the related string data (e.g. short message, subject) (projection)
stringnormalized_address You can only use this property for search filter
stringcleaned_address You can only use this property for search filter
stringaddress_filter You can only use this property for search filter
integersim_slot_no 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()

_contacts_person_usage view (read only)

Type Property ID Description
string_uriIdentifier of this person usage view
integerperson_id DB record ID of the person
stringdisplay_name Display name of the person
stringdisplay_name_index The first character of first string for grouping. This is normalized using icu (projection)
integerdisplay_contact_id Display contact ID that the person belongs to (projection)
stringringtone_path Ringtone path of the person (projection)
stringimage_thumbnail_path Image thumbnail path of the person (projection)
stringvibration Vibration path of the person (projection)
stringmessage_alert Message alert path of the person (projection)
booleanis_favorite The person is favorite or not
booleanhas_phonenumber The person has phone number or not
booleanhas_email The person has email or not
integerusage_type Usage type, refer to the contacts_usage_type_e
integertimes_used Usage number of person

_contacts_contact_number view (read only)

Type Property ID Description
string_uriIdentifier of this contacts number view
integercontact_idContact ID that the number belongs to
stringdisplay_nameDisplay name of contact that the number belongs to
integerdisplay_source_typeThe source type of display name, refer to the contacts_display_name_source_type_e (projection)
integeraddress_book_idAddressbook ID that the number belongs to
integerperson_idPerson ID that the number belongs to
stringringtone_pathRingtone path that the number belongs to (projection)
stringimage_thumbnail_pathImage thumbnail path that the number belongs to (projection)
integernumber_id DB record ID of the number
integertype Number type, refer to the contacts_number_type_e (projection)
stringlabel Custom number type label, when the number type is CONTACTS_NUMBER_TYPE_CUSTOM (projection)
booleanis_default The number is default number or not
stringnumber Number
stringnumber_filter 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
stringnormalized_number You can only use this property for search filter
stringcleaned_number You can only use this property for search filter

_contacts_contact_email view (read only)

Type Property ID Description
string_uriIdentifier of this contacts email view
integercontact_idContact ID that the email belongs to
stringdisplay_nameDisplay name that the email belongs to
integerdisplay_source_typeThe source type of display name that the email belongs to (projection)
integeraddress_book_idAddressbook ID that the email belongs to
integerperson_idPerson ID that the email belongs to
stringringtone_pathRingtone path that the email belongs to (projection)
stringimage_thumbnail_pathImage thumbnail path that the email belongs to (projection)
integeremail_id DB record ID of the email
integertype Email type, refer to the contacts_email_type_e (projection)
stringlabel Custom mail type label, when the email type is CONTACTS_EMAIL_TYPE_CUSTOM (projection)
booleanis_default Email is default email or not
stringemail Email address

_contacts_contact_grouprel view (read only)

Type Property ID Description
string_uriIdentifier of this contact grouprel view
integercontact_idContact ID that the contact group relation belongs to
stringdisplay_nameDisplay name of the group relation
integerdisplay_source_typeThe source type of display name (projection)
integeraddress_book_idAddressbook ID that the group relation belongs to
integerperson_idPerson ID that the group relation belongs to
stringringtone_pathRingtone path of the group relation (projection)
stringimage_thumbnail_pathImage thumbnail path of the group relation (projection)
integergroup_id DB record ID of the group relation
stringgroup_name Group name (projection)

_contacts_contact_activity view (read only)

Type Property ID Description
string_uriIdentifier of this contact activity view
integercontact_idContact ID that the activity belongs to
stringdisplay_nameDisplay name of the contact that the activity belongs to
integerdisplay_source_typeThe source type of display name that the activity belongs to
integeraddress_book_idAddressbook that the activity belongs to
integerperson_idPerson ID that the activity belongs to
stringringtone_pathRingtone path of the contact that the activity belongs to (projection)
stringimage_thumbnail_pathImage thumbnail path of the contact that the activity belongs to (projection)
integeractivity_id DB record ID of the activity
stringsource_name Account name that the activity belongs to
stringstatus Activity status (projection)
integertimestamp Published time of activity
stringservice_operation Data for service_set_operation
stringuri Data for service_set_uri

_contacts_phone_log_stat view (read only)

Type Property ID Description
string_uriIdentifier of this log stat view
integerlog_count Log count (projection)
integerlog_type Log type, see the contacts_phone_log_type_e
integersim_slot_no 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() (Since 3.0)

_contacts_sip view (Since 3.0)

Type Property ID Read, Write Description
string_uriread onlyIdentifier of this contacts sip view
integerid read onlyDB record ID of the sip
integercontact_id read, write onceContact ID that the sip belongs to
stringaddress read, writeSIP address
integertype read, writesip type, refer to the contacts_sip_type_e
stringlabel read, writeCustom sip type label, when the sip type is CONTACTS_SIP_TYPE_CUSTOM