Exemplo n.º 1
0
 /**
  * Indicate that the candidate is ending its candidate session. 
  * 
  * In other words, the candidate makes the item session
  * go from the INTERACTING mode to the SUSPENDED mode, without ending the attempt. The attempt can be resumed by a
  * call to the beginCandidateSession() method.
  * 
  * @throws AssessmentItemSessionException If a state violation occurs.
  */
 public function endCandidateSession()
 {
     $state = $this->getState();
     if ($state !== AssessmentItemSessionState::INTERACTING) {
         $msg = "Cannot switch from state " . strtoupper(AssessmentItemSessionState::getNameByConstant($state)) . " to state SUSPENDED.";
         $code = AssessmentItemSessionException::STATE_VIOLATION;
         throw new AssessmentItemSessionException($msg, $this, $code);
     } else {
         $this->endAttempt(null, false);
         $this->setState(AssessmentItemSessionState::SUSPENDED);
     }
 }
 /**
  * Set the item session in INTERACTING state.
  * 
  * @throws AssessmentItemSessionException With code STATE_VIOLATION if the state of the session is not INITIAL nor SUSPENDED nor MODAL_FEEDBACK nor INTERACTING.
  */
 public function interact()
 {
     $state = $this->getState();
     if ($state !== AssessmentItemSessionState::INTERACTING) {
         if ($state !== AssessmentItemSessionState::INITIAL && $state !== AssessmentItemSessionState::SUSPENDED && $state !== AssessmentItemSessionState::MODAL_FEEDBACK) {
             $msg = "Cannot switch from state '" . AssessmentItemSessionState::getNameByConstant($state) . "' to state 'interacting'.";
             $code = AssessmentItemSessionException::STATE_VIOLATION;
             throw new AssessmentItemSessionException($msg, $this, $code);
         }
         $this->setState(AssessmentItemSessionState::INTERACTING);
         // Reset the time reference. If not, the time spent in SUSPENDED mode will be taken into account!
         $this->setTimeReference(new DateTime('now', new DateTimeZone('UTC')));
     }
 }