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 ()

	getLastStartedPass ()

	setLastStartedPass ($lastStartedPass)

	isObjectiveOriented ()

	persistTestStartLock ($testStartLock)

	lookupTestStartLock ()

	setAccessCodeToSession ($access_code)

	unsetAccessCodeInSession ()

	getAccessCodeFromSession ()

	doesAccessCodeInSessionExists ()

	createNewAccessCode ()

	isAccessCodeUsed ($code)

	isAnonymousUser ()

	reportableResultsAvailable (ilObjTest $testOBJ)

	hasSinglePassReportable (ilObjTest $testObj)

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

	$lastStartedPass

	$objectiveOrientedContainerId

	$reportableResultsAvailable = null

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.

@access public

Reimplemented in ilTestSessionDynamicQuestionSet.

Definition at line 96 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->lastStartedPass = null;
        $this->lastFinishedPass = null;
        $this->objectiveOrientedContainerId = 0;
    }

Member Function Documentation

◆ activeIDExists()

ilTestSession::activeIDExists	(	$user_id,
		$test_id
	)

protected

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

    {
        global $DIC;
        $ilDB = $DIC['ilDB'];
 
        if ($GLOBALS['DIC']['ilUser']->getId() != 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->setLastStartedPass($row['last_started_pass']);
                $this->setLastFinishedPass($row['last_finished_pass']);
                $this->setObjectiveOrientedContainerId((int) $row['objective_container']);
 
                return true;
            }
        }
        return false;
    }

References $DIC, $GLOBALS, $ilDB, $result, $test_id, $user_id, setLastFinishedPass(), setLastStartedPass(), and setObjectiveOrientedContainerId().

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

Here is the call graph for this function:

Here is the caller graph for this function:

◆ buildAccessCode()

ilTestSession::buildAccessCode ( )

private

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

    {
        // 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;
    }

References $i, $index, ACCESS_CODE_CHAR_DOMAIN, and ACCESS_CODE_LENGTH.

Referenced by createNewAccessCode().

Here is the caller graph for this function:

◆ createNewAccessCode()

ilTestSession::createNewAccessCode ( )

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

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

References buildAccessCode(), and isAccessCodeUsed().

Here is the call graph for this function:

◆ doesAccessCodeInSessionExists()

ilTestSession::doesAccessCodeInSessionExists ( )

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

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

References $_SESSION, and getTestId().

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

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getAccessCodeFromSession()

ilTestSession::getAccessCodeFromSession ( )

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

    {
        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()];
    }

References $_SESSION, ACCESS_CODE_SESSION_INDEX, and getTestId().

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

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getActiveId()

ilTestSession::getActiveId ( )

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

    {
        return $this->active_id;
    }

References $active_id.

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

Here is the caller graph for this function:

◆ getAnonymousId()

ilTestSession::getAnonymousId ( )

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

    {
        return $this->anonymous_id;
    }

References $anonymous_id.

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

Here is the caller graph for this function:

◆ getLastFinishedPass()

ilTestSession::getLastFinishedPass ( )

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

    {
        return $this->lastFinishedPass;
    }

References $lastFinishedPass.

Referenced by hasSinglePassReportable(), increaseTestPass(), and saveToDb().

Here is the caller graph for this function:

◆ getLastSequence()

ilTestSession::getLastSequence ( )

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

    {
        return $this->lastsequence;
    }

References $lastsequence.

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

Here is the caller graph for this function:

◆ getLastStartedPass()

ilTestSession::getLastStartedPass ( )

Returns: int

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

    {
        return $this->lastStartedPass;
    }

References $lastStartedPass.

Referenced by increaseTestPass().

Here is the caller graph for this function:

◆ getObjectiveOrientedContainerId()

ilTestSession::getObjectiveOrientedContainerId ( )

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

    {
        return $this->objectiveOrientedContainerId;
    }

References $objectiveOrientedContainerId.

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

Here is the caller graph for this function:

◆ getPass()

ilTestSession::getPass ( )

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

    {
        return $this->pass;
    }

References $pass.

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

Here is the caller graph for this function:

◆ getRefId()

ilTestSession::getRefId ( )

Get Ref id.

Returns: integer Ref id

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

    {
        return $this->ref_id;
    }

Referenced by ilLOTestQuestionAdapter\getInstance(), ilLOTestQuestionAdapter\isQualifiedStartRun(), ilLOTestQuestionAdapter\notifyTestStart(), and ilTestSessionDynamicQuestionSet\saveToDb().

Here is the caller graph for this function:

◆ getSubmittedTimestamp()

ilTestSession::getSubmittedTimestamp ( )

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

    {
        return $this->submittedTimestamp;
    }

References $submittedTimestamp.

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

Here is the caller graph for this function:

◆ getTestId()

ilTestSession::getTestId ( )

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

    {
        return $this->test_id;
    }

References $test_id.

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

Here is the caller graph for this function:

◆ getUserId()

ilTestSession::getUserId ( )

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

    {
        return $this->user_id;
    }

References $user_id.

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

Here is the caller graph for this function:

◆ hasSinglePassReportable()

ilTestSession::hasSinglePassReportable ( ilObjTest $testObj )

Returns: bool

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

    {
        global $DIC; /* @var ILIAS\DI\Container $DIC */
        
        require_once 'Modules/Test/classes/class.ilTestPassesSelector.php';
        $testPassesSelector = new ilTestPassesSelector($DIC->database(), $testObj);
        $testPassesSelector->setActiveId($this->getActiveId());
        $testPassesSelector->setLastFinishedPass($this->getLastFinishedPass());
        
        if (count($testPassesSelector->getReportablePasses()) == 1) {
            return true;
        }
        
        return false;
    }

References $DIC, getActiveId(), and getLastFinishedPass().

Here is the call graph for this function:

◆ increasePass()

ilTestSession::increasePass ( )

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

    {
        $this->pass += 1;
    }

Referenced by increaseTestPass().

Here is the caller graph for this function:

◆ increaseTestPass()

ilTestSession::increaseTestPass ( )

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

    {
        global $DIC;
        $ilDB = $DIC['ilDB'];
        $ilLog = $DIC['ilLog'];
        
        if (!$this->active_id) {
            require_once 'Modules/Test/exceptions/class.ilTestException.php';
            throw new ilTestException('missing active id on test pass increase!');
        }
 
        $this->increasePass();
        $this->setLastSequence(0);
        $submitted = ($this->isSubmitted()) ? 1 : 0;
        
        if (!isset($_SESSION[$this->active_id]['tst_last_increase_pass'])) {
            $_SESSION[$this->active_id]['tst_last_increase_pass'] = 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[$this->active_id]['tst_last_increase_pass'] > 10) {
            $_SESSION[$this->active_id]['tst_last_increase_pass'] = time();
            $this->tstamp = time();
            $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()),
                        'last_started_pass' => array('integer', $this->getLastStartedPass()),
                        'objective_container' => array('integer', (int) $this->getObjectiveOrientedContainerId())
                    ),
                array(
                        'active_id' => array('integer', $this->getActiveId())
                    )
                );
        }
    }

References $_SESSION, $active_id, $DIC, $ilDB, $ilLog, $submitted, getActiveId(), getLastFinishedPass(), getLastSequence(), getLastStartedPass(), getObjectiveOrientedContainerId(), getPass(), getSubmittedTimestamp(), increasePass(), isSubmitted(), and setLastSequence().

Here is the call graph for this function:

◆ isAccessCodeUsed()

ilTestSession::isAccessCodeUsed ( $code )

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

    {
        global $DIC;
        $ilDB = $DIC['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);
    }

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

Referenced by createNewAccessCode().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ isAnonymousUser()

ilTestSession::isAnonymousUser ( )

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

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

References getUserId().

Here is the call graph for this function:

◆ isObjectiveOriented()

ilTestSession::isObjectiveOriented ( )

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

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

References getObjectiveOrientedContainerId().

Here is the call graph for this function:

◆ isSubmitted()

ilTestSession::isSubmitted ( )

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

    {
        return $this->submitted;
    }

References $submitted.

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

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

Reimplemented in ilTestSessionDynamicQuestionSet.

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

    {
        global $DIC;
        $ilDB = $DIC['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->setLastStartedPass($row['last_started_pass']);
            $this->setLastFinishedPass($row['last_finished_pass']);
            $this->setObjectiveOrientedContainerId((int) $row['objective_container']);
        }
    }

References $active_id, $DIC, $ilDB, $result, setLastFinishedPass(), setLastStartedPass(), and setObjectiveOrientedContainerId().

Here is the call graph for this function:

◆ loadTestSession()

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

Reimplemented in ilTestSessionDynamicQuestionSet.

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

    {
        global $DIC;
        $ilDB = $DIC['ilDB'];
        $ilUser = $DIC['ilUser'];
 
        if (!$user_id) {
            $user_id = $ilUser->getId();
        }
        if (($GLOBALS['DIC']['ilUser']->getId() == 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())
            );
        } elseif (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 ($GLOBALS['DIC']['ilUser']->getId() == 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)
            );
        }
 
        // TODO bheyser: Refactor
        $this->user_id = $user_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->setLastStartedPass($row['last_started_pass']);
            $this->setLastFinishedPass($row['last_finished_pass']);
            $this->setObjectiveOrientedContainerId((int) $row['objective_container']);
        } elseif ($this->doesAccessCodeInSessionExists()) {
            $this->unsetAccessCodeInSession();
        }
    }

References $anonymous_id, $DIC, $GLOBALS, $ilDB, $ilUser, $result, $test_id, $user_id, doesAccessCodeInSessionExists(), getAccessCodeFromSession(), setLastFinishedPass(), setLastStartedPass(), setObjectiveOrientedContainerId(), and unsetAccessCodeInSession().

Here is the call graph for this function:

◆ lookupTestStartLock()

ilTestSession::lookupTestStartLock ( )

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

    {
        global $DIC;
        $ilDB = $DIC['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;
    }

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

Here is the call graph for this function:

◆ persistTestStartLock()

ilTestSession::persistTestStartLock ( $testStartLock )

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

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

References $DIC, $ilDB, and getActiveId().

Here is the call graph for this function:

◆ reportableResultsAvailable()

ilTestSession::reportableResultsAvailable ( ilObjTest $testOBJ )

Parameters

ilObjTest $testOBJ

Returns: bool

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

    {
        if ($this->reportableResultsAvailable === null) {
            $this->reportableResultsAvailable = true;
            
            if (!$this->getActiveId()) {
                $this->reportableResultsAvailable = false;
            }
            
            if (!$testOBJ->canShowTestResults($this)) {
                $this->reportableResultsAvailable = false;
            }
        }
        
        return $this->reportableResultsAvailable;
    }

References $reportableResultsAvailable, ilObjTest\canShowTestResults(), getActiveId(), and reportableResultsAvailable().

Referenced by reportableResultsAvailable().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ saveToDb()

ilTestSession::saveToDb ( )

Reimplemented in ilTestSessionDynamicQuestionSet.

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

    {
        global $DIC;
        $ilDB = $DIC['ilDB'];
        $ilLog = $DIC['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()),
                    'last_started_pass' => array('integer', $this->getPass()),
                    'objective_container' => array('integer', (int) $this->getObjectiveOrientedContainerId())
                ),
                array(
                    'active_id' => array('integer', $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()),
                        'last_started_pass' => array('integer', $this->getPass()),
                        'objective_container' => array('integer', (int) $this->getObjectiveOrientedContainerId())
                    )
                );
                $this->active_id = $next_id;
            }
        }
    }

References $anonymous_id, $DIC, $ilDB, $ilLog, $submitted, activeIDExists(), getActiveId(), getAnonymousId(), getLastFinishedPass(), getLastSequence(), getObjectiveOrientedContainerId(), getPass(), getSubmittedTimestamp(), getTestId(), getUserId(), and isSubmitted().

Here is the call graph for this function:

◆ setAccessCodeToSession()

ilTestSession::setAccessCodeToSession ( $access_code )

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

    {
        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;
    }

References $_SESSION, ACCESS_CODE_SESSION_INDEX, and getTestId().

Here is the call graph for this function:

◆ setAnonymousId()

ilTestSession::setAnonymousId ( $anonymous_id )

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

    {
        $this->anonymous_id = $anonymous_id;
    }

References $anonymous_id.

◆ setLastFinishedPass()

ilTestSession::setLastFinishedPass ( $lastFinishedPass )

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

    {
        $this->lastFinishedPass = $lastFinishedPass;
    }

References $lastFinishedPass.

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

Here is the caller graph for this function:

◆ setLastSequence()

ilTestSession::setLastSequence ( $lastsequence )

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

    {
        $this->lastsequence = $lastsequence;
    }

References $lastsequence.

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

Here is the caller graph for this function:

◆ setLastStartedPass()

ilTestSession::setLastStartedPass ( $lastStartedPass )

Parameters

int $lastStartedPass

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

    {
        $this->lastStartedPass = $lastStartedPass;
    }

References $lastStartedPass.

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

Here is the caller graph for this function:

◆ setObjectiveOrientedContainerId()

ilTestSession::setObjectiveOrientedContainerId ( $objectiveOriented )

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

    {
        $this->objectiveOrientedContainerId = $objectiveOriented;
    }

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

Here is the caller graph for this function:

◆ setPass()

ilTestSession::setPass ( $pass )

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

    {
        $this->pass = $pass;
    }

References $pass.

◆ setRefId()

ilTestSession::setRefId ( $a_val )

Set Ref id.

Parameters

integer Ref id

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

    {
        $this->ref_id = $a_val;
    }

◆ setSubmitted()

ilTestSession::setSubmitted ( )

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

    {
        $this->submitted = true;
    }

◆ setSubmittedTimestamp()

ilTestSession::setSubmittedTimestamp ( )

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

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

◆ setTestId()

ilTestSession::setTestId ( $test_id )

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

    {
        $this->test_id = $test_id;
    }

References $test_id.

◆ setUserId()

ilTestSession::setUserId ( $user_id )

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

    {
        $this->user_id = $user_id;
    }

References $user_id.

◆ unsetAccessCodeInSession()

ilTestSession::unsetAccessCodeInSession ( )

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

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

References $_SESSION, and getTestId().

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

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(), increaseTestPass(), loadFromDb(), and ilTestSessionDynamicQuestionSet\loadFromDb().

◆ $anonymous_id

ilTestSession::$anonymous_id

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

Referenced by getAnonymousId(), loadTestSession(), ilTestSessionDynamicQuestionSet\loadTestSession(), saveToDb(), 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().

◆ $lastStartedPass

ilTestSession::$lastStartedPass

private

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

Referenced by getLastStartedPass(), and setLastStartedPass().

◆ $objectiveOrientedContainerId

ilTestSession::$objectiveOrientedContainerId

private

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

Referenced by getObjectiveOrientedContainerId().

◆ $reportableResultsAvailable

ilTestSession::$reportableResultsAvailable = null

private

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

Referenced by reportableResultsAvailable().

◆ $submitted

ilTestSession::$submitted

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

Referenced by increaseTestPass(), isSubmitted(), saveToDb(), 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 activeIDExists(), getTestId(), loadTestSession(), 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 activeIDExists(), getUserId(), loadTestSession(), ilTestSessionDynamicQuestionSet\loadTestSession(), and setUserId().

◆ ACCESS_CODE_CHAR_DOMAIN

const ilTestSession::ACCESS_CODE_CHAR_DOMAIN = "0123456789abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ"

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

Referenced by buildAccessCode().

◆ ACCESS_CODE_LENGTH

const ilTestSession::ACCESS_CODE_LENGTH = 5

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

Referenced by buildAccessCode().

◆ ACCESS_CODE_SESSION_INDEX

const ilTestSession::ACCESS_CODE_SESSION_INDEX = "tst_access_code"

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

Referenced by getAccessCodeFromSession(), and setAccessCodeToSession().

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()

◆ getLastStartedPass()

◆ getObjectiveOrientedContainerId()

◆ getPass()

◆ getRefId()

◆ getSubmittedTimestamp()

◆ getTestId()

◆ getUserId()

◆ hasSinglePassReportable()

◆ increasePass()

◆ increaseTestPass()

◆ isAccessCodeUsed()

◆ isAnonymousUser()

◆ isObjectiveOriented()

◆ isSubmitted()

◆ loadFromDb()

◆ loadTestSession()

◆ lookupTestStartLock()

◆ persistTestStartLock()

◆ reportableResultsAvailable()

◆ saveToDb()

◆ setAccessCodeToSession()

◆ setAnonymousId()

◆ setLastFinishedPass()

◆ setLastSequence()

◆ setLastStartedPass()

◆ setObjectiveOrientedContainerId()

◆ setPass()

◆ setRefId()

◆ setSubmitted()

◆ setSubmittedTimestamp()

◆ setTestId()

◆ setUserId()

◆ unsetAccessCodeInSession()

Field Documentation

◆ $active_id

◆ $anonymous_id

◆ $lastFinishedPass

◆ $lastPresentationMode

◆ $lastsequence

◆ $lastStartedPass

◆ $objectiveOrientedContainerId

◆ $reportableResultsAvailable

◆ $submitted

◆ $submittedTimestamp

◆ $test_id

◆ $tstamp

◆ $user_id

◆ ACCESS_CODE_CHAR_DOMAIN

◆ ACCESS_CODE_LENGTH

◆ ACCESS_CODE_SESSION_INDEX