BlackBerry Forums Support Community

Closed Thread
LinkBack Thread Tools
Old 06-25-2010, 10:09 AM   #1 (permalink)
Knows Where the Search Button Is
Join Date: May 2010
Model: 9000
Carrier: AT&T
Posts: 15
Post Thanks: 0
Thanked 0 Times in 0 Posts
Default Blackberry Contact Attributes: What's supported where, and how are they mapped?

Please Login to Remove!

I'm writing an app that allows a user to enter a new contact, and, of course, would like to make the entry screen as much as possible like RIM's to give a seamless experience (I can't find any way of just opening the Blackberry "Add Contact" screen itself, and having it return me what the user entered, which would be my preferred way of doing this). In doing so, I have run into this question.

Is there some definitive documentation as to what attributes are supported for which fields, and how the Blackberry address book maps them?

Here is the main (well, OK, so far, only) specific anomaly. The Blackberry API documentation says this regarding Contact.TEL:
When adding a TEL field, the attribute is chosen by examining the attributes parameter for the presence of one of the supported attributes in the following order: ATTR_FAX, ATTR_PAGER, ATTR_MOBILE, ATTR_HOME, ATTR_WORK, ATTR_OTHER with the first one found that does not have a value already assigned to it being chosen. If no such attribute is found, or there are no vacant fields for values of the given attribute type, then the first available attribute is used in the order: ATTR_OTHER, ATTR_WORK, ATTR_HOME, ATTR_MOBILE, ATTR_PAGER, ATTR_FAX (even though the attribute is not present in the attributes parameter).

The TEL field supports at most 8 values, with each value having a distinct attribute. The PIMItem.getAttributes(int, int) method for the TEL field will always return one of ATTR_WORK, ATTR_HOME, ATTR_MOBILE, ATTR_PAGER, ATTR_FAX, or ATTR_OTHER.
But the Blackberry contact data entry screen has these telephone fields:
Work 2
Home 2
Mobile 2
As is obvious here, there is no Contact.TEL-ATTR_WORK2, Contact.TEL-ATTR_HOME2, etc. How are these phone numbers being stored? BTW, note also that this is nine phone fields, one more than the documentation says you can have (assuming "Other" is a telephone field; I haven't tried to store anything in it, but, if you enter data into it, it certainly enforces a phone number formatted string).

Experimenting with the software seems to validate the documentation, but that's not what the Blackberry contact entry screen seems to do.

Anyone out there run into this? Any pointers to more definitive documentation?

Closed Thread

Thread Tools

Posting Rules
You may not post new threads
You may not post replies
You may not post attachments
You may not edit your posts

vB code is On
Smilies are On
[IMG] code is On
HTML code is Off
Trackbacks are On
Pingbacks are On
Refbacks are On

Siemens Soft Starter 25 AMPS 3RW3025-1Ab05 + 3rW3926-8A
Siemens Soft Starter 25 AMPS 3RW3025-1Ab05 + 3rW3926-8A pictureSiemens Power Supply Unit 1P 6EP1 334-1SL11
Siemens Power Supply Unit 1P 6EP1 334-1SL11 pictureSiemens Motor Fan Cover, A7B82500007323, 51-817-542
Siemens Motor Fan Cover, A7B82500007323, 51-817-542 pictureSiemens Simodrive 6SN1130-1AD11-0BA0 VSA-Modul 12, 5/25A 1G
Siemens Simodrive 6SN1130-1AD11-0BA0 VSA-Modul 12, 5/25A      1G pictureSiemens 1ft51060af711-z SERVO MOTOR SERVO MOTOR 1ft5106-0af71-1-z
Siemens 1ft51060af711-z SERVO MOTOR SERVO MOTOR 1ft5106-0af71-1-z picture

Copyright 2004-2016
The names RIM and BlackBerry are registered Trademarks of BlackBerry Inc.