È possibile creare un contatto e assegnarlo all'elenco contatti predefinito oppure a un altro elenco contatti su un dispositivo BlackBerry.

1. Importare le classi e le interfacce richieste.

   import net.rim.blackberry.api.pdap.BlackBerryContact; 
   import net.rim.blackberry.api.pdap.BlackBerryContactList;
   import net.rim.blackberry.api.pdap.BlackBerryPIMList;
   import net.rim.device.api.system.ControlledAccessException;
   import javax.microedition.pim.PIM;
   import javax.microedition.pim.PIMList;
   import javax.microedition.pim.PIMException;
   import javax.microedition.pim.ContactList;

2. Per aggiungere il nuovo contatto all'elenco contatti predefinito, richiamare PIM.openPIMList(int, int) per aprire l'istanza dell'elenco contatti predefinito, passando come parametri il tipo di elenco da aprire (PIM.CONTACT_LIST) e la modalità di accesso PIM.READ_WRITE. Andare al passaggio 4.

   BlackBerryContactList contactList = (BlackBerryContactList) 
       PIM.getInstance().openPIMList(PIM.CONTACT_LIST, PIM.READ_WRITE);

3. Per aggiungere il nuovo contatto a un elenco contatti non predefinito, effettuare le seguenti azioni:
   1. Richiamare PIM.listPIMLists(int), passando come parametro il tipo di elenco (PIM.CONTACT_LIST), per restituire una matrice di oggetti String. La matrice restituita fornisce i nomi assegnati dal sistema per ogni elenco contatti. L'elenco contatti predefinito viene restituito all'indice 0 della matrice.

      String[] lists = PIM.listPIMLists(PIM.CONTACT_LIST);

   2. Scorrere la matrice restituita da PIM.listPIMLists() per trovare il nome assegnato dal sistema relativo all'elenco contatti che si desidera aprire.
   3. Richiamare PIM.openPIMList(int, int, String) per aprire l'istanza dell'elenco contatti, passando come parametri il tipo di elenco da aprire (PIM.CONTACT_LIST), la modalità di accesso PIM.READ_WRITE e il nome dell'elenco contatti.

      BlackBerryContactList contactList = (BlackBerryContactList) 
          PIM.getInstance().openPIMList(PIM.CONTACT_LIST, PIM.READ_WRITE, name);

4. Richiamare ContactList.createContact() per aggiungere il nuovo contatto all'elenco contatti.

   BlackBerryContact contact = contactList.createContact();

5. Richiamare uno o più dei seguenti metodi per aggiungere informazioni sul nuovo contatto. Per ulteriori informazioni sui metodi PIMItem, vedere la documentazione di riferimento sulle API di BlackBerry Java Development Environment.
   • addString()
   • addStringArray()
   • addDate()
   • addInt()
   • addBoolean()
   • addBinary()
6. Richiamare i metodi seguenti per verificare che le informazioni rispettino i requisiti di dimensione e immettere i requisiti per il campo del contatto specificato.
   • Richiamare ContactList.isSupportedField(int) per verificare che l'elemento supporti il tipo di campo.
   • Richiamare ContactList.isSupportedAttribute(int, int) per verificare che il campo supporti l'attributo specificato.
   • Richiamare PIMList.maxValues(int field) per verificare il numero di valori supportati dal campo.
7. Richiamare Contact.commit() per eseguire il commit delle modifiche.

   if(contact.isModified())
   {
       contact.commit();
   }

8. Verificare la presenza di PIMException e ControlledAccessException se l'applicazione non dispone dell'autorizzazione per accedere all'applicazione che richiama.