TimeTrex API Manual

APIPayrollRemittanceAgencyEvent extends APIFactory
in package

Table of Contents

$data  : mixed
$api_message_id  : mixed
$current_company  : mixed
$current_user  : mixed
$current_user_prefs  : mixed
$main_class  : mixed
$main_class_obj  : mixed
$pager_obj  : mixed
$permission  : mixed
$progress_bar_obj  : mixed
__construct()  : mixed
APIPayrollRemittanceAgencyEvent constructor.
calculateNextRunDate()  : array<string|int, mixed>|bool
convertAPIReturnHandlerToValidatorObject()  : bool|Validator
Take a API ReturnHandler array and pulls out the Validation errors/warnings to be merged back into another Validator This is useful for calling one API function from another one when their are sub-classes.
convertToMultipleRecords()  : array<string|int, mixed>
convertToSingleRecord()  : mixed
copyPayrollRemittanceAgencyEvent()  : array<string|int, mixed>
Copy one or more payroll remittance agencies.
deletePayrollRemittanceAgencyEvent()  : array<string|int, mixed>|bool
Delete one or more payroll remittance agencies.
doLogWizardEvent()  : mixed
exportRecords()  : array<string|int, mixed>|bool
Download a result_set as a csv.
getAPIMessageID()  : bool|null
Returns the API messageID for each individual call.
getCommonPayrollRemittanceAgencyEventData()  : array<string|int, mixed>
Get only the fields that are common across all records in the search criteria. Used for Mass Editing of records.
getCurrentCompanyObject()  : bool|CompanyFactory
getCurrentUserObject()  : bool|UserFactory
getCurrentUserPreferenceObject()  : bool|UserPreferenceFactory
getFileAndPayWithPaymentServicesData()  : array<string|int, mixed>|bool
Submits data to Payment Services for filing and payment.
getMainClassObject()  : string
getMakePaymentData()  : array<string|int, mixed>|bool
Returns make payment data intended for the tax wizard
getNextInsertID()  : string
getOptions()  : bool|array<string|int, mixed>
Get options for dropdown boxes.
getOptionsBatch()  : array<string|int, mixed>
Bridge multiple batched requests to main class getOptions factory.
getPagerData()  : array<string|int, mixed>|bool
getPagerObject()  : Pager
getPayrollRemittanceAgencyEvent()  : array<string|int, mixed>|bool
Get payroll remittance agency data for one or more agencies.
getPayrollRemittanceAgencyEventDefaultData()  : array<string|int, mixed>
Get default payroll remittance agency data for creating new payroll remittance agency.
getPermissionChildren()  : array<string|int, mixed>
getPermissionObject()  : bool|null|Permission
getProgressBarObject()  : null|ProgressBar
getProtocolVersion()  : int
getReportData()  : array<string|int, mixed>|bool
Returns report data intended for the tax wizard
getVariableToFunctionMap()  : array<string|int, mixed>
Bridge to main class getVariableToFunctionMap factory.
handlePermissionFilterColumns()  : array<string|int, mixed>|null
In cases where data can be displayed in just a list_view (dropdown boxes), ie: branch, department, job, task in In/Out punch view restrict the dropdown box to just a subset of columns, so not all data is shown.
handleRecordValidationResults()  : array<string|int, mixed>
initializeFilterAndPager()  : array<string|int, mixed>|bool
isProgressBarStarted()  : bool
returnHandler()  : array<string|int, mixed>|bool
Controls returning information to client in a standard format.
setAPIMessageID()  : bool
setMainClassObject()  : bool
Allow storing the main class object persistently in memory, so we can build up other variables to help out things like getOptions() Mainly used for the APIReport class.
setPagerObject()  : bool
setPayrollRemittanceAgencyEvent()  : array<string|int, mixed>|bool
Set payroll remittance agency data for one or more agencies.
setProgressBarObject()  : bool
setValidationArray()  : array<string|int, mixed>|bool
stripReturnHandler()  : mixed
validatePayrollRemittanceAgencyEvent()  : array<string|int, mixed>
Validate payroll remittance agency data for one or more agencies.

Properties

Methods

calculateNextRunDate()

public calculateNextRunDate( $data) : array<string|int, mixed>|bool
Parameters
$data :
Return values
array<string|int, mixed>|bool

convertAPIReturnHandlerToValidatorObject()

Take a API ReturnHandler array and pulls out the Validation errors/warnings to be merged back into another Validator This is useful for calling one API function from another one when their are sub-classes.

public convertAPIReturnHandlerToValidatorObject( $api_retarr[, bool $validator_obj = false ]) : bool|Validator
Parameters
$api_retarr :
$validator_obj : bool = false
Return values
bool|Validator

convertToMultipleRecords()

public convertToMultipleRecords(array<string|int, mixed> $data) : array<string|int, mixed>
Parameters
$data : array<string|int, mixed>
Return values
array<string|int, mixed>

convertToSingleRecord()

public convertToSingleRecord(array<string|int, mixed> $data) : mixed
Parameters
$data : array<string|int, mixed>
Return values
mixed

copyPayrollRemittanceAgencyEvent()

Copy one or more payroll remittance agencies.

public copyPayrollRemittanceAgencyEvent(array<string|int, mixed> $data) : array<string|int, mixed>
Parameters
$data : array<string|int, mixed>

payroll remittance agency IDs

Return values
array<string|int, mixed>

deletePayrollRemittanceAgencyEvent()

Delete one or more payroll remittance agencies.

public deletePayrollRemittanceAgencyEvent(array<string|int, mixed> $data) : array<string|int, mixed>|bool
Parameters
$data : array<string|int, mixed>

payroll remittance agency data

Return values
array<string|int, mixed>|bool

doLogWizardEvent()

public doLogWizardEvent(mixed $agency_event_id, mixed $event, mixed $step, mixed $action) : mixed
Parameters
$agency_event_id : mixed
$event : mixed
$step : mixed
$action : mixed
Return values
mixed

exportRecords()

Download a result_set as a csv.

public exportRecords(string $format, string $file_name, array<string|int, mixed> $result, array<string|int, mixed> $filter_columns) : array<string|int, mixed>|bool
Parameters
$format : string
$file_name : string
$result : array<string|int, mixed>
$filter_columns : array<string|int, mixed>
Return values
array<string|int, mixed>|bool

getAPIMessageID()

Returns the API messageID for each individual call.

public getAPIMessageID() : bool|null
Return values
bool|null

getCommonPayrollRemittanceAgencyEventData()

Get only the fields that are common across all records in the search criteria. Used for Mass Editing of records.

public getCommonPayrollRemittanceAgencyEventData(array<string|int, mixed> $data) : array<string|int, mixed>
Parameters
$data : array<string|int, mixed>

filter data

Return values
array<string|int, mixed>

getFileAndPayWithPaymentServicesData()

Submits data to Payment Services for filing and payment.

public getFileAndPayWithPaymentServicesData( $prae_id,  $action_id[, null $data = null ]) : array<string|int, mixed>|bool
Parameters
$prae_id :
$action_id :
$data : null = null
Return values
array<string|int, mixed>|bool

getMainClassObject()

public getMainClassObject() : string
Return values
string

getMakePaymentData()

Returns make payment data intended for the tax wizard

public getMakePaymentData( $prae_id,  $action_id[, null $data = null ]) : array<string|int, mixed>|bool
Parameters
$prae_id :
$action_id :
$data : null = null
Return values
array<string|int, mixed>|bool

getNextInsertID()

public getNextInsertID() : string
Return values
string

getOptions()

Get options for dropdown boxes.

public getOptions([bool|string $name = false ][, mixed $parent = null ]) : bool|array<string|int, mixed>
Parameters
$name : bool|string = false

Name of options to return, ie: 'columns', 'type', 'status'

$parent : mixed = null

Parent name/ID of options to return if data is in hierarchical format. (ie: Province)

Return values
bool|array<string|int, mixed>

getOptionsBatch()

Bridge multiple batched requests to main class getOptions factory.

public getOptionsBatch([array<string|int, mixed> $requested_options = [] ]) : array<string|int, mixed>
Parameters
$requested_options : array<string|int, mixed> = []
Return values
array<string|int, mixed>

getPagerData()

public getPagerData() : array<string|int, mixed>|bool
Return values
array<string|int, mixed>|bool

getPayrollRemittanceAgencyEvent()

Get payroll remittance agency data for one or more agencies.

public getPayrollRemittanceAgencyEvent([array<string|int, mixed> $data = null ][, bool $disable_paging = false ]) : array<string|int, mixed>|bool
Parameters
$data : array<string|int, mixed> = null

filter data

$disable_paging : bool = false
Return values
array<string|int, mixed>|bool

getPayrollRemittanceAgencyEventDefaultData()

Get default payroll remittance agency data for creating new payroll remittance agency.

public getPayrollRemittanceAgencyEventDefaultData() : array<string|int, mixed>
Return values
array<string|int, mixed>

getPermissionChildren()

public getPermissionChildren() : array<string|int, mixed>
Return values
array<string|int, mixed>

getProtocolVersion()

public getProtocolVersion() : int
Return values
int

getReportData()

Returns report data intended for the tax wizard

public getReportData( $prae_id,  $report_id[, null $data = null ]) : array<string|int, mixed>|bool
Parameters
$prae_id :
$report_id :
$data : null = null
Return values
array<string|int, mixed>|bool

getVariableToFunctionMap()

Bridge to main class getVariableToFunctionMap factory.

public getVariableToFunctionMap(string $name[, string|int $parent = null ]) : array<string|int, mixed>
Parameters
$name : string
$parent : string|int = null
Return values
array<string|int, mixed>

handlePermissionFilterColumns()

In cases where data can be displayed in just a list_view (dropdown boxes), ie: branch, department, job, task in In/Out punch view restrict the dropdown box to just a subset of columns, so not all data is shown.

public handlePermissionFilterColumns(array<string|int, mixed> $filter_columns, array<string|int, mixed> $allowed_columns) : array<string|int, mixed>|null
Parameters
$filter_columns : array<string|int, mixed>
$allowed_columns : array<string|int, mixed>
Return values
array<string|int, mixed>|null

handleRecordValidationResults()

public handleRecordValidationResults(object|bool $validator, array<string|int, mixed> $validator_stats, int $key, array<string|int, mixed>|bool $save_result[, bool $user_generic_status_batch_id = false ][, mixed $system_job_queue = false ]) : array<string|int, mixed>
Parameters
$validator : object|bool
$validator_stats : array<string|int, mixed>
$key : int
$save_result : array<string|int, mixed>|bool
$user_generic_status_batch_id : bool = false
$system_job_queue : mixed = false
Return values
array<string|int, mixed>

initializeFilterAndPager()

public initializeFilterAndPager(array<string|int, mixed> $data[, bool $disable_paging = false ]) : array<string|int, mixed>|bool
Parameters
$data : array<string|int, mixed>
$disable_paging : bool = false
Return values
array<string|int, mixed>|bool

isProgressBarStarted()

public isProgressBarStarted() : bool
Return values
bool

returnHandler()

Controls returning information to client in a standard format.

public returnHandler([bool $retval = true ][, bool $code = false ][, bool $description = false ][, bool $details = false ][, bool $validator_stats = false ][, bool $user_generic_status_batch_id = false ][, bool $request_data = false ][, bool $system_job_queue = false ]) : array<string|int, mixed>|bool

FIXME: Need to return the original request (with any modified values due to restrictions/validation issues) Also need to return paging data variables here too, as JSON can't make multiple calls. In order to do this we need to always return a special data structure that includes this information. static function returnHandler( $retval = TRUE, $args = array( 'code' => FALSE, 'description' => FALSE, 'details' = FALSE, 'validator_stats' => FALSE, 'user_generic_status_batch_id' => FALSE ) ) { The above will require too many changes, just add two more variables at the end, as it will only really be used by API->get*() functions. FIXME: Use a requestHandler() to handle all input requests, so we can parse out things like validate_only, ignore_warning (for user acknowledgable warnings) and handling all parameter parsing in a central place. static function returnHandler( $retval = TRUE, $code = FALSE, $description = FALSE, $details = FALSE, $validator_stats = FALSE, $user_generic_status_batch_id = FALSE, $request = FALSE, $pager = FALSE ) {

Parameters
$retval : bool = true
$code : bool = false
$description : bool = false
$details : bool = false
$validator_stats : bool = false
$user_generic_status_batch_id : bool = false
$request_data : bool = false
$system_job_queue : bool = false
Return values
array<string|int, mixed>|bool

setAPIMessageID()

public setAPIMessageID(string $id) : bool
Parameters
$id : string

UUID

Return values
bool

setMainClassObject()

Allow storing the main class object persistently in memory, so we can build up other variables to help out things like getOptions() Mainly used for the APIReport class.

public setMainClassObject(object $obj) : bool
Parameters
$obj : object
Return values
bool

setPagerObject()

public setPagerObject(object $lf) : bool
Parameters
$lf : object
Return values
bool

setPayrollRemittanceAgencyEvent()

Set payroll remittance agency data for one or more agencies.

public setPayrollRemittanceAgencyEvent(array<string|int, mixed> $data[, bool $validate_only = false ][, bool $ignore_warning = true ]) : array<string|int, mixed>|bool
Parameters
$data : array<string|int, mixed>

payroll remittance agency

$validate_only : bool = false
$ignore_warning : bool = true
Return values
array<string|int, mixed>|bool

setProgressBarObject()

public setProgressBarObject( $progress_bar_obj) : bool
Parameters
$progress_bar_obj :
Return values
bool

setValidationArray()

public setValidationArray(array<string|int, Validator$validator_obj_arr[, string $record_label = null ]) : array<string|int, mixed>|bool
Parameters
$validator_obj_arr : array<string|int, Validator>

Array of Validator objects.

$record_label : string = null

Prefix for record label if performing a mass function to differentiate one record from another.

Return values
array<string|int, mixed>|bool

stripReturnHandler()

public stripReturnHandler(mixed $retarr) : mixed
Parameters
$retarr : mixed
Return values
mixed

validatePayrollRemittanceAgencyEvent()

Validate payroll remittance agency data for one or more agencies.

public validatePayrollRemittanceAgencyEvent(array<string|int, mixed> $data) : array<string|int, mixed>
Parameters
$data : array<string|int, mixed>

payroll remittance agency data

Return values
array<string|int, mixed>

Search results