<?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 Core
*/
class AuthorizationFactory extends Factory {
protected $table = 'authorizations';
protected $pk_sequence_name = 'authorizations_id_seq'; //PK Sequence name
protected $obj_handler = null;
protected $obj_handler_obj = null;
protected $hierarchy_arr = null;
/**
* @param $name
* @param null $parent
* @return array|null
*/
function _getFactoryOptions( $name, $parent = null ) {
$retval = null;
switch ( $name ) {
case 'object_type':
$retval = [
//10 => 'default_schedule',
//20 => 'schedule_amendment',
//30 => 'shift_amendment',
//40 => 'pay_stub_amendment',
//52 => 'request_vacation',
//54 => 'request_missed_punch',
//56 => 'request_edit_punch',
//58 => 'request_absence',
//59 => 'request_schedule',
90 => 'timesheet',
200 => 'expense',
//50 => 'request', //request_other
1010 => 'request_punch',
1020 => 'request_punch_adjust',
1030 => 'request_absence',
1040 => 'request_schedule',
1100 => 'request_other',
];
break;
case 'columns':
$retval = [
'-1010-created_by' => TTi18n::gettext( 'Name' ),
'-1020-created_date' => TTi18n::gettext( 'Date' ),
'-1030-authorized' => TTi18n::gettext( 'Authorized' ),
//'-1100-object_type' => TTi18n::gettext('Object Type'),
//'-2020-updated_by' => TTi18n::gettext('Updated By'),
//'-2030-updated_date' => TTi18n::gettext('Updated Date'),
];
break;
case 'list_columns':
$retval = Misc::arrayIntersectByKey( $this->getOptions( 'default_display_columns' ), Misc::trimSortPrefix( $this->getOptions( 'columns' ) ) );
break;
case 'default_display_columns': //Columns that are displayed by default.
$retval = [
'created_by',
'created_date',
'authorized',
];
break;
}
return $retval;
}
/**
* @param $data
* @return array
*/
function _getVariableToFunctionMap( $data ) {
$variable_function_map = [
'id' => 'ID',
'object_type_id' => 'ObjectType',
'object_type' => false,
'object_id' => 'Object',
'authorized' => 'Authorized',
'deleted' => 'Deleted',
];
return $variable_function_map;
}
/**
* @return bool
*/
function getCurrentUserObject() {
return $this->getGenericObject( 'UserListFactory', $this->getCurrentUser(), 'user_obj' );
}
/**
* Stores the current user in memory, so we can determine if its the employee verifying, or a superior.
* @return mixed
*/
function getCurrentUser() {
return $this->getGenericTempDataValue( 'current_user_id' );
}
/**
* @param string $value UUID
* @return bool
*/
function setCurrentUser( $value ) {
$value = trim( $value );
return $this->setGenericTempDataValue( 'current_user_id', $value );
}
/**
* @return array|bool|null
*/
function getHierarchyArray() {
if ( is_array( $this->hierarchy_arr ) ) {
return $this->hierarchy_arr;
} else {
$user_id = $this->getCurrentUser();
if ( is_object( $this->getObjectHandler() ) ) {
$this->getObjectHandler()->getByID( $this->getObject() );
$current_obj = $this->getObjectHandler()->getCurrent();
$object_user_id = $current_obj->getUser();
if ( TTUUID::isUUID( $object_user_id ) && $object_user_id != TTUUID::getZeroID() && $object_user_id != TTUUID::getNotExistID() ) {
$ulf = TTnew( 'UserListFactory' ); /** @var UserListFactory $ulf */
$company_id = $ulf->getById( $object_user_id )->getCurrent()->getCompany();
Debug::Text( ' Authorizing User ID: ' . $user_id .' Object User ID: ' . $object_user_id . ' Company ID: ' . $company_id, __FILE__, __LINE__, __METHOD__, 10 );
$hlf = TTnew( 'HierarchyListFactory' ); /** @var HierarchyListFactory $hlf */
$this->hierarchy_arr = $hlf->getHierarchyParentByCompanyIdAndUserIdAndObjectTypeID( $company_id, $object_user_id, $this->getObjectType(), false );
Debug::Arr( $this->hierarchy_arr, ' Hierarchy Arr: ', __FILE__, __LINE__, __METHOD__, 10 );
return $this->hierarchy_arr;
} else {
Debug::Text( ' Could not find Object User ID: ' . $user_id, __FILE__, __LINE__, __METHOD__, 10 );
}
} else {
Debug::Text( ' ERROR: No ObjectHandler defined...', __FILE__, __LINE__, __METHOD__, 10 );
}
}
return false;
}
/**
* @return array|bool
*/
function getHierarchyChildLevelArray() {
$retval = [];
$user_id = $this->getCurrentUser();
$parent_arr = $this->getHierarchyArray();
if ( is_array( $parent_arr ) && count( $parent_arr ) > 0 ) {
$next_level = false;
foreach ( $parent_arr as $level_parent_arr ) {
if ( in_array( $user_id, $level_parent_arr ) ) {
$next_level = true;
continue;
}
if ( $next_level == true ) {
//Debug::Arr( $level_parent_arr, ' Child: Level: '. $level, __FILE__, __LINE__, __METHOD__, 10 );
$retval = array_merge( $retval, $level_parent_arr ); //Append from all levels.
}
}
}
if ( count( $retval ) > 0 ) {
return $retval;
}
return false;
}
/**
* @param bool $force
* @return bool|mixed
*/
function getHierarchyCurrentLevelArray( $force = false ) {
$retval = false;
$user_id = $this->getCurrentUser();
$parent_arr = $this->getHierarchyArray();
if ( is_array( $parent_arr ) && count( $parent_arr ) > 0 ) {
$next_level = false;
foreach ( $parent_arr as $level_parent_arr ) {
if ( in_array( $user_id, $level_parent_arr ) ) {
$next_level = true;
if ( $force == false ) {
continue;
}
}
if ( $next_level == true ) { //Current level is alway one level lower, as this often gets called after the level has been changed.
$retval = $level_parent_arr;
//Debug::Arr( $level_parent_arr, ' Current: Level: ' . $level, __FILE__, __LINE__, __METHOD__, 10 );
break;
}
}
if ( $next_level == true && $retval == false ) {
//Current level was the top and only level.
$retval = $level_parent_arr;
//Debug::Arr( $level_parent_arr, ' Current: Level: ' . $level, __FILE__, __LINE__, __METHOD__, 10 );
}
}
return $retval;
}
/**
* @return array|bool|mixed
*/
function getHierarchyParentLevelArray() {
$retval = false;
$user_id = TTUUID::castUUID( $this->getCurrentUser() );
$parent_arr = array_reverse( (array)$this->getHierarchyArray() );
if ( is_array( $parent_arr ) && count( $parent_arr ) > 0 ) {
$next_level = false;
foreach ( $parent_arr as $level_parent_arr ) {
if ( is_array( $level_parent_arr ) && in_array( $user_id, $level_parent_arr ) ) {
$next_level = true;
continue;
}
//Since this loops in reverse, always assume the first element is the parent for cases where a subordinate may be submitting the object (ie: request) and it needs to go to the direct superiors.
if ( $next_level == true ) {
//Debug::Arr( $level_parent_arr, ' Parents: Level: '. $level, __FILE__, __LINE__, __METHOD__, 10 );
$retval = $level_parent_arr;
break;
}
}
//If we get here without finding a parent, use the lowest lower parents by default.
if ( $next_level == false ) {
reset( $parent_arr );
$retval = $parent_arr[key( $parent_arr )];
}
}
return $retval;
}
/**
* This will return false if it can't find a hierarchy, or if its at the top level (1) and can't find a higher level.
* @return bool|int|string
*/
function getNextHierarchyLevel() {
$retval = false;
$user_id = $this->getCurrentUser();
$parent_arr = $this->getHierarchyArray();
if ( is_array( $parent_arr ) && count( $parent_arr ) > 0 ) {
foreach ( $parent_arr as $level => $level_parent_arr ) {
if ( in_array( $user_id, $level_parent_arr ) ) {
break;
}
$retval = $level;
}
}
if ( $retval < 1 ) {
Debug::Text( ' ERROR, hierarchy level goes past 1... This shouldnt happen...', __FILE__, __LINE__, __METHOD__, 10 );
$retval = false;
}
return $retval;
}
/**
* @param string $company_id UUID
* @param string $user_id UUID
* @param int $hierarchy_type_id
* @return int|mixed
*/
static function getInitialHierarchyLevel( $company_id, $user_id, $hierarchy_type_id ) {
$hierarchy_highest_level = 99;
if ( $company_id != '' && $user_id != '' && $hierarchy_type_id > 0 ) {
$hlf = TTnew( 'HierarchyListFactory' ); /** @var HierarchyListFactory $hlf */
$hierarchy_arr = $hlf->getHierarchyParentByCompanyIdAndUserIdAndObjectTypeID( $company_id, $user_id, $hierarchy_type_id, false );
if ( isset( $hierarchy_arr ) && is_array( $hierarchy_arr ) ) {
//Debug::Arr( $hierarchy_arr, ' aUser ID ' . $user_id . ' Type ID: ' . $hierarchy_type_id . ' Array: ', __FILE__, __LINE__, __METHOD__, 10 );
//See if current user is in superior list, if so, start at one level up in the hierarchy, unless its level 1.
foreach ( $hierarchy_arr as $level => $superior_user_ids ) {
if ( in_array( $user_id, $superior_user_ids, true ) == true ) {
Debug::Text( ' Found user in superior list at level: ' . $level, __FILE__, __LINE__, __METHOD__, 10 );
$i = $level;
while ( isset( $hierarchy_arr[$i] ) ) {
if ( $i != 1 ) {
Debug::Text( ' Removing lower level: ' . $i, __FILE__, __LINE__, __METHOD__, 10 );
unset( $hierarchy_arr[$i] );
}
$i++;
}
}
}
//Debug::Arr( $hierarchy_arr, ' bUser ID ' . $user_id . ' Type ID: ' . $hierarchy_type_id . ' Array: ', __FILE__, __LINE__, __METHOD__, 10 );
$hierarchy_arr = array_keys( $hierarchy_arr );
$hierarchy_highest_level = end( $hierarchy_arr );
}
}
Debug::Text( ' Returning initial hierarchy level to: ' . $hierarchy_highest_level, __FILE__, __LINE__, __METHOD__, 10 );
return $hierarchy_highest_level;
}
/**
* @return bool
*/
function isValidParent() {
$user_id = $this->getCurrentUser();
$parent_arr = $this->getHierarchyArray();
if ( is_array( $parent_arr ) && count( $parent_arr ) > 0 ) {
krsort( $parent_arr );
foreach ( $parent_arr as $level_parent_arr ) {
if ( in_array( $user_id, $level_parent_arr ) ) {
return true;
}
}
}
Debug::Text( ' Authorizing User is not a parent of the object owner: ', __FILE__, __LINE__, __METHOD__, 10 );
return false;
}
/**
* @return bool
*/
function isFinalAuthorization() {
$user_id = $this->getCurrentUser();
$parent_arr = $this->getHierarchyArray();
if ( is_array( $parent_arr ) && count( $parent_arr ) > 0 ) {
//Check that level 1 parent exists
if ( isset( $parent_arr[1] ) && in_array( $user_id, $parent_arr[1] ) ) {
Debug::Text( ' Final Authorization!', __FILE__, __LINE__, __METHOD__, 10 );
return true;
}
}
Debug::Text( ' NOT Final Authorization!', __FILE__, __LINE__, __METHOD__, 10 );
return false;
}
/**
* Checks to see if the currently logged in user is the only superior in the hierarchy at the current level.
* This would normally be paired with a isFinalAuthorization() check as well.
* @return bool
*/
function isCurrentUserOnlySuperior() {
$hierarchy_current_level_user_ids = $this->getHierarchyCurrentLevelArray();
if ( count( $hierarchy_current_level_user_ids ) == 1 && in_array( $this->getCurrentUser(), $hierarchy_current_level_user_ids ) ) {
return true;
}
return false;
}
/**
* @return null|object
*/
function getObjectHandler() {
if ( is_object( $this->obj_handler ) ) {
return $this->obj_handler;
} else {
switch ( $this->getObjectType() ) {
case 90: //TimeSheet
$this->obj_handler = TTnew( 'PayPeriodTimeSheetVerifyListFactory' );
break;
case 200:
$this->obj_handler = TTnew( 'UserExpenseListFactory' );
break;
case 50: //Requests
case 1010:
case 1020:
case 1030:
case 1040:
case 1100:
$this->obj_handler = TTnew( 'RequestListFactory' );
break;
}
return $this->obj_handler;
}
}
/**
* @return bool|int
*/
function getObjectType() {
return $this->getGenericDataValue( 'object_type_id' );
}
/**
* @param $value
* @return bool
*/
function setObjectType( $value ) {
$value = (int)trim( $value );
return $this->setGenericDataValue( 'object_type_id', $value );
}
/**
* @return bool|mixed
*/
function getObject() {
return $this->getGenericDataValue( 'object_id' );
}
/**
* @param string $value UUID
* @return bool
*/
function setObject( $value ) {
$value = TTUUID::castUUID( $value );
return $this->setGenericDataValue( 'object_id', $value );
}
/**
* @return bool
*/
function getAuthorized() {
return $this->fromBool( $this->getGenericDataValue( 'authorized' ) );
}
/**
* @param $value
* @return bool
*/
function setAuthorized( $value ) {
return $this->setGenericDataValue( 'authorized', $this->toBool( $value ) );
}
/**
* @return bool
*/
function clearHistory() {
Debug::text( 'Clearing Authorization History For Type: ' . $this->getObjectType() . ' ID: ' . $this->getObject(), __FILE__, __LINE__, __METHOD__, 10 );
if ( $this->getObjectType() === false || $this->getObject() === false ) {
Debug::text( 'Clearing Authorization History FAILED!', __FILE__, __LINE__, __METHOD__, 10 );
return false;
}
$alf = TTnew( 'AuthorizationListFactory' ); /** @var AuthorizationListFactory $alf */
$alf->getByObjectTypeAndObjectId( $this->getObjectType(), $this->getObject() );
foreach ( $alf as $authorization_obj ) {
$authorization_obj->setDeleted( true );
$authorization_obj->Save();
}
return true;
}
/**
* @return object
*/
function getObjectHandlerObject() {
if ( is_object( $this->obj_handler_obj ) ) {
return $this->obj_handler_obj;
} else {
//Get user_id of object.
$this->getObjectHandler()->getByID( $this->getObject() );
$this->obj_handler_obj = $this->getObjectHandler()->getCurrent();
// if ( method_exists( $this->obj_handler_obj, 'setCurrentUser' ) AND $this->obj_handler_obj->getCurrentUser() != $this->getCurrentUser() ) { //Required for authorizing TimeSheets from MyAccount -> TimeSheet Authorization.
// $this->obj_handler_obj->setCurrentUser( $this->getCurrentUser() );
// }
return $this->obj_handler_obj;
}
}
/**
* @return boolean
*/
function setObjectHandlerStatus() {
$is_final_authorization = $this->isFinalAuthorization();
$this->obj_handler_obj = $this->getObjectHandlerObject();
if ( $this->getAuthorized() === true ) {
if ( $is_final_authorization === true ) {
//If no other superiors exist in the hierarchy and we are at the top level, assume its authorized.
if ( $this->getCurrentUser() != $this->obj_handler_obj->getUser() || $this->isCurrentUserOnlySuperior() == true ) {
Debug::Text( ' Approving Authorization... Final Authorizing Object: ' . $this->getObject() . ' - Type: ' . $this->getObjectType(), __FILE__, __LINE__, __METHOD__, 10 );
$this->obj_handler_obj->setAuthorizationLevel( 1 );
$this->obj_handler_obj->setStatus( 50 ); //Active/Authorized
$this->obj_handler_obj->setAuthorized( true );
} else {
Debug::Text( ' Currently logged in user is authorizing (or submitting as new) their own request, when other superiors exist in the hierarchy, not authorizing...', __FILE__, __LINE__, __METHOD__, 10 );
}
} else {
Debug::text( ' Approving Authorization, moving to next level up...', __FILE__, __LINE__, __METHOD__, 10 );
$current_level = $this->obj_handler_obj->getAuthorizationLevel();
if ( $current_level > 1 ) { //Highest level is 1, so no point in making it less than that.
//Get the next level above the current user doing the authorization, in case they have dropped down a level or two.
$next_level = $this->getNextHierarchyLevel();
if ( $next_level !== false && $next_level < $current_level ) {
Debug::text( ' Current Level: ' . $current_level . ' Moving Up To Level: ' . $next_level, __FILE__, __LINE__, __METHOD__, 10 );
$this->obj_handler_obj->setAuthorizationLevel( $next_level );
}
}
unset( $current_level, $next_level );
}
} else {
Debug::text( ' Declining Authorization...', __FILE__, __LINE__, __METHOD__, 10 );
$this->obj_handler_obj->setStatus( 55 ); //'AUTHORIZATION DECLINED'
$this->obj_handler_obj->setAuthorized( false );
}
return true;
}
/**
* @return array|bool
*/
function getUserAuthorizationIds() {
$object_handler_user_id = $this->getObjectHandlerObject()->getUser(); //Object handler (request) user_id.
$is_final_authorization = $this->isFinalAuthorization();
$authorization_level = $this->getObjectHandlerObject()->getAuthorizationLevel(); //This is the *new* level, not the old level.
$hierarchy_current_level_arr = $this->getHierarchyCurrentLevelArray();
Debug::Arr( $hierarchy_current_level_arr, ' Authorization Level: ' . $authorization_level . ' Authorized: ' . (int)$this->getAuthorized() . ' Is Final Auth: ' . (int)$is_final_authorization . ' Object Handler User ID: ' . $object_handler_user_id, __FILE__, __LINE__, __METHOD__, 10 );
if ( $this->getAuthorized() == true && $authorization_level == 0 ) {
//Final authorization has taken place
//Notify original submittor and all lower level superiors?
$user_ids = $this->getHierarchyChildLevelArray();
if ( is_a( $this->getObjectHandlerObject(), 'PayPeriodTimeSheetVerify' ) ) { //is_a() will match on plugin class names too because it also checks the parent class name.
//Check to see what type of timesheet verification is required, if its superior only, don't notify the employee to avoid confusion.
if ( $this->getObjectHandlerObject()->getVerificationType() != 30 ) {
$user_ids[] = $object_handler_user_id;
} else {
Debug::text( ' TimeSheetVerification for superior only, dont motify employee...', __FILE__, __LINE__, __METHOD__, 10 );
}
} else {
$user_ids[] = $object_handler_user_id;
}
//Debug::Arr($user_ids , ' aAuthorization Level: '. $authorization_level .' Authorized: '. (int)$this->getAuthorized() .' Child: ' , __FILE__, __LINE__, __METHOD__, 10);
} else {
//Debug::Text(' bAuthorization Level: '. $authorization_level .' Authorized: '. (int)$this->getAuthorized(), __FILE__, __LINE__, __METHOD__, 10);
//Final authorization has *not* yet taken place
if ( $this->getObjectHandlerObject()->getStatus() == 55 ) { //Declined
//Authorization declined. Notify original submittor and all lower level superiors?
$user_ids = $this->getHierarchyChildLevelArray();
$user_ids[] = $object_handler_user_id;
//Debug::Arr($user_ids , ' b1Authorization Level: '. $authorization_level .' Authorized: '. (int)$this->getAuthorized() .' Child: ', __FILE__, __LINE__, __METHOD__, 10);
} else if ( $is_final_authorization == true && $this->getCurrentUser() == $object_handler_user_id && $this->getAuthorized() == true && $authorization_level == 1 ) {
//Subordinate who is also a superior at the top and only level of the hierarchy is submitting a request.
$user_ids = $this->getHierarchyCurrentLevelArray( true ); //Force to real current level.
//Debug::Arr($user_ids , ' b2Authorization Level: '. $authorization_level .' Authorized: '. (int)$this->getAuthorized() .' Child: ', __FILE__, __LINE__, __METHOD__, 10);
} else {
//Authorized at a middle level, notify current level superiors only so they know its waiting on them.
$user_ids = $this->getHierarchyParentLevelArray();
//Debug::Arr($user_ids , ' b3Authorization Level: '. $authorization_level .' Authorized: '. (int)$this->getAuthorized() .' Parent: ', __FILE__, __LINE__, __METHOD__, 10);
}
}
if( isset( $user_ids ) && !empty( $user_ids ) ) {
//Remove the current authorizing user from the array, as they don't need to be notified as they are performing the action.
$user_ids = array_diff( (array)$user_ids, [ $this->getCurrentUser() ] ); //CurrentUser is currently logged in user.
//remove duplicate user_ids
$user_ids = array_unique( $user_ids );
return $user_ids;
}
return [];
}
/**
* @return bool
*/
function sendNotificationAuthorization( ) {
Debug::Text( 'getNotificationData: ', __FILE__, __LINE__, __METHOD__, 10 );
$user_ids = $this->getUserAuthorizationIds();
if ( empty ( $user_ids ) ) {
return false;
}
//Get initiator user from User Object so we can include more information in the message.
if ( is_object( $this->getCurrentUserObject() ) ) {
$u_obj = $this->getCurrentUserObject();
} else {
Debug::Text( 'From object does not exist: ' . $this->getCurrentUser(), __FILE__, __LINE__, __METHOD__, 10 );
return false;
}
foreach ( $user_ids as $user_id ) {
//Grab each users preferences as they can be custom to them and their language etc.
$ulf = TTnew( 'UserListFactory' ); /** @var UserListFactory $ulf */
$ulf->getById( $user_id );
if ( $ulf->getRecordCount() == 1 ) {
$user_to_obj = $ulf->getCurrent();
if ( is_object( $user_to_obj ) ) {
$user_to_pref_obj = $user_to_obj->getUserPreferenceObject(); /** @var UserPreferenceFactory $user_to_pref_obj */
$user_to_pref_obj->setDateTimePreferences();
TTi18n::setLanguage( $user_to_pref_obj->getLanguage() );
TTi18n::setCountry( $user_to_obj->getCountry() );
TTi18n::setLocale();
} else {
return false;
}
} else {
Debug::Text( 'ERROR: User does not exist: ' . $user_id, __FILE__, __LINE__, __METHOD__, 10 );
return false;
}
$object_handler_user_obj = $this->getObjectHandlerObject()->getUserObject(); //Object handler (request) user_id.
$status_label = TTi18n::ucfirst( TTi18n::strtolower( Option::getByKey( $this->getObjectHandlerObject()->getStatus(), Misc::trimSortPrefix( $this->getObjectHandlerObject()->getOptions( 'status' ) ) ) ) ); //PENDING, AUTHORIZED, DECLINED
$title_short = '#object_type# '. TTi18n::gettext( 'by' ) .' #object_employee_first_name# #object_employee_last_name# #status#.';
$title_long = '#object_type# '. TTi18n::gettext( 'by' ) .' #object_employee_first_name# #object_employee_last_name# #status# '. TTi18n::gettext( 'for' ) .' #date#';
switch ( $this->getObjectType() ) {
case 90: //TimeSheet
$object_type = TTi18n::getText( 'TimeSheet' );
$notification_object_type = 90;
if ( $this->getAuthorized() == true && $this->getObjectHandlerObject()->getAuthorizationLevel() == 0 ) {
// Timesheet has been verified link back to timesheet.
$link = Misc::getURLProtocol() . '://' . Misc::getHostName() . Environment::getDefaultInterfaceBaseURL() . 'html5/#!m=TimeSheet';
// If timesheet belongs to user being notified set type as timesheet_verify timesheet_authorize for supervisors.
if ( $object_handler_user_obj->getId() === $user_to_obj->getId() ) {
$notification_type = 'timesheet_verify';
} else {
$notification_type = 'timesheet_authorize';
}
} else {
$link = Misc::getURLProtocol() . '://' . Misc::getHostName() . Environment::getDefaultInterfaceBaseURL() . 'html5/#!m=TimeSheetAuthorization&a=view&id=' . $this->getObject() . '&tab=TimeSheetVerification';
$notification_type = 'timesheet_authorize';
}
$display_date = TTDate::getDate( 'DATE', $this->getObjectHandlerObject()->getPayPeriodObject()->getEndDate() );
$body_short = TTi18n::getText( 'Pay Period' ) . ': ' . TTDate::getDate( 'DATE', $this->getObjectHandlerObject()->getPayPeriodObject()->getStartDate() ) . ' -> ' . TTDate::getDate( 'DATE', $this->getObjectHandlerObject()->getPayPeriodObject()->getEndDate() );
break;
case 200: //Expense
$object_type = TTi18n::getText( 'Expense' );
$notification_object_type = 110;
if ( $this->getAuthorized() == true && $this->getObjectHandlerObject()->getAuthorizationLevel() == 0 ) {
// Expense has been authorized link back to original expense and not the authorization view.
$link = Misc::getURLProtocol() . '://' . Misc::getHostName() . Environment::getDefaultInterfaceBaseURL() . 'html5/#!m=LoginUserExpense&a=view&id=' . $this->getObject() . '&tab=Expense';
// If expense belongs to user being notified set type as expense_verify else expense_authorize for supervisors.
if ( $object_handler_user_obj->getId() === $user_to_obj->getId() ) {
$notification_type = 'expense_verify';
} else {
$notification_type = 'expense_authorize';
}
} else {
$link = Misc::getURLProtocol() . '://' . Misc::getHostName() . Environment::getDefaultInterfaceBaseURL() . 'html5/#!m=ExpenseAuthorization&a=edit&id=' . $this->getObject() . '&tab=Expense';
$notification_type = 'expense_authorize';
}
$display_date = TTDate::getDate( 'DATE', $this->getObjectHandlerObject()->getIncurredDate() );
//Check if its a custom unit or just dollars so the message can be formatted properly for each.
if ( is_object( $this->getObjectHandlerObject()->getExpensePolicyObject() ) && $this->getObjectHandlerObject()->getExpensePolicyObject()->getType() == 30 ) { //30=Per Unit
$body_short = $this->getObjectHandlerObject()->getGrossAmount() . ' ' . $this->getObjectHandlerObject()->getExpensePolicyObject()->getUnitName() . ' ' . TTi18n::getText( 'incurred on' ) . ': ' . TTDate::getDate( 'DATE', $this->getObjectHandlerObject()->getIncurredDate() );
} else {
$body_short = '$' . $this->getObjectHandlerObject()->getGrossAmount() . ' ' . TTi18n::getText( 'incurred on' ) . ': ' . TTDate::getDate( 'DATE', $this->getObjectHandlerObject()->getIncurredDate() );
}
//Add the reimbursable amount so its clear to the end-user.
$body_short .= "\n". TTi18n::getText( 'Reimbursable Amount' ) .': $'. $this->getObjectHandlerObject()->getReimburseAmount();
break;
case 50: //Requests
case 1010:
case 1020:
case 1030:
case 1040:
case 1100:
$object_type = TTi18n::getText( 'Request' );
$notification_object_type = 50;
if ( $this->getAuthorized() == true && $this->getObjectHandlerObject()->getAuthorizationLevel() == 0 ) {
// Request has been authorized link back to original request and not the authorization view.
$link = Misc::getURLProtocol() . '://' . Misc::getHostName() . Environment::getDefaultInterfaceBaseURL() . 'html5/#!m=Request&a=view&id=' . $this->getObject() . '&tab=Request';
// If request belongs to user being notified set type as request else request_authorize for supervisors.
if ( $object_handler_user_obj->getId() === $user_to_obj->getId() ) {
$notification_type = 'request';
} else {
$notification_type = 'request_authorize';
}
} else {
$link = Misc::getURLProtocol() . '://' . Misc::getHostName() . Environment::getDefaultInterfaceBaseURL() . 'html5/#!m=RequestAuthorization&a=view&id=' . $this->getObject() . '&tab=Request';
$notification_type = 'request_authorize';
}
$display_date = TTDate::getDate( 'DATE', $this->getObjectHandlerObject()->getDateStamp() );
$body_short = Option::getByKey( $this->getObjectHandlerObject()->getType(), Misc::trimSortPrefix( $this->getObjectHandlerObject()->getOptions( 'type' ) ) ) . ' ' . TTi18n::getText( 'on' ) . ' ' . TTDate::getDate( 'DATE', $this->getObjectHandlerObject()->getDateStamp() );
break;
}
//Define title_short/body variables here.
$search_arr = [
'#object_type#',
'#object_type_long_description#',
'#status#',
'#date#',
'#current_employee_first_name#',
'#current_employee_last_name#',
'#object_employee_first_name#',
'#object_employee_last_name#',
'#object_employee_default_branch#',
'#object_employee_default_department#',
'#object_employee_group#',
'#object_employee_title#',
'#company_name#',
'#url#',
];
$replace_arr = Misc::escapeHTML( [
$object_type,
$body_short,
$status_label,
$display_date,
$u_obj->getFirstName(),
$u_obj->getLastName(),
$object_handler_user_obj->getFirstName(),
$object_handler_user_obj->getLastName(),
( is_object( $object_handler_user_obj->getDefaultBranchObject() ) ) ? $object_handler_user_obj->getDefaultBranchObject()->getName() : null,
( is_object( $object_handler_user_obj->getDefaultDepartmentObject() ) ) ? $object_handler_user_obj->getDefaultDepartmentObject()->getName() : null,
( is_object( $object_handler_user_obj->getGroupObject() ) ) ? $object_handler_user_obj->getGroupObject()->getName() : null,
( is_object( $object_handler_user_obj->getTitleObject() ) ) ? $object_handler_user_obj->getTitleObject()->getName() : null,
( is_object( $object_handler_user_obj->getCompanyObject() ) ) ? $object_handler_user_obj->getCompanyObject()->getName() : null,
( Misc::getURLProtocol() . '://' . Misc::getHostName() . Environment::getDefaultInterfaceBaseURL() ),
] );
$title_short = str_replace( $search_arr, $replace_arr, $title_short );
$title_long = str_replace( $search_arr, $replace_arr, $title_long );
$body_short = str_replace( $search_arr, $replace_arr, $body_short );
//$body_long = TTi18n::gettext( '*DO NOT REPLY TO THIS EMAIL - PLEASE USE THE LINK BELOW INSTEAD*' ) . "\n\n";
$body_long = '#object_type# '. TTi18n::gettext( 'by' ) .' #object_employee_first_name# #object_employee_last_name# #status#'. "\n";
$body_long .= ( $replace_arr[1] != '' ) ? '#object_type_long_description#' . "\n" : null;
$body_long .= "\n";
$body_long .= ( $replace_arr[8] != '' ) ? TTi18n::gettext( 'Default Branch' ) . ': #object_employee_default_branch#' . "\n" : null;
$body_long .= ( $replace_arr[9] != '' ) ? TTi18n::gettext( 'Default Department' ) . ': #object_employee_default_department#' . "\n" : null;
$body_long .= ( $replace_arr[10] != '' ) ? TTi18n::gettext( 'Group' ) . ': #object_employee_group#' . "\n" : null;
$body_long .= ( $replace_arr[11] != '' ) ? TTi18n::gettext( 'Title' ) . ': #object_employee_title#' . "\n" : null;
$body_long .= TTi18n::gettext( 'Link' ) . ': <a href="#url#">' . APPLICATION_NAME . ' ' . TTi18n::gettext( 'Login' ) . '</a>' . "\n";
$body_long .= NotificationFactory::addEmailFooter( ( ( is_object( $object_handler_user_obj->getCompanyObject() ) ) ? $object_handler_user_obj->getCompanyObject()->getName() : null ) );
$body_long = '<html><body><pre>' . str_replace( $search_arr, $replace_arr, $body_long ) . '</pre></body></html>';
$notification_data = [
'object_id' => $this->getObject(),
'user_id' => $user_id,
'type_id' => $notification_type,
'object_type_id' => $notification_object_type,
'title_short' => $title_short,
'title_long' => $title_long,
'body_short' => $body_short,
'body_long_html' => $body_long, //For emails
'payload' => [ 'link' => $link ],
];
Notification::sendNotification( $notification_data );
}
//reset datetime and tti8n preferences to current user
$user_pref_obj = $u_obj->getUserPreferenceObject(); /** @var UserPreferenceFactory $user_pref_obj */
$user_pref_obj->setDateTimePreferences();
TTi18n::setLanguage( $user_pref_obj->getLanguage() );
TTi18n::setCountry( $u_obj->getCountry() );
TTi18n::setLocale();
return true;
}
function markRelatedNotificationsAsRead() {
$request_object_type_to_notification_object_type_map = [
90 => 90, //'timesheet',
200 => 110, //'expense',
//50 => 'request', //request_other
1010 => 50, //'request_punch',
1020 => 50, //'request_punch_adjust',
1030 => 50, //'request_absence',
1040 => 50, //'request_schedule',
1100 => 50, //'request_other',
];
if ( isset( $request_object_type_to_notification_object_type_map[$this->getObjectType()] ) ) {
$notification_object_type_id = $request_object_type_to_notification_object_type_map[$this->getObjectType()];
if ( $this->isFinalAuthorization() == true ) {
//If its a final authorization, mark notification as read for *all* notifications/users at any level.
NotificationFactory::updateStatusByObjectIdAndObjectTypeId( $notification_object_type_id, $this->getObject() ); //Mark any notifications linked to these exceptions as read.
} else {
//If its a superior at a low level, only mark notifications as read for any other superior at the same level.
$hierarchy_current_level_user_ids = $this->getHierarchyCurrentLevelArray();
NotificationFactory::updateStatusByObjectIdAndObjectTypeId( $notification_object_type_id, $this->getObject(), $hierarchy_current_level_user_ids ); //Mark any notifications linked to these exceptions as read.
}
}
return true;
}
/**
* Used by Request/TimeSheetVerification/Expense when initially saving a record to notify the immediate superiors, rather than using the message notification.
* @param string $current_user_id UUID
* @param int $object_type_id
* @param string $object_id UUID
* @return bool
*/
static function sendNotificationAuthorizationOnInitialObjectSave( $current_user_id, $object_type_id, $object_id ) {
$authorization_obj = TTNew( 'AuthorizationFactory' ); /** @var AuthorizationFactory $authorization_obj */
$authorization_obj->setObjectType( $object_type_id );
$authorization_obj->setObject( $object_id );
$authorization_obj->setCurrentUser( $current_user_id );
$authorization_obj->setAuthorized( true );
$authorization_obj->sendNotificationAuthorization();
}
/**
* @return bool
*/
function isUnique() {
$ph = [
'object_type' => (int)$this->getObjectType(),
'object_id' => TTUUID::castUUID( $this->getObject() ),
'authorized' => (int)$this->getAuthorized(),
'created_by' => TTUUID::castUUID( $this->getCreatedBy() ),
];
$query = 'select id from ' . $this->getTable() . ' where object_type_id = ? AND object_id = ? AND authorized = ? AND created_by = ?';
$id = $this->db->GetOne( $query, $ph );
Debug::Arr( $id, 'Unique Authorization: ' . $id, __FILE__, __LINE__, __METHOD__, 10 );
if ( $id === false ) {
return true;
} else {
if ( $id == $this->getId() ) {
return true;
}
}
return false;
}
/**
* @param bool $ignore_warning
* @return bool
*/
function Validate( $ignore_warning = true ) {
//
// BELOW: Validation code moved from set*() functions.
//
// Object Type
$this->Validator->inArrayKey( 'object_type',
$this->getObjectType(),
TTi18n::gettext( 'Object Type is invalid' ),
$this->getOptions( 'object_type' )
);
// Object ID
$this->Validator->isResultSetWithRows( 'object',
( is_object( $this->getObjectHandler() ) ) ? $this->getObjectHandler()->getByID( $this->getObject() ) : false,
TTi18n::gettext( 'Object ID is invalid' )
);
//Prevent duplicate authorizations by the same person.
// This may cause problems if the hierarchy is changed and the same superior needs to authorize the request again though?
// By definition this should never happen at the final authorization level, so someone higher up in the hierarchy could always drop down and authorize it during the transition.
if ( $this->getDeleted() == false ) {
if ( $this->Validator->getValidateOnly() == false && $this->isUnique() == false ) {
$this->Validator->isTrue( 'object',
false,
TTi18n::gettext( 'Record has already been authorized/declined by you' ) );
}
}
//
// ABOVE: Validation code moved from set*() functions.
//
if ( $this->getDeleted() === false
&& $this->isFinalAuthorization() === false
&& $this->isValidParent() === false ) {
//FYI: This error may occur on timesheet authorization if the timesheet cannot be verified because pending requests or critical severity exceptions exist. Though it should display a proper validation message to that affect instead.
$this->Validator->isTrue( 'parent',
false,
TTi18n::gettext( 'Employee authorizing this object is not a superior in the hierarchy that controls it' ) );
return false;
}
$this->setObjectHandlerStatus();
if ( $this->getDeleted() == false && is_object( $this->getObjectHandlerObject() ) && $this->getObjectHandlerObject()->isValid() == false ) {
Debug::text( ' ObjectHandler Validation Failed, pass validation errors up the chain...', __FILE__, __LINE__, __METHOD__, 10 );
$this->Validator->merge( $this->getObjectHandlerObject()->Validator );
}
return true;
}
/**
* @return bool
*/
function preSave() {
//Debug::Text(' Calling preSave!: ', __FILE__, __LINE__, __METHOD__, 10);
$this->StartTransaction();
return true;
}
/**
* @return bool
*/
function postSave() {
if ( $this->getDeleted() == false ) {
if ( is_object( $this->getObjectHandlerObject() ) && $this->getObjectHandlerObject()->isValid() == true ) {
Debug::text( ' Object Valid...', __FILE__, __LINE__, __METHOD__, 10 );
//Return true if object saved correctly.
$retval = $this->getObjectHandlerObject()->Save( false );
if ( $this->getObjectHandlerObject()->isValid() == false ) {
Debug::text( ' Object postSave validation FAILED!', __FILE__, __LINE__, __METHOD__, 10 );
$this->Validator->merge( $this->getObjectHandlerObject()->Validator );
} else {
Debug::text( ' Object postSave validation SUCCESS!', __FILE__, __LINE__, __METHOD__, 10 );
$this->markRelatedNotificationsAsRead(); //Mark existing notifications as read before new ones are sent.
$this->sendNotificationAuthorization();
}
if ( $retval === true ) {
$this->CommitTransaction();
return true;
} else {
$this->FailTransaction();
}
} else {
//Always fail the transaction if we get this far.
//This stops authorization entries from being inserted.
$this->FailTransaction();
}
$this->CommitTransaction(); //preSave() starts the transaction
return false;
}
$this->CommitTransaction(); //preSave() starts the transaction
return true;
}
/**
* @param $data
* @return bool
*/
function setObjectFromArray( $data ) {
if ( is_array( $data ) ) {
$variable_function_map = $this->getVariableToFunctionMap();
foreach ( $variable_function_map as $key => $function ) {
if ( isset( $data[$key] ) ) {
$function = 'set' . $function;
switch ( $key ) {
default:
if ( method_exists( $this, $function ) ) {
$this->$function( $data[$key] );
}
break;
}
}
}
$this->setCreatedAndUpdatedColumns( $data );
return true;
}
return false;
}
/**
* @param null $include_columns
* @param bool $permission_children_ids
* @return array
*/
function getObjectAsArray( $include_columns = null, $permission_children_ids = false ) {
$data = [];
$variable_function_map = $this->getVariableToFunctionMap();
if ( is_array( $variable_function_map ) ) {
foreach ( $variable_function_map as $variable => $function_stub ) {
if ( $include_columns == null || ( isset( $include_columns[$variable] ) && $include_columns[$variable] == true ) ) {
$function = 'get' . $function_stub;
switch ( $variable ) {
case 'object_type':
Debug::text( ' Object Type...', __FILE__, __LINE__, __METHOD__, 10 );
$data[$variable] = Option::getByKey( $this->getObjectType(), $this->getOptions( $variable ) );
break;
default:
if ( method_exists( $this, $function ) ) {
$data[$variable] = $this->$function();
}
break;
}
}
}
$this->getPermissionColumns( $data, $this->getColumn( 'user_id' ), $this->getCreatedBy(), $permission_children_ids, $include_columns );
$this->getCreatedAndUpdatedColumns( $data, $include_columns );
}
return $data;
}
/**
* @param $log_action
* @return bool
*/
function addLog( $log_action ) {
if ( $this->getAuthorized() === true ) {
$authorized = TTi18n::getText( 'True' );
} else {
$authorized = TTi18n::getText( 'False' );
}
return TTLog::addEntry( $this->getId(), $log_action, TTi18n::getText( 'Authorization Object Type' ) . ': ' . ucwords( str_replace( '_', ' ', Option::getByKey( $this->getObjectType(), $this->getOptions( 'object_type' ) ) ) ) . ' ' . TTi18n::getText( 'Authorized' ) . ': ' . $authorized, null, $this->getTable() );
}
}
?>