Vincular un contacto

Puede vincular un contacto de su aplicación con un contacto de la aplicación Contactos del dispositivo BlackBerry. Puede decidir cómo interactuar con el usuario del dispositivo BlackBerry cuando vincula un contacto. Los pasos siguientes describen un enfoque posible.
Antes de comenzar:
  • Cree los contactos en su aplicación creando una clase que implemente la interfaz LinkableContact y también una instancia de la misma.
  • Defina una clase que amplíe LinkedContactInfoProvider y registre la clase con su aplicación. Para obtener más información, consulte Crear un proveedor de información para un contacto vinculado.
  1. Importe las clases y las interfaces necesarias.
    import net.rim.blackberry.api.pdap.*;
    import net.rim.blackberry.api.pdap.contactlinking.*;
    import javax.microedition.pim.*;
  2. Compruebe si hay un contacto en la aplicación de contactos (un objeto BlackBerryContact) que sea un candidato para la vinculación de su contacto. El método LinkedContactUtilities.getContactLinkCandidate() devuelve BlackBerryContact si encuentra un contacto en la aplicación de contactos que tenga la misma dirección de correo electrónico o el mismo número de teléfono que el LinkableContact que se le ha pasado. Si no hay ningún contacto coincidente, el método devuelve null.
    BlackBerryContact bbContact = 
        LinkedContactUtilities.getContactLinkCandidate(linkableContact);
  3. Si se encuentra una coincidencia, vincule su contacto con BlackBerryContact.
    bbContact = LinkedContactUtilities.linkContact(bbContact, linkableContact);
  4. Si no se encuentra ninguna coincidencia, haga que el usuario seleccione un contacto de la aplicación Contactos para vincularlo con el contacto seleccionado.
    BlackBerryContactList contacts = null;
    try
    {
        contacts = (BlackBerryContactList) PIM.getInstance().
            openPIMList(PIM.CONTACT_LIST, PIM.READ_WRITE);
    }
    catch(PIMException e)
    {
        ContactLinkingDemo.errorDialog("Couldn't open contacts list.");   
        return;                 
    }
    Object choice = contacts.choose();
    if(choice instanceof BlackBerryContact)
    {
        bbContact = (BlackBerryContact)choice;
    }
  5. Compruebe si el contacto seleccionado de la aplicación Contactos ya está vinculado con un contacto de su aplicación.
    LinkedContactUtilities.isContactLinked(bbContact, 
        linkableContact.getApplicationID())
    
  6. Si el contacto seleccionado en la aplicación Contactos aún no está vinculado, vincúlelo con el contacto de su aplicación.
    bbContact = LinkedContactUtilities.linkContact(bbContact, linkableContact);
    

Ejemplo de código: Vincular un contacto

Para consultar un ejemplo de este planteamiento para vincular un contacto, consulte linkContact() en la aplicación de ejemplo de demostración de vinculación de contactos que se incluye en BlackBerry Java SDK.

Tema siguiente: Eliminar un vínculo

¿Le ha resultado útil esta información? Envíenos sus comentarios.