JobFactory
extends Factory
in package
Table of Contents
- $cache : Cache_Lite_Function|Cache_Lite_Output
- $data : mixed
- $db : mixed
- $is_new : mixed
- $old_data : mixed
- $rs : mixed
- $tmp_data : mixed
- $validate_only : mixed
- $Validator : mixed
- $address_validator_regex : mixed
- $api_message_id : mixed
- $city_validator_regex : mixed
- $client_obj : mixed
- $company_obj : mixed
- $enable_system_log_detail : mixed
- $pk_sequence_name : mixed
- $progress_bar_obj : mixed
- $table : mixed
- $ignore_column_list : bool
- $is_valid : mixed
- $validate_default_item : mixed
- __construct() : mixed
- Factory constructor.
- __toString() : bool|string
- Print primary columns from object.
- _getFactoryOptions() : array<string|int, mixed>|null
- _getVariableToFunctionMap() : array<string|int, mixed>
- addLog() : bool
- bulkDelete() : bool
- castGenericDataValue() : mixed
- Generic casting function that all set/get*() functions should pass through.
- clearCacheSavedInTransaction() : bool
- clearData() : bool
- clearGeoCode() : bool
- clearNonMappedData() : array<string|int, mixed>|null
- Removes array elements from $data that are not in the function map.
- clearOldData() : bool
- CommitSavePoint() : bool
- CommitTransaction() : mixed
- convertFlexArray() : array<string|int, mixed>
- createTransactions() : array<string|int, mixed>|bool
- decodeCustomFields() : bool
- decodeGenericJSONData() : bool
- Decode generic 'other_json' column data.
- decodeJSONColumn() : bool
- Decodes JSON columns that are not the 'other_json' column.
- Delete() : bool
- Deletes the record directly from the database.
- encodeCustomFields() : bool
- encodeGenericJSONData() : bool
- Encode generic 'other_json' column data. This should only be done in Save() after all validation has occurred already and we are just about to commit it to the DB.
- encodeJSONColumns() : bool
- Encode any JSON columns that are not 'other_json' column. This should only be done in Save() after all validation has occurred already and we are just about to commit it to the DB.
- ExecuteSQL() : bool
- Execute SQL queries and handle paging properly for select statements.
- FailTransaction() : mixed
- fromBool() : bool
- fromJSONBool() : bool
- getAddress1() : bool
- getAddress2() : bool
- getAffectedRows() : int|bool
- getAPIMessageID() : bool|null
- Used for updating progress bar for API calls.
- getBadQuantityRate() : bool|mixed
- getBillableRate() : bool|mixed
- getBranch() : bool|mixed
- getCache() : bool|mixed
- getCity() : bool|mixed
- getClient() : bool|mixed
- getClientObject() : bool|null
- getColumn() : bool|mixed
- Generic function get any data from the data array.
- getColumnList() : array<string|int, mixed>|bool
- getCompany() : bool|mixed
- getCompanyGenericMapData() : mixed
- Generic function to return and cache CompanyGenericMap data, this greatly improves performance of CalculatePolicy when many policies exist.
- getCompanyObject() : null
- getCountry() : bool|mixed
- getCreatedAndUpdatedColumns() : bool
- getCreatedBy() : bool|mixed
- getCreatedDate() : int
- getCurrent() : mixed
- Grabs the current object
- getCurrentRow() : int|bool
- getCustomField() : void
- Get a single custom field by ID.
- getCustomFields() : mixed
- getCustomFieldsColumns() : array<string|int, mixed>
- getCustomFieldsDataForObject() : array<string|int, mixed>
- Get custom field data for this specific object, so it can be easily cached in memory without having to go to the database or unserialize it from cache for every row.
- getCustomFieldsDefaultData() : mixed
- getCustomFieldsParseHints() : array<string|int, mixed>
- getCustomFieldTableName() : string
- getDataDifferences() : array<string|int, mixed>
- Returns the differences in data from the DB vs the in-memory object, so the data will be the OLD data. Used in Validation/postSave() functions to determine if a field has changed or not.
- getDateRangeSQL() : bool|string
- This function takes plain input from the user and creates a SQL statement for filtering based on a date range.
- getDefaultItem() : bool|mixed
- getDeleted() : bool
- getDeletedBy() : bool|mixed
- getDeletedDate() : bool|mixed
- getDepartment() : bool|mixed
- getDescription() : bool|mixed
- getEmptyRecordSet() : mixed
- getEnableSystemLogDetail() : bool
- getEnableValidateDefaultItem() : bool
- getEndDate() : bool|mixed
- getEstimateBadQuantity() : bool|mixed
- getEstimateQuantity() : bool|mixed
- getEstimateTime() : bool|mixed
- getExcludeJobItem() : array<string|int, mixed>|bool
- getExcludeUser() : array<string|int, mixed>|bool
- getGenericDataValue() : bool|mixed
- Generic getter/setter functions that should be used when Validation code is moved from get/set functions to Validate() function.
- getGenericJSONDataValue() : bool|mixed
- Generic getter/setter functions for handling generic JSON data in 'other_json' SQL column.
- getGenericObject() : object|bool
- Generic function to return and cache class objects ListFactory, ListFactoryMethod, Variable, ID, IDMethod
- getGenericOldDataValue() : bool|mixed
- getGenericTempDataValue() : bool
- Generic getter/setter functions that should be used when Validation code is moved from get/set functions to Validate() function.
- getGEOFenceIds() : array<string|int, mixed>|bool
- getGroup() : bool|mixed
- getIButtonID() : int
- getId() : bool|mixed
- getIDSByListFactory() : array<string|int, mixed>|bool
- getIncludeJobItem() : array<string|int, mixed>|bool
- getIncludeUser() : array<string|int, mixed>|bool
- getIterator() : FactoryListIterator
- getJobItemGroup() : array<string|int, mixed>|bool
- getJobItemGroupSelectionType() : bool|int
- getLabelId() : bool|mixed|string
- getLatitude() : bool|float
- getLocationNote() : bool|mixed
- getLongitude() : bool|float
- getManualID() : bool|int
- getMinimumTime() : bool|mixed
- getName() : bool|mixed
- getNameMetaphone() : bool|mixed
- getNextAvailableManualId() : int
- getNextInsertId() : bool|string
- getNote() : bool|mixed
- getObjectAsArray() : array<string|int, mixed>
- getOptions() : array<string|int, mixed>|bool
- getPermissionColumns() : bool
- getPostalCode() : bool|mixed
- getProgressBarObject() : null|ProgressBar
- getProvince() : bool|mixed
- getRecordCount() : int|bool
- getSchedulePercent() : bool|float|int|null
- getSequenceName() : bool
- getSerialPattern() : mixed
- getStartDate() : bool|mixed
- getStatus() : bool|int
- getSupervisor() : bool|mixed
- getTable() : bool|string
- getTag() : bool|string
- getTransactionMode() : string
- getUpdatedBy() : bool|mixed
- getUpdatedDate() : int
- getUserBranch() : array<string|int, mixed>|bool
- getUserBranchSelectionType() : bool|int
- getUserDepartment() : array<string|int, mixed>|bool
- getUserDepartmentSelectionType() : bool|int
- getUserGroup() : array<string|int, mixed>|bool
- getUserGroupSelectionType() : bool|int
- getUserTitle() : array<string|int, mixed>|bool
- getUserTitleSelectionType() : bool|int
- getValidSQLColumns() : array<string|int, mixed>
- getVariableToFunctionMap() : array<string|int, mixed>|bool
- handleSaveSQLReturning() : bool
- Used to handle any "RETURNING ..." clause on a SQL INSERT/UPDATE query.
- hasDataChanged() : bool
- Determine if the record data has changed at all.
- isAllowedItem() : bool
- isAllowedUser() : bool
- isClientFriendly() : bool
- Check if the remote client is our main UI app controlled by us, vs. a user utilizing the API for example.
- isDataDifferent() : bool
- Used to check the differences between a single key in the $old_data vs. $data arrays.
- isNew() : bool
- Determines if the data is new data, or updated data. Basically determines if a database INSERT or UPDATE SQL statement is generated.
- isSQLExceptionRetryable() : bool
- Determines if a SQL exception is one that can be retried or not.
- isUniqueManualID() : bool
- isValid() : bool
- Call class specific validation function just before saving.
- isWarning() : bool
- Call class specific validation function just before saving.
- modifyInsertQuery() : mixed
- Modifies the automatically generated SQL INSERT query for adding things like " ON CONFLICT ..."
- parseCustomFieldsFromArray() : mixed
- postSave() : bool
- preSave() : bool
- removeCache() : bool
- RetryTransaction() : mixed
- Accepts a Closure and is retried at set intervals which should be in a transaction.
- rewind() : bool
- Rewinds record set iterator to begining. The same as ADODB's MoveFirst() function.
- RollbackSavePoint() : bool
- Save() : bool|int|string
- Determines to insert or update, and does it.
- saveCache() : bool
- serializeRS() : string
- Serialize ADODB recordset.
- setAddress1() : bool
- setAddress2() : bool
- setAPIMessageID() : bool
- setBadQuantityRate() : bool
- setBillableRate() : bool
- setBranch() : bool
- setCacheLifeTime() : bool
- setCity() : bool
- setClient() : bool
- setCompany() : bool
- setCountry() : bool
- setCreatedAndUpdatedColumns() : bool
- setCreatedBy() : bool
- setCreatedDate() : bool
- setCustomField() : void
- Set a single custom field by ID.
- setCustomFields() : bool
- setDefaultItem() : bool
- setDeleted() : bool
- setDeletedBy() : bool|null
- setDeletedDate() : bool
- setDepartment() : bool
- setDescription() : bool
- setEnableSystemLogDetail() : bool
- setEnableValidateDefaultItem() : bool
- setEndDate() : bool
- setEstimateBadQuantity() : bool
- setEstimateQuantity() : bool
- setEstimateTime() : bool
- setExcludeJobItem() : bool
- setExcludeUser() : bool
- setGenericDataValue() : bool
- setGenericJSONDataValue() : bool
- Generic getter/setter functions for handling generic JSON data in 'other_json' SQL column.
- setGenericObject() : bool
- Allow method to pre-populate/overwrite the cache if needed.
- setGenericTempDataValue() : bool
- setGEOFenceIds() : bool
- setGroup() : bool
- setIButtonID() : bool
- setId() : bool
- setIncludeJobItem() : bool
- setIncludeUser() : bool
- setIsValid() : bool
- Sets the is_valid flag, mostly used to set it to FALSE to force a full re-validation.
- setJobItemGroup() : bool
- setJobItemGroupSelectionType() : bool
- setLatitude() : bool
- setLocationNote() : bool
- setLongitude() : bool
- setManualID() : bool
- setMinimumTime() : bool
- setName() : bool
- setNameMetaphone() : bool
- setNote() : bool
- setObjectFromArray() : bool
- setPostalCode() : bool
- setProgressBarObject() : bool
- setProvince() : bool
- setQueryStatementTimeout() : bool
- setSerialPattern() : bool
- setStartDate() : bool
- setStatus() : bool
- setSupervisor() : bool
- setTag() : bool
- setTransactionMode() : mixed
- setUpdatedBy() : bool|null
- setUpdatedDate() : bool|int|null|string
- setUserBranch() : bool
- setUserBranchSelectionType() : bool
- setUserDepartment() : bool
- setUserDepartmentSelectionType() : bool
- setUserGroup() : bool
- setUserGroupSelectionType() : bool
- setUserTitle() : bool
- setUserTitleSelectionType() : bool
- StartSavePoint() : bool
- StartTransaction() : mixed
- toBool() : int
- toJSONBool() : string
- Validate() : bool
- validateCustomFields() : mixed
- castInteger() : bool|int|string
- getColumnsFromAliases() : array<string|int, mixed>
- getCustomFieldWhereSQL() : string
- getDatabaseType() : string
- getListSQL() : bool|int|string|array<string|int, mixed>
- getSortSQL() : bool|string
- getSQLStringAggregate() : string
- getSQLToEpochFunction() : string
- getSQLToTimeFunction() : string
- getSQLToTimeStampFunction() : string
- getWhereClauseSQL() : null|string
- getWhereSQL() : bool|string
- handleSQLSyntax() : string
- SQL where clause Syntax: or % as wildcard.
- stripSQLSyntax() : mixed
- getInsertQuery() : mixed
- getRecordSetColumnList() : array<string|int, mixed>|bool
- getUpdateQuery() : bool
- parseColumnName() : bool|string
- Parses out the exact column name, without any aliases, or = signs in it.
Properties
$cache
public
Cache_Lite_Function|Cache_Lite_Output
$cache
= \null
$data
public
mixed
$data
= []
$db
public
mixed
$db
= \null
$is_new
public
mixed
$is_new
= \null
$old_data
public
mixed
$old_data
= []
$rs
public
mixed
$rs
= \null
$tmp_data
public
mixed
$tmp_data
= []
$validate_only
public
mixed
$validate_only
= \false
$Validator
public
mixed
$Validator
= \null
$address_validator_regex
protected
mixed
$address_validator_regex
= '/^[a-zA-Z0-9-,_\\/\\.\'#\\ |\\x{0080}-\\x{FFFF}]{1,250}$/iu'
$api_message_id
protected
mixed
$api_message_id
= \null
$city_validator_regex
protected
mixed
$city_validator_regex
= '/^[a-zA-Z0-9-,_\\.\'#\\ |\\x{0080}-\\x{FFFF}]{1,250}$/iu'
$client_obj
protected
mixed
$client_obj
= \null
$company_obj
protected
mixed
$company_obj
= \null
$enable_system_log_detail
protected
mixed
$enable_system_log_detail
= \true
$pk_sequence_name
protected
mixed
$pk_sequence_name
= 'job_id_seq'
$progress_bar_obj
protected
mixed
$progress_bar_obj
= \null
$table
protected
mixed
$table
= 'job'
$ignore_column_list
private
bool
$ignore_column_list
$is_valid
private
mixed
$is_valid
= \false
$validate_default_item
private
mixed
$validate_default_item
Methods
__construct()
Factory constructor.
public
__construct() : mixed
Return values
mixed —__toString()
Print primary columns from object.
public
__toString() : bool|string
Return values
bool|string —_getFactoryOptions()
public
_getFactoryOptions(string $name[, null $parent = null ]) : array<string|int, mixed>|null
Parameters
- $name : string
- $parent : null = null
Return values
array<string|int, mixed>|null —_getVariableToFunctionMap()
public
_getVariableToFunctionMap(array<string|int, mixed> $data) : array<string|int, mixed>
Parameters
- $data : array<string|int, mixed>
Return values
array<string|int, mixed> —addLog()
public
addLog( $log_action) : bool
Parameters
Return values
bool —bulkDelete()
public
bulkDelete(string|array<string|int, mixed> $ids) : bool
Parameters
- $ids : string|array<string|int, mixed>
-
UUID
Tags
Return values
bool —castGenericDataValue()
Generic casting function that all set/get*() functions should pass through.
public
castGenericDataValue( &$value, $cast) : mixed
However for now lets wait until we have meta data from SQL schema so we can pass those datatypes directly into this.
Parameters
Return values
mixed —clearCacheSavedInTransaction()
public
clearCacheSavedInTransaction() : bool
Return values
bool —clearData()
public
clearData() : bool
Return values
bool —clearGeoCode()
public
clearGeoCode([array<string|int, mixed> $data_diff = null ]) : bool
Parameters
- $data_diff : array<string|int, mixed> = null
Return values
bool —clearNonMappedData()
Removes array elements from $data that are not in the function map.
public
clearNonMappedData([array<string|int, mixed>|null $data = null ]) : array<string|int, mixed>|null
Parameters
- $data : array<string|int, mixed>|null = null
Return values
array<string|int, mixed>|null —clearOldData()
public
clearOldData() : bool
Return values
bool —CommitSavePoint()
public
CommitSavePoint( $name) : bool
Parameters
Return values
bool —CommitTransaction()
public
CommitTransaction([bool $unnest_transactions = false ]) : mixed
Parameters
- $unnest_transactions : bool = false
Tags
Return values
mixed —convertFlexArray()
public
convertFlexArray(array<string|int, mixed> $array) : array<string|int, mixed>
Parameters
- $array : array<string|int, mixed>
Return values
array<string|int, mixed> —createTransactions()
public
createTransactions([int $effective_date = null ][, int $start_date = null ][, int $end_date = null ][, array<string|int, mixed> $flags = [] ]) : array<string|int, mixed>|bool
Parameters
- $effective_date : int = null
-
EPOCH
- $start_date : int = null
-
EPOCH
- $end_date : int = null
-
EPOCH
- $flags : array<string|int, mixed> = []
Return values
array<string|int, mixed>|bool —decodeCustomFields()
public
decodeCustomFields() : bool
Return values
bool —decodeGenericJSONData()
Decode generic 'other_json' column data.
public
decodeGenericJSONData() : bool
Return values
bool —decodeJSONColumn()
Decodes JSON columns that are not the 'other_json' column.
public
decodeJSONColumn( $column) : bool
Parameters
Return values
bool —Delete()
Deletes the record directly from the database.
public
Delete([bool $disable_audit_log = false ]) : bool
Parameters
- $disable_audit_log : bool = false
Tags
Return values
bool —encodeCustomFields()
public
encodeCustomFields() : bool
Return values
bool —encodeGenericJSONData()
Encode generic 'other_json' column data. This should only be done in Save() after all validation has occurred already and we are just about to commit it to the DB.
public
encodeGenericJSONData() : bool
Return values
bool —encodeJSONColumns()
Encode any JSON columns that are not 'other_json' column. This should only be done in Save() after all validation has occurred already and we are just about to commit it to the DB.
public
encodeJSONColumns() : bool
Return values
bool —ExecuteSQL()
Execute SQL queries and handle paging properly for select statements.
public
ExecuteSQL(string $query[, array<string|int, mixed> $ph = null ][, int $limit = null ][, int $page = null ]) : bool
Parameters
- $query : string
- $ph : array<string|int, mixed> = null
- $limit : int = null
-
Limit the number of records returned
- $page : int = null
-
Page number of records to return for pagination
Tags
Return values
bool —FailTransaction()
public
FailTransaction() : mixed
Return values
mixed —fromBool()
public
fromBool(string|int|bool $value) : bool
Parameters
- $value : string|int|bool
Return values
bool —fromJSONBool()
public
fromJSONBool(string|int|bool $value) : bool
Parameters
- $value : string|int|bool
Return values
bool —getAddress1()
public
getAddress1() : bool
Return values
bool —getAddress2()
public
getAddress2() : bool
Return values
bool —getAffectedRows()
public
getAffectedRows() : int|bool
Return values
int|bool —getAPIMessageID()
Used for updating progress bar for API calls.
public
getAPIMessageID() : bool|null
Return values
bool|null —getBadQuantityRate()
public
getBadQuantityRate() : bool|mixed
Return values
bool|mixed —getBillableRate()
public
getBillableRate() : bool|mixed
Return values
bool|mixed —getBranch()
public
getBranch() : bool|mixed
Return values
bool|mixed —getCache()
public
getCache(string $cache_id[, string $group_id = null ]) : bool|mixed
Parameters
- $cache_id : string
- $group_id : string = null
Return values
bool|mixed —getCity()
public
getCity() : bool|mixed
Return values
bool|mixed —getClient()
public
getClient() : bool|mixed
Return values
bool|mixed —getClientObject()
public
getClientObject() : bool|null
Return values
bool|null —getColumn()
Generic function get any data from the data array.
public
getColumn(string $column) : bool|mixed
Used mainly for the reports that return grouped queries and such.
Parameters
- $column : string
Return values
bool|mixed —getColumnList()
public
getColumnList() : array<string|int, mixed>|bool
Return values
array<string|int, mixed>|bool —getCompany()
public
getCompany() : bool|mixed
Return values
bool|mixed —getCompanyGenericMapData()
Generic function to return and cache CompanyGenericMap data, this greatly improves performance of CalculatePolicy when many policies exist.
public
getCompanyGenericMapData(string $company_id, int $object_type_id, string $id, string $variable) : mixed
Parameters
- $company_id : string
-
UUID
- $object_type_id : int
- $id : string
-
UUID
- $variable : string
Return values
mixed —getCompanyObject()
public
getCompanyObject() : null
Return values
null —getCountry()
public
getCountry() : bool|mixed
Return values
bool|mixed —getCreatedAndUpdatedColumns()
public
getCreatedAndUpdatedColumns(array<string|int, mixed> &$data[, null $include_columns = null ]) : bool
Parameters
- $data : array<string|int, mixed>
- $include_columns : null = null
Return values
bool —getCreatedBy()
public
getCreatedBy() : bool|mixed
Return values
bool|mixed —getCreatedDate()
public
getCreatedDate() : int
Return values
int —getCurrent()
Grabs the current object
public
final getCurrent() : mixed
Return values
mixed —getCurrentRow()
public
getCurrentRow([int $offset = 1 ]) : int|bool
Parameters
- $offset : int = 1
Return values
int|bool —getCustomField()
Get a single custom field by ID.
public
getCustomField(string $id) : void
Parameters
- $id : string
-
UUID
Return values
void —getCustomFields()
public
getCustomFields( $company_id, $data[, $include_columns = null ]) : mixed
Parameters
Return values
mixed —getCustomFieldsColumns()
public
getCustomFieldsColumns(array<string|int, mixed> $columns, string $company_id[, bool $use_sort_prefix = true ][, string|null $table_name = null ]) : array<string|int, mixed>
Parameters
- $columns : array<string|int, mixed>
- $company_id : string
- $use_sort_prefix : bool = true
- $table_name : string|null = null
Return values
array<string|int, mixed> —getCustomFieldsDataForObject()
Get custom field data for this specific object, so it can be easily cached in memory without having to go to the database or unserialize it from cache for every row.
public
getCustomFieldsDataForObject( $company_id[, mixed $table_name = null ]) : array<string|int, mixed>
Parameters
Tags
Return values
array<string|int, mixed> —getCustomFieldsDefaultData()
public
getCustomFieldsDefaultData( $company_id, $data[, bool $get_all_fields = false ]) : mixed
Parameters
Return values
mixed —getCustomFieldsParseHints()
public
getCustomFieldsParseHints(array<string|int, mixed> $columns, string $company_id, string|null $table_name) : array<string|int, mixed>
Parameters
- $columns : array<string|int, mixed>
- $company_id : string
- $table_name : string|null
Return values
array<string|int, mixed> —getCustomFieldTableName()
public
getCustomFieldTableName() : string
Return values
string —getDataDifferences()
Returns the differences in data from the DB vs the in-memory object, so the data will be the OLD data. Used in Validation/postSave() functions to determine if a field has changed or not.
public
getDataDifferences() : array<string|int, mixed>
Return values
array<string|int, mixed> —getDateRangeSQL()
This function takes plain input from the user and creates a SQL statement for filtering based on a date range.
public
getDateRangeSQL(string $str, string $column[, string $format = 'epoch' ][, bool $include_blank_dates = false ]) : bool|string
Supported Syntax:
=01-Jan-09 <=01-Jan-09 <01-Jan-09 01-Jan-09 01-Jan-09 & <10-Jan-09
Parameters
- $str : string
- $column : string
- $format : string = 'epoch'
- $include_blank_dates : bool = false
Return values
bool|string —getDefaultItem()
public
getDefaultItem() : bool|mixed
Return values
bool|mixed —getDeleted()
public
getDeleted() : bool
Return values
bool —getDeletedBy()
public
getDeletedBy() : bool|mixed
Return values
bool|mixed —getDeletedDate()
public
getDeletedDate() : bool|mixed
Return values
bool|mixed —getDepartment()
public
getDepartment() : bool|mixed
Return values
bool|mixed —getDescription()
public
getDescription() : bool|mixed
Return values
bool|mixed —getEmptyRecordSet()
public
getEmptyRecordSet([string $id = null ]) : mixed
Parameters
- $id : string = null
-
UUID
Tags
Return values
mixed —getEnableSystemLogDetail()
public
getEnableSystemLogDetail() : bool
Return values
bool —getEnableValidateDefaultItem()
public
getEnableValidateDefaultItem() : bool
Return values
bool —getEndDate()
public
getEndDate() : bool|mixed
Return values
bool|mixed —getEstimateBadQuantity()
public
getEstimateBadQuantity() : bool|mixed
Return values
bool|mixed —getEstimateQuantity()
public
getEstimateQuantity() : bool|mixed
Return values
bool|mixed —getEstimateTime()
public
getEstimateTime() : bool|mixed
Return values
bool|mixed —getExcludeJobItem()
public
getExcludeJobItem() : array<string|int, mixed>|bool
Return values
array<string|int, mixed>|bool —getExcludeUser()
public
getExcludeUser() : array<string|int, mixed>|bool
Return values
array<string|int, mixed>|bool —getGenericDataValue()
Generic getter/setter functions that should be used when Validation code is moved from get/set functions to Validate() function.
public
getGenericDataValue(string $name[, null $cast = null ]) : bool|mixed
Parameters
- $name : string
- $cast : null = null
Return values
bool|mixed —getGenericJSONDataValue()
Generic getter/setter functions for handling generic JSON data in 'other_json' SQL column.
public
getGenericJSONDataValue(string $name[, null $cast = null ]) : bool|mixed
Parameters
- $name : string
- $cast : null = null
Return values
bool|mixed —getGenericObject()
Generic function to return and cache class objects ListFactory, ListFactoryMethod, Variable, ID, IDMethod
public
getGenericObject(string $list_factory, string|int $id, string $variable[, string $list_factory_method = 'getById' ][, string $id_method = 'getID' ]) : object|bool
Parameters
- $list_factory : string
- $id : string|int
-
UUID
- $variable : string
- $list_factory_method : string = 'getById'
- $id_method : string = 'getID'
Return values
object|bool —getGenericOldDataValue()
public
getGenericOldDataValue(string $name) : bool|mixed
Parameters
- $name : string
-
Gets data value from old_data array, or the original value in the database, prior to any changes currently in memory.
Return values
bool|mixed —getGenericTempDataValue()
Generic getter/setter functions that should be used when Validation code is moved from get/set functions to Validate() function.
public
getGenericTempDataValue(string $name) : bool
Parameters
- $name : string
Return values
bool —getGEOFenceIds()
public
getGEOFenceIds() : array<string|int, mixed>|bool
Return values
array<string|int, mixed>|bool —getGroup()
public
getGroup() : bool|mixed
Return values
bool|mixed —getIButtonID()
public
getIButtonID() : int
Return values
int —getId()
public
getId() : bool|mixed
Return values
bool|mixed —getIDSByListFactory()
public
getIDSByListFactory(object $lf) : array<string|int, mixed>|bool
Parameters
- $lf : object
Return values
array<string|int, mixed>|bool —getIncludeJobItem()
public
getIncludeJobItem() : array<string|int, mixed>|bool
Return values
array<string|int, mixed>|bool —getIncludeUser()
public
getIncludeUser() : array<string|int, mixed>|bool
Return values
array<string|int, mixed>|bool —getIterator()
public
final getIterator() : FactoryListIterator
Return values
FactoryListIterator —getJobItemGroup()
public
getJobItemGroup() : array<string|int, mixed>|bool
Return values
array<string|int, mixed>|bool —getJobItemGroupSelectionType()
public
getJobItemGroupSelectionType() : bool|int
Return values
bool|int —getLabelId()
public
getLabelId() : bool|mixed|string
Return values
bool|mixed|string —getLatitude()
public
getLatitude() : bool|float
Return values
bool|float —getLocationNote()
public
getLocationNote() : bool|mixed
Return values
bool|mixed —getLongitude()
public
getLongitude() : bool|float
Return values
bool|float —getManualID()
public
getManualID() : bool|int
Return values
bool|int —getMinimumTime()
public
getMinimumTime() : bool|mixed
Return values
bool|mixed —getName()
public
getName() : bool|mixed
Return values
bool|mixed —getNameMetaphone()
public
getNameMetaphone() : bool|mixed
Return values
bool|mixed —getNextAvailableManualId()
public
getNextAvailableManualId([string $company_id = null ]) : int
Parameters
- $company_id : string = null
-
UUID
Return values
int —getNextInsertId()
public
getNextInsertId() : bool|string
Return values
bool|string —getNote()
public
getNote() : bool|mixed
Return values
bool|mixed —getObjectAsArray()
public
getObjectAsArray([null $include_columns = null ]) : array<string|int, mixed>
Parameters
- $include_columns : null = null
Return values
array<string|int, mixed> —getOptions()
public
getOptions(string $name[, string|int $parent = null ]) : array<string|int, mixed>|bool
Parameters
- $name : string
- $parent : string|int = null
Return values
array<string|int, mixed>|bool —getPermissionColumns()
public
getPermissionColumns(array<string|int, mixed> &$data, string $object_user_id, string $created_by_id[, string $permission_children_ids = null ][, array<string|int, mixed> $include_columns = null ]) : bool
Parameters
- $data : array<string|int, mixed>
- $object_user_id : string
-
UUID
- $created_by_id : string
-
UUID
- $permission_children_ids : string = null
-
UUID
- $include_columns : array<string|int, mixed> = null
Return values
bool —getPostalCode()
public
getPostalCode() : bool|mixed
Return values
bool|mixed —getProgressBarObject()
public
getProgressBarObject() : null|ProgressBar
Return values
null|ProgressBar —getProvince()
public
getProvince() : bool|mixed
Return values
bool|mixed —getRecordCount()
public
getRecordCount() : int|bool
Return values
int|bool —getSchedulePercent()
public
getSchedulePercent([bool $epoch = false ]) : bool|float|int|null
Parameters
- $epoch : bool = false
Return values
bool|float|int|null —getSequenceName()
public
getSequenceName() : bool
Return values
bool —getSerialPattern()
public
getSerialPattern() : mixed
Return values
mixed —getStartDate()
public
getStartDate() : bool|mixed
Return values
bool|mixed —getStatus()
public
getStatus() : bool|int
Return values
bool|int —getSupervisor()
public
getSupervisor() : bool|mixed
Return values
bool|mixed —getTable()
public
getTable([bool $strip_quotes = false ]) : bool|string
Parameters
- $strip_quotes : bool = false
Return values
bool|string —getTag()
public
getTag() : bool|string
Return values
bool|string —getTransactionMode()
public
getTransactionMode([bool $force = false ]) : string
Parameters
- $force : bool = false
Return values
string —getUpdatedBy()
public
getUpdatedBy() : bool|mixed
Return values
bool|mixed —getUpdatedDate()
public
getUpdatedDate() : int
Return values
int —getUserBranch()
public
getUserBranch() : array<string|int, mixed>|bool
Return values
array<string|int, mixed>|bool —getUserBranchSelectionType()
public
getUserBranchSelectionType() : bool|int
Return values
bool|int —getUserDepartment()
public
getUserDepartment() : array<string|int, mixed>|bool
Return values
array<string|int, mixed>|bool —getUserDepartmentSelectionType()
public
getUserDepartmentSelectionType() : bool|int
Return values
bool|int —getUserGroup()
public
getUserGroup() : array<string|int, mixed>|bool
Return values
array<string|int, mixed>|bool —getUserGroupSelectionType()
public
getUserGroupSelectionType() : bool|int
Return values
bool|int —getUserTitle()
public
getUserTitle() : array<string|int, mixed>|bool
Return values
array<string|int, mixed>|bool —getUserTitleSelectionType()
public
getUserTitleSelectionType() : bool|int
Return values
bool|int —getValidSQLColumns()
public
getValidSQLColumns(array<string|int, mixed> $array[, bool $strict = true ][, array<string|int, mixed> $additional_fields = null ]) : array<string|int, mixed>
Parameters
- $array : array<string|int, mixed>
- $strict : bool = true
- $additional_fields : array<string|int, mixed> = null
Tags
Return values
array<string|int, mixed> —getVariableToFunctionMap()
public
getVariableToFunctionMap([array<string|int, mixed> $data = null ]) : array<string|int, mixed>|bool
Parameters
- $data : array<string|int, mixed> = null
Return values
array<string|int, mixed>|bool —handleSaveSQLReturning()
Used to handle any "RETURNING ..." clause on a SQL INSERT/UPDATE query.
public
handleSaveSQLReturning( $rs) : bool
Parameters
Return values
bool —hasDataChanged()
Determine if the record data has changed at all.
public
hasDataChanged() : bool
Return values
bool —isAllowedItem()
public
isAllowedItem(string $id) : bool
Parameters
- $id : string
-
UUID
Return values
bool —isAllowedUser()
public
isAllowedUser(string $id, string $branch_id, string $department_id) : bool
Parameters
- $id : string
-
UUID
- $branch_id : string
-
UUID
- $department_id : string
-
UUID
Return values
bool —isClientFriendly()
Check if the remote client is our main UI app controlled by us, vs. a user utilizing the API for example.
public
isClientFriendly() : bool
This is mostly used to determine if we can return columns that are resource intensive to compute when obtaining a list. (ie: Users, Jobs)
Return values
bool —isDataDifferent()
Used to check the differences between a single key in the $old_data vs. $data arrays.
public
isDataDifferent( $key, $data_diff[, null $type_id = null ][, null $new_data = null ]) : bool
This is especially important to use when trying to see if a date or timestamp field in the DB has changed, as they need to be handled in special ways.
Parameters
Return values
bool —isNew()
Determines if the data is new data, or updated data. Basically determines if a database INSERT or UPDATE SQL statement is generated.
public
isNew([bool $force_lookup = false ][, string $id = null ]) : bool
Parameters
- $force_lookup : bool = false
- $id : string = null
-
UUID
Return values
bool —isSQLExceptionRetryable()
Determines if a SQL exception is one that can be retried or not.
public
isSQLExceptionRetryable( $e) : bool
Parameters
Return values
bool —isUniqueManualID()
public
isUniqueManualID(string $id) : bool
Parameters
- $id : string
-
UUID
Return values
bool —isValid()
Call class specific validation function just before saving.
public
isValid([bool $ignore_warning = true ]) : bool
Parameters
- $ignore_warning : bool = true
Return values
bool —isWarning()
Call class specific validation function just before saving.
public
isWarning() : bool
Return values
bool —modifyInsertQuery()
Modifies the automatically generated SQL INSERT query for adding things like " ON CONFLICT ..."
public
modifyInsertQuery( $query) : mixed
Parameters
Return values
mixed —parseCustomFieldsFromArray()
public
parseCustomFieldsFromArray( $data) : mixed
Parameters
Return values
mixed —postSave()
public
postSave() : bool
Return values
bool —preSave()
public
preSave() : bool
Return values
bool —removeCache()
public
removeCache([string $cache_id = null ][, string $group_id = null ]) : bool
Parameters
- $cache_id : string = null
- $group_id : string = null
Return values
bool —RetryTransaction()
Accepts a Closure and is retried at set intervals which should be in a transaction.
public
RetryTransaction( $transaction_function[, int $retry_max_attempts = 4 ][, int $retry_sleep = 1 ]) : mixed
Parameters
Tags
Return values
mixed —rewind()
Rewinds record set iterator to begining. The same as ADODB's MoveFirst() function.
public
final rewind() : bool
Return values
bool —RollbackSavePoint()
public
RollbackSavePoint( $name) : bool
Parameters
Return values
bool —Save()
Determines to insert or update, and does it.
public
Save([bool $reset_data = true ][, bool $force_lookup = false ]) : bool|int|string
Have this handle created, createdby, updated, updatedby.
Parameters
- $reset_data : bool = true
- $force_lookup : bool = false
Tags
Return values
bool|int|string —saveCache()
public
saveCache(mixed $data, string $cache_id[, string $group_id = null ]) : bool
Parameters
- $data : mixed
- $cache_id : string
- $group_id : string = null
Return values
bool —serializeRS()
Serialize ADODB recordset.
public
serializeRS(object $rs) : string
Parameters
- $rs : object
Tags
Return values
string —setAddress1()
public
setAddress1( $value) : bool
Parameters
Return values
bool —setAddress2()
public
setAddress2( $value) : bool
Parameters
Return values
bool —setAPIMessageID()
public
setAPIMessageID(string $id) : bool
Parameters
- $id : string
-
UUID
Return values
bool —setBadQuantityRate()
public
setBadQuantityRate( $value) : bool
Parameters
Return values
bool —setBillableRate()
public
setBillableRate( $value) : bool
Parameters
Return values
bool —setBranch()
public
setBranch(string $value) : bool
Parameters
- $value : string
-
UUID
Return values
bool —setCacheLifeTime()
public
setCacheLifeTime(int $secs) : bool
Parameters
- $secs : int
Return values
bool —setCity()
public
setCity( $value) : bool
Parameters
Return values
bool —setClient()
public
setClient(string $value) : bool
Parameters
- $value : string
-
UUID
Return values
bool —setCompany()
public
setCompany(string $value) : bool
Parameters
- $value : string
-
UUID
Return values
bool —setCountry()
public
setCountry( $value) : bool
Parameters
Return values
bool —setCreatedAndUpdatedColumns()
public
setCreatedAndUpdatedColumns(array<string|int, mixed> $data[, array<string|int, mixed> $variable_to_function_map = [] ]) : bool
Parameters
- $data : array<string|int, mixed>
- $variable_to_function_map : array<string|int, mixed> = []
Return values
bool —setCreatedBy()
public
setCreatedBy([string $id = null ]) : bool
Parameters
- $id : string = null
-
UUID
Return values
bool —setCreatedDate()
public
setCreatedDate([int $epoch = null ]) : bool
Parameters
- $epoch : int = null
-
EPOCH
Return values
bool —setCustomField()
Set a single custom field by ID.
public
setCustomField(mixed $value, string $id) : void
Parameters
- $value : mixed
- $id : string
-
UUID
Return values
void —setCustomFields()
public
setCustomFields( $data) : bool
Parameters
Return values
bool —setDefaultItem()
public
setDefaultItem(string $value) : bool
Parameters
- $value : string
-
UUID
Return values
bool —setDeleted()
public
setDeleted(bool $bool) : bool
Parameters
- $bool : bool
Return values
bool —setDeletedBy()
public
setDeletedBy([string $id = null ]) : bool|null
Parameters
- $id : string = null
-
UUID
Return values
bool|null —setDeletedDate()
public
setDeletedDate([int $epoch = null ]) : bool
Parameters
- $epoch : int = null
-
EPOCH
Return values
bool —setDepartment()
public
setDepartment(string $value) : bool
Parameters
- $value : string
-
UUID
Return values
bool —setDescription()
public
setDescription( $value) : bool
Parameters
Return values
bool —setEnableSystemLogDetail()
public
setEnableSystemLogDetail( $bool) : bool
Parameters
Return values
bool —setEnableValidateDefaultItem()
public
setEnableValidateDefaultItem( $bool) : bool
Parameters
Return values
bool —setEndDate()
public
setEndDate(int $value) : bool
Parameters
- $value : int
-
EPOCH
Return values
bool —setEstimateBadQuantity()
public
setEstimateBadQuantity( $value) : bool
Parameters
Return values
bool —setEstimateQuantity()
public
setEstimateQuantity( $value) : bool
Parameters
Return values
bool —setEstimateTime()
public
setEstimateTime( $value) : bool
Parameters
Return values
bool —setExcludeJobItem()
public
setExcludeJobItem(string $ids) : bool
Parameters
- $ids : string
-
UUID
Return values
bool —setExcludeUser()
public
setExcludeUser(string $ids) : bool
Parameters
- $ids : string
-
UUID
Return values
bool —setGenericDataValue()
public
setGenericDataValue(string $name, mixed $data[, null $cast = null ]) : bool
Parameters
- $name : string
- $data : mixed
- $cast : null = null
Return values
bool —setGenericJSONDataValue()
Generic getter/setter functions for handling generic JSON data in 'other_json' SQL column.
public
setGenericJSONDataValue(string $name, mixed $data[, null $cast = null ]) : bool
Parameters
- $name : string
- $data : mixed
- $cast : null = null
Return values
bool —setGenericObject()
Allow method to pre-populate/overwrite the cache if needed.
public
setGenericObject(object $obj, string $variable) : bool
Parameters
- $obj : object
- $variable : string
Return values
bool —setGenericTempDataValue()
public
setGenericTempDataValue(string $name, mixed $data) : bool
Parameters
- $name : string
- $data : mixed
Return values
bool —setGEOFenceIds()
public
setGEOFenceIds(string|array<string|int, string> $ids) : bool
Parameters
- $ids : string|array<string|int, string>
-
UUID
Return values
bool —setGroup()
public
setGroup(string $value) : bool
Parameters
- $value : string
-
UUID
Return values
bool —setIButtonID()
public
setIButtonID( $value) : bool
Parameters
Return values
bool —setId()
public
setId(string $id) : bool
Parameters
- $id : string
-
UUID
Return values
bool —setIncludeJobItem()
public
setIncludeJobItem(string $ids) : bool
Parameters
- $ids : string
-
UUID
Return values
bool —setIncludeUser()
public
setIncludeUser(string $ids) : bool
Parameters
- $ids : string
-
UUID
Return values
bool —setIsValid()
Sets the is_valid flag, mostly used to set it to FALSE to force a full re-validation.
public
setIsValid([bool $is_valid = false ]) : bool
Required because $this->is_valid is a private variable and should stay that way.
Parameters
- $is_valid : bool = false
Return values
bool —setJobItemGroup()
public
setJobItemGroup(string|array<string|int, string> $ids) : bool
Parameters
- $ids : string|array<string|int, string>
-
UUID
Return values
bool —setJobItemGroupSelectionType()
public
setJobItemGroupSelectionType( $value) : bool
Parameters
Return values
bool —setLatitude()
public
setLatitude( $value) : bool
Parameters
Return values
bool —setLocationNote()
public
setLocationNote( $value) : bool
Parameters
Return values
bool —setLongitude()
public
setLongitude( $value) : bool
Parameters
Return values
bool —setManualID()
public
setManualID( $value) : bool
Parameters
Return values
bool —setMinimumTime()
public
setMinimumTime( $value) : bool
Parameters
Return values
bool —setName()
public
setName( $value) : bool
Parameters
Return values
bool —setNameMetaphone()
public
setNameMetaphone( $value) : bool
Parameters
Return values
bool —setNote()
public
setNote( $value) : bool
Parameters
Return values
bool —setObjectFromArray()
public
setObjectFromArray( $data) : bool
Parameters
Return values
bool —setPostalCode()
public
setPostalCode( $value) : bool
Parameters
Return values
bool —setProgressBarObject()
public
setProgressBarObject(object $obj) : bool
Parameters
- $obj : object
Return values
bool —setProvince()
public
setProvince( $value) : bool
Parameters
Return values
bool —setQueryStatementTimeout()
public
setQueryStatementTimeout([null $milliseconds = null ]) : bool
Parameters
- $milliseconds : null = null
Return values
bool —setSerialPattern()
public
setSerialPattern( $value) : bool
Parameters
Return values
bool —setStartDate()
public
setStartDate(int $value) : bool
Parameters
- $value : int
-
EPOCH
Return values
bool —setStatus()
public
setStatus( $value) : bool
Parameters
Return values
bool —setSupervisor()
public
setSupervisor(string $value) : bool
Parameters
- $value : string
-
UUID
Return values
bool —setTag()
public
setTag( $value) : bool
Parameters
Return values
bool —setTransactionMode()
public
setTransactionMode([string $mode = '' ]) : mixed
Parameters
- $mode : string = ''
Return values
mixed —setUpdatedBy()
public
setUpdatedBy([string $id = null ]) : bool|null
Parameters
- $id : string = null
-
UUID
Return values
bool|null —setUpdatedDate()
public
setUpdatedDate([int $epoch = null ]) : bool|int|null|string
Parameters
- $epoch : int = null
-
EPOCH
Return values
bool|int|null|string —setUserBranch()
public
setUserBranch(string $ids) : bool
Parameters
- $ids : string
-
UUID
Return values
bool —setUserBranchSelectionType()
public
setUserBranchSelectionType( $value) : bool
Parameters
Return values
bool —setUserDepartment()
public
setUserDepartment(string $ids) : bool
Parameters
- $ids : string
-
UUID
Return values
bool —setUserDepartmentSelectionType()
public
setUserDepartmentSelectionType( $value) : bool
Parameters
Return values
bool —setUserGroup()
public
setUserGroup(string $ids) : bool
Parameters
- $ids : string
-
UUID
Return values
bool —setUserGroupSelectionType()
public
setUserGroupSelectionType( $value) : bool
Parameters
Return values
bool —setUserTitle()
public
setUserTitle(string $ids) : bool
Parameters
- $ids : string
-
UUID
Return values
bool —setUserTitleSelectionType()
public
setUserTitleSelectionType( $value) : bool
Parameters
Return values
bool —StartSavePoint()
public
StartSavePoint( $name) : bool
Parameters
Return values
bool —StartTransaction()
public
StartTransaction() : mixed
Return values
mixed —toBool()
public
toBool(string|int|bool $value) : int
Parameters
- $value : string|int|bool
Return values
int —toJSONBool()
public
toJSONBool(string|int|bool $value) : string
Parameters
- $value : string|int|bool
Return values
string —Validate()
public
Validate([bool $ignore_warning = true ]) : bool
Parameters
- $ignore_warning : bool = true
Return values
bool —validateCustomFields()
public
validateCustomFields(mixed $company_id[, mixed $enable_required_field_check = true ]) : mixed
Parameters
- $company_id : mixed
- $enable_required_field_check : mixed = true
Return values
mixed —castInteger()
protected
castInteger(int|string $int[, string $type = 'int' ]) : bool|int|string
Parameters
- $int : int|string
- $type : string = 'int'
Return values
bool|int|string —getColumnsFromAliases()
protected
getColumnsFromAliases(array<string|int, mixed> $columns, array<string|int, mixed> $aliases) : array<string|int, mixed>
Parameters
- $columns : array<string|int, mixed>
- $aliases : array<string|int, mixed>
Return values
array<string|int, mixed> —getCustomFieldWhereSQL()
protected
getCustomFieldWhereSQL(mixed $company_id, mixed $column, array<string|int, mixed> $filter_data, array<string|int, mixed> &$ph) : string
Parameters
- $company_id : mixed
- $column : mixed
- $filter_data : array<string|int, mixed>
- $ph : array<string|int, mixed>
Return values
string —getDatabaseType()
protected
getDatabaseType() : string
Return values
string —getListSQL()
protected
getListSQL(array<string|int, mixed>|string|int $array[, array<string|int, mixed> &$ph = null ][, string|bool $cast = false ]) : bool|int|string|array<string|int, mixed>
Parameters
- $array : array<string|int, mixed>|string|int
- $ph : array<string|int, mixed> = null
- $cast : string|bool = false
Return values
bool|int|string|array<string|int, mixed> —getSortSQL()
protected
getSortSQL(array<string|int, mixed> $array[, bool $strict = true ][, array<string|int, mixed> $additional_fields = null ]) : bool|string
Parameters
- $array : array<string|int, mixed>
- $strict : bool = true
- $additional_fields : array<string|int, mixed> = null
Return values
bool|string —getSQLStringAggregate()
protected
getSQLStringAggregate(string $sql, string $glue) : string
Parameters
- $sql : string
- $glue : string
Return values
string —getSQLToEpochFunction()
protected
getSQLToEpochFunction(string $sql) : string
Parameters
- $sql : string
Return values
string —getSQLToTimeFunction()
protected
getSQLToTimeFunction(string $sql) : string
Parameters
- $sql : string
Return values
string —getSQLToTimeStampFunction()
protected
getSQLToTimeStampFunction() : string
Return values
string —getWhereClauseSQL()
protected
getWhereClauseSQL(array<string|int, mixed>|string $columns, array<string|int, mixed>|string $args, string $type, array<string|int, mixed> &$ph[, string $query_stub = null ][, bool $and = true ]) : null|string
Parameters
- $columns : array<string|int, mixed>|string
- $args : array<string|int, mixed>|string
- $type : string
- $ph : array<string|int, mixed>
- $query_stub : string = null
- $and : bool = true
Tags
Return values
null|string —getWhereSQL()
protected
getWhereSQL(array<string|int, mixed> $array[, bool $append_where = false ]) : bool|string
Parameters
- $array : array<string|int, mixed>
- $append_where : bool = false
Return values
bool|string —handleSQLSyntax()
SQL where clause Syntax: or % as wildcard.
protected
handleSQLSyntax(string $arg) : string
"
Handles '*' and '%' as wildcards, defaults to wildcard on the end always. If no wildcard is to be added, the last character should be |
Parameters
- $arg : string
Return values
string —stripSQLSyntax()
protected
stripSQLSyntax(string $arg) : mixed
Parameters
- $arg : string
Return values
mixed —getInsertQuery()
private
getInsertQuery() : mixed
Return values
mixed —getRecordSetColumnList()
private
getRecordSetColumnList(object $rs) : array<string|int, mixed>|bool
Parameters
- $rs : object
Return values
array<string|int, mixed>|bool —getUpdateQuery()
private
getUpdateQuery() : bool
Tags
Return values
bool —parseColumnName()
Parses out the exact column name, without any aliases, or = signs in it.
private
parseColumnName(string $column) : bool|string
Parameters
- $column : string