ilTestSessionDynamicQuestionSet Class Reference

Inheritance diagram for ilTestSessionDynamicQuestionSet:

Collaboration diagram for ilTestSessionDynamicQuestionSet:

Public Member Functions
	__construct ()
	ilTestSession constructor More...
	getQuestionSetFilterSelection ()
	loadFromDb ($active_id)
	Loads the session data for a given active id. More...
	loadTestSession ($test_id, $user_id="", $anonymous_id="")
	saveToDb ()
	getCurrentQuestionId ()
	setCurrentQuestionId ($currentQuestionId)
Public Member Functions inherited from ilTestSession
	__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)

Private Attributes
	$questionSetFilterSelection = null

Additional Inherited Members
Data Fields inherited from ilTestSession
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 inherited from ilTestSession
	activeIDExists ($user_id, $test_id)
Protected Attributes inherited from ilTestSession
string	$lastPresentationMode

Detailed Description

Definition at line 27 of file class.ilTestSessionDynamicQuestionSet.php.

Constructor & Destructor Documentation

__construct()

ilTestSessionDynamicQuestionSet::__construct

(

)

ilTestSession constructor

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

@access public

Reimplemented from ilTestSession.

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

    {
        parent::__construct();
 
        $this->questionSetFilterSelection = new ilTestDynamicQuestionSetFilterSelection();
    }

References ILIAS\GlobalScreen\Provider\__construct().

Here is the call graph for this function:

Member Function Documentation

getCurrentQuestionId()

ilTestSessionDynamicQuestionSet::getCurrentQuestionId

(

)

Definition at line 202 of file class.ilTestSessionDynamicQuestionSet.php.

                                          : int
    {
        return $this->getLastSequence();
    }

References ilTestSession\getLastSequence().

Referenced by ilTestSequenceDynamicQuestionSet\cleanupQuestions().

Here is the call graph for this function:

Here is the caller graph for this function:

getQuestionSetFilterSelection()

ilTestSessionDynamicQuestionSet::getQuestionSetFilterSelection

(

)

Returns

ilTestDynamicQuestionSetFilterSelection

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

                                                   : ilTestDynamicQuestionSetFilterSelection
    {
        return $this->questionSetFilterSelection;
    }

References $questionSetFilterSelection.

Referenced by saveToDb().

Here is the caller graph for this function:

loadFromDb()

ilTestSessionDynamicQuestionSet::loadFromDb

(

$active_id

)

Loads the session data for a given active id.

Parameters

integer

$active_id

The database id of the test session

Reimplemented from ilTestSession.

Definition at line 49 of file class.ilTestSessionDynamicQuestionSet.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->submitted = ($row["submitted"]) ? true : false;
            $this->submittedTimestamp = $row["submittimestamp"];
            $this->tstamp = $row["tstamp"];
 
            $this->questionSetFilterSelection->setTaxonomySelection(unserialize($row['taxfilter']));
            $this->questionSetFilterSelection->setAnswerStatusSelection($row['answerstatusfilter']);
            $this->questionSetFilterSelection->setAnswerStatusActiveId($row['active_id']);
        }
    }

References ilTestSession\$active_id, $DIC, and $ilDB.

loadTestSession()

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

Reimplemented from ilTestSession.

Definition at line 75 of file class.ilTestSessionDynamicQuestionSet.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->submitted = ($row["submitted"]) ? true : false;
            $this->submittedTimestamp = $row["submittimestamp"];
            $this->tstamp = $row["tstamp"];
 
            $this->questionSetFilterSelection->setTaxonomySelection(unserialize($row['taxfilter']));
            $this->questionSetFilterSelection->setAnswerStatusSelection($row['answerstatusfilter']);
            $this->questionSetFilterSelection->setAnswerStatusActiveId($row['active_id']);
        } elseif ($this->doesAccessCodeInSessionExists()) {
            $this->unsetAccessCodeInSession();
        }
    }

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

Here is the call graph for this function:

saveToDb()

ilTestSessionDynamicQuestionSet::saveToDb

(

)

Reimplemented from ilTestSession.

Definition at line 129 of file class.ilTestSessionDynamicQuestionSet.php.

                              : void
    {
        global $DIC;
        $ilDB = $DIC['ilDB'];
        $ilLog = $DIC['ilLog'];
 
        $submitted = ($this->isSubmitted()) ? 1 : 0;
        if ($this->active_id > 0) {
            $affectedRows = $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),
                    'taxfilter' => array('text', serialize($this->getQuestionSetFilterSelection()->getTaxonomySelection())),
                    'answerstatusfilter' => array('text', $this->getQuestionSetFilterSelection()->getAnswerStatusSelection())
                ),
                array(
                    'active_id' => array('integer', $this->getActiveId())
                )
            );
 
            // update learning progress
            include_once("./Modules/Test/classes/class.ilObjTestAccess.php");
            include_once("./Services/Tracking/classes/class.ilLPStatusWrapper.php");
            ilLPStatusWrapper::_updateStatus(
                ilObjTestAccess::_lookupObjIdForTestId($this->getTestId()),
                ilObjTestAccess::_getParticipantId($this->getActiveId())
            );
        } else {
            if (!$this->activeIDExists($this->getUserId(), $this->getTestId())) {
                $anonymous_id = ($this->getAnonymousId()) ?: null;
 
                $next_id = $ilDB->nextId('tst_active');
                $affectedRows = $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),
                        'taxfilter' => array('text', serialize($this->getQuestionSetFilterSelection()->getTaxonomySelection())),
                        'answerstatusfilter' => array('text', $this->getQuestionSetFilterSelection()->getAnswerStatusSelection())
                    )
                );
                $this->active_id = $next_id;
 
                // update learning progress
                include_once("./Modules/Test/classes/class.ilObjTestAccess.php");
                include_once("./Services/Tracking/classes/class.ilLPStatusWrapper.php");
                ilLPStatusWrapper::_updateStatus(
                    ilObjTestAccess::_lookupObjIdForTestId($this->getTestId()),
                    $this->getUserId()
                );
            }
        }
 
        include_once("./Services/Tracking/classes/class.ilLearningProgress.php");
        ilLearningProgress::_tracProgress(
            $this->getUserId(),
            ilObjTestAccess::_lookupObjIdForTestId($this->getTestId()),
            $this->getRefId(),
            'tst'
        );
    }

References ilTestSession\$anonymous_id, $DIC, $ilDB, ilTestSession\$submitted, ilObjTestAccess\_getParticipantId(), ilObjTestAccess\_lookupObjIdForTestId(), ilLearningProgress\_tracProgress(), ilLPStatusWrapper\_updateStatus(), ilTestSession\activeIDExists(), ilTestSession\getActiveId(), ilTestSession\getAnonymousId(), ilTestSession\getLastSequence(), ilTestSession\getPass(), getQuestionSetFilterSelection(), ilTestSession\getRefId(), ilTestSession\getSubmittedTimestamp(), ilTestSession\getTestId(), ilTestSession\getUserId(), and ilTestSession\isSubmitted().

Here is the call graph for this function:

setCurrentQuestionId()

ilTestSessionDynamicQuestionSet::setCurrentQuestionId

(

$currentQuestionId

)

Definition at line 207 of file class.ilTestSessionDynamicQuestionSet.php.

    {
        $this->setLastSequence((int) $currentQuestionId);
    }

References ilTestSession\setLastSequence().

Referenced by ilTestSequenceDynamicQuestionSet\cleanupQuestions().

Here is the call graph for this function:

Here is the caller graph for this function:

Field Documentation

$questionSetFilterSelection

ilTestSessionDynamicQuestionSet::$questionSetFilterSelection = null

private

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

Referenced by getQuestionSetFilterSelection().

---

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

• Modules/Test/classes/class.ilTestSessionDynamicQuestionSet.php