The CContact type exposes the following members.

Constructors

  NameDescription
Public methodCContact(IiMISUser)
Creates a brand new contact with properties initialized to their defaults
Public methodCContact(IiMISUser, String)
Creates a CContact object for an exising contact by reading the existing data from the database

Methods

  NameDescription
Public methodBillDuesSubscriptions
Bill dues subscriptions for the given effective date.
Public methodBillNonDuesSubscriptions
Bill non-dues subscriptions for the given effective date.
Public methodBillSingleNonDuesSubscription
Bill non-dues subscriptions for the given product for the given effective date.
Protected methodCheckAndModifyEditStatus
Sets the EditStatus to Modified if it is Unchanged
(Inherited from iboBase.)
Public methodConvertGuest
Converts an "IBOGuest" anonymous contact into a real CContact
Public methodCreateUserSecurity
Adds security information.
Public methodDelete
iBoBase override to ensure that we get rid of CContactUser when we delete CContact
(Overrides iboBase..::..Delete()()()().)
Public methodEquals
Determines whether the specified Object is equal to the current Object.
(Inherited from Object.)
Protected methodFinalize
Allows an Object to attempt to free resources and perform other cleanup operations before the Object is reclaimed by garbage collection.
(Inherited from Object.)
Public methodGetAddressByNum
Gets the address object with the given address num (key to the address) from this contact
Public methodGetAddressByPurpose
Given the address purpose (AddressPurpose) returns the address with that purpose, if any.
Public methodStatic memberGetContacts(IiMISUser, String, String, array<SqlParameter>[]()[][])
Retrieves a collection of Contacts from the database using the supplied SQL FROM and WHERE criteria and parameters. The starting SQL is: SELECT Name.* FROM Name {0} WHERE 1 = 1 {1}. So any additional FROM criteria should look something like: ", Name_Note" or "INNER JOIN Name_Note ON Name.ID = Name_Note.ID" etc. Any additional WHERE criteria should start with AND, like: "AND Name.ID = Name_Note.ID" etc.
Public methodStatic memberGetContacts(DataServer, IiMISUser, String, String, array<SqlParameter>[]()[][])
Retrieves a collection of Contacts from the database using the supplied SQL FROM and WHERE criteria and parameters. The starting SQL is: SELECT Name.* FROM Name {0} WHERE 1 = 1 {1}. So any additional FROM criteria should look something like: ", Name_Note" or "INNER JOIN Name_Note ON Name.ID = Name_Note.ID" etc. Any additional WHERE criteria should start with AND, like: "AND Name.ID = Name_Note.ID" etc.
Public methodStatic memberGetContacts(IiMISUser, String, String, String, array<SqlParameter>[]()[][])
Retrieves a collection of Contacts from the database using the supplied SQL FROM and WHERE criteria, ORDER BY clause and parameters. The starting SQL is: SELECT Name.* FROM Name {0} WHERE 1 = 1 {1} ORDER BY {2}. So any additional FROM criteria should look something like: ", Name_Note" or "INNER JOIN Name_Note ON Name.ID = Name_Note.ID" etc. Any additional WHERE criteria should start with AND, like: "AND Name.ID = Name_Note.ID" etc. The ORDER BY should look like: "Name.LAST_NAME" or "Name.LAST_NAME DESC" etc.
Public methodStatic memberGetContacts(DataServer, IiMISUser, String, String, String, array<SqlParameter>[]()[][])
Retrieves a collection of Contacts from the database using the supplied SQL FROM and WHERE criteria, ORDER BY clause and parameters. The starting SQL is: SELECT Name.* FROM Name {0} WHERE 1 = 1 {1} ORDER BY {2}. So any additional FROM criteria should look something like: ", Name_Note" or "INNER JOIN Name_Note ON Name.ID = Name_Note.ID" etc. Any additional WHERE criteria should start with AND, like: "AND Name.ID = Name_Note.ID" etc. The ORDER BY clause should look like: "Name.LAST_NAME" or "Name.LAST_NAME DESC" etc.
Public methodGetExtTableByName
Finds the ExtTable instance with the given name for the Contact and returns a reference to it.
Public methodGetExtViewByName
Finds the ExtView instance with the given name for the Contact and returns a reference to it.
Public methodGetHashCode
Serves as a hash function for a particular type.
(Inherited from Object.)
Public methodGetType
Gets the Type of the current instance.
(Inherited from Object.)
Protected methodMemberwiseClone
Creates a shallow copy of the current Object.
(Inherited from Object.)
Public methodNewActivity
Adds a new CActivity object to the Contact and returns a reference to it.
Public methodNewAddress()()()()
Adds a new Address object to the Contact and returns a reference to it.
Public methodNewAddress(String)
Adds a new Address object to the Contact and returns a reference to it.
Public methodNewExtTableRow
Adds a new instance of a CExtTable with the given name and returns a reference to it.
Public methodNewExtView
Adds a new instance of the ExtView with the given name and returns a reference to it.
Public methodNewNote
Adds a new note object to the Contact and returns a reference to it.
Public methodNewSubscription
Used to create a new CSubscription
Public methodSave()()()()
Saves the Contact record, along with all of its child records, to the database
Public methodSave(DataServer)
Saves the Contact record, along with all of its child records, to the database
Public methodSave(DataServer, Boolean)
Saves the Contact record, along with all of its child records, to the database
Public methodSetContactId
Sets the ContactId to the value sent in. This method overrides any Automatic ID generation and should be use carefully.
Public methodSetInstituteContactId
Sets the InstituteContactId for the contact with the option to flowdown the name and address. The InstituteContactId property should normally be used, which is the same as calling this function but with true sent for both flowdown options. Use this method to override one or both of the flowdown options.
Public methodSetInstituteReference
Sets the CompanyID and CompanyMemberType for a contact. This should only be used for bulk load operations where the company may not yet exist when its employees or subsidiaries are loaded. Normally, the CompanyID property should be set instead.
Public methodSetNames
Calls internal methods to calculcate FullName and LastFirst
(Inherited from CContactBasic.)
Public methodToString
Returns a String that represents the current Object.
(Inherited from Object.)
Public methodStatic memberUpgradeBasic
Upgrades a CContactBasic object to a CContact object. Used to take the basic contact and address information created for orders and the like and turn them into ream Contacts in the Contact Management system.
Public methodValidate()()()()
Validates the data set in the contact's properties against cross-property business rules. If any errors are found Validate will return false and the Asi.iBO.Errors property should be checked for details. Validate can be called at any time to check for errors but it will automatically be called at save time.
(Overrides CContactBasic..::..Validate()()()().)
Public methodValidate(DataServer)
Validates the data set in the contact's properties against cross-property business rules. I any errors are found Validate will return false and the Asi.iBO.Errors property should be checked for details. Validate can be called at any time to check for errors but it will automatically be called at save time.

Fields

  NameDescription
Protected fieldm_blnCompanyRecord
Whether or not this contact is an Institute.
(Inherited from CContactBasic.)
Protected fieldm_blnDupMatchInfoDirty
Whether or not duplicate match key is out of date.
(Inherited from CContactBasic.)
Protected fieldm_DisableNameUpdates
Whether or not to automatically update FullName and LastFirst
(Inherited from CContactBasic.)
Protected fieldm_strCompany
Company name
(Inherited from CContactBasic.)
Protected fieldm_strCompanySort
Company sort
(Inherited from CContactBasic.)
Protected fieldm_strContactId
Contact ID
(Inherited from CContactBasic.)
Protected fieldm_strDesignation
Designation
(Inherited from CContactBasic.)
Protected fieldm_strEmail
Email
(Inherited from CContactBasic.)
Protected fieldm_strFax
Fax
(Inherited from CContactBasic.)
Protected fieldm_strFirstName
First name
(Inherited from CContactBasic.)
Protected fieldm_strFullName
Calculate FullName string
(Inherited from CContactBasic.)
Protected fieldm_strInformal
Informal name
(Inherited from CContactBasic.)
Protected fieldm_strLastFirst
Calculated LastFirst string
(Inherited from CContactBasic.)
Protected fieldm_strLastName
Last name
(Inherited from CContactBasic.)
Protected fieldm_strMiddleName
Middle name
(Inherited from CContactBasic.)
Protected fieldm_strPrefix
Prefix
(Inherited from CContactBasic.)
Protected fieldm_strSuffix
Suffix
(Inherited from CContactBasic.)
Protected fieldm_strTitle
Title
(Inherited from CContactBasic.)
Protected fieldm_strTollFreePhone
Toll free phone
(Inherited from CContactBasic.)
Protected fieldm_strWorkPhone
Work phone
(Inherited from CContactBasic.)
Protected fieldmChangeLogEntries
Stores change log entries. Indexed by PropertyName.
(Inherited from CContactBasic.)
Protected fieldmEditStatus
The edit status (unchanged, modified, etc) of this record.
(Inherited from iboBase.)
Protected fieldmErrors
The current list of errors encountered by this class instance during processing.
(Inherited from iboBase.)

Properties

  NameDescription
Public propertyActivities
Array of activities associated with this contact. Will be null if the contact has no activities.
Public propertyActivityCount
The number of activities associated with this contact
Public propertyAddressCount
The number of addresses that the contact has.
Public propertyAddresses
Array of addresses associated with this contact. Will be null if the contact has no addresses
Public propertyBillingCategory
The billing category for this contact, used to categorize contacts for billing purposes
Public propertyBirthDate
The birth date of the contact
Public propertyChapter
The chapter to which the contact belongs (if any)
Public propertyContactId
The Key to the Contact. Often the member ID for members.
Public propertyContactRank
The rank of this contact within the organization. Used to sort contacts on a roster. Lower numbers sort to the top.
Public propertyContactStatusCode
The status of the contact's record. Must be one of the values configured in iMIS.
Public propertyCreatedOn
The date and time that this record was added to iMIS
Public propertyCustomerType
The customer type object representing this contact's customer type
Public propertyCustomerTypeChangedOn
The date and time that the customer type (member type) of this contact was last changed
Public propertyCustomerTypeCode
Gets or sets a reference to the CCustomerType of this customer/contact.
Public propertyDefaultAddress
The main/default address for this contact.
Public propertyDefaultSolicitorId
The ContactId for the default solicitor associated with this Contact.
Public propertyDesignation
Gets or sets the designation that follows the customer's/contact's name.
(Inherited from CContactBasic.)
Public propertyDisableNameUpdates
Whether or not to automatically update FullName and LastFirst
(Inherited from CContactBasic.)
Public propertyDisplayCurrency
Gets or sets the currency code of the currency in which this contact would like monetary amounts displayed.
Public propertyDuplicateMatchingFactor
Gets the result of the duplicate matching formula used to help to prevent duplicate contacts from being input.
Public propertyEditStatus
Indicates the current edit status of this object, i.e., New, Modified, Deleted, or Unchanged. See EEditStatus
(Inherited from iboBase.)
Public propertyEmailAddress
The primary email address of the contact. Alternative email addresses can be entered in the Address records
(Overrides CContactBasic..::..EmailAddress.)
Public propertyErrors
The collection of CError objects (error and warning messages) associated with this object instance
(Inherited from iboBase.)
Public propertyErrorsCount
Gets the number of error and warning messages that have been set on this object.
(Inherited from iboBase.)
Public propertyExcludeFromDirectory
Indicates whether or not this contact should be excluded from any print or online directory lists
Public propertyExcludeFromMailings
Indicates whether or not this contact should be excluded from any mailings
Public propertyExtTableCount
The number of ExtTables associated with this contact
Public propertyExtTables
Array of CExtTables associated with this contact. Will be null if the contact has no data in any ExtTable.
Public propertyExtViewCount
The number of ExtViews associated with this contact
Public propertyExtViews
Array of CExtViews associated with this contact. Will be null if the contact has no data in any ExtView.
Public propertyFax
The FAX number (facsimile telephone number) of this contact
(Overrides CContactBasic..::..Fax.)
Public propertyFinancialEntityCode
The Organization (Financial Entity) to which this contact record belongs. This is used to distinguish different financial entities within iMIS and is validated against the list setup in iMIS Organization Names.
Public propertyFinancialProfile
The financial profile object for this contact.
Public propertyFirstName
Gets or sets the first (or given) name of this contact, if a person. Not set for Institute/Company records.
(Inherited from CContactBasic.)
Public propertyFullName
Gets the full name of the contact/customer.
(Inherited from CContactBasic.)
Public propertyFunctionalTitle
The functional (job) title of the contact. Functional title is used to group people with the same job function but different actual job titles together for querying, sorting or reporting. For example, contacts with a title of Secretary, Office Assistant, and Receptionist might all get the Functional Title "Office Assistant".
Public propertyGender
The Gender (sex) if the contact, if a person. Valid values are "M" for Male, "F" for female or the empty string for unspecified or for companies.
Public propertyHomePhone
The home telephone number of the contact
Public propertyInformal
Gets or sets the informal or nickname of the contact. For example, FirstName = "Robert", the informal name might be "Bob".
(Inherited from CContactBasic.)
Public propertyInstituteContactId
The Contact ID of the institute/company for which this contact works (for people) or is a subsidiary of (for institutes/companies)
Public propertyInstituteCustomerTypeCode
The Customer type of the institute
Public propertyInstituteName
Gets or sets the name of the institute/company for which the ship to customer works, or if the customer is an institute/company, its name.
(Inherited from CContactBasic.)
Public propertyInstituteSort
Gets the Institute name, optimized for sorting
(Inherited from CContactBasic.)
Public propertyIsInstitute
Gets or sets an indicator of whether this contact is an institute/company (true) or a Person (false).
(Inherited from CContactBasic.)
Public propertyIsMember
Indicates whether or not the contact is a member. A contact is a member if MemberRecord is true and Status begins with "A"
Public propertyJoinDate
The date that the contact joined (became a member of) the organization
Public propertyLastFirst
Gets the contact's last and first name. Calculated as LastName, FirstName. Like Doe, John
(Inherited from CContactBasic.)
Public propertyLastFirstInstitute
Gets the contact's last and first name or the institute name if no last or first is available. Calculated as LastName, FirstName. Like Doe, John or ABC Corp.
(Inherited from CContactBasic.)
Public propertyLastName
Gets or sets the last name, family name or surname of this contact/customer, if a person. Not set for Institute/Company records.
(Inherited from CContactBasic.)
Public propertyMailCode
Also known as "Address Code" this code may be assigned to contacts and addresses (depending on system options) to allow them to be sorted together in mailings
Public propertyMajorKey
A second unique key (in addition to ContactId) that can optionally be assigned to contacts to help in retrieving them via the iMIS search functionality. Usually something like Social Security Number, License Number, Certification Number, Old Member ID, etc.
Public propertyMemberStatusCode
The membership status of the Contact
Public propertyMemberStatusDate
The date on which the MemberStatus was set to its current state
Public propertyMiddleName
Gets or sets the middle name of the contact/customer.
(Inherited from CContactBasic.)
Public propertyNoteCount
The number of notes that exist for this contact
Public propertyNotes
Array of notes about this contact. Will be null if the contact has no notes.
Public propertyPaidThroughDate
The date through whcih this contact has paid membership dues.
Public propertyPreferredBillAddress
The CAddress that is the contact's preferred address for bills
Public propertyPreferredMailAddress
The CAddress that is the contact's preferred address for mailings
Public propertyPreferredShipAddress
The CAddress that is the contact's preferred address for shipping
Public propertyPrefix
Gets or sets the prefix (personal title) to the customer's name. Like Mr., Mrs., etc.
(Inherited from CContactBasic.)
Public propertyPreviousCustomerTypeCode
The previous customer type (member type) before it was changed to its present value.
Public propertyPrimarySubscription
Gets the primary subscription associated with this contact
Public propertySicCode
The Standard Industrial Classification (SIC) Code that best matches the one in which this contact does business.
Public propertySortName
Gets the name of the contact, optimized for sorting
(Inherited from CContactBasic.)
Public propertySourceCode
A character code indicating the source of this contact
Public propertySubscriptionCount
The number of subscriptions associated with this contact
Public propertySubscriptions
Array of subscriptions associated with this contact. Will be null if the contact has no notes.
Public propertySuffix
Gets or sets the suffix to the customer's name. Like Sr., Jr., etc.
(Inherited from CContactBasic.)
Public propertyTitle
The job title of the contact. Like CEO, Staff Accountant, etc.
(Inherited from CContactBasic.)
Public propertyTollFreePhone
Gets or sets the toll free telephone number of this contact. (A.K.A., 800 number)
(Inherited from CContactBasic.)
Public propertyUpdatedByUserId
The login user id of the user who last updated this contact's record
Public propertyUpdatedOn
The date and time that this contact's record was last updated
Public propertyUseMemberPricing
Indicates whether or not to give this contact member pricing when doing product sales.
Public propertyUserSecurity
The security object associated with this Contact
Public propertyWebsiteAddress
The contact's website address. May include the http:// but does not need it unless it needs to be https
Public propertyWorkPhone
The contact's telephone number at work
(Overrides CContactBasic..::..WorkPhone.)

See Also