Linking third-party contacts with contacts in the Contacts application

You can allow BlackBerry® device users to link contact data in your 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 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.

You can define the information to display in the Contacts application when the user is viewing a contact that is linked to one of your contacts.

The Contact Linking Demo sample application is included in the BlackBerry® Java® SDK. The application demonstrates how to use the Contact Linking API.

Next topic: Link a contact

Was this information helpful? Send us your comments.