Linking third-party contacts with contacts in the contacts application

You can allow BlackBerry® device users to link contact data in your BlackBerry® Java® Application with contacts in the contacts application on the BlackBerry device by using the Contact Linking API in the net.rim.blackberry.api.pdap.contactlinking package. For example, you can allow users to link a contact in your CRM application with a contact in the contacts application.

A contact in a third-party application can be linked with only one contact in the contacts application. However, a contact in the contacts application can be linked with contacts in multiple third-party applications. When a user tries to link a contact in your application with a contact in the contacts application, you can use the Contact Linking API to perform some tasks automatically, such as searching for a matching contact and checking whether the contact is already linked.

You can create menu items that appear in the contacts application when a user views a contact in the contacts application that is linked with one of your contacts. The menu items can perform any action you want. For example, you can allow a user to add notes in the contacts application about the contact in your application.

When you link a contact in your application with a contact in the contacts application, you can add a custom field to the contacts application. You can use that custom field to display information about your contact.

To download a sample application that demonstrates how to use the Contact Linking API, visit www.blackberry.com/go/contactlinkingsample. For more information about the Contact Linking API, see the API reference for the BlackBerry® Java® Development Environment.

Next topic: Link a contact

Was this information helpful? Send us your comments.