ilLOTestQuestionAdapter Class Reference

Test question filter. More...

Collaboration diagram for ilLOTestQuestionAdapter:

Public Member Functions
	__construct ($a_user_id, $a_course_id)
	getTestRefId ()
	setTestRefId ($testRefId)
	notifyTestStart (ilTestSession $a_test_session, $a_test_obj_id)
	Called from learning objective test on actual test start. More...
	prepareTestPass (ilTestSession $a_test_session, ilTestSequence $a_test_sequence)
	Called from learning objective test. More...
	buildQuestionRelatedObjectiveList (ilTestQuestionSequence $a_test_sequence, ilTestQuestionRelatedObjectivesList $a_objectives_list)
	updateQuestionResult (ilTestSession $session, assQuestion $qst)
	update question result of run More...

Static Public Member Functions
static	getInstance (ilTestSession $a_test_session)

Protected Member Functions
	lookupRelevantObjectiveIdsForTest ($a_container_id, $a_tst_ref_id, $a_user_id)
	Lookup all relevant objective ids for a specific test. More...
	buildQuestionRelatedObjectiveListByTest (ilTestQuestionSequence $a_test_sequence, ilTestQuestionRelatedObjectivesList $a_objectives_list)
	buildQuestionRelatedObjectiveListByQuestions (ilTestQuestionSequence $a_test_sequence, ilTestQuestionRelatedObjectivesList $a_objectives_list)
	lookupObjectiveIdByRandomQuestionSelectionDefinitionId ($a_id)
	lookupObjectiveIdByFixedQuestionId ($a_question_id)
	getRelatedObjectivesForSeparatedTest ($testRefId)
	getUserId ()
	getContainerId ()
	getSettings ()
	Get loc settings. More...
	getAssignments ()
	initUserResult (ilTestSession $session)
	init user result More...
	isQualifiedStartRun (ilTestSession $session)
	Check if current run is a start object run. More...
	setQuestionsOptional (ilTestSequence $seq)
	set questions optional More...
	hideQuestions (ilTestSequence $seq)
	Hide questions. More...
	initTestRun (ilTestSession $session)
	storeTestRun ()
	Store test run in DB. More...
	updateQuestions (ilTestSession $session, ilTestSequence $seq)
	updateSeparateTestQuestions (ilTestSession $session, ilTestSequence $seq)
	Update questions for separate tests. More...
	updateFixedQuestions (ilTestSession $session, ilTestSequence $seq)
	updateRandomQuestions (ilTestSession $session, ilTestSequenceRandomQuestionSet $seq)
	update random questions More...
	isInRun ($a_qid)

Protected Attributes
	$logger = null
	$settings = null
	$assignments = null
	$user_id = 0
	$container_id = 0
	$testRefId = null

Static Private Member Functions
static	getQuestionData ($testObjId, $questionIds)

Detailed Description

Test question filter.

Author

Stefan Meyer smeye.nosp@m.r.il.nosp@m.ias@g.nosp@m.mx.d.nosp@m.e

Version

$Id$

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

Constructor & Destructor Documentation

__construct()

ilLOTestQuestionAdapter::__construct	(		$a_user_id,
			$a_course_id
	)

Parameters

type	$a_user_id
type	$a_course_id

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

References $GLOBALS, ilLOTestAssignments\getInstance(), ilLOSettings\getInstanceByObjId(), and settings().

    {
        $this->logger = $GLOBALS['DIC']->logger()->crs();
        
        $this->user_id = $a_user_id;
        $this->container_id = $a_course_id;
        
        $this->settings = ilLOSettings::getInstanceByObjId($this->container_id);
        $this->assignments = ilLOTestAssignments::getInstance($this->container_id);
    }

Here is the call graph for this function:

Member Function Documentation

buildQuestionRelatedObjectiveList()

ilLOTestQuestionAdapter::buildQuestionRelatedObjectiveList	(	ilTestQuestionSequence	$a_test_sequence,
		ilTestQuestionRelatedObjectivesList	$a_objectives_list
	)

Parameters

ilTestSequence	$a_test_sequence
ilTestQuestionRelatedObjectivesList	$a_objectives_list

Definition at line 193 of file class.ilLOTestQuestionAdapter.php.

References buildQuestionRelatedObjectiveListByQuestions(), buildQuestionRelatedObjectiveListByTest(), getSettings(), getTestRefId(), ilLOSettings\TYPE_TEST_INITIAL, and ilLOSettings\TYPE_TEST_QUALIFIED.

Referenced by ilTestServiceGUI\buildQuestionRelatedObjectivesList().

    {
        $testType = $this->assignments->getTypeByTest($this->getTestRefId());
        
        if ($testType == ilLOSettings::TYPE_TEST_INITIAL && $this->getSettings()->hasSeparateInitialTests()) {
            $this->buildQuestionRelatedObjectiveListByTest($a_test_sequence, $a_objectives_list);
        } elseif ($testType == ilLOSettings::TYPE_TEST_QUALIFIED && $this->getSettings()->hasSeparateQualifiedTests()) {
            $this->buildQuestionRelatedObjectiveListByTest($a_test_sequence, $a_objectives_list);
        } else {
            $this->buildQuestionRelatedObjectiveListByQuestions($a_test_sequence, $a_objectives_list);
        }
    }

Here is the call graph for this function:

Here is the caller graph for this function:

buildQuestionRelatedObjectiveListByQuestions()

ilLOTestQuestionAdapter::buildQuestionRelatedObjectiveListByQuestions ( ilTestQuestionSequence  $a_test_sequence, ilTestQuestionRelatedObjectivesList  $a_objectives_list  )

protected

Definition at line 215 of file class.ilLOTestQuestionAdapter.php.

References ilTestQuestionRelatedObjectivesList\addQuestionRelatedObjectives(), ilTestQuestionSequence\getQuestionIds(), lookupObjectiveIdByFixedQuestionId(), and lookupObjectiveIdByRandomQuestionSelectionDefinitionId().

Referenced by buildQuestionRelatedObjectiveList().

    {
        foreach ($a_test_sequence->getQuestionIds() as $questionId) {
            if ($a_test_sequence instanceof ilTestRandomQuestionSequence) {
                $definitionId = $a_test_sequence->getResponsibleSourcePoolDefinitionId($questionId);
                $objectiveIds = $this->lookupObjectiveIdByRandomQuestionSelectionDefinitionId($definitionId);
            } else {
                $objectiveIds = $this->lookupObjectiveIdByFixedQuestionId($questionId);
            }
            
            if (count($objectiveIds)) {
                $a_objectives_list->addQuestionRelatedObjectives($questionId, $objectiveIds);
            }
        }
    }

Here is the call graph for this function:

Here is the caller graph for this function:

buildQuestionRelatedObjectiveListByTest()

ilLOTestQuestionAdapter::buildQuestionRelatedObjectiveListByTest ( ilTestQuestionSequence  $a_test_sequence, ilTestQuestionRelatedObjectivesList  $a_objectives_list  )

protected

Definition at line 206 of file class.ilLOTestQuestionAdapter.php.

References ilTestQuestionRelatedObjectivesList\addQuestionRelatedObjectives(), array, ilTestQuestionSequence\getQuestionIds(), getRelatedObjectivesForSeparatedTest(), and getTestRefId().

Referenced by buildQuestionRelatedObjectiveList().

    {
        $objectiveIds = array($this->getRelatedObjectivesForSeparatedTest($this->getTestRefId()));
        
        foreach ($a_test_sequence->getQuestionIds() as $questionId) {
            $a_objectives_list->addQuestionRelatedObjectives($questionId, $objectiveIds);
        }
    }

Here is the call graph for this function:

Here is the caller graph for this function:

getAssignments()

ilLOTestQuestionAdapter::getAssignments ( )

protected

Returns

ilLOTestAssignments

Definition at line 277 of file class.ilLOTestQuestionAdapter.php.

References $assignments.

Referenced by getRelatedObjectivesForSeparatedTest(), initUserResult(), isQualifiedStartRun(), updateQuestionResult(), and updateQuestions().

    {
        return $this->assignments;
    }

Here is the caller graph for this function:

getContainerId()

ilLOTestQuestionAdapter::getContainerId ( )

protected

Definition at line 259 of file class.ilLOTestQuestionAdapter.php.

References $container_id.

Referenced by isQualifiedStartRun(), and lookupObjectiveIdByRandomQuestionSelectionDefinitionId().

    {
        return $this->container_id;
    }

Here is the caller graph for this function:

getInstance()

static ilLOTestQuestionAdapter::getInstance ( ilTestSession  $a_test_session )

static

Definition at line 609 of file class.ilLOTestQuestionAdapter.php.

References $adapter, ilTestSession\getObjectiveOrientedContainerId(), ilTestSession\getRefId(), and ilTestSession\getUserId().

Referenced by ilTestPlayerAbstractGUI\archiveParticipantSubmission(), ilTestSubmissionReviewGUI\buildUserReviewOutput(), ilTestServiceGUI\getPassOverviewTableData(), ilTestServiceGUI\getResultsOfUserOutput(), ilTestServiceGUI\outCorrectSolution(), ilTestEvaluationGUI\outParticipantsPassDetails(), ilTestEvaluationGUI\outUserListOfAnswerPasses(), ilTestEvaluationGUI\outUserPassDetails(), ilTestOutputGUI\saveQuestionSolution(), ilTestOutputGUI\showQuestionCmd(), ilTestEvalObjectiveOrientedGUI\showVirtualPassCmd(), and ilTestOutputGUI\startTestCmd().

    {
        $adapter = new self(
            $a_test_session->getUserId(),
            $a_test_session->getObjectiveOrientedContainerId()
        );
        
        $adapter->setTestRefId($a_test_session->getRefId());
        $adapter->initTestRun($a_test_session);
        
        return $adapter;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

getQuestionData()

static ilLOTestQuestionAdapter::getQuestionData (   $testObjId,   $questionIds  )

staticprivate

Definition at line 593 of file class.ilLOTestQuestionAdapter.php.

References $ilDB, $lng, and ilAssQuestionList\QUESTION_INSTANCE_TYPE_DUPLICATES.

    {
        global $ilDB, $lng, $ilPluginAdmin;
        
        require_once 'Modules/TestQuestionPool/classes/class.ilAssQuestionList.php';
        $questionList = new ilAssQuestionList($ilDB, $lng, $ilPluginAdmin);
        $questionList->setParentObjId($testObjId);

        $questionList->setQuestionInstanceTypeFilter(ilAssQuestionList::QUESTION_INSTANCE_TYPE_DUPLICATES);
        $questionList->setQuestionIdsFilter($questionIds);

        $questionList->load();

        return $questionList->getQuestionDataArray();
    }

getRelatedObjectivesForSeparatedTest()

ilLOTestQuestionAdapter::getRelatedObjectivesForSeparatedTest (   $testRefId )

protected

Definition at line 243 of file class.ilLOTestQuestionAdapter.php.

References $testRefId, and getAssignments().

Referenced by buildQuestionRelatedObjectiveListByTest().

    {
        foreach ($this->getAssignments()->getAssignments() as $assignment) {
            if ($assignment->getTestRefId() == $testRefId) {
                return $assignment->getObjectiveId();
            }
        }
        
        return null;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

getSettings()

ilLOTestQuestionAdapter::getSettings ( )

protected

Get loc settings.

Returns

ilLOSettings

Definition at line 268 of file class.ilLOTestQuestionAdapter.php.

References $settings.

Referenced by buildQuestionRelatedObjectiveList(), isQualifiedStartRun(), lookupRelevantObjectiveIdsForTest(), prepareTestPass(), and updateRandomQuestions().

    {
        return $this->settings;
    }

Here is the caller graph for this function:

getTestRefId()

ilLOTestQuestionAdapter::getTestRefId

(

)

Returns

null

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

References $testRefId.

Referenced by buildQuestionRelatedObjectiveList(), and buildQuestionRelatedObjectiveListByTest().

    {
        return $this->testRefId;
    }

Here is the caller graph for this function:

getUserId()

ilLOTestQuestionAdapter::getUserId ( )

protected

Definition at line 254 of file class.ilLOTestQuestionAdapter.php.

References $user_id.

    {
        return $this->user_id;
    }

hideQuestions()

ilLOTestQuestionAdapter::hideQuestions ( ilTestSequence  $seq )

protected

Hide questions.

Parameters

ilTestSequence

$seq

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

References ilTestSequence\clearHiddenQuestions(), ilTestSequence\getQuestionIds(), ilTestSequence\hideQuestion(), and isInRun().

Referenced by prepareTestPass().

    {
        // first unhide all questions
        $seq->clearHiddenQuestions();
        foreach ($seq->getQuestionIds() as $qid) {
            if (!$this->isInRun($qid)) {
                $seq->hideQuestion($qid);
            }
        }
    }

Here is the call graph for this function:

Here is the caller graph for this function:

initTestRun()

ilLOTestQuestionAdapter::initTestRun ( ilTestSession  $session )

protected

Definition at line 471 of file class.ilLOTestQuestionAdapter.php.

References ilObject\_lookupObjId(), ilTestSession\getRefId(), and ilLOTestRun\getRun().

Referenced by notifyTestStart().

    {
        include_once './Modules/Course/classes/Objectives/class.ilLOTestRun.php';
        $this->run = ilLOTestRun::getRun(
            $this->container_id,
            $this->user_id,
            ilObject::_lookupObjId($session->getRefId())
        );
    }

Here is the call graph for this function:

Here is the caller graph for this function:

initUserResult()

ilLOTestQuestionAdapter::initUserResult ( ilTestSession  $session )

protected

init user result

Definition at line 285 of file class.ilLOTestQuestionAdapter.php.

References getAssignments(), ilTestSession\getRefId(), isQualifiedStartRun(), ilLOUtils\lookupObjectiveRequiredPercentage(), and ilLOUserResults\lookupResult().

Referenced by prepareTestPass().

    {
        // check if current test is start object and fullfilled
        // if yes => do not increase tries.
        $is_qualified_run = false;
        if ($this->isQualifiedStartRun($session)) {
            $is_qualified_run = true;
        }
        
        foreach ($this->run as $run) {
            include_once './Modules/Course/classes/Objectives/class.ilLOUserResults.php';
            include_once './Modules/Course/classes/Objectives/class.ilLOUtils.php';
                
            $old_result = ilLOUserResults::lookupResult(
                $this->container_id,
                $this->user_id,
                $run->getObjectiveId(),
                $this->getAssignments()->getTypeByTest($session->getRefId())
            );
            
            include_once './Modules/Course/classes/Objectives/class.ilLOUtils.php';
            
            $limit = ilLOUtils::lookupObjectiveRequiredPercentage(
                $this->container_id,
                $run->getObjectiveId(),
                $session->getRefId(),
                $run->getMaxPoints()
            );

            $max_attempts = ilLOUtils::lookupMaxAttempts(
                $this->container_id,
                $run->getObjectiveId(),
                $session->getRefId()
            );
            
            $this->logger->debug('Max attempts = ' . $max_attempts);
            
            if ($max_attempts) {
                // check if current test is start object and fullfilled
                // if yes => do not increase tries.
                $this->logger->debug('Checking for qualified test...');
                if (!$is_qualified_run) {
                    $this->logger->debug(' and increasing attempts.');
                    ++$old_result['tries'];
                }
                $old_result['is_final'] = ($old_result['tries'] >= $max_attempts);
            }
            
            $ur = new ilLOUserResults($this->container_id, $this->user_id);
            $ur->saveObjectiveResult(
                $run->getObjectiveId(),
                $this->getAssignments()->getTypeByTest($session->getRefId()),
                $old_result['status'],
                $old_result['result_perc'],
                $limit,
                $old_result['tries'],
                $old_result['is_final']
            );
        }
    }

Here is the call graph for this function:

Here is the caller graph for this function:

isInRun()

ilLOTestQuestionAdapter::isInRun (   $a_qid )

protected

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

Referenced by hideQuestions(), and setQuestionsOptional().

    {
        foreach ($this->run as $run) {
            if ($run->questionExists($a_qid)) {
                return true;
            }
        }
        return false;
    }

Here is the caller graph for this function:

isQualifiedStartRun()

ilLOTestQuestionAdapter::isQualifiedStartRun ( ilTestSession  $session )

protected

Check if current run is a start object run.

Parameters

ilTestSession

$session

Returns

boolean

Definition at line 351 of file class.ilLOTestQuestionAdapter.php.

References ilObject\_getAllReferences(), getAssignments(), getContainerId(), ilTestSession\getRefId(), getSettings(), ilContainerStartObjects\isStartObject(), and ilLOSettings\TYPE_TEST_INITIAL.

Referenced by initUserResult().

    {
        if ($this->getAssignments()->getTypeByTest($session->getRefId()) == ilLOSettings::TYPE_TEST_INITIAL) {
            $this->logger->debug('Initial test');
            return false;
        }
        
        if ($session->getRefId() != $this->getSettings()->getQualifiedTest()) {
            $this->logger->debug('No qualified test run');
            return false;
        }
        include_once './Services/Container/classes/class.ilContainerStartObjects.php';
        if (!ilContainerStartObjects::isStartObject($this->getContainerId(), $session->getRefId())) {
            $this->logger->debug('No start object');
            return false;
        }
        // Check if start object is fullfilled
        
        $container_ref_ids = ilObject::_getAllReferences($this->getContainerId());
        $container_ref_id = end($container_ref_ids);
        
        $start = new ilContainerStartObjects(
            $container_ref_id,
            $this->getContainerId()
        );
        if ($start->isFullfilled($this->getUserId(), $session->getRefId())) {
            $this->logger->debug('Is fullfilled');
            return false;
        }
        $this->logger->debug('Is not fullfilled');
        return true;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

lookupObjectiveIdByFixedQuestionId()

ilLOTestQuestionAdapter::lookupObjectiveIdByFixedQuestionId (   $a_question_id )

protected

Definition at line 237 of file class.ilLOTestQuestionAdapter.php.

References ilCourseObjectiveQuestion\lookupObjectivesOfQuestion().

Referenced by buildQuestionRelatedObjectiveListByQuestions().

    {
        include_once './Modules/Course/classes/class.ilCourseObjectiveQuestion.php';
        return ilCourseObjectiveQuestion::lookupObjectivesOfQuestion($a_question_id);
    }

Here is the call graph for this function:

Here is the caller graph for this function:

lookupObjectiveIdByRandomQuestionSelectionDefinitionId()

ilLOTestQuestionAdapter::lookupObjectiveIdByRandomQuestionSelectionDefinitionId (   $a_id )

protected

Definition at line 231 of file class.ilLOTestQuestionAdapter.php.

References getContainerId(), and ilLORandomTestQuestionPools\lookupObjectiveIdsBySequence().

Referenced by buildQuestionRelatedObjectiveListByQuestions().

    {
        include_once './Modules/Course/classes/Objectives/class.ilLORandomTestQuestionPools.php';
        return ilLORandomTestQuestionPools::lookupObjectiveIdsBySequence($this->getContainerId(), $a_id);
    }

Here is the call graph for this function:

Here is the caller graph for this function:

lookupRelevantObjectiveIdsForTest()

ilLOTestQuestionAdapter::lookupRelevantObjectiveIdsForTest (   $a_container_id,   $a_tst_ref_id,   $a_user_id  )

protected

Lookup all relevant objective ids for a specific test.

Returns

array

Definition at line 64 of file class.ilLOTestQuestionAdapter.php.

References $assignments, $results, ilCourseObjective\_getObjectiveIds(), array, ilLOTestAssignments\getInstance(), getSettings(), ilLOSettings\TYPE_TEST_INITIAL, and ilLOSettings\TYPE_TEST_QUALIFIED.

Referenced by notifyTestStart().

    {
        include_once './Modules/Course/classes/Objectives/class.ilLOTestAssignments.php';
        $assignments = ilLOTestAssignments::getInstance($a_container_id);
        
        include_once './Modules/Course/classes/class.ilCourseObjective.php';
        $objective_ids = ilCourseObjective::_getObjectiveIds($a_container_id);
        
        $relevant_objective_ids = array();
        if (!$this->getSettings()->hasSeparateInitialTests()) {
            if ($a_tst_ref_id == $this->getSettings()->getInitialTest()) {
                $relevant_objective_ids = $objective_ids;
            }
        } elseif (!$this->getSettings()->hasSeparateQualifiedTests()) {
            if ($a_tst_ref_id == $this->getSettings()->getQualifiedTest()) {
                $relevant_objective_ids = $objective_ids;
            }
        }

        foreach ((array) $objective_ids as $objective_id) {
            $assigned_itest = $assignments->getTestByObjective($objective_id, ilLOSettings::TYPE_TEST_INITIAL);
            if ($assigned_itest == $a_tst_ref_id) {
                $relevant_objective_ids[] = $objective_id;
            }
            $assigned_qtest = $assignments->getTestByObjective($objective_id, ilLOSettings::TYPE_TEST_QUALIFIED);
            if ($assigned_qtest == $a_tst_ref_id) {
                $relevant_objective_ids[] = $objective_id;
            }
        }
        
        $relevant_objective_ids = array_unique($relevant_objective_ids);
        
        if (count($relevant_objective_ids) <= 1) {
            return $relevant_objective_ids;
        }
        
        // filter passed objectives
        $test_type = $assignments->getTypeByTest($a_tst_ref_id);
        
        $passed_objectives = array();
        include_once './Modules/Course/classes/Objectives/class.ilLOUserResults.php';
        $results = new ilLOUserResults($a_container_id, $a_user_id);
        
        $passed = $results->getCompletedObjectiveIds();
        $this->logger->debug('Passed objectives are ' . print_r($passed, true) . ' for test type: ' . $test_type);
        
        
        // all completed => show all objectives
        if (count($passed) >= count($relevant_objective_ids)) {
            return $relevant_objective_ids;
        }
        
        $unpassed = array();
        foreach ($relevant_objective_ids as $objective_id) {
            if (!in_array($objective_id, $passed)) {
                $unpassed[] = $objective_id;
            }
        }
        return $unpassed;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

notifyTestStart()

ilLOTestQuestionAdapter::notifyTestStart	(	ilTestSession	$a_test_session,
			$a_test_obj_id
	)

Called from learning objective test on actual test start.

Parameters

ilTestSession	$a_test_session
integer	$a_test_obj_id

Definition at line 131 of file class.ilLOTestQuestionAdapter.php.

References array, ilLOTestRun\create(), ilLOTestRun\deleteRun(), ilTestSession\getObjectiveOrientedContainerId(), ilTestSession\getRefId(), ilTestSession\getUserId(), initTestRun(), and lookupRelevantObjectiveIdsForTest().

    {
        $relevant_objectives = $this->lookupRelevantObjectiveIdsForTest(
            $a_test_session->getObjectiveOrientedContainerId(),
            $a_test_session->getRefId(),
            $a_test_session->getUserId()
        );
        $this->logger->debug('Notify test start: ' . print_r($relevant_objectives, true));

        // delete test runs
        include_once './Modules/Course/classes/Objectives/class.ilLOTestRun.php';
        ilLOTestRun::deleteRun(
            $a_test_session->getObjectiveOrientedContainerId(),
            $a_test_session->getUserId(),
            $a_test_obj_id
        );
        
        foreach ((array) $relevant_objectives as $oid) {
            $this->logger->debug('Adding new run for objective with id: ' . $oid);
            $run = new ilLOTestRun(
                $a_test_session->getObjectiveOrientedContainerId(),
                $a_test_session->getUserId(),
                $a_test_obj_id,
                $oid
            );
            $run->create();
        }
        
        // finally reinitialize test runs
        $this->initTestRun($a_test_session);
    }

Here is the call graph for this function:

prepareTestPass()

ilLOTestQuestionAdapter::prepareTestPass	(	ilTestSession	$a_test_session,
		ilTestSequence	$a_test_sequence
	)

Called from learning objective test.

Parameters

ilTestSession	$a_test_session
ilTestSequence	$a_test_sequence

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

References getSettings(), ilLOSettings\HIDE_PASSED_OBJECTIVE_QST, hideQuestions(), initUserResult(), ilLOSettings\MARK_PASSED_OBJECTIVE_QST, ilTestSequence\saveToDb(), setQuestionsOptional(), storeTestRun(), and updateQuestions().

    {
        $this->logger->debug('Prepare test pass called');
        
        $this->updateQuestions($a_test_session, $a_test_sequence);

        if ($this->getSettings()->getPassedObjectiveMode() == ilLOSettings::MARK_PASSED_OBJECTIVE_QST) {
            $this->setQuestionsOptional($a_test_sequence);
        } elseif ($this->getSettings()->getPassedObjectiveMode() == ilLOSettings::HIDE_PASSED_OBJECTIVE_QST) {
            $this->hideQuestions($a_test_sequence);
        }

        $this->storeTestRun();
        $this->initUserResult($a_test_session);
        
        // Save test sequence
        $a_test_sequence->saveToDb();
        
        return true;
    }

Here is the call graph for this function:

setQuestionsOptional()

ilLOTestQuestionAdapter::setQuestionsOptional ( ilTestSequence  $seq )

protected

set questions optional

Parameters

ilTestSequence

$seq

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

References ilTestSequence\clearOptionalQuestions(), ilTestSequence\getQuestionIds(), isInRun(), and ilTestSequence\setQuestionOptional().

Referenced by prepareTestPass().

    {
        // first unset optional on all questions
        $seq->clearOptionalQuestions();
        foreach ($seq->getQuestionIds() as $qid) {
            if (!$this->isInRun($qid)) { // but is assigned to any LO
                $seq->setQuestionOptional($qid);
            }
        }
    }

Here is the call graph for this function:

Here is the caller graph for this function:

setTestRefId()

ilLOTestQuestionAdapter::setTestRefId

(

$testRefId

)

Parameters

null

$testRefId

Definition at line 55 of file class.ilLOTestQuestionAdapter.php.

References $testRefId.

    {
        $this->testRefId = $testRefId;
    }

storeTestRun()

ilLOTestQuestionAdapter::storeTestRun ( )

protected

Store test run in DB.

Definition at line 484 of file class.ilLOTestQuestionAdapter.php.

Referenced by prepareTestPass().

    {
        foreach ($this->run as $tst_run) {
            $tst_run->update();
        }
    }

Here is the caller graph for this function:

updateFixedQuestions()

ilLOTestQuestionAdapter::updateFixedQuestions ( ilTestSession  $session, ilTestSequence  $seq  )

protected

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

References $id, ilCourseObjectiveQuestion\_lookupMaximumPointsOfQuestion(), ilObject\_lookupObjId(), ilTestSession\getRefId(), and ilCourseObjectiveQuestion\lookupQuestionsByObjective().

Referenced by updateQuestions().

    {
        foreach ($this->run as $tst_run) {
            $tst_run->clearQuestions();
            include_once './Modules/Course/classes/class.ilCourseObjectiveQuestion.php';
            $qst = ilCourseObjectiveQuestion::lookupQuestionsByObjective(
                ilObject::_lookupObjId($session->getRefId()),
                $tst_run->getObjectiveId()
            );
            $points = 0;
            foreach ($qst as $id) {
                $tst_run->addQuestion($id);
                $points += ilCourseObjectiveQuestion::_lookupMaximumPointsOfQuestion($id);
            }
            $tst_run->setMaxPoints($points);
        }
    }

Here is the call graph for this function:

Here is the caller graph for this function:

updateQuestionResult()

ilLOTestQuestionAdapter::updateQuestionResult	(	ilTestSession	$session,
		assQuestion	$qst
	)

update question result of run

Parameters

ilTestSession	$session
assQuestion	$qst

Definition at line 389 of file class.ilLOTestQuestionAdapter.php.

References $GLOBALS, $res, ilLPStatusWrapper\_updateStatus(), ilTestSession\getActiveId(), getAssignments(), assQuestion\getId(), ilTestSession\getPass(), assQuestion\getReachedPoints(), ilTestSession\getRefId(), ilLOUtils\isCompleted(), ilLOUserResults\lookupResult(), ilLOUserResults\STATUS_COMPLETED, and ilLOUserResults\STATUS_FAILED.

    {
        foreach ($this->run as $run) {
            if ($run->questionExists($qst->getId())) {
                $GLOBALS['ilLog']->write(__METHOD__ . ': reached points are ' . $qst->getReachedPoints($session->getActiveId(), $session->getPass()));
                $run->setQuestionResult(
                    $qst->getId(),
                    $qst->getReachedPoints($session->getActiveId(), $session->getPass())
                );
                $run->update();
                
                $res = $run->getResult();
                
                include_once './Modules/Course/classes/Objectives/class.ilLOUserResults.php';
                include_once './Modules/Course/classes/Objectives/class.ilLOUtils.php';
                
                $old_result = ilLOUserResults::lookupResult(
                    $this->container_id,
                    $this->user_id,
                    $run->getObjectiveId(),
                    $this->getAssignments()->getTypeByTest($session->getRefId())
                );
                
                $ur = new ilLOUserResults($this->container_id, $this->user_id);
                $ur->saveObjectiveResult(
                    $run->getObjectiveId(),
                    $this->getAssignments()->getTypeByTest($session->getRefId()),
                    $comp = ilLOUtils::isCompleted(
                            $this->container_id,
                            $session->getRefId(),
                            $run->getObjectiveId(),
                            $res['max'],
                            $res['reached'],
                            $old_result['limit_perc']
                        ) ?
                                ilLOUserResults::STATUS_COMPLETED :
                                ilLOUserResults::STATUS_FAILED,
                    (int) $res['percentage'],
                    $old_result['limit_perc'],
                    $old_result['tries'],
                    $old_result['is_final']
                );
                $GLOBALS['ilLog']->write(__METHOD__ . ': ' . print_r($run->getResult(), true));
                $GLOBALS['ilLog']->write(__METHOD__ . '!!!!!!!!!!!!!!!!!!!!: ' . print_r($comp, true));
                
                include_once("./Services/Tracking/classes/class.ilLPStatusWrapper.php");
                ilLPStatusWrapper::_updateStatus($this->container_id, $this->user_id);
            }
        }
        return false;
    }

Here is the call graph for this function:

updateQuestions()

ilLOTestQuestionAdapter::updateQuestions ( ilTestSession  $session, ilTestSequence  $seq  )

protected

Definition at line 492 of file class.ilLOTestQuestionAdapter.php.

References $GLOBALS, getAssignments(), ilTestSession\getRefId(), updateFixedQuestions(), updateRandomQuestions(), and updateSeparateTestQuestions().

Referenced by prepareTestPass().

    {
        if ($this->getAssignments()->isSeparateTest($session->getRefId())) {
            $GLOBALS['ilLog']->write(__METHOD__ . ': separate run');
            return $this->updateSeparateTestQuestions($session, $seq);
        }
        if ($seq instanceof ilTestSequenceFixedQuestionSet) {
            $GLOBALS['ilLog']->write(__METHOD__ . ': fixed run');
            return $this->updateFixedQuestions($session, $seq);
        }
        if ($seq instanceof ilTestSequenceRandomQuestionSet) {
            $GLOBALS['ilLog']->write(__METHOD__ . ': random run');
            return $this->updateRandomQuestions($session, $seq);
        }
    }

Here is the call graph for this function:

Here is the caller graph for this function:

updateRandomQuestions()

ilLOTestQuestionAdapter::updateRandomQuestions ( ilTestSession  $session, ilTestSequenceRandomQuestionSet  $seq  )

protected

update random questions

Parameters

ilTestSession	$session
ilTestSequenceRandomQuestionSet	$seq

Definition at line 551 of file class.ilLOTestQuestionAdapter.php.

References ilCourseObjectiveQuestion\_lookupMaximumPointsOfQuestion(), ilObject\_lookupObjId(), ilTestSequence\getQuestionIds(), ilTestSession\getRefId(), ilTestSequenceRandomQuestionSet\getResponsibleSourcePoolDefinitionId(), getSettings(), ilLORandomTestQuestionPools\lookupSequencesByType(), ilLOSettings\TYPE_TEST_INITIAL, and ilLOSettings\TYPE_TEST_QUALIFIED.

Referenced by updateQuestions().

    {
        include_once './Modules/Course/classes/Objectives/class.ilLORandomTestQuestionPools.php';
        include_once './Modules/Course/classes/class.ilCourseObjectiveQuestion.php';

        foreach ($this->run as $tst_run) {
            // Clear questions of previous run
            $tst_run->clearQuestions();
            
            $sequences = ilLORandomTestQuestionPools::lookupSequencesByType(
                $this->container_id,
                $tst_run->getObjectiveId(),
                ilObject::_lookupObjId($session->getRefId()),
                (
                    ($this->getSettings()->getQualifiedTest() == $session->getRefId()) ?
                    ilLOSettings::TYPE_TEST_QUALIFIED :
                    ilLOSettings::TYPE_TEST_INITIAL
                )
            );
            
            $points = 0;
            foreach ($seq->getQuestionIds() as $qst) {
                if (in_array($seq->getResponsibleSourcePoolDefinitionId($qst), $sequences)) {
                    $tst_run->addQuestion($qst);
                    $points += ilCourseObjectiveQuestion::_lookupMaximumPointsOfQuestion($qst);
                }
            }
            $tst_run->setMaxPoints($points);
        }
    }

Here is the call graph for this function:

Here is the caller graph for this function:

updateSeparateTestQuestions()

ilLOTestQuestionAdapter::updateSeparateTestQuestions ( ilTestSession  $session, ilTestSequence  $seq  )

protected

Update questions for separate tests.

Parameters

ilTestSession	$session
ilTestSequence	$seq

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

References ilCourseObjectiveQuestion\_lookupMaximumPointsOfQuestion(), and ilTestSequence\getQuestionIds().

Referenced by updateQuestions().

    {
        foreach ($this->run as $tst_run) {
            $tst_run->clearQuestions();
            $points = 0;
            foreach ($seq->getQuestionIds() as $idx => $qst_id) {
                $tst_run->addQuestion($qst_id);
                include_once './Modules/Course/classes/class.ilCourseObjectiveQuestion.php';
                $points += ilCourseObjectiveQuestion::_lookupMaximumPointsOfQuestion($qst_id);
            }
            $tst_run->setMaxPoints($points);
        }
    }

Here is the call graph for this function:

Here is the caller graph for this function:

Field Documentation

$assignments

ilLOTestQuestionAdapter::$assignments = null

protected

Definition at line 21 of file class.ilLOTestQuestionAdapter.php.

Referenced by getAssignments(), and lookupRelevantObjectiveIdsForTest().

$container_id

ilLOTestQuestionAdapter::$container_id = 0

protected

Definition at line 24 of file class.ilLOTestQuestionAdapter.php.

Referenced by getContainerId().

$logger

ilLOTestQuestionAdapter::$logger = null

protected

Definition at line 18 of file class.ilLOTestQuestionAdapter.php.

$settings

ilLOTestQuestionAdapter::$settings = null

protected

Definition at line 20 of file class.ilLOTestQuestionAdapter.php.

Referenced by getSettings().

$testRefId

ilLOTestQuestionAdapter::$testRefId = null

protected

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

Referenced by getRelatedObjectivesForSeparatedTest(), getTestRefId(), and setTestRefId().

$user_id

ilLOTestQuestionAdapter::$user_id = 0

protected

Definition at line 23 of file class.ilLOTestQuestionAdapter.php.

Referenced by getUserId().

---

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

• Modules/Course/classes/Objectives/class.ilLOTestQuestionAdapter.php