Methods summary
public
|
|
public
integer
|
#
add( array $appointment_data )
Add an appointment record to the database.
Add an appointment record to the database.
This method adds a new appointment to the database. If the appointment
doesn't exists it is going to be inserted, otherwise the record is going to be
updated.
Parameters
- $appointment_data
array $appointment_data Associative array with the appointmet's data. Each key has the
same name with the database fields.
Returns
integer Returns the appointments id.
ExpectedException
ValidationException
DatabaseException
|
public
boolean
|
#
exists( array $appointment_data )
Check if a particular appointment record already exists.
Check if a particular appointment record already exists.
This method checks wether the given appointment already exists in the
database. It doesn't search with the id, but by using the following fields:
"start_datetime", "end_datetime", "id_users_provider", "id_users_customer",
"id_services".
Parameters
- $appointment_data
array $appointment_data Associative array with the appointment's data. Each key has
the same name with the database fields.
Returns
boolean Returns wether the record exists or not.
ExpectedException
InvalidArgumentException When the $appointment_data array does not contain the
necessary field.
|
public
integer
|
#
find_record_id( array $appointment_data )
Find the database id of an appointment record.
Find the database id of an appointment record.
The appointment data should include the following fields in order to get the
unique id from the database: start_datetime, end_datetime, id_users_provider,
id_users_customer, id_services.
<strong>IMPORTANT!</strong> The record must already exists in the
database, otherwise an exception is raised.
Parameters
- $appointment_data
array $appointment_data Array with the appointment data. The keys of the array should
have the same names as the db fields.
Returns
integer Returns the id.
ExpectedException
DatabaseException
|
public
boolean
|
#
validate_data( array $appointment_data )
Validate appointment data before the insert or update operation is
executed.
Validate appointment data before the insert or update operation is
executed.
Parameters
- $appointment_data
array $appointment_data Contains the appointment data.
Returns
boolean Returns the validation result.
|
public
boolean
|
#
delete( integer $appointment_id )
Delete an existing appointment record from the database.
Delete an existing appointment record from the database.
Parameters
- $appointment_id
integer $appointment_id The record id to be deleted.
Returns
boolean Returns the delete operation result.
ExpectedException
InvalidArgumentException Raises when the $appointment_id is not an integer.
|
public
array
|
#
get_row( integer $appointment_id )
Get a specific row from the appointments table.
Get a specific row from the appointments table.
Parameters
- $appointment_id
integer $appointment_id The record's id to be returned.
Returns
array Returns an associative array with the selected record's data. Each key has the
same name as the database field names.
|
public
string
|
#
get_value( string $field_name, integer $appointment_id )
Get a specific field value from the database.
Get a specific field value from the database.
Parameters
- $field_name
string $field_name The field name of the value to be returned.
- $appointment_id
integer $appointment_id The selected record's id.
Returns
string Returns the records value from the database.
|
public
array
|
#
get_batch( string $where_clause = '' )
Get all, or specific records from appointment's table.
Get all, or specific records from appointment's table.
Parameters
- $where_clause
string $where_clause (OPTIONAL) The WHERE clause of the query to be executed. DO NOT
INCLUDE 'WHERE' KEYWORD.
Returns
array Returns the rows from the database.
Example
$this->Model->getBatch('id = ' . $recordId);
|