457 lines
15 KiB
PHP
457 lines
15 KiB
PHP
|
<?php
|
||
|
|
/*********************************************************************************
|
||
|
|
*
|
||
|
|
* TimeTrex is a Workforce Management program developed by
|
||
|
|
* TimeTrex Software Inc. Copyright (C) 2003 - 2021 TimeTrex Software Inc.
|
||
|
|
*
|
||
|
|
* This program is free software; you can redistribute it and/or modify it under
|
||
|
|
* the terms of the GNU Affero General Public License version 3 as published by
|
||
|
|
* the Free Software Foundation with the addition of the following permission
|
||
|
|
* added to Section 15 as permitted in Section 7(a): FOR ANY PART OF THE COVERED
|
||
|
|
* WORK IN WHICH THE COPYRIGHT IS OWNED BY TIMETREX, TIMETREX DISCLAIMS THE
|
||
|
|
* WARRANTY OF NON INFRINGEMENT OF THIRD PARTY RIGHTS.
|
||
|
|
*
|
||
|
|
* This program is distributed in the hope that it will be useful, but WITHOUT
|
||
|
|
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
|
||
|
|
* FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more
|
||
|
|
* details.
|
||
|
|
*
|
||
|
|
*
|
||
|
|
* You should have received a copy of the GNU Affero General Public License along
|
||
|
|
* with this program; if not, see http://www.gnu.org/licenses or write to the Free
|
||
|
|
* Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
|
||
|
|
* 02110-1301 USA.
|
||
|
|
*
|
||
|
|
*
|
||
|
|
* You can contact TimeTrex headquarters at Unit 22 - 2475 Dobbin Rd. Suite
|
||
|
|
* #292 West Kelowna, BC V4T 2E9, Canada or at email address info@timetrex.com.
|
||
|
|
*
|
||
|
|
*
|
||
|
|
* The interactive user interfaces in modified source and object code versions
|
||
|
|
* of this program must display Appropriate Legal Notices, as required under
|
||
|
|
* Section 5 of the GNU Affero General Public License version 3.
|
||
|
|
*
|
||
|
|
*
|
||
|
|
* In accordance with Section 7(b) of the GNU Affero General Public License
|
||
|
|
* version 3, these Appropriate Legal Notices must retain the display of the
|
||
|
|
* "Powered by TimeTrex" logo. If the display of the logo is not reasonably
|
||
|
|
* feasible for technical reasons, the Appropriate Legal Notices must display
|
||
|
|
* the words "Powered by TimeTrex".
|
||
|
|
*
|
||
|
|
********************************************************************************/
|
||
|
|
|
||
|
|
|
||
|
|
/**
|
||
|
|
* @package Modules\PayPeriod
|
||
|
|
*/
|
||
|
|
class PayPeriodScheduleListFactory extends PayPeriodScheduleFactory implements IteratorAggregate {
|
||
|
|
|
||
|
|
/**
|
||
|
|
* @param int $limit Limit the number of records returned
|
||
|
|
* @param int $page Page number of records to return for pagination
|
||
|
|
* @param array $where Additional SQL WHERE clause in format of array( $column => $filter, ... ). ie: array( 'id' => 1, ... )
|
||
|
|
* @param array $order Sort order passed to SQL in format of array( $column => 'asc', 'name' => 'desc', ... ). ie: array( 'id' => 'asc', 'name' => 'desc', ... )
|
||
|
|
* @return $this
|
||
|
|
*/
|
||
|
|
function getAll( $limit = null, $page = null, $where = null, $order = null ) {
|
||
|
|
$query = '
|
||
|
|
select *
|
||
|
|
from ' . $this->getTable() . '
|
||
|
|
WHERE deleted=0';
|
||
|
|
$query .= $this->getWhereSQL( $where );
|
||
|
|
$query .= $this->getSortSQL( $order );
|
||
|
|
|
||
|
|
$this->rs = $this->ExecuteSQL( $query, null, $limit, $page );
|
||
|
|
|
||
|
|
return $this;
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* @param string $id UUID
|
||
|
|
* @param array $where Additional SQL WHERE clause in format of array( $column => $filter, ... ). ie: array( 'id' => 1, ... )
|
||
|
|
* @param array $order Sort order passed to SQL in format of array( $column => 'asc', 'name' => 'desc', ... ). ie: array( 'id' => 'asc', 'name' => 'desc', ... )
|
||
|
|
* @return bool|PayPeriodScheduleListFactory
|
||
|
|
*/
|
||
|
|
function getById( $id, $where = null, $order = null ) {
|
||
|
|
if ( $id == '' ) {
|
||
|
|
return false;
|
||
|
|
}
|
||
|
|
|
||
|
|
$this->rs = $this->getCache( $id );
|
||
|
|
if ( $this->rs === false ) {
|
||
|
|
$ph = [
|
||
|
|
'id' => TTUUID::castUUID( $id ),
|
||
|
|
];
|
||
|
|
|
||
|
|
$query = '
|
||
|
|
select *
|
||
|
|
from ' . $this->getTable() . '
|
||
|
|
where id = ?
|
||
|
|
AND deleted=0';
|
||
|
|
$query .= $this->getWhereSQL( $where );
|
||
|
|
$query .= $this->getSortSQL( $order );
|
||
|
|
|
||
|
|
$this->rs = $this->ExecuteSQL( $query, $ph );
|
||
|
|
|
||
|
|
$this->saveCache( $this->rs, $id );
|
||
|
|
}
|
||
|
|
|
||
|
|
return $this;
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* @param string $user_id UUID
|
||
|
|
* @param array $where Additional SQL WHERE clause in format of array( $column => $filter, ... ). ie: array( 'id' => 1, ... )
|
||
|
|
* @param array $order Sort order passed to SQL in format of array( $column => 'asc', 'name' => 'desc', ... ). ie: array( 'id' => 'asc', 'name' => 'desc', ... )
|
||
|
|
* @return bool|PayPeriodScheduleListFactory
|
||
|
|
*/
|
||
|
|
function getByUserId( $user_id, $where = null, $order = null ) {
|
||
|
|
if ( $user_id == '' ) {
|
||
|
|
return false;
|
||
|
|
}
|
||
|
|
|
||
|
|
$ppsulf = new PayPeriodScheduleUserListFactory();
|
||
|
|
|
||
|
|
$ph = [
|
||
|
|
'user_id' => TTUUID::castUUID( $user_id ),
|
||
|
|
];
|
||
|
|
|
||
|
|
$query = '
|
||
|
|
select a.*
|
||
|
|
from ' . $this->getTable() . ' as a,
|
||
|
|
' . $ppsulf->getTable() . ' as b
|
||
|
|
where a.id = b.pay_period_schedule_id
|
||
|
|
AND b.user_id = ?
|
||
|
|
AND a.deleted=0';
|
||
|
|
$query .= $this->getWhereSQL( $where );
|
||
|
|
$query .= $this->getSortSQL( $order );
|
||
|
|
|
||
|
|
$this->rs = $this->ExecuteSQL( $query, $ph );
|
||
|
|
|
||
|
|
return $this;
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* @param string $id UUID
|
||
|
|
* @param int $limit Limit the number of records returned
|
||
|
|
* @param int $page Page number of records to return for pagination
|
||
|
|
* @param array $where Additional SQL WHERE clause in format of array( $column => $filter, ... ). ie: array( 'id' => 1, ... )
|
||
|
|
* @param array $order Sort order passed to SQL in format of array( $column => 'asc', 'name' => 'desc', ... ). ie: array( 'id' => 'asc', 'name' => 'desc', ... )
|
||
|
|
* @return bool|PayPeriodScheduleListFactory
|
||
|
|
*/
|
||
|
|
function getByCompanyId( $id, $limit = null, $page = null, $where = null, $order = null ) {
|
||
|
|
if ( $id == '' ) {
|
||
|
|
return false;
|
||
|
|
}
|
||
|
|
|
||
|
|
$ph = [
|
||
|
|
'id' => TTUUID::castUUID( $id ),
|
||
|
|
];
|
||
|
|
|
||
|
|
|
||
|
|
$query = '
|
||
|
|
select *
|
||
|
|
from ' . $this->getTable() . ' as a
|
||
|
|
where company_id = ?
|
||
|
|
AND deleted=0';
|
||
|
|
$query .= $this->getWhereSQL( $where );
|
||
|
|
$query .= $this->getSortSQL( $order );
|
||
|
|
|
||
|
|
$this->rs = $this->ExecuteSQL( $query, $ph, $limit, $page );
|
||
|
|
|
||
|
|
return $this;
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* @param string $company_id UUID
|
||
|
|
* @param string|string[] $user_ids UUID
|
||
|
|
* @param array $where Additional SQL WHERE clause in format of array( $column => $filter, ... ). ie: array( 'id' => 1, ... )
|
||
|
|
* @param array $order Sort order passed to SQL in format of array( $column => 'asc', 'name' => 'desc', ... ). ie: array( 'id' => 'asc', 'name' => 'desc', ... )
|
||
|
|
* @return bool|PayPeriodScheduleListFactory
|
||
|
|
*/
|
||
|
|
function getByCompanyIdAndUserId( $company_id, $user_ids, $where = null, $order = null ) {
|
||
|
|
if ( $company_id == '' ) {
|
||
|
|
return false;
|
||
|
|
}
|
||
|
|
|
||
|
|
if ( $user_ids == '' ) {
|
||
|
|
return false;
|
||
|
|
}
|
||
|
|
/*
|
||
|
|
if ( $order == NULL ) {
|
||
|
|
$order = array( 'type_id' => 'asc' );
|
||
|
|
$strict = FALSE;
|
||
|
|
} else {
|
||
|
|
$strict = TRUE;
|
||
|
|
}
|
||
|
|
*/
|
||
|
|
$ppsuf = new PayPeriodScheduleUserFactory();
|
||
|
|
|
||
|
|
$ph = [ 'company_id' => TTUUID::castUUID( $company_id ), ];
|
||
|
|
|
||
|
|
$query = '
|
||
|
|
select a.*,
|
||
|
|
b.user_id as user_id
|
||
|
|
from ' . $this->getTable() . ' as a,
|
||
|
|
' . $ppsuf->getTable() . ' as b
|
||
|
|
where a.id = b.pay_period_schedule_id
|
||
|
|
AND a.company_id = ? ';
|
||
|
|
|
||
|
|
if ( isset( $user_ids ) && ( $user_ids != '' || ( is_array( $user_ids ) && isset( $user_ids[0] ) ) ) ) {
|
||
|
|
$query .= ' AND b.user_id in (' . $this->getListSQL( $user_ids, $ph, 'uuid' ) . ') ';
|
||
|
|
}
|
||
|
|
|
||
|
|
$query .= ' AND a.deleted = 0';
|
||
|
|
$query .= $this->getWhereSQL( $where );
|
||
|
|
$query .= $this->getSortSQL( $order );
|
||
|
|
|
||
|
|
$this->rs = $this->ExecuteSQL( $query, $ph );
|
||
|
|
|
||
|
|
return $this;
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* @param string $id UUID
|
||
|
|
* @param string $company_id UUID
|
||
|
|
* @param array $order Sort order passed to SQL in format of array( $column => 'asc', 'name' => 'desc', ... ). ie: array( 'id' => 'asc', 'name' => 'desc', ... )
|
||
|
|
* @return bool|PayPeriodScheduleListFactory
|
||
|
|
*/
|
||
|
|
function getByIdAndCompanyId( $id, $company_id, $order = null ) {
|
||
|
|
if ( $id == '' ) {
|
||
|
|
return false;
|
||
|
|
}
|
||
|
|
|
||
|
|
if ( $company_id == '' ) {
|
||
|
|
return false;
|
||
|
|
}
|
||
|
|
|
||
|
|
$ph = [
|
||
|
|
'company_id' => TTUUID::castUUID( $company_id ),
|
||
|
|
'id' => TTUUID::castUUID( $id ),
|
||
|
|
];
|
||
|
|
|
||
|
|
$query = '
|
||
|
|
select *
|
||
|
|
from ' . $this->getTable() . '
|
||
|
|
where company_id = ?
|
||
|
|
AND id = ?
|
||
|
|
AND deleted=0';
|
||
|
|
$query .= $this->getSortSQL( $order );
|
||
|
|
|
||
|
|
$this->rs = $this->ExecuteSQL( $query, $ph );
|
||
|
|
|
||
|
|
return $this;
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* @param string|string[] $id UUID
|
||
|
|
* @param string $company_id UUID
|
||
|
|
* @param int $limit Limit the number of records returned
|
||
|
|
* @param int $page Page number of records to return for pagination
|
||
|
|
* @param array $where Additional SQL WHERE clause in format of array( $column => $filter, ... ). ie: array( 'id' => 1, ... )
|
||
|
|
* @param array $order Sort order passed to SQL in format of array( $column => 'asc', 'name' => 'desc', ... ). ie: array( 'id' => 'asc', 'name' => 'desc', ... )
|
||
|
|
* @return bool|PayPeriodScheduleListFactory
|
||
|
|
*/
|
||
|
|
function getByPayPeriodIdAndCompanyId( $id, $company_id, $limit = null, $page = null, $where = null, $order = null ) {
|
||
|
|
if ( $id == '' ) {
|
||
|
|
return false;
|
||
|
|
}
|
||
|
|
|
||
|
|
if ( $company_id == '' ) {
|
||
|
|
return false;
|
||
|
|
}
|
||
|
|
|
||
|
|
$ph = [
|
||
|
|
'company_id' => TTUUID::castUUID( $company_id ),
|
||
|
|
];
|
||
|
|
|
||
|
|
$ppf = new PayPeriodFactory();
|
||
|
|
|
||
|
|
$query = '
|
||
|
|
select _ADODB_COUNT
|
||
|
|
*
|
||
|
|
_ADODB_COUNT
|
||
|
|
from ' . $this->getTable() . '
|
||
|
|
where company_id = ?
|
||
|
|
AND id in ( select ppf.pay_period_schedule_id from ' . $ppf->getTable() . ' as ppf where ppf.id in (' . $this->getListSQL( $id, $ph, 'uuid' ) . ') )
|
||
|
|
AND deleted=0';
|
||
|
|
$query .= $this->getSortSQL( $order );
|
||
|
|
|
||
|
|
$this->rs = $this->ExecuteSQL( $query, $ph, $limit, $page );
|
||
|
|
|
||
|
|
return $this;
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* @param string $company_id UUID
|
||
|
|
* @param bool $include_blank
|
||
|
|
* @return array|bool
|
||
|
|
*/
|
||
|
|
function getByCompanyIdArray( $company_id, $include_blank = true ) {
|
||
|
|
|
||
|
|
$ppslf = new PayPeriodScheduleListFactory();
|
||
|
|
$ppslf->getByCompanyId( $company_id );
|
||
|
|
|
||
|
|
$list = [];
|
||
|
|
if ( $include_blank == true ) {
|
||
|
|
$list[TTUUID::getZeroID()] = '--';
|
||
|
|
}
|
||
|
|
|
||
|
|
foreach ( $ppslf as $pps_obj ) {
|
||
|
|
$list[$pps_obj->getID()] = $pps_obj->getName();
|
||
|
|
}
|
||
|
|
|
||
|
|
if ( empty( $list ) == false ) {
|
||
|
|
return $list;
|
||
|
|
}
|
||
|
|
|
||
|
|
return false;
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* @param $lf
|
||
|
|
* @param bool $include_blank
|
||
|
|
* @return array|bool
|
||
|
|
*/
|
||
|
|
function getArrayByListFactory( $lf, $include_blank = true ) {
|
||
|
|
if ( !is_object( $lf ) ) {
|
||
|
|
return false;
|
||
|
|
}
|
||
|
|
|
||
|
|
$list = [];
|
||
|
|
if ( $include_blank == true ) {
|
||
|
|
$list[TTUUID::getZeroID()] = '--';
|
||
|
|
}
|
||
|
|
|
||
|
|
foreach ( $lf as $obj ) {
|
||
|
|
$list[$obj->getID()] = $obj->getName();
|
||
|
|
}
|
||
|
|
|
||
|
|
if ( empty( $list ) == false ) {
|
||
|
|
return $list;
|
||
|
|
}
|
||
|
|
|
||
|
|
return false;
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* @param $lf
|
||
|
|
* @return array|bool
|
||
|
|
*/
|
||
|
|
function getUserToPayPeriodScheduleMapArrayByListFactory( $lf ) {
|
||
|
|
if ( !is_object( $lf ) ) {
|
||
|
|
return false;
|
||
|
|
}
|
||
|
|
|
||
|
|
$retarr = [];
|
||
|
|
foreach ( $lf as $obj ) {
|
||
|
|
$retarr[$obj->getColumn( 'user_id' )] = $obj->getId();
|
||
|
|
}
|
||
|
|
|
||
|
|
if ( empty( $retarr ) == false ) {
|
||
|
|
return $retarr;
|
||
|
|
}
|
||
|
|
|
||
|
|
return false;
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* @param string $company_id UUID
|
||
|
|
* @param $filter_data
|
||
|
|
* @param int $limit Limit the number of records returned
|
||
|
|
* @param int $page Page number of records to return for pagination
|
||
|
|
* @param array $where Additional SQL WHERE clause in format of array( $column => $filter, ... ). ie: array( 'id' => 1, ... )
|
||
|
|
* @param array $order Sort order passed to SQL in format of array( $column => 'asc', 'name' => 'desc', ... ). ie: array( 'id' => 'asc', 'name' => 'desc', ... )
|
||
|
|
* @return bool|PayPeriodScheduleListFactory
|
||
|
|
*/
|
||
|
|
function getAPISearchByCompanyIdAndArrayCriteria( $company_id, $filter_data, $limit = null, $page = null, $where = null, $order = null ) {
|
||
|
|
if ( $company_id == '' ) {
|
||
|
|
return false;
|
||
|
|
}
|
||
|
|
|
||
|
|
if ( !is_array( $order ) ) {
|
||
|
|
//Use Filter Data ordering if its set.
|
||
|
|
if ( isset( $filter_data['sort_column'] ) && $filter_data['sort_order'] ) {
|
||
|
|
$order = [ Misc::trimSortPrefix( $filter_data['sort_column'] ) => $filter_data['sort_order'] ];
|
||
|
|
}
|
||
|
|
}
|
||
|
|
|
||
|
|
$additional_order_fields = [ 'total_users' ];
|
||
|
|
|
||
|
|
$sort_column_aliases = [
|
||
|
|
'type' => 'a.type_id',
|
||
|
|
'start_week_day' => 'a.start_week_day_id',
|
||
|
|
'shift_assigned_day' => 'a.shift_assigned_day_id',
|
||
|
|
];
|
||
|
|
|
||
|
|
$order = $this->getColumnsFromAliases( $order, $sort_column_aliases );
|
||
|
|
|
||
|
|
if ( $order == null ) {
|
||
|
|
$order = [ 'name' => 'asc' ];
|
||
|
|
$strict = false;
|
||
|
|
} else {
|
||
|
|
//Always sort by last name, first name after other columns
|
||
|
|
if ( !isset( $order['name'] ) ) {
|
||
|
|
$order['name'] = 'asc';
|
||
|
|
}
|
||
|
|
$strict = true;
|
||
|
|
}
|
||
|
|
//Debug::Arr($order, 'Order Data:', __FILE__, __LINE__, __METHOD__, 10);
|
||
|
|
//Debug::Arr($filter_data, 'Filter Data:', __FILE__, __LINE__, __METHOD__, 10);
|
||
|
|
|
||
|
|
$uf = new UserFactory();
|
||
|
|
$ppsuf = new PayPeriodScheduleUserFactory();
|
||
|
|
|
||
|
|
$ph = [
|
||
|
|
'company_id' => TTUUID::castUUID( $company_id ),
|
||
|
|
];
|
||
|
|
|
||
|
|
$query = '
|
||
|
|
select
|
||
|
|
_ADODB_COUNT
|
||
|
|
a.*,
|
||
|
|
(select count(*) from ' . $ppsuf->getTable() . ' as ppsuf_tmp where ppsuf_tmp.pay_period_schedule_id = a.id ) as total_users,
|
||
|
|
y.first_name as created_by_first_name,
|
||
|
|
y.middle_name as created_by_middle_name,
|
||
|
|
y.last_name as created_by_last_name,
|
||
|
|
z.first_name as updated_by_first_name,
|
||
|
|
z.middle_name as updated_by_middle_name,
|
||
|
|
z.last_name as updated_by_last_name
|
||
|
|
_ADODB_COUNT
|
||
|
|
from ' . $this->getTable() . ' as a
|
||
|
|
LEFT JOIN ' . $uf->getTable() . ' as y ON ( a.created_by = y.id AND y.deleted = 0 )
|
||
|
|
LEFT JOIN ' . $uf->getTable() . ' as z ON ( a.updated_by = z.id AND z.deleted = 0 )
|
||
|
|
where a.company_id = ?
|
||
|
|
';
|
||
|
|
|
||
|
|
$query .= ( isset( $filter_data['permission_children_ids'] ) ) ? $this->getWhereClauseSQL( 'a.created_by', $filter_data['permission_children_ids'], 'uuid_list', $ph ) : null;
|
||
|
|
$query .= ( isset( $filter_data['id'] ) ) ? $this->getWhereClauseSQL( 'a.id', $filter_data['id'], 'uuid_list', $ph ) : null;
|
||
|
|
$query .= ( isset( $filter_data['exclude_id'] ) ) ? $this->getWhereClauseSQL( 'a.id', $filter_data['exclude_id'], 'not_uuid_list', $ph ) : null;
|
||
|
|
|
||
|
|
if ( isset( $filter_data['type'] ) && !is_array( $filter_data['type'] ) && trim( $filter_data['type'] ) != '' && !isset( $filter_data['type_id'] ) ) {
|
||
|
|
$filter_data['type_id'] = Option::getByFuzzyValue( $filter_data['type'], $this->getOptions( 'type' ) );
|
||
|
|
}
|
||
|
|
$query .= ( isset( $filter_data['type_id'] ) ) ? $this->getWhereClauseSQL( 'a.type_id', $filter_data['type_id'], 'numeric_list', $ph ) : null;
|
||
|
|
$query .= ( isset( $filter_data['name'] ) ) ? $this->getWhereClauseSQL( 'a.name', $filter_data['name'], 'text', $ph ) : null;
|
||
|
|
$query .= ( isset( $filter_data['description'] ) ) ? $this->getWhereClauseSQL( 'a.description', $filter_data['description'], 'text', $ph ) : null;
|
||
|
|
|
||
|
|
$query .= ( isset( $filter_data['created_by'] ) ) ? $this->getWhereClauseSQL( [ 'a.created_by', 'y.first_name', 'y.last_name' ], $filter_data['created_by'], 'user_id_or_name', $ph ) : null;
|
||
|
|
|
||
|
|
$query .= ( isset( $filter_data['updated_by'] ) ) ? $this->getWhereClauseSQL( [ 'a.updated_by', 'z.first_name', 'z.last_name' ], $filter_data['updated_by'], 'user_id_or_name', $ph ) : null;
|
||
|
|
|
||
|
|
|
||
|
|
$query .= '
|
||
|
|
AND a.deleted = 0
|
||
|
|
';
|
||
|
|
$query .= $this->getWhereSQL( $where );
|
||
|
|
$query .= $this->getSortSQL( $order, $strict, $additional_order_fields );
|
||
|
|
|
||
|
|
$this->rs = $this->ExecuteSQL( $query, $ph, $limit, $page );
|
||
|
|
|
||
|
|
return $this;
|
||
|
|
}
|
||
|
|
|
||
|
|
}
|
||
|
|
|
||
|
|
?>
|