Test session handler. More...

Inheritance diagram for ilTestSession:

Collaboration diagram for ilTestSession:

Public Member Functions
	__construct ()
	ilTestSession constructor More...

	setRefId ($a_val)
	Set Ref id. More...

	getRefId ()
	Get Ref id. More...

	increaseTestPass ()

	saveToDb ()

	loadTestSession ($test_id, $user_id="", $anonymous_id="")

	loadFromDb ($active_id)
	Loads the session data for a given active id. More...

	getActiveId ()

	setUserId ($user_id)

	getUserId ()

	setTestId ($test_id)

	getTestId ()

	setAnonymousId ($anonymous_id)

	getAnonymousId ()

	setLastSequence ($lastsequence)

	getLastSequence ()

	setPass ($pass)

	getPass ()

	increasePass ()

	isSubmitted ()

	setSubmitted ()

	getSubmittedTimestamp ()

	setSubmittedTimestamp ()

	setLastFinishedPass ($lastFinishedPass)

	getLastFinishedPass ()

	setObjectiveOrientedContainerId ($objectiveOriented)

	getObjectiveOrientedContainerId ()

	isObjectiveOriented ()

	persistTestStartLock ($testStartLock)

	lookupTestStartLock ()

	setAccessCodeToSession ($access_code)

	unsetAccessCodeInSession ()

	getAccessCodeFromSession ()

	doesAccessCodeInSessionExists ()

	createNewAccessCode ()

	isAccessCodeUsed ($code)

	isAnonymousUser ()

Data Fields
const	ACCESS_CODE_SESSION_INDEX = "tst_access_code"

const	ACCESS_CODE_CHAR_DOMAIN = "0123456789abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ"

const	ACCESS_CODE_LENGTH = 5

	$active_id

	$user_id

	$anonymous_id

	$test_id

	$lastsequence

	$submitted

	$tstamp

	$submittedTimestamp

Protected Member Functions
	activeIDExists ($user_id, $test_id)

Protected Attributes
	$lastPresentationMode

Private Member Functions
	buildAccessCode ()

Private Attributes
	$lastFinishedPass

	$objectiveOrientedContainerId

Detailed Description

Test session handler.

This class manages the test session for a participant

Author: Helmut Schottmüller helmu.nosp@m.t.sc.nosp@m.hottm.nosp@m.uell.nosp@m.er@ma.nosp@m.c.co.nosp@m.m

Version: $Id$

Definition at line 13 of file class.ilTestSession.php.

Constructor & Destructor Documentation

◆ __construct()

ilTestSession::__construct ( )

ilTestSession constructor

The constructor takes possible arguments an creates an instance of the ilTestSession object.

public

Definition at line 94 of file class.ilTestSession.php.

         {
                 $this->active_id = 0;
                 $this->user_id = 0;
                 $this->anonymous_id = 0;
                 $this->test_id = 0;
                 $this->lastsequence = 0;
                 $this->lastPresentationMode = null;
                 $this->submitted = FALSE;
                 $this->submittedTimestamp = "";
                 $this->pass = 0;
                 $this->ref_id = 0;
                 $this->tstamp = 0;
 
                 $this->lastFinishedPass = null;
                 $this->objectiveOrientedContainerId = 0;
         }

Member Function Documentation

◆ activeIDExists()

ilTestSession::activeIDExists	(	$user_id,
		$test_id
	)

protected

Definition at line 132 of file class.ilTestSession.php.

References $_SESSION, $ilDB, $result, $row, setLastFinishedPass(), and setObjectiveOrientedContainerId().

Referenced by increaseTestPass(), ilTestSessionDynamicQuestionSet\saveToDb(), and saveToDb().

         {
                 global $ilDB;
 
                 if ($_SESSION["AccountId"] != ANONYMOUS_USER_ID)
                 {
                         $result = $ilDB->queryF("SELECT * FROM tst_active WHERE user_fi = %s AND test_fi = %s",
                                 array('integer','integer'),
                                 array($user_id, $test_id)
                         );
                         if ($result->numRows())
                         {
                                 $row = $ilDB->fetchAssoc($result);
                                 $this->active_id = $row["active_id"];
                                 $this->user_id = $row["user_fi"];
                                 $this->anonymous_id = $row["anonymous_id"];
                                 $this->test_id = $row["test_fi"];
                                 $this->lastsequence = $row["lastindex"];
                                 $this->pass = $row["tries"];
                                 $this->submitted = ($row["submitted"]) ? TRUE : FALSE;
                                 $this->submittedTimestamp = $row["submittimestamp"];
                                 $this->tstamp = $row["tstamp"];
 
                                 $this->setLastFinishedPass($row['last_finished_pass']);
                                 $this->setObjectiveOrientedContainerId((int)$row['objective_container']);
 
                                 return true;
                         }
                 }
                 return false;
         }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ buildAccessCode()

ilTestSession::buildAccessCode ( )

private

Definition at line 582 of file class.ilTestSession.php.

References $code.

Referenced by createNewAccessCode().

         {
                 // create a 5 character code
                 $codestring = self::ACCESS_CODE_CHAR_DOMAIN;
 
                 mt_srand();
 
                 $code = "";
 
                 for($i = 1; $i <= self::ACCESS_CODE_LENGTH; $i++)
                 {
                         $index = mt_rand(0, strlen($codestring)-1);
                         $code .= substr($codestring, $index, 1);
                 }
 
                 return $code;
         }

Here is the caller graph for this function:

◆ createNewAccessCode()

ilTestSession::createNewAccessCode ( )

Definition at line 558 of file class.ilTestSession.php.

References $code, buildAccessCode(), and isAccessCodeUsed().

         {
                 do
                 {
                         $code = $this->buildAccessCode();
                 }
                 while( $this->isAccessCodeUsed($code) );
 
                 return $code;
         }

Here is the call graph for this function:

◆ doesAccessCodeInSessionExists()

ilTestSession::doesAccessCodeInSessionExists ( )

Definition at line 548 of file class.ilTestSession.php.

References $_SESSION, and getTestId().

Referenced by ilTestPlayerAbstractGUI\ensureExistingTestSession(), ilTestSessionDynamicQuestionSet\loadTestSession(), and loadTestSession().

         {
                 if( !is_array($_SESSION[self::ACCESS_CODE_SESSION_INDEX]) )
                 {
                         return false;
                 }
 
                 return isset($_SESSION[self::ACCESS_CODE_SESSION_INDEX][$this->getTestId()]);
         }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getAccessCodeFromSession()

ilTestSession::getAccessCodeFromSession ( )

Definition at line 533 of file class.ilTestSession.php.

References $_SESSION, and getTestId().

Referenced by ilTestPlayerAbstractGUI\ensureExistingTestSession(), ilTestSessionDynamicQuestionSet\loadTestSession(), and loadTestSession().

         {
                 if( !is_array($_SESSION[self::ACCESS_CODE_SESSION_INDEX]) )
                 {
                         return null;
                 }
 
                 if( !isset($_SESSION[self::ACCESS_CODE_SESSION_INDEX][$this->getTestId()]) )
                 {
                         return null;
                 }
 
                 return $_SESSION[self::ACCESS_CODE_SESSION_INDEX][$this->getTestId()];
         }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getActiveId()

ilTestSession::getActiveId ( )

Definition at line 385 of file class.ilTestSession.php.

References $active_id.

Referenced by ilTestService\buildVirtualSequence(), ilTestPlayerAbstractGUI\ensureExistingTestSession(), ilTestServiceGUI\getPassOverviewTableData(), ilTestPlayerAbstractGUI\handleSkillTriggering(), increaseTestPass(), lookupTestStartLock(), persistTestStartLock(), ilTestSessionDynamicQuestionSet\saveToDb(), saveToDb(), ilTestRandomQuestionSetBuilder\storeQuestion(), and ilLOTestQuestionAdapter\updateQuestionResult().

         {
                 return $this->active_id;
         }

Here is the caller graph for this function:

◆ getAnonymousId()

ilTestSession::getAnonymousId ( )

Definition at line 415 of file class.ilTestSession.php.

References $anonymous_id.

Referenced by increaseTestPass(), ilTestSessionDynamicQuestionSet\saveToDb(), and saveToDb().

         {
                 return $this->anonymous_id;
         }

Here is the caller graph for this function:

◆ getLastFinishedPass()

ilTestSession::getLastFinishedPass ( )

Definition at line 470 of file class.ilTestSession.php.

References $lastFinishedPass.

Referenced by increaseTestPass(), and saveToDb().

         {
                 return $this->lastFinishedPass;
         }

Here is the caller graph for this function:

◆ getLastSequence()

ilTestSession::getLastSequence ( )

Definition at line 425 of file class.ilTestSession.php.

References $lastsequence.

Referenced by ilTestSessionDynamicQuestionSet\getCurrentQuestionId(), ilTestSequence\hasStarted(), increaseTestPass(), ilTestSessionDynamicQuestionSet\saveToDb(), and saveToDb().

         {
                 return $this->lastsequence;
         }

Here is the caller graph for this function:

◆ getObjectiveOrientedContainerId()

ilTestSession::getObjectiveOrientedContainerId ( )

Definition at line 480 of file class.ilTestSession.php.

References $objectiveOrientedContainerId.

Referenced by ilLOTestQuestionAdapter\getInstance(), increaseTestPass(), isObjectiveOriented(), ilLOTestQuestionAdapter\notifyTestStart(), and saveToDb().

         {
                 return $this->objectiveOrientedContainerId;
         }

Here is the caller graph for this function:

◆ getPass()

ilTestSession::getPass ( )

Definition at line 435 of file class.ilTestSession.php.

References $pass.

Referenced by ilTestPlayerAbstractGUI\handleSkillTriggering(), increaseTestPass(), ilTestSessionDynamicQuestionSet\saveToDb(), saveToDb(), ilTestRandomQuestionSetBuilder\storeQuestion(), and ilLOTestQuestionAdapter\updateQuestionResult().

         {
                 return $this->pass;
         }

Here is the caller graph for this function:

◆ getRefId()

ilTestSession::getRefId ( )

Get Ref id.

Returns: integer Ref id

Definition at line 127 of file class.ilTestSession.php.

References $ref_id.

Referenced by ilLOTestQuestionAdapter\getInstance(), ilLOTestQuestionAdapter\initTestRun(), ilLOTestQuestionAdapter\initUserResult(), ilLOTestQuestionAdapter\isQualifiedStartRun(), ilLOTestQuestionAdapter\notifyTestStart(), ilTestSessionDynamicQuestionSet\saveToDb(), saveToDb(), ilLOTestQuestionAdapter\updateFixedQuestions(), ilLOTestQuestionAdapter\updateQuestionResult(), ilLOTestQuestionAdapter\updateQuestions(), and ilLOTestQuestionAdapter\updateRandomQuestions().

         {
                 return $this->ref_id;
         }

Here is the caller graph for this function:

◆ getSubmittedTimestamp()

ilTestSession::getSubmittedTimestamp ( )

Definition at line 455 of file class.ilTestSession.php.

References $submittedTimestamp.

Referenced by increaseTestPass(), ilTestSessionDynamicQuestionSet\saveToDb(), and saveToDb().

         {
                 return $this->submittedTimestamp;
         }

Here is the caller graph for this function:

◆ getTestId()

ilTestSession::getTestId ( )

Definition at line 405 of file class.ilTestSession.php.

References $test_id.

Referenced by doesAccessCodeInSessionExists(), getAccessCodeFromSession(), increaseTestPass(), isAccessCodeUsed(), ilTestSessionDynamicQuestionSet\saveToDb(), saveToDb(), setAccessCodeToSession(), and unsetAccessCodeInSession().

         {
                 return $this->test_id;
         }

Here is the caller graph for this function:

◆ getUserId()

ilTestSession::getUserId ( )

Definition at line 395 of file class.ilTestSession.php.

References $user_id.

Referenced by ilLOTestQuestionAdapter\getInstance(), ilTestPlayerAbstractGUI\handleSkillTriggering(), increaseTestPass(), isAnonymousUser(), ilLOTestQuestionAdapter\notifyTestStart(), ilTestSessionDynamicQuestionSet\saveToDb(), and saveToDb().

         {
                 return $this->user_id;
         }

Here is the caller graph for this function:

◆ increasePass()

ilTestSession::increasePass ( )

Definition at line 440 of file class.ilTestSession.php.

Referenced by increaseTestPass().

         {
                 $this->pass += 1;
         }

Here is the caller graph for this function:

◆ increaseTestPass()

ilTestSession::increaseTestPass ( )

Definition at line 164 of file class.ilTestSession.php.

References $_SESSION, $ilDB, $ilLog, ilObjTestAccess\_getParticipantId(), ilObjTestAccess\_lookupObjIdForTestId(), ilLPStatusWrapper\_updateStatus(), activeIDExists(), getActiveId(), getAnonymousId(), getLastFinishedPass(), getLastSequence(), getObjectiveOrientedContainerId(), getPass(), getSubmittedTimestamp(), getTestId(), getUserId(), increasePass(), isSubmitted(), and setLastSequence().

         {
                 global $ilDB, $ilLog;
 
                 $this->increasePass();
                 $this->setLastSequence(0);
                 $submitted = ($this->isSubmitted()) ? 1 : 0;
                 // there has to be at least 10 seconds between new test passes (to ensure that noone double clicks the finish button and increases the test pass by more than 1)
                 if (time() - $_SESSION['tst_last_increase_pass'] > 10)
                 {
                         $_SESSION['tst_last_increase_pass'] = time();
                         $this->tstamp = time();
                         if ($this->active_id > 0)
                         {
                                 $ilDB->update('tst_active',
                                         array(
                                                 'lastindex' => array('integer', $this->getLastSequence()),
                                                 'tries' => array('integer', $this->getPass()),
                                                 'submitted' => array('integer', $submitted),
                                                 'submittimestamp' => array('timestamp', strlen($this->getSubmittedTimestamp()) ? $this->getSubmittedTimestamp() : NULL),
                                                 'tstamp' => array('integer', time()),
                                                 'last_finished_pass' => array('integer', $this->getLastFinishedPass()),
                                                 'objective_container' => array('integer', (int)$this->getObjectiveOrientedContainerId())
                                         ),
                                         array(
                                                 'active_id' => array('integer', $this->getActiveId())
                                         )
                                 );
 
                                 // update learning progress
                                 include_once("./Modules/Test/classes/class.ilObjTestAccess.php");
                                 include_once("./Services/Tracking/classes/class.ilLPStatusWrapper.php");
                                 ilLPStatusWrapper::_updateStatus(ilObjTestAccess::_lookupObjIdForTestId($this->getTestId()),
                                         ilObjTestAccess::_getParticipantId($this->active_id));
                         }
                         else
                         {
                                 if (!$this->activeIDExists($this->getUserId(), $this->getTestId()))
                                 {
                                         $anonymous_id = ($this->getAnonymousId()) ? $this->getAnonymousId() : NULL;
                                         $submittedTs = (strlen($this->getSubmittedTimestamp())) ? $this->getSubmittedTimestamp() : NULL;
                                         $next_id = $ilDB->nextId('tst_active');
 
                                         $ilDB->insert('tst_active', array(
                                                 'active_id' => array('integer', $next_id),
                                                 'user_fi' => array('integer', $this->getUserId()),
                                                 'anonymous_id' => array('text', $anonymous_id),
                                                 'test_fi' => array('integer', $this->getTestId()),
                                                 'lastindex' => array('integer', $this->getLastSequence()),
                                                 'tries' => array('integer', $this->getPass()),
                                                 'submitted' => array('integer', $submitted),
                                                 'submittimestamp' => array('timestamp', $submittedTs),
                                                 'tstamp' => array('integer', time()),
                                                 'objective_container' => array('integer', (int)$this->getObjectiveOrientedContainerId()),
                                         ));
 
                                         $this->active_id = $next_id;
 
                                         // update learning progress
                                         include_once("./Modules/Test/classes/class.ilObjTestAccess.php");
                                         include_once("./Services/Tracking/classes/class.ilLPStatusWrapper.php");
                                         ilLPStatusWrapper::_updateStatus(ilObjTestAccess::_lookupObjIdForTestId($this->getTestId()),
                                                 $this->getUserId());
                                 }
                         }
                 }
         }

Here is the call graph for this function:

◆ isAccessCodeUsed()

ilTestSession::isAccessCodeUsed ( $code )

Definition at line 569 of file class.ilTestSession.php.

References $code, $ilDB, $query, $result, and getTestId().

Referenced by createNewAccessCode().

         {
                 global $ilDB;
                 
                 $query = "SELECT anonymous_id FROM tst_active WHERE test_fi = %s AND anonymous_id = %s";
 
                 $result = $ilDB->queryF(
                         $query, array('integer', 'text'), array($this->getTestId(), $code)
                 );
                 
                 return ($result->numRows() > 0);
         }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ isAnonymousUser()

ilTestSession::isAnonymousUser ( )

Definition at line 600 of file class.ilTestSession.php.

References getUserId().

Referenced by ilTestPlayerAbstractGUI\ensureExistingTestSession().

         {
                 return $this->getUserId() == ANONYMOUS_USER_ID;
         }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ isObjectiveOriented()

ilTestSession::isObjectiveOriented ( )

Definition at line 485 of file class.ilTestSession.php.

References getObjectiveOrientedContainerId().

         {
                 return (bool)$this->getObjectiveOrientedContainerId();
         }

Here is the call graph for this function:

◆ isSubmitted()

ilTestSession::isSubmitted ( )

Definition at line 445 of file class.ilTestSession.php.

References $submitted.

Referenced by increaseTestPass(), ilTestSessionDynamicQuestionSet\saveToDb(), and saveToDb().

         {
                 return $this->submitted;
         }

Here is the caller graph for this function:

◆ loadFromDb()

ilTestSession::loadFromDb ( $active_id )

Loads the session data for a given active id.

Parameters

integer $active_id The database id of the test session

Definition at line 360 of file class.ilTestSession.php.

References $ilDB, $result, $row, setLastFinishedPass(), and setObjectiveOrientedContainerId().

         {
                 global $ilDB;
                 $result = $ilDB->queryF("SELECT * FROM tst_active WHERE active_id = %s", 
                         array('integer'),
                         array($active_id)
                 );
                 if ($result->numRows())
                 {
                         $row = $ilDB->fetchAssoc($result);
                         $this->active_id = $row["active_id"];
                         $this->user_id = $row["user_fi"];
                         $this->anonymous_id = $row["anonymous_id"];
                         $this->test_id = $row["test_fi"];
                         $this->lastsequence = $row["lastindex"];
                         $this->pass = $row["tries"];
                         $this->submitted = ($row["submitted"]) ? TRUE : FALSE;
                         $this->submittedTimestamp = $row["submittimestamp"];
                         $this->tstamp = $row["tstamp"];
 
                         $this->setLastFinishedPass($row['last_finished_pass']);
                         $this->setObjectiveOrientedContainerId((int)$row['objective_container']);
                 }
         }

Here is the call graph for this function:

◆ loadTestSession()

ilTestSession::loadTestSession	(	$test_id,
		$user_id = `""`,
		$anonymous_id = `""`
	)

Definition at line 299 of file class.ilTestSession.php.

References $_SESSION, $ilDB, $ilUser, $result, $row, doesAccessCodeInSessionExists(), getAccessCodeFromSession(), setLastFinishedPass(), setObjectiveOrientedContainerId(), and unsetAccessCodeInSession().

         {
                 global $ilDB;
                 global $ilUser;
 
                 if (!$user_id)
                 {
                         $user_id = $ilUser->getId();
                 }
                 if (($_SESSION["AccountId"] == ANONYMOUS_USER_ID) && $this->doesAccessCodeInSessionExists())
                 {
                         $result = $ilDB->queryF("SELECT * FROM tst_active WHERE user_fi = %s AND test_fi = %s AND anonymous_id = %s",
                                 array('integer','integer','text'),
                                 array($user_id, $test_id, $this->getAccessCodeFromSession())
                         );
                 }
                 else if (strlen($anonymous_id))
                 {
                         $result = $ilDB->queryF("SELECT * FROM tst_active WHERE user_fi = %s AND test_fi = %s AND anonymous_id = %s",
                                 array('integer','integer','text'),
                                 array($user_id, $test_id, $anonymous_id)
                         );
                 }
                 else
                 {
                         if ($_SESSION["AccountId"] == ANONYMOUS_USER_ID)
                         {
                                 return NULL;
                         }
                         $result = $ilDB->queryF("SELECT * FROM tst_active WHERE user_fi = %s AND test_fi = %s",
                                 array('integer','integer'),
                                 array($user_id, $test_id)
                         );
                 }
                 if ($result->numRows())
                 {
                         $row = $ilDB->fetchAssoc($result);
                         $this->active_id = $row["active_id"];
                         $this->user_id = $row["user_fi"];
                         $this->anonymous_id = $row["anonymous_id"];
                         $this->test_id = $row["test_fi"];
                         $this->lastsequence = $row["lastindex"];
                         $this->pass = $row["tries"];
                         $this->submitted = ($row["submitted"]) ? TRUE : FALSE;
                         $this->submittedTimestamp = $row["submittimestamp"];
                         $this->tstamp = $row["tstamp"];
 
                         $this->setLastFinishedPass($row['last_finished_pass']);
                         $this->setObjectiveOrientedContainerId((int)$row['objective_container']);
                 }
                 elseif( $this->doesAccessCodeInSessionExists() )
                 {
                         $this->unsetAccessCodeInSession();
                 }
         }

Here is the call graph for this function:

◆ lookupTestStartLock()

ilTestSession::lookupTestStartLock ( )

Definition at line 501 of file class.ilTestSession.php.

References $ilDB, $res, $row, and getActiveId().

         {
                 global $ilDB;
                 
                 $res = $ilDB->queryF(
                         "SELECT start_lock FROM tst_active WHERE active_id = %s",
                         array('integer'), array($this->getActiveId())
                 );
                 
                 while($row = $ilDB->fetchAssoc($res))
                 {
                         return $row['start_lock'];
                 }
                 
                 return null;
         }

Here is the call graph for this function:

◆ persistTestStartLock()

ilTestSession::persistTestStartLock ( $testStartLock )

Definition at line 490 of file class.ilTestSession.php.

References $ilDB, and getActiveId().

         {
                 global $ilDB;
 
                 $ilDB->update(
                         'tst_active',
                         array('start_lock' => array('text', $testStartLock)),
                         array('active_id' => array('integer', $this->getActiveId()))
                 );
         }

Here is the call graph for this function:

◆ saveToDb()

ilTestSession::saveToDb ( )

Definition at line 232 of file class.ilTestSession.php.

References $ilDB, $ilLog, ilObjTestAccess\_getParticipantId(), ilObjTestAccess\_lookupObjIdForTestId(), ilLearningProgress\_tracProgress(), ilLPStatusWrapper\_updateStatus(), activeIDExists(), getActiveId(), getAnonymousId(), getLastFinishedPass(), getLastSequence(), getObjectiveOrientedContainerId(), getPass(), getRefId(), getSubmittedTimestamp(), getTestId(), getUserId(), and isSubmitted().

Referenced by ilTestPlayerAbstractGUI\ensureExistingTestSession().

         {
                 global $ilDB, $ilLog;
                 
                 $submitted = ($this->isSubmitted()) ? 1 : 0;
                 if ($this->active_id > 0)
                 {
                         $ilDB->update('tst_active',
                                 array(
                                         'lastindex' => array('integer', $this->getLastSequence()),
                                         'tries' => array('integer', $this->getPass()),
                                         'submitted' => array('integer', $submitted),
                                         'submittimestamp' => array('timestamp', (strlen($this->getSubmittedTimestamp())) ? $this->getSubmittedTimestamp() : NULL),
                                         'tstamp' => array('integer', time()-10),
                                         'last_finished_pass' => array('integer', $this->getLastFinishedPass()),
                                         'objective_container' => array('integer', (int)$this->getObjectiveOrientedContainerId())
                                 ),
                                 array(
                                         'active_id' => array('integer', $this->getActiveId())
                                 )
                         );
 
                         // update learning progress
                         include_once("./Modules/Test/classes/class.ilObjTestAccess.php");
                         include_once("./Services/Tracking/classes/class.ilLPStatusWrapper.php");
                         ilLPStatusWrapper::_updateStatus(ilObjTestAccess::_lookupObjIdForTestId($this->getTestId()),
                                 ilObjTestAccess::_getParticipantId($this->getActiveId()));
                 }
                 else
                 {
                         if (!$this->activeIDExists($this->getUserId(), $this->getTestId()))
                         {
                                 $anonymous_id = ($this->getAnonymousId()) ? $this->getAnonymousId() : NULL;
 
                                 $next_id = $ilDB->nextId('tst_active');
                                 $ilDB->insert('tst_active',
                                         array(
                                                 'active_id' => array('integer', $next_id),
                                                 'user_fi' => array('integer', $this->getUserId()),
                                                 'anonymous_id' => array('text', $anonymous_id),
                                                 'test_fi' => array('integer', $this->getTestId()),
                                                 'lastindex' => array('integer', $this->getLastSequence()),
                                                 'tries' => array('integer', $this->getPass()),
                                                 'submitted' => array('integer', $submitted),
                                                 'submittimestamp' => array('timestamp', (strlen($this->getSubmittedTimestamp())) ? $this->getSubmittedTimestamp() : NULL),
                                                 'tstamp' => array('integer', time()-10),
                                                 'last_finished_pass' => array('integer', $this->getLastFinishedPass()),
                                                 'objective_container' => array('integer', (int)$this->getObjectiveOrientedContainerId())
                                         )
                                 );
                                 $this->active_id = $next_id;
 
                                 // update learning progress
                                 include_once("./Modules/Test/classes/class.ilObjTestAccess.php");
                                 include_once("./Services/Tracking/classes/class.ilLPStatusWrapper.php");
                                 ilLPStatusWrapper::_updateStatus(ilObjTestAccess::_lookupObjIdForTestId($this->getTestId()),
                                         $this->getUserId());
                         }
                 }
                 include_once './Modules/Test/classes/class.ilObjTestAccess.php';
                 include_once("./Services/Tracking/classes/class.ilLearningProgress.php");
                 ilLearningProgress::_tracProgress($this->getUserId(),
                                                                                   ilObjTestAccess::_lookupObjIdForTestId($this->getTestId()),
                                                                                   $this->getRefId(),
                                                                                   'tst');
         }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ setAccessCodeToSession()

ilTestSession::setAccessCodeToSession ( $access_code )

Definition at line 518 of file class.ilTestSession.php.

References $_SESSION, and getTestId().

         {
                 if (!is_array($_SESSION[self::ACCESS_CODE_SESSION_INDEX]))
                 {
                         $_SESSION[self::ACCESS_CODE_SESSION_INDEX] = array();
                 }
                 
                 $_SESSION[self::ACCESS_CODE_SESSION_INDEX][$this->getTestId()] = $access_code;
         }

Here is the call graph for this function:

◆ setAnonymousId()

ilTestSession::setAnonymousId ( $anonymous_id )

Definition at line 410 of file class.ilTestSession.php.

References $anonymous_id.

Referenced by ilTestPlayerAbstractGUI\ensureExistingTestSession().

         {
                 $this->anonymous_id = $anonymous_id;
         }

Here is the caller graph for this function:

◆ setLastFinishedPass()

ilTestSession::setLastFinishedPass ( $lastFinishedPass )

Definition at line 465 of file class.ilTestSession.php.

References $lastFinishedPass.

Referenced by activeIDExists(), loadFromDb(), and loadTestSession().

         {
                 $this->lastFinishedPass = $lastFinishedPass;
         }

Here is the caller graph for this function:

◆ setLastSequence()

ilTestSession::setLastSequence ( $lastsequence )

Definition at line 420 of file class.ilTestSession.php.

References $lastsequence.

Referenced by increaseTestPass(), and ilTestSessionDynamicQuestionSet\setCurrentQuestionId().

         {
                 $this->lastsequence = $lastsequence;
         }

Here is the caller graph for this function:

◆ setObjectiveOrientedContainerId()

ilTestSession::setObjectiveOrientedContainerId ( $objectiveOriented )

Definition at line 475 of file class.ilTestSession.php.

Referenced by activeIDExists(), loadFromDb(), and loadTestSession().

         {
                 $this->objectiveOrientedContainerId = $objectiveOriented;
         }

Here is the caller graph for this function:

◆ setPass()

ilTestSession::setPass ( $pass )

Definition at line 430 of file class.ilTestSession.php.

References $pass.

         {
                 $this->pass = $pass;
         }

◆ setRefId()

ilTestSession::setRefId ( $a_val )

Set Ref id.

Parameters

integer Ref id

Definition at line 117 of file class.ilTestSession.php.

         {
                 $this->ref_id = $a_val;
         }

◆ setSubmitted()

ilTestSession::setSubmitted ( )

Definition at line 450 of file class.ilTestSession.php.

         {
                 $this->submitted = TRUE;
         }

◆ setSubmittedTimestamp()

ilTestSession::setSubmittedTimestamp ( )

Definition at line 460 of file class.ilTestSession.php.

         {
                 $this->submittedTimestamp = strftime("%Y-%m-%d %H:%M:%S");
         }

◆ setTestId()

ilTestSession::setTestId ( $test_id )

Definition at line 400 of file class.ilTestSession.php.

References $test_id.

         {
                 $this->test_id = $test_id;
         }

◆ setUserId()

ilTestSession::setUserId ( $user_id )

Definition at line 390 of file class.ilTestSession.php.

References $user_id.

Referenced by ilTestPlayerAbstractGUI\ensureExistingTestSession().

         {
                 $this->user_id = $user_id;
         }

Here is the caller graph for this function:

◆ unsetAccessCodeInSession()

ilTestSession::unsetAccessCodeInSession ( )

Definition at line 528 of file class.ilTestSession.php.

References $_SESSION, and getTestId().

Referenced by ilTestSessionDynamicQuestionSet\loadTestSession(), and loadTestSession().

         {
                 unset($_SESSION[self::ACCESS_CODE_SESSION_INDEX][$this->getTestId()]);
         }

Here is the call graph for this function:

Here is the caller graph for this function:

Field Documentation

◆ $active_id

ilTestSession::$active_id

Definition at line 26 of file class.ilTestSession.php.

Referenced by getActiveId(), and ilTestSessionDynamicQuestionSet\loadFromDb().

◆ $anonymous_id

ilTestSession::$anonymous_id

Definition at line 40 of file class.ilTestSession.php.

Referenced by getAnonymousId(), ilTestSessionDynamicQuestionSet\loadTestSession(), ilTestSessionDynamicQuestionSet\saveToDb(), and setAnonymousId().

◆ $lastFinishedPass

ilTestSession::$lastFinishedPass

private

Definition at line 82 of file class.ilTestSession.php.

Referenced by getLastFinishedPass(), and setLastFinishedPass().

◆ $lastPresentationMode

ilTestSession::$lastPresentationMode

protected

Definition at line 59 of file class.ilTestSession.php.

◆ $lastsequence

ilTestSession::$lastsequence

Definition at line 54 of file class.ilTestSession.php.

Referenced by getLastSequence(), and setLastSequence().

◆ $objectiveOrientedContainerId

ilTestSession::$objectiveOrientedContainerId

private

Definition at line 84 of file class.ilTestSession.php.

Referenced by getObjectiveOrientedContainerId().

◆ $submitted

ilTestSession::$submitted

Definition at line 66 of file class.ilTestSession.php.

Referenced by isSubmitted(), and ilTestSessionDynamicQuestionSet\saveToDb().

◆ $submittedTimestamp

ilTestSession::$submittedTimestamp

Definition at line 80 of file class.ilTestSession.php.

Referenced by getSubmittedTimestamp().

◆ $test_id

ilTestSession::$test_id

Definition at line 47 of file class.ilTestSession.php.

Referenced by getTestId(), ilTestSessionDynamicQuestionSet\loadTestSession(), and setTestId().

◆ $tstamp

ilTestSession::$tstamp

Definition at line 73 of file class.ilTestSession.php.

◆ $user_id

ilTestSession::$user_id

Definition at line 33 of file class.ilTestSession.php.

Referenced by getUserId(), ilTestSessionDynamicQuestionSet\loadTestSession(), and setUserId().

◆ ACCESS_CODE_CHAR_DOMAIN

const ilTestSession::ACCESS_CODE_CHAR_DOMAIN = "0123456789abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ"

Definition at line 17 of file class.ilTestSession.php.

◆ ACCESS_CODE_LENGTH

const ilTestSession::ACCESS_CODE_LENGTH = 5

Definition at line 19 of file class.ilTestSession.php.

◆ ACCESS_CODE_SESSION_INDEX

const ilTestSession::ACCESS_CODE_SESSION_INDEX = "tst_access_code"

Definition at line 15 of file class.ilTestSession.php.

The documentation for this class was generated from the following file:

Modules/Test/classes/class.ilTestSession.php

Public Member Functions

Data Fields

Protected Member Functions

Protected Attributes

Private Member Functions

Private Attributes

Detailed Description

Constructor & Destructor Documentation

◆ __construct()

Member Function Documentation

◆ activeIDExists()

◆ buildAccessCode()

◆ createNewAccessCode()

◆ doesAccessCodeInSessionExists()

◆ getAccessCodeFromSession()

◆ getActiveId()

◆ getAnonymousId()

◆ getLastFinishedPass()

◆ getLastSequence()

◆ getObjectiveOrientedContainerId()

◆ getPass()

◆ getRefId()

◆ getSubmittedTimestamp()

◆ getTestId()

◆ getUserId()

◆ increasePass()

◆ increaseTestPass()

◆ isAccessCodeUsed()

◆ isAnonymousUser()

◆ isObjectiveOriented()

◆ isSubmitted()

◆ loadFromDb()

◆ loadTestSession()

◆ lookupTestStartLock()

◆ persistTestStartLock()

◆ saveToDb()

◆ setAccessCodeToSession()

◆ setAnonymousId()

◆ setLastFinishedPass()

◆ setLastSequence()

◆ setObjectiveOrientedContainerId()

◆ setPass()

◆ setRefId()

◆ setSubmitted()

◆ setSubmittedTimestamp()

◆ setTestId()

◆ setUserId()

◆ unsetAccessCodeInSession()

Field Documentation

◆ $active_id

◆ $anonymous_id

◆ $lastFinishedPass

◆ $lastPresentationMode

◆ $lastsequence

◆ $objectiveOrientedContainerId

◆ $submitted

◆ $submittedTimestamp

◆ $test_id

◆ $tstamp

◆ $user_id

◆ ACCESS_CODE_CHAR_DOMAIN

◆ ACCESS_CODE_LENGTH

◆ ACCESS_CODE_SESSION_INDEX