/**
* Creates or updates a clocking.
*
* @param int $id
* @param array $data
* @return int The clocking ID
*/
public function do_update($id, $data)
{
$con = Propel::getConnection();
if (!$con->beginTransaction()) {
throw new Exception('Could not start transaction.');
}
$clocking = null;
try {
$authUser = $this->requireUser();
// Validate input data
$validator = new KickstartValidator();
$locale = Localizer::getInstance();
// Cut off seconds to get time in full minutes
if (isset($data['Start']) and is_numeric($data['Start'])) {
$data['Start'] -= date('s', $data['Start']);
}
if (isset($data['End']) and is_numeric($data['End'])) {
$data['End'] -= date('s', $data['End']);
}
$warnings = $validator->filterErrors($data, $this->initFilter($this->filter_basic, $locale));
if ($warnings) {
return array('result' => false, 'warnings' => $warnings);
}
if ((string) $id === '') {
$event = 'create';
$clocking = new Clocking();
} else {
$event = 'update';
$clocking = $this->getClockingById($id, $con);
if ($clocking->getBooked() or $clocking->getFrozen()) {
throw new Exception('Cannot change clocking entry #' . $id . ' because it already has bookings or is locked for booking.');
}
}
$isAdmin = $authUser->getIsAdmin();
$allowedColumns = array('TypeId' => true, 'Start' => true, 'End' => true, 'Breaktime' => true, 'Comment' => true);
if ($isAdmin) {
$allowedColumns['ApprovalStatus'] = true;
}
$clocking->fromArray(array_intersect_key($data, array('UserId' => true) + $allowedColumns));
$clockingUser = $clocking->getUserRelatedByUserId($con);
$clockingUserId = $clocking->getUserId();
$authUserAccountId = $authUser->getAccountId();
// Check if authenticated user may access clocking's user
if ($clockingUser === null or (string) $clockingUser->getAccountId() !== (string) $authUserAccountId or !$isAdmin and $clockingUser !== $authUser) {
throw new Exception('Invalid user #' . $clockingUserId . ' specified for clocking or no permission to access that user\'s data.');
}
$type = $clocking->getClockingType($con);
if ($type === null) {
throw new Exception('Clocking #' . $id . ' has no clocking type assigned.');
}
$account = $authUser->getAccount($con);
if ($account === null) {
throw new Exception('Could not load account of user #' . $authUser->getId() . ' "' . $authUser->getFQN($con) . '".');
}
// Check hard time limit for non-admin users
if (!$isAdmin) {
$this->validateTimeLimits($account, $authUser, $clocking, $con);
}
$isNew = $clocking->isNew();
// Save first to obtain an ID which may be referenced by a plugin
$clocking->save($con);
$clockingData = EntityArray::from($clocking, $con) + array('IsNew' => $isNew, 'Type' => EntityArray::from($type, $con));
if (!$isAdmin and ($type->getApprovalRequired() or $this->pastGraceTimeExceeded($type, min((int) $clocking->getStart('U'), (int) $clocking->getEnd('U'))))) {
$clocking->setApprovalStatus(ClockingPeer::APPROVAL_STATUS_REQUIRED);
}
$clocking->fromArray(array_intersect_key(PluginPeer::fireEvent($clockingUser, 'clocking', $event, $clockingData, $con), $allowedColumns));
$type = $clocking->getClockingType($con);
// Plugins may have changed this
if ($type === null or (string) $type->getAccountId() !== (string) $authUserAccountId) {
throw new Exception('Clocking #' . $id . ' has an invalid or unknown clocking type #' . $clocking->getTypeId() . ' assigned.');
}
$start = (int) $clocking->getStart('U');
$end = (int) $clocking->getEnd('U');
if ($start > $end) {
throw new APIException(self::ERROR_INTERVAL, 'Start time (' . $clocking->getStart('Y-m-d H:i:s') . ') must be before end time (' . $clocking->getEnd('Y-m-d H:i:s') . ').', array('start' => $start, 'end' => $end));
} elseif ($type->getWholeDay()) {
// Set time of day for start and end to 00:00:00
$clocking->setStart(strtotime(date('Y-m-d 00:00:00', $start)));
$clocking->setEnd(strtotime(date('Y-m-d 00:00:00', $end)));
// Set break time to 0
$clocking->setBreaktime(0);
} elseif ($start === $end) {
// Create an open clocking entry (i.e. sign on for work).
// Fail if there are other open entries.
if (($openClocking = $this->getOpenClocking($authUser, $clockingUser, $clocking, $con)) !== null) {
$openComment = $openClocking->getComment();
throw new APIException(self::ERROR_OPEN, 'Clocking #' . $openClocking->getId() . ((string) $openComment === '' ? '' : ' "' . $openComment . '"') . ' from ' . $openClocking->getStart('r') . ' to ' . $openClocking->getEnd('r') . ' is already open. Please close that entry first.' . $openClocking->getId() . ' ' . $clocking->getId(), $openClocking);
}
} elseif ($clocking->getTime() < $clocking->getBreaktime()) {
throw new APIException(self::ERROR_BREAK, 'Break (' . $clocking->getBreaktime() / 60 . ' minutes) must be less than the specified work time (' . $clocking->getTime() . ' = ' . $clocking->getStart('Y-m-d H:i:s') . ' - ' . $clocking->getEnd('Y-m-d H:i:s') . ').');
}
$futureGraceTime = $type->getFutureGraceTime();
if ($futureGraceTime !== null and $end > time() + $futureGraceTime) {
throw new APIException(self::ERROR_FUTURE, 'Clocking type "' . $type->getIdentifier() . '" #' . $type->getId() . ' does not allow entries in the future (' . $clocking->getStart('Y-m-d H:i:s') . ' - ' . $clocking->getEnd('Y-m-d H:i:s') . ').');
}
$clocking->save($con);
$clocking->reload(false, $con);
if ($clocking->getFrozen()) {
throw new APIException(self::ERROR_LOCKED, 'The clocking #' . $clocking->getId() . ' is currently locked for booking.');
}
// Check for other non-whole-day clockings with overlapping time
if (!$type->getWholeDay()) {
$firstConflict = self::createClockingQuery($authUser, $con)->filterById($clocking->getId(), Criteria::NOT_EQUAL)->filterByUserId($clockingUserId)->add(ClockingTypePeer::WHOLE_DAY, 0, Criteria::EQUAL)->filterByStart($end, Criteria::LESS_THAN)->filterByEnd($start, Criteria::GREATER_THAN)->filterByDeleted(0, Criteria::EQUAL)->findOne($con);
if ($firstConflict !== null) {
throw new APIException(self::ERROR_OVERLAP, $clocking->__toString() . ' overlaps with ' . $firstConflict->__toString() . '.', $firstConflict);
}
}
SystemLogPeer::add('clocking.' . $event, $clocking, SystemLogPeer::CODE_SUCCESSFUL, null, $authUser, array('clocking' => $clocking->toArray()), $con);
} catch (Exception $e) {
$con->rollBack();
SystemLogPeer::add('clocking.' . $event, $clocking, SystemLogPeer::CODE_FAILED, $e->getMessage(), $authUser, array('exception' => $e->__toString(), 'clocking' => $clocking->toArray()), $con);
throw $e;
}
if (!$con->commit()) {
throw new Exception('Could not commit transaction.');
}
return $clocking->getId();
}
