This file is part of ILIAS, a powerful learning management system published by ILIAS open source e-Learning e.V. More...

Inheritance diagram for ilTestSession:

Collaboration diagram for ilTestSession:

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

	setRefId (int $a_val)

	getRefId ()

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

	isPasswordChecked ()

	setPasswordChecked (bool $value)

	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

int	$active_id

int	$user_id

	$anonymous_id = null

int	$test_id

int	$lastsequence

bool	$submitted

int	$tstamp

string	$submittedTimestamp

Protected Member Functions
	activeIDExists ($user_id, $test_id)

Protected Attributes
string	$lastPresentationMode

Private Member Functions
	buildAccessCode ()

Private Attributes
int	$ref_id

int	$pass

int	$objectiveOrientedContainerId

	$lastFinishedPass

	$lastStartedPass

	$reportableResultsAvailable = null

Detailed Description

This file is part of ILIAS, a powerful learning management system published by ILIAS open source e-Learning e.V.

ILIAS is licensed with the GPL-3.0, see https://www.gnu.org/licenses/gpl-3.0.en.html You should have received a copy of said license along with the source code, too.

If this is not the case or you just want to try ILIAS, you'll find us at: https://www.ilias.de https://github.com/ILIAS-eLearning 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 28 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 60 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 89 of file class.ilTestSession.php.

                                                         : bool
    {
        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 = (int) $row["active_id"];
                $this->user_id = (int) $row["user_fi"];
                $this->anonymous_id = $row["anonymous_id"];
                $this->test_id = (int) $row["test_fi"];
                $this->lastsequence = (int) $row["lastindex"];
                $this->pass = (int) $row["tries"];
                $this->submitted = ($row["submitted"]) ? true : false;
                $this->submittedTimestamp = (string) $row["submittimestamp"];
                $this->tstamp = (int) $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, $test_id, $user_id, ANONYMOUS_USER_ID, ILIAS\Survey\Mode\getId(), ILIAS\Repository\int(), 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 533 of file class.ilTestSession.php.

                                      : string
    {
        // 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 508 of file class.ilTestSession.php.

                                         : string
    {
        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 495 of file class.ilTestSession.php.

                                                   : bool
    {
        if (!is_array(ilSession::get(self::ACCESS_CODE_SESSION_INDEX))) {
            return false;
        }
        $session_code = ilSession::get(self::ACCESS_CODE_SESSION_INDEX);
        if (!isset($session_code[$this->getTestId()])) {
            return false;
        }
 
        return isset($session_code[$this->getTestId()]);
    }

References ilSession\get(), 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 482 of file class.ilTestSession.php.

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

References ilSession\get(), 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 305 of file class.ilTestSession.php.

                                 : int
    {
        return $this->active_id;
    }

References $active_id.

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

Here is the caller graph for this function:

◆ getAnonymousId()

ilTestSession::getAnonymousId ( )

Returns: int|string|null

Definition at line 342 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 397 of file class.ilTestSession.php.

    {
        return $this->lastFinishedPass;
    }

References $lastFinishedPass.

Referenced by ilObjTest\canShowTestResults(), ilObjTest\hasAnyTestResult(), hasSinglePassReportable(), increaseTestPass(), and saveToDb().

Here is the caller graph for this function:

◆ getLastSequence()

ilTestSession::getLastSequence ( )

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

                                     : int
    {
        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 415 of file class.ilTestSession.php.

                                        : ?int
    {
        return $this->lastStartedPass;
    }

References $lastStartedPass.

Referenced by increaseTestPass().

Here is the caller graph for this function:

◆ getObjectiveOrientedContainerId()

ilTestSession::getObjectiveOrientedContainerId ( )

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

                                                     : int
    {
        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 362 of file class.ilTestSession.php.

                             : int
    {
        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 ( )

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

                              : int
    {
        return $this->ref_id;
    }

References $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 382 of file class.ilTestSession.php.

                                           : ?string
    {
        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 325 of file class.ilTestSession.php.

                               : int
    {
        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 315 of file class.ilTestSession.php.

                               : int
    {
        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 597 of file class.ilTestSession.php.

                                                               : bool
    {
        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 367 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 122 of file class.ilTestSession.php.

                                      : void
    {
        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;
        $active = ilSession::get($this->active_id);
        if (!isset($active['tst_last_increase_pass']) || $active['tst_last_increase_pass'] !== null) {
            $active['tst_last_increase_pass'] = 0;
            //ilSession::set($this->active_id, $active);
            //$_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() - $active['tst_last_increase_pass'] > 10) {
            $active['tst_last_increase_pass'] = time();
            //ilSession::set($this->active_id, $active);
            $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', $this->getObjectiveOrientedContainerId())
                    ),
                array(
                        'active_id' => array('integer', $this->getActiveId())
                    )
            );
        }
    }

References $DIC, $ilDB, $submitted, ilSession\get(), 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 517 of file class.ilTestSession.php.

                                           : bool
    {
        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, 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 550 of file class.ilTestSession.php.

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

References ANONYMOUS_USER_ID, and getUserId().

Here is the call graph for this function:

◆ isObjectiveOriented()

ilTestSession::isObjectiveOriented ( )

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

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

References getObjectiveOrientedContainerId().

Here is the call graph for this function:

◆ isPasswordChecked()

ilTestSession::isPasswordChecked ( )

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

                                       : bool
    {
        if (ilSession::get('pw_checked_' . $this->active_id) === null) {
            return false;
        }
        return ilSession::get('pw_checked_' . $this->active_id);
    }

References ilSession\get().

Here is the call graph for this function:

◆ isSubmitted()

ilTestSession::isSubmitted ( )

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

                                 : bool
    {
        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 278 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, 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 218 of file class.ilTestSession.php.

                                                                                : void
    {
        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;
            }
            $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, $test_id, $user_id, ANONYMOUS_USER_ID, doesAccessCodeInSessionExists(), getAccessCodeFromSession(), ILIAS\Survey\Mode\getId(), setLastFinishedPass(), setLastStartedPass(), setObjectiveOrientedContainerId(), and unsetAccessCodeInSession().

Here is the call graph for this function:

◆ lookupTestStartLock()

ilTestSession::lookupTestStartLock ( )

Definition at line 445 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 433 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 577 of file class.ilTestSession.php.

                                                                  : ?bool
    {
        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 167 of file class.ilTestSession.php.

                              : void
    {
        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', $this->getObjectiveOrientedContainerId())
                ),
                array(
                    'active_id' => array('integer', $this->getActiveId())
                )
            );
        } else {
            if (!$this->activeIDExists($this->getUserId(), $this->getTestId())) {
                $anonymous_id = $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', $this->getObjectiveOrientedContainerId())
                    )
                );
                $this->active_id = $next_id;
            }
        }
    }

References $anonymous_id, $DIC, $ilDB, $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 463 of file class.ilTestSession.php.

    {
        if (!is_array(ilSession::get(self::ACCESS_CODE_SESSION_INDEX))) {
            ilSession::set(self::ACCESS_CODE_SESSION_INDEX, array());
        }
        $session_code = ilSession::get(self::ACCESS_CODE_SESSION_INDEX);
        $session_code[$this->getTestId()] = $access_code;
        ilSession::set(self::ACCESS_CODE_SESSION_INDEX, $session_code);
        //$_SESSION[self::ACCESS_CODE_SESSION_INDEX][$this->getTestId()] = $access_code;
    }

References ilSession\get(), getTestId(), and ilSession\set().

Here is the call graph for this function:

◆ setAnonymousId()

ilTestSession::setAnonymousId ( $anonymous_id )

Parameters

int | null | string $anonymous_id

Returns: void

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

                                                 : void
    {
        $this->anonymous_id = $anonymous_id;
    }

References $anonymous_id.

◆ setLastFinishedPass()

ilTestSession::setLastFinishedPass ( $lastFinishedPass )

Definition at line 392 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 347 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 423 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 402 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 357 of file class.ilTestSession.php.

    {
        $this->pass = $pass;
    }

References $pass.

◆ setPasswordChecked()

ilTestSession::setPasswordChecked ( bool $value )

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

                                                   : void
    {
        ilSession::set('pw_checked_' . $this->active_id, $value);
    }

References ilSession\set().

Here is the call graph for this function:

◆ setRefId()

ilTestSession::setRefId ( int $a_val )

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

                                        : void
    {
        $this->ref_id = $a_val;
    }

◆ setSubmitted()

ilTestSession::setSubmitted ( )

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

    {
        $this->submitted = true;
    }

◆ setSubmittedTimestamp()

ilTestSession::setSubmittedTimestamp ( )

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

    {
        $this->submittedTimestamp = date('Y-m-d H:i:s');
    }

◆ setTestId()

ilTestSession::setTestId ( $test_id )

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

                                       : void
    {
        $this->test_id = $test_id;
    }

References $test_id.

◆ setUserId()

ilTestSession::setUserId ( $user_id )

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

                                       : void
    {
        $this->user_id = $user_id;
    }

References $user_id.

◆ unsetAccessCodeInSession()

ilTestSession::unsetAccessCodeInSession ( )

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

    {
        $session_code = ilSession::get(self::ACCESS_CODE_SESSION_INDEX);
        unset($session_code[$this->getTestId()]);
        ilSession::set(self::ACCESS_CODE_SESSION_INDEX, $session_code);
        //unset($_SESSION[self::ACCESS_CODE_SESSION_INDEX][$this->getTestId()]);
    }

References ilSession\get(), getTestId(), and ilSession\set().

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

int ilTestSession::$active_id

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

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

◆ $anonymous_id

ilTestSession::$anonymous_id = null

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

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

◆ $lastFinishedPass

ilTestSession::$lastFinishedPass

private

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

Referenced by getLastFinishedPass(), and setLastFinishedPass().

◆ $lastPresentationMode

string ilTestSession::$lastPresentationMode

protected

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

◆ $lastsequence

int ilTestSession::$lastsequence

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

Referenced by getLastSequence(), and setLastSequence().

◆ $lastStartedPass

ilTestSession::$lastStartedPass

private

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

Referenced by getLastStartedPass(), and setLastStartedPass().

◆ $objectiveOrientedContainerId

int ilTestSession::$objectiveOrientedContainerId

private

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

Referenced by getObjectiveOrientedContainerId().

◆ $pass

int ilTestSession::$pass

private

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

Referenced by getPass(), and setPass().

◆ $ref_id

int ilTestSession::$ref_id

private

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

Referenced by getRefId().

◆ $reportableResultsAvailable

ilTestSession::$reportableResultsAvailable = null

private

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

Referenced by reportableResultsAvailable().

◆ $submitted

bool ilTestSession::$submitted

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

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

◆ $submittedTimestamp

string ilTestSession::$submittedTimestamp

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

Referenced by getSubmittedTimestamp().

◆ $test_id

int ilTestSession::$test_id

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

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

◆ $tstamp

int ilTestSession::$tstamp

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

◆ $user_id

int ilTestSession::$user_id

Definition at line 37 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 31 of file class.ilTestSession.php.

Referenced by buildAccessCode().

◆ ACCESS_CODE_LENGTH

const ilTestSession::ACCESS_CODE_LENGTH = 5

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

Referenced by buildAccessCode().

◆ ACCESS_CODE_SESSION_INDEX

const ilTestSession::ACCESS_CODE_SESSION_INDEX = "tst_access_code"

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

Referenced by ILIAS\Modules\Test\AccessFileUploadAnswer\accessCodeOk(), ILIAS\Modules\Test\test\AccessFileUploadAnswerTest\testAnonymousWithInvalidAccessCode(), ILIAS\Modules\Test\test\AccessFileUploadAnswerTest\testAnonymousWithoutAccessCode(), ILIAS\Modules\Test\test\AccessFileUploadAnswerTest\testAnonymousWithValidAccessCode(), ilTestSessionTest\testSetAccessCodeToSession(), ilTestSessionTest\testUnsetAccessCodeInSession(), and ILIAS\Modules\Test\test\AccessFileUploadAnswerTest\testUserWhichCanAccessTheTestResults().

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

◆ isPasswordChecked()

◆ isSubmitted()

◆ loadFromDb()

◆ loadTestSession()

◆ lookupTestStartLock()

◆ persistTestStartLock()

◆ reportableResultsAvailable()

◆ saveToDb()

◆ setAccessCodeToSession()

◆ setAnonymousId()

◆ setLastFinishedPass()

◆ setLastSequence()

◆ setLastStartedPass()

◆ setObjectiveOrientedContainerId()

◆ setPass()

◆ setPasswordChecked()

◆ setRefId()

◆ setSubmitted()

◆ setSubmittedTimestamp()

◆ setTestId()

◆ setUserId()

◆ unsetAccessCodeInSession()

Field Documentation

◆ $active_id

◆ $anonymous_id

◆ $lastFinishedPass

◆ $lastPresentationMode

◆ $lastsequence

◆ $lastStartedPass

◆ $objectiveOrientedContainerId

◆ $pass

◆ $ref_id

◆ $reportableResultsAvailable

◆ $submitted

◆ $submittedTimestamp

◆ $test_id

◆ $tstamp

◆ $user_id

◆ ACCESS_CODE_CHAR_DOMAIN

◆ ACCESS_CODE_LENGTH

◆ ACCESS_CODE_SESSION_INDEX