ilTestSession Class Reference

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.

public

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.

References $DIC, $GLOBALS, $ilDB, ANONYMOUS_USER_ID, ILIAS\Survey\Mode\getId(), ILIAS\Repository\int(), setLastFinishedPass(), setLastStartedPass(), and setObjectiveOrientedContainerId().

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

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

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.

References $i, and $index.

Referenced by createNewAccessCode().

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

Here is the caller graph for this function:

createNewAccessCode()

ilTestSession::createNewAccessCode

(

)

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

References buildAccessCode(), and isAccessCodeUsed().

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

        return $code;
    }

Here is the call graph for this function:

doesAccessCodeInSessionExists()

ilTestSession::doesAccessCodeInSessionExists

(

)

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

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

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

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

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.

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

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

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

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.

References $active_id.

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

                                 : int
    {
        return $this->active_id;
    }

Here is the caller graph for this function:

getAnonymousId()

ilTestSession::getAnonymousId

(

)

Returns

int|string|null

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

References $anonymous_id.

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

    {
        return $this->anonymous_id;
    }

Here is the caller graph for this function:

getLastFinishedPass()

ilTestSession::getLastFinishedPass

(

)

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

References $lastFinishedPass.

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

    {
        return $this->lastFinishedPass;
    }

Here is the caller graph for this function:

getLastSequence()

ilTestSession::getLastSequence

(

)

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

References $lastsequence.

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

                                     : int
    {
        return $this->lastsequence;
    }

Here is the caller graph for this function:

getLastStartedPass()

ilTestSession::getLastStartedPass

(

)

Returns

int

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

References $lastStartedPass.

Referenced by increaseTestPass().

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

Here is the caller graph for this function:

getObjectiveOrientedContainerId()

ilTestSession::getObjectiveOrientedContainerId

(

)

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

References $objectiveOrientedContainerId.

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

                                                     : int
    {
        return $this->objectiveOrientedContainerId;
    }

Here is the caller graph for this function:

getPass()

ilTestSession::getPass

(

)

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

References $pass.

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

                             : int
    {
        return $this->pass;
    }

Here is the caller graph for this function:

getRefId()

ilTestSession::getRefId

(

)

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

References $ref_id.

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

                              : int
    {
        return $this->ref_id;
    }

Here is the caller graph for this function:

getSubmittedTimestamp()

ilTestSession::getSubmittedTimestamp

(

)

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

References $submittedTimestamp.

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

                                           : ?string
    {
        return $this->submittedTimestamp;
    }

Here is the caller graph for this function:

getTestId()

ilTestSession::getTestId

(

)

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

References $test_id.

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

                               : int
    {
        return $this->test_id;
    }

Here is the caller graph for this function:

getUserId()

ilTestSession::getUserId

(

)

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

References $user_id.

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

                               : int
    {
        return $this->user_id;
    }

Here is the caller graph for this function:

hasSinglePassReportable()

ilTestSession::hasSinglePassReportable

(

ilObjTest

$testObj

)

Returns

bool

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

References $DIC, getActiveId(), getLastFinishedPass(), and ilTestPassesSelector\setActiveId().

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

Here is the call graph for this function:

increasePass()

ilTestSession::increasePass

(

)

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

References $DIC, $ilDB, ilSession\get(), getActiveId(), getLastFinishedPass(), getLastSequence(), getLastStartedPass(), getObjectiveOrientedContainerId(), getPass(), getSubmittedTimestamp(), increasePass(), isSubmitted(), and setLastSequence().

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

Here is the call graph for this function:

isAccessCodeUsed()

ilTestSession::isAccessCodeUsed

(

$code

)

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

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

Referenced by createNewAccessCode().

                                           : 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);
    }

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.

References ANONYMOUS_USER_ID, and getUserId().

Referenced by ilTestPlayerAbstractGUI\ensureExistingTestSession().

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

References getObjectiveOrientedContainerId().

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

Here is the call graph for this function:

isPasswordChecked()

ilTestSession::isPasswordChecked

(

)

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

References ilSession\get().

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

Here is the call graph for this function:

isSubmitted()

ilTestSession::isSubmitted

(

)

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

References $submitted.

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

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

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

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

Here is the call graph for this function:

loadTestSession()

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

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

References $anonymous_id, $DIC, $GLOBALS, $ilDB, $ilUser, $user_id, ANONYMOUS_USER_ID, doesAccessCodeInSessionExists(), getAccessCodeFromSession(), ILIAS\Survey\Mode\getId(), setLastFinishedPass(), setLastStartedPass(), setObjectiveOrientedContainerId(), and unsetAccessCodeInSession().

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

Here is the call graph for this function:

lookupTestStartLock()

ilTestSession::lookupTestStartLock

(

)

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

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

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

Here is the call graph for this function:

persistTestStartLock()

ilTestSession::persistTestStartLock

(

$testStartLock

)

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

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

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

reportableResultsAvailable()

ilTestSession::reportableResultsAvailable

(

ilObjTest

$testOBJ

)

Parameters

ilObjTest

$testOBJ

Returns

bool

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

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

                                                                  : ?bool
    {
        if ($this->reportableResultsAvailable === null) {
            $this->reportableResultsAvailable = true;

            if (!$this->getActiveId()) {
                $this->reportableResultsAvailable = false;
            }

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

        return $this->reportableResultsAvailable;
    }

Here is the call graph for this function:

saveToDb()

ilTestSession::saveToDb

(

)

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

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

Referenced by ilTestPlayerAbstractGUI\ensureExistingTestSession().

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

Here is the call graph for this function:

Here is the caller graph for this function:

setAccessCodeToSession()

ilTestSession::setAccessCodeToSession

(

$access_code

)

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

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

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

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.

References $anonymous_id.

Referenced by ilTestPlayerAbstractGUI\ensureExistingTestSession().

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

Here is the caller graph for this function:

setLastFinishedPass()

ilTestSession::setLastFinishedPass

(

$lastFinishedPass

)

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

References $lastsequence.

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

    {
        $this->lastsequence = $lastsequence;
    }

Here is the caller graph for this function:

setLastStartedPass()

ilTestSession::setLastStartedPass

(

$lastStartedPass

)

Parameters

int

$lastStartedPass

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

References $lastStartedPass.

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

    {
        $this->lastStartedPass = $lastStartedPass;
    }

Here is the caller graph for this function:

setObjectiveOrientedContainerId()

ilTestSession::setObjectiveOrientedContainerId

(

$objectiveOriented

)

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

References $pass.

    {
        $this->pass = $pass;
    }

setPasswordChecked()

ilTestSession::setPasswordChecked

(

bool

$value

)

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

References ilSession\set().

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

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.

References $test_id.

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

setUserId()

ilTestSession::setUserId

(

$user_id

)

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

References $user_id.

Referenced by ilTestPlayerAbstractGUI\ensureExistingTestSession().

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

Here is the caller graph for this function:

unsetAccessCodeInSession()

ilTestSession::unsetAccessCodeInSession

(

)

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

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

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

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

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

$anonymous_id

ilTestSession::$anonymous_id = null

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

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

ACCESS_CODE_CHAR_DOMAIN

const ilTestSession::ACCESS_CODE_CHAR_DOMAIN = "0123456789abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ"

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

ACCESS_CODE_LENGTH

const ilTestSession::ACCESS_CODE_LENGTH = 5

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

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