Associer un contact

Vous pouvez associer un contact de votre application à un contact de l'application Contacts du terminal BlackBerry. Vous pouvez décider comment interagir avec l'utilisateur de terminal BlackBerry lorsque vous associez un contact. Les étapes qui suivent décrivent une approche possible.
Avant de commencer :
  • Dans votre application, créez les contacts en concevant et en instanciant une classe qui implémente l'interface LinkableContact.
  • Définissez une classe développant LinkedContactInfoProvider et enregistrez la classe auprès de votre application. Pour plus d'informations, reportez-vous à la section Créer un fournisseur d'informations pour un contact lié.
  1. Importez les classes et les interfaces requises.
    import net.rim.blackberry.api.pdap.*;
    import net.rim.blackberry.api.pdap.contactlinking.*;
    import javax.microedition.pim.*;
  2. Contrôlez la présence d'un contact dans l'application Contacts (un objet BlackBerryContact) qui pourrait être associé à votre contact. La méthode LinkedContactUtilities.getContactLinkCandidate() renvoie un objet BlackBerryContact si elle trouve un contact de l'application Contacts ayant la même adresse électronique ou le même numéro de téléphone que l'objet LinkableContact qui lui a été transmis. En l'absence de contact correspondant, la méthode renvoie null.
    BlackBerryContact bbContact = 
        LinkedContactUtilities.getContactLinkCandidate(linkableContact);
  3. Si une correspondance est trouvée, associez votre contact à l'objet BlackBerryContact.
    bbContact = LinkedContactUtilities.linkContact(bbContact, linkableContact);
  4. Si aucune correspondance n'est trouvée, l'utilisateur sélectionne un contact de l'application Contacts à associer au contact sélectionné.
    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. Contrôlez si le contact sélectionné dans l'application Contacts est déjà associé à un contact de votre application.
    LinkedContactUtilities.isContactLinked(bbContact, 
        linkableContact.getApplicationID())
    
  6. Si le contact sélectionné dans l'application Contacts n'est pas déjà associé, associez-le au contact de votre application.
    bbContact = LinkedContactUtilities.linkContact(bbContact, linkableContact);
    

Échantillon de code : association d'un contact

Pour consulter un exemple de cette méthode d'association d'un contact, reportez-vous à la classe linkContact() dans l'exemple d'application Contact Linking Demo inclus dans BlackBerry Java SDK.


Ces informations vous ont-elles été utiles ? Envoyez-nous vos commentaires.