FS::contact - Object methods for contact records
use FS::contact;
$record = new FS::contact \%hash;
$record = new FS::contact { 'column' => 'value' };
$error = $record->insert;
$error = $new_record->replace($old_record);
$error = $record->delete;
$error = $record->check;
An FS::contact object represents an specific contact person for a prospect or customer. FS::contact inherits from FS::Record. The following fields are currently supported:
primary key
prospectnum
custnum
locationnum
last
first
title
comment
empty or Y
empty or bcrypt
disabled
Creates a new contact. To add the contact to the database, see "insert".
Note that this stores the hash reference, not a distinct copy of the hash it points to. You can ask the object for a copy with the hash method.
Adds this record to the database. If there is an error, returns the error, otherwise returns false.
Delete this record from the database.
Replaces the OLD_RECORD with this one in the database. If there is an error, returns the error, otherwise returns false.
Subroutine, takes a string and returns a list (suitable for assigning to a hash) with keys 'countrycode', 'phonenum' and 'extension'
(Should probably be moved to contact_phone.pm, hence the initial underscore.)
Used by insert & replace to update the fuzzy search cache
Checks all fields to make sure this is a valid contact. If there is an error, returns the error, otherwise returns false. Called by the insert and replace methods.
Returns a formatted string representing this contact, including name, title and comment.
Returns a formatted string representing this contact, with just the name.
Returns the name of this contact's class (see FS::contact_class).
Alternate search constructor (class method). Given an email address, returns the contact for that address, or the empty string if no contact has that email address.
Alternate search constructor (class method). Given an email address and custnum, returns the contact for that address and custnum. If that contact doesn't have selfservice access, or there isn't one, returns the empty string.
Changes the contact's selfservice access password to NEW_PASSWORD. This does not check password policy rules (see is_password_allowed) and will return an error only if editing the record fails for some reason.
If NEW_PASSWORD is the same as the existing password, this does nothing.
Returns a list reference containing the set of contact fields used in the web interface for one-line editing (i.e. excluding contactnum, prospectnum, custnum and locationnum, as well as password fields, but including fields for contact_email and contact_phone records.)
FS::Record, schema.html from the base documentation.