企业协同办公平台EntboostTW

<?php require_once dirname(__FILE__).'/attendance_define.php'; /** * 寻找适用的考勤时间段[多个] * @param {timestamp} $signDateTime 指定时间戳 * @param {boolean} $output 是否输出结果到页面 * @param {string} $userId 用户编号 * @param {array} $groupCodes 群组的编号列表 * @param {string} $entCode 企业编号 * @return {boolean|array} false=执行失败，array=考勤时间段列表 */ function findActionRuleTimes($signDateTime, $output, $userId, $groupCodes, $entCode) { //声明引用外部变量 global $WEEK_VALUES; $instance = AttendSettingService::get_instance(); //查找相适应的考勤设置 $settings = $instance->getAttendSettings($userId, $groupCodes, $entCode); if ($settings===false) { $errMsg = "getAttendSettings error"; ResultHandle::errorToJsonAndOutput($errMsg, $errMsg, $output); return false; } if (count($settings)>0) { $entity = $settings[0]; log_info('found att_set_id='.$entity['att_set_id'].', setting_name='.$entity['name'].', target_type='.$entity['target_type'].', target_id='.$entity['target_id']); //查找相应的考勤规则 $weekDayValue = $WEEK_VALUES[date('w', $signDateTime)]; $times = $instance->getAttendRuleTimes($entity['att_set_id'], $weekDayValue); if (is_bool($times)) { $errMsg = "getAttendRuleTimes error"; ResultHandle::errorToJsonAndOutput($errMsg, $errMsg, $output); return false; } return $times; } else { //没有考勤设置，视为假期 log_info("no attend setting, it's holiday for userId=$userId"); return array(); //return generateHolidayAttendRuleTimeRec(); } } /** * 在指定时刻下，尝试分析出一个适用考勤时间段 * @param {timestamp} $signDateTime 指定时间戳 * @param {boolean} $output 是否输出结果到页面 * @param {array} $times 时间段列表 * @param {int} $actionType 考勤操作：1=签到，2=签退 * @param {boolean} $signCheckMiddleTime 是否使用时间段中间作为参考 * @param {boolean} $controlAction 是否控制"签到"、"签退" * @return {boolean|array} false=执行失败，array(关联数组，元素实际表示一个对象的各字段)=一个可执行的考勤时间段记录 */ function analyzeAttendTimesWithActionType($signDateTime, $output, $times, $actionType, $signCheckMiddleTime, $controlAction) { $errMsg = ($actionType==1?"sign in":"sign out")." error"; $toSignDate = date('Y-m-d', $signDateTime); $toSignTime = date('H:i:s', $signDateTime); $matchedTimeRec; //保存已匹配的时间段记录 $lastTimeRec; //暂存上一条时间段记录 $lastMiddleTime; //暂存上一条记录时间段的中间 $lastSignoutTime; //暂存上一条记录的签退时间 //遍历查找最迟的适用时间段 foreach ($times as $timeRec) { //log_debug($timeRec); $signinTimeStr = $timeRec['signin_time']; $signoutTimeStr = $timeRec['signout_time']; $signinTime = strtotime($toSignDate.' '.$signinTimeStr); $signoutTime = strtotime($toSignDate.' '.$signoutTimeStr); $diff = $signoutTime - $signinTime; //两个时间的一半 $middleTime = $signinTime + $diff/2; $middleTimeStr = date('Y-m-d H:i:s', $middleTime); log_debug("actionType=$actionType, toSignTime=$toSignTime, signinTimeStr=$signinTimeStr, middleTimeStr=$middleTimeStr, signoutTimeStr=$signoutTimeStr"); //允许签到：当前时间小于[签到时间与签退时间的一半] //允许签退：当前时间大于等于[签到时间与签退时间的一半]，并且小于下一个考勤时间段(或第二天) //======== 签退 ======= if (ACTION_TYPE_SIGN_OUT==$actionType) { if (!empty($matchedTimeRec)) { if ($signDateTime<$signinTime) { //签退操作不得晚于下一个时间段 log_debug("match signout time before next signinTime $signinTimeStr"); break; } else if ($signCheckMiddleTime && $signDateTime<$middleTime) { //签退时间未到[签到时间与签退时间的一半]，并且已进入下一个时间段，不允许签退 log_debug("not arrive signout time $middleTimeStr"); unset($matchedTimeRec); break; } } if (($signCheckMiddleTime && $signDateTime>=$middleTime) || (!$signCheckMiddleTime && $signDateTime>$signinTime)) { $matchedTimeRec = $timeRec; } } //======== 签到 ======= if (ACTION_TYPE_SIGN_IN==$actionType) { if (($signCheckMiddleTime && $signDateTime<$middleTime) || (!$signCheckMiddleTime && $signDateTime<$signoutTime)) { $matchedTimeRec = $timeRec; } //签到时间小于上一个时间段的签退时间，不允许签到 if (!empty($lastTimeRec) && !empty($matchedTimeRec)) { //$lastSignoutTimeStr = $nowDate.' '.$lastTimeRec['signout_time']; if ($signDateTime <= $lastSignoutTime) { $lastSignoutTimeStr = date('Y-m-d H:i:s', $lastSignoutTime); log_debug("not pass last signout time $lastSignoutTimeStr, use last record"); $matchedTimeRec = $lastTimeRec; //继续判断$lastTimeRec是否受$signCheckMiddleTime限制，是否在合法的签到时间 if (($signCheckMiddleTime && $signDateTime>=$lastMiddleTime) || (!$signCheckMiddleTime && $signDateTime>=$lastSignoutTime)) { unset($matchedTimeRec); log_debug("last record is not matched for sign in, signCheckMiddleTime=$signCheckMiddleTime"); } } break; } } $lastTimeRec = $timeRec; $lastMiddleTime = $middleTime; $lastSignoutTime = $signoutTime; } if (!empty($matchedTimeRec)) { return $matchedTimeRec; } else { //没有可用时间段 if ($controlAction) { //禁止"签到"、"签退" ResultHandle::errorToJsonAndOutput($errMsg, "no matched attend time", $output , ACTION_TYPE_SIGN_IN==$actionType?EBStateCode::$EB_STATE_DISABLE_SIGN_IN:EBStateCode::$EB_STATE_DISABLE_SIGN_OUT); return false; } else { //不禁止，由调用方决定下一步 return null; } } } /** * 产生假期考勤规则记录 */ function generateHolidayAttendRuleTimeRec() { return array('holiday'=>true, 'att_rul_id'=>'0', 'att_tim_id'=>'0'); /* if ($holiday) { $matchedTimeRec = array('holiday'=>true, 'att_rul_id'=>'0', 'att_tim_id'=>'0'); } else { $weekNum = intval(date('w', $date)); //周一至周五是工作日 $holiday = true; if ($weekNum>0 && $weekNum<6) $holiday = false; $matchedTimeRec = array('holiday'=>false, 'att_rul_id'=>'0', 'att_tim_id'=>'0' , 'name'=>'默认考勤规则', 'signin_time'=>'09:00:00', 'signin_ignore'=>'0', 'signout_time'=>'18:00:00', 'signout_ignore'=>'0' , 'work_day'=>'31', 'att_tim_id1'=>'0', 'att_tim_id2'=>'0', 'att_tim_id3'=>'0', 'att_tim_id4'=>'0', 'flexible_work'=>'0', 'flag'=>'0' ); } return $matchedTimeRec;*/ } /** * 执行签到/签退操作 * @param {timestamp} $signDateTime 指定时间戳 * @param {boolean} $output 是否输出结果到页面 * @param {int} $actionType 考勤操作：1=签到，2=签退 * @param {array} $matchedTimeRec 一个可执行的考勤时间段记录(关联数组，元素实际表示一个对象的各字段) * @param {string} $userId 用户编号 * @param {string} $userName 用户名称 * @param {string} $groupCode 群组编号(暂保留，填NULL) * @param {string} $entCode 企业编号 * @param boolean 执行结果 */ function executeSignInOutAction($signDateTime, $output, $actionType, $matchedTimeRec, $userId, $userName, $groupCode, $entCode) { $errMsg = ($actionType==ACTION_TYPE_SIGN_IN?"sign in":"sign out")." error"; $signDate = date('Y-m-d', $signDateTime); $instance = AttendRecordService::get_instance(); //！！！==注意使用假期类型的$matchedTimeRec，缺少某些字段==!!! //假期判断 if(!empty($matchedTimeRec['holiday'])) //假期按加班进行签到(签退) $attRuleId = $matchedTimeRec['att_rul_id']; $attTimId = $matchedTimeRec['att_tim_id']; //获取假期签到、签退的记录列表 $records = $instance->getAttendRecord($entCode, null, $userId, $signDate, 0, 0); if (is_bool($records)) { ResultHandl