>

Property Name	Type	Read/Write	Description
Name	String	Read Only	If the incoming phone number is associated with a contact then this will be the same as EventArgs.Contact.Name, otherwise the same as EventArgs.CidName.
CidName	String	Read Only	Gets the caller's name as specified by the modem.
PhoneNumber	String	Read Only	Gets the caller's phone number as specified by the modem.
Date	DateTime	Read Only	Gets the date of the call.
Contact	Contact	Read Only	Gets the contact object associated with the PhoneNumber. If no contact matches the incoming phone number then this will be an empty contact.

You can check if the contact is empty with the IsEmpty property. Example:

if (EventArgs.Contact.IsEmpty)
{
	// do something
}

Contact Object Properties

Property Name	Type	Read/Write	Description
Name	String	Read Only	Gets the contact's name.
Description	String	Read Only	Gets the contact description.
ImageLocation	String	Read Only	Gets the location of the image associated with the contact.
Custom1	String	Read Only	Gets a user defined value.
Custom2	String	Read Only	Gets a user defined value.
Custom3	String	Read Only	Gets a user defined value.
Custom4	String	Read Only	Gets a user defined value.
PhoneNumbers	Array	Read Only	Gets an array of Phone objects.
Addresses	Array	Read Only	Gets an array of Address objects.
IsEmpty	Boolean	Read Only	Gets a boolean indicating if the contact object is empty.

Phone Object Properties

Property Name	Type	Read/Write	Description
PhoneNumber	String	Read Only	Gets the phone's phone number.
PhoneType	String	Read Only	Gets the phone type. One of the following: Home, PersonalMobile, Fax, Work, WorkMobile, Pager, Car, CompanyMain, Other.

Address Object Properties

Property Name	Type	Read/Write	Description
Street	String	Read Only	Gets the address's street number and name.
Street2	String	Read Only	Gets a second optional street line.
City	String	Read Only	Gets the address's city.
State	String	Read Only	Gets the address's state.
ZipCode	String	Read Only	Gets the zipcode or postal code for the address.
FreeFormAddress	String	Read Only	Gets the address as a single free form line.
AddressType	String	Read Only	Gets the address type. One of the following: Home, Business, Other

Contact Configuration

Contact information is stored in the "Contacts.xml" file on the master service server in the common program data folder.

• In Windows Vista this will usually be: C:\ProgramData\Codecore Technologies\Elve\Contacts.xml
• In Windows XP this will usually be C:\Documents and Settings\All Users\Application Data\Codecore Technologies\Elve\Contacts.xml
  

The example file below shows all the elements, although some of them are optional.

<?xml version="1.0" encoding="utf-8" ?>
<Contacts>
	<Contact>
		<Name>John Smith</Name>
		<Description>Kathy's brother</Description>
		<ImageLocation></ImageLocation>
		<Phone>
			<Number>3125551212</Number>
			<!-- PhoneTypes: Home, PersonalMobile, Fax, Work, WorkMobile, Pager, Car, CompanyMain, Other -->
			<PhoneType>Mobile</PhoneType>
		</Phone>
		<Address>
			<Street>123 Hickory Ln</Street>
			<City>Chicago</City>
			<State>IL</State>
			<ZipCode>60123</ZipCode>
			<!-- AddressTypes: Home, Business, Other -->
			<AddressType>Home</AddressType>
		</Address>
		<Address>
			<FreeFormAddress>456 Aspen Dr, Chicago, IL, 60123</FreeFormAddress>
			<!-- AddressTypes: Home, Business, Other -->
			<AddressType>Business</AddressType>
		</Address>
		<Custom1></Custom1>
		<Custom2></Custom2>
		<Custom3></Custom3>
		<Custom4></Custom4>
	</Contact>	   
</Contacts>

Contact xml elements:

Name          : (Required) The contact's name.
Description   : (Optional) Any description about the contact.
ImageLocation : (Optional) The location of an image associated with the contact.
Custom1       : (Optional) This is a custom field that can hold any thing you want.
Custom2       : (Optional) This is a custom field that can hold any thing you want.
Custom3       : (Optional) This is a custom field that can hold any thing you want.
Custom4       : (Optional) This is a custom field that can hold any thing you want.
Phone         : (Optional) See below for the Phone xml element children.
Address       : (Optional) See below for the Address xml element children.

Phone xml elements (Optional):

Number    : (Required) The phone number as consecutive numbers. Ex. 3125551212
PhoneType : (Required) One of the following: Home, PersonalMobile, Fax, Work, WorkMobile, Pager, Car, CompanyMain, Other.

Address xml elements (Optional):

Street          : (Optional) The name of the device driver's event that this rule applies to.
Street2         : (Optional) A second street line.
City            : (Optional) The city.
State           : (Optional) The state.
ZipCode         : (Optional) The zip code or postal code.
FreeFormAddress : A free form address field, this is mutually exclusive with Street, Street2, City, State, ZipCode.
AddressType     : (Required) One of the following: Home, Business, Other

Multiple Phone and Address elements may exist.