Difference between revisions of "Freeside:3:Documentation:Developer/FS/prospect main"

Revision as of 20:06, 27 June 2012

NAME

FS::prospect_main - Object methods for prospect_main records

SYNOPSIS

 use FS::prospect_main;

 $record = new FS::prospect_main \%hash;
 $record = new FS::prospect_main { 'column' => 'value' };

 $error = $record->insert;

 $error = $new_record->replace($old_record);

 $error = $record->delete;

 $error = $record->check;

DESCRIPTION

An FS::prospect_main object represents a prospect. FS::prospect_main inherits from FS::Record. The following fields are currently supported:

prospectnum

primary key

agentnum

Agent

company

company

METHODS

new HASHREF

Creates a new prospect. To add the prospect 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.

insert

Adds this record to the database. If there is an error, returns the error, otherwise returns false.

delete

Delete this record from the database.

replace OLD_RECORD

Replaces the OLD_RECORD with this one in the database. If there is an error, returns the error, otherwise returns false.

check

Checks all fields to make sure this is a valid prospect. If there is an error, returns the error, otherwise returns false. Called by the insert and replace methods.

name; contact

Returns the contacts (see FS::contact) associated with this prospect.

cust_location

Returns the locations (see FS::cust_location) associated with this prospect.

qual

Returns the qualifications (see FS::qual) associated with this prospect.

search HASHREF

(Class method)

Returns a qsearch hash expression to search for the parameters specified in HASHREF. Valid parameters are:

agentnum

BUGS

SEE ALSO

FS::Record, schema.html from the base documentation.