The JebContact class is the wrapper of Exchange Contact. If you intend to retrieve additional contact fields other than those directly supported by the methods of JebContact, new methods can be added to JebContact for this purpose.

Prerequisites

1. JDK 2.x or higher
2. J-Integra
3. MS Exchange Server Version 5.5 Service Pack 4 (or higher), MS Exchange 2000 Service Pack 3 (or higher), or MS Exchange 2003
4. Ensure that you have installed the J-Integra license
5. Make sure you have configured the Exchange Server

Add New Methods

1. Find JebContact.java, which is in your \source\com\intrinsyc\jeb folder.
   
   For example, C:\jintegra\source\com\intrinsyc\jeb\JebContact.java
   
   
2. Backup it by copying and pasting, and name the backup file as JebContact_backup.java.
   
   
3. Open JebContact.java. Look up the property tag of field from the Appendix: CDO Contact Properties below, and add a new "get" method and a new "set" method to JebContact.java.
   
   For instance, to manipulate the Company Name field, look up the Appendix: CDO Contact Properties and you will see that CdoPR_COMPANY_NAME is the property tag of Company Name. Add the following getCompanyName and setCompanyName methods to your JebContact.java by copying and pasting.

/** 
 * Returns the company name of this contact if it exists. An error will 
 * not be thrown for this. 
 * 
 * @returns String - Contains the company name if it exists or null otherwise 
 */


public String getCompanyName() {  
 
 Field fd = null;  
 String returnValue = null;  
 
    try {    
  fd = this.getFieldObject(      
   new Integer(com.intrinsyc.cdo.CdoPropTags.CdoPR_COMPANY_NAME),
   new FieldsProxy(_message.getFields())    );    
  returnValue = (String)fd.getValue();  
 } catch (Exception e) {    
  e.printStackTrace();  
 }  
 
    return returnValue;
}


/**
 * Sets the value of the company name for this message. If the company name
 * field does not exist, it will be added and have it's value set 
 * 
 * @param companyName - The name to set for this contact
 * @throws JebException - If the name cannot be set or added
 */

public void setCompanyName(String companyName) throws JebException {  
 
 Field fd = null;  
    try {    
  fd = this.getFieldObject(      
            new Integer(com.intrinsyc.cdo.CdoPropTags.CdoPR_COMPANY_NAME),      
   new FieldsProxy(_message.getFields())    );    
        if(fd == null) {      
   this.addFieldObject(new Integer(com.intrinsyc.cdo.CdoPropTags.CdoPR_COMPANY_NAME),        
      companyName, new FieldsProxy(_message.getFields())      );    
  } 
        else {      
   fd.setValue(companyName);    
  }  
 } catch (Exception e) {    
  throw new JebException("Cannot setCompanyName:\n" + e);  
 }
}

4. Compile the modified JebContact.java.
   
   C:\jintegra\source\com\intrinsyc\jeb>javac JebContact.java
   
5. Go to \lib, and make a backup file of jeb.jar. Name the backup file as jeb_bk.jar.
   
   C:\jintegra\lib>copy jeb.jar jeb_bk.jar
   
6. In \lib directory, create new directories and make the path structure be
   \lib\com\intrinsyc\jeb.
   
   C:\jintegra\lib>mkdir com
   C:\jintegra\lib>cd com
   C:\jintegra\lib\com>mkdir intrinsyc
   C:\jintegra\lib\com>cd intrinsyc
   C:\jintegra\lib\com\intrinsyc>mkdir jeb
   
   C:\jintegra\lib\com\intrinsyc\jeb>
   
7. Move the newly compiled JebContact.class to \lib\com\intrinsyc\jeb.
   
   C:\jintegra\source\com\intrinsyc\jeb>move JebContact.class C:\jintegra\lib\com\intrinsyc\jeb
   
8. Update jeb.jar with the newly compiled JebContact.class. Remember to reserve the path structure of JebContact.class as com\intrinsyc\jeb\JebContact.class.
   
   C:\jintegra\lib>jar uf jeb.jar com\intrinsyc\jeb\JebContact.class
   
   
9. Now the methods getCompanyName and setCompanyName are ready to be used for manipulating Company Name just like the other "get" and "set" methods in JebContact.
   
   Refer to the Java examples in C:\jintegra\examples\java-exchange\applications\.

Note

The constants in JebContact.java are defined according to Appendix: CDO Contact Properties. You may need to add more such variables which depends on the fields that you need to manipulate.

private static final String CdoPropSetID3 = "0420060000000000C000000000000046";
private static final String CdoContact_EmailAddrType = "0x8082";
private static final String CdoContact_EmailEmailAddress = "0x8083";
private static final String CdoContact_EmailOriginalDisplayName = "0x8084";
private static final String CdoContact_FileAs = "0x8005";
private static final String CdoContact_FullNameAndCompany = "0x8019";

The ways to create and read the fields are very different which depends on what kinds of fields you are dealing with. For instance, CdoPR_BUSINESS_ADDRESS_COUNTRY and CdoPR_BUSINESS_ADDRESS_STREET are "Outlook contacts", and the way to populate them is different than the other kinds of fields. To do so, please refer to these two places:
1. the section "Create an Outlook Contact with CDO" from http://www.cdolive.com/cdo5.htm
2. the section "Read MAPI Properties" from http://www.smithfamily.com/Reference/CDOLive%20-%20Property%20Tags%20and%20Types.htm

More documentation is available from http://www.cdolive.com andhttp://msdn.microsoft.com/library/en-us/cdo/html/_olemsg_mapi_property_tags.asp

Appendix: CDO Contact Properties

The following table is a list of the most commonly used property tags of CDO contact: