ilLOTestQuestionAdapter Class Reference

Test question filter. More...

Collaboration diagram for ilLOTestQuestionAdapter:

Public Member Functions
	__construct ($a_user_id, $a_course_id)

Static Public Member Functions
static	filterQuestions (ilTestSession $a_test_session, ilTestSequence $a_test_sequence)
	Called from learning objective test. More...
static	updateObjectiveStatus (ilTestSession $a_test_session, ilTestSequence $a_test_sequence, assQuestion $a_question)
	Store result and update objective status. More...

Protected Member Functions
	getUserId ()
	getContainerId ()
	getSettings ()
	Get loc settings. More...
	initUserResult (ilTestSession $session)
	init user result More...
	isQualifiedStartRun (ilTestSession $session)
	Check if current run is a start object run. More...
	updateQuestionResult (ilTestSession $session, assQuestion $qst)
	update question result of run More...
	hideQuestions (ilTestSequence $seq)
	Hide questions. More...
	initTestRun (ilTestSession $session)
	storeTestRun ()
	Store test run in DB. More...
	updateQuestions (ilTestSession $session, ilTestSequence $seq)
	updateFixedQuestions (ilTestSession $session, ilTestSequence $seq)
	updateRandomQuestions (ilTestSession $session, ilTestSequenceRandomQuestionSet $seq)
	isInRun ($a_qid)

Protected Attributes
	$settings = NULL
	$user_id = 0
	$container_id = 0

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 12 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 26 of file class.ilLOTestQuestionAdapter.php.

        {
                $this->user_id = $a_user_id;
                $this->container_id = $a_course_id;
                
                $this->settings = ilLOSettings::getInstanceByObjId($this->container_id);
        }

References ilLOSettings\getInstanceByObjId().

Here is the call graph for this function:

Member Function Documentation

filterQuestions()

static ilLOTestQuestionAdapter::filterQuestions ( ilTestSession  $a_test_session, ilTestSequence  $a_test_sequence  )

static

Called from learning objective test.

Parameters

ilTestSession	$a_test_session
ilTestSequence	$a_test_sequence

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

        {
                
                $adapter = new self(
                                $a_test_session->getUserId(),
                                $a_test_session->getObjectiveOrientedContainerId()
                );
                $adapter->initTestRun($a_test_session);
                $adapter->updateQuestions($a_test_session, $a_test_sequence);
                $adapter->hideQuestions($a_test_sequence);
                $adapter->storeTestRun();
                $adapter->initUserResult($a_test_session);
                
                // Save test sequence
                $a_test_sequence->saveToDb();
                
                $GLOBALS['ilLog']->write(__METHOD__.': '.print_r($a_test_sequence,true));
                return true;
        }

References $GLOBALS, ilTestSession\getObjectiveOrientedContainerId(), ilTestSession\getUserId(), and ilTestSequence\saveToDb().

Referenced by ilTestOutputGUI\filterTestSequenceByObjectives().

Here is the call graph for this function:

Here is the caller graph for this function:

getContainerId()

ilLOTestQuestionAdapter::getContainerId ( )

protected

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

        {
                return $this->container_id;
        }

References $container_id.

Referenced by isQualifiedStartRun().

Here is the caller graph for this function:

getQuestionData()

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

staticprivate

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

        {
                global $ilDB, $lng, $ilPluginAdmin;
                
                require_once 'Modules/TestQuestionPool/classes/class.ilAssQuestionList.php';
                $questionList = new ilAssQuestionList($ilDB, $lng, $ilPluginAdmin, $testObjId);
 
                $questionList->setQuestionInstanceTypeFilter(ilAssQuestionList::QUESTION_INSTANCE_TYPE_DUPLICATES);
                $questionList->setQuestionIdsFilter($questionIds);
 
                $questionList->load();
 
                return $questionList->getQuestionDataArray();
        }

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

getSettings()

ilLOTestQuestionAdapter::getSettings ( )

protected

Get loc settings.

Returns

ilLOSettings

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

        {
                return $this->settings;
        }

References $settings.

getUserId()

ilLOTestQuestionAdapter::getUserId ( )

protected

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

        {
                return $this->user_id;
        }

References $user_id.

hideQuestions()

ilLOTestQuestionAdapter::hideQuestions ( ilTestSequence  $seq )

protected

Hide questions.

Parameters

ilTestSequence

$seq

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

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

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

Here is the call graph for this function:

initTestRun()

ilLOTestQuestionAdapter::initTestRun ( ilTestSession  $session )

protected

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

        {
                include_once './Modules/Course/classes/Objectives/class.ilLOTestRun.php';
                $this->run = ilLOTestRun::getRun(
                                $this->container_id, 
                                $this->user_id,
                                ilObject::_lookupObjId($session->getRefId())
                );
                #$GLOBALS['ilLog']->write(__METHOD__.': '.print_r($this->run,true));
        }

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

Here is the call graph for this function:

initUserResult()

ilLOTestQuestionAdapter::initUserResult ( ilTestSession  $session )

protected

init user result

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

        {
                // 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->getSettings()->getQualifiedTest() == $session->getRefId()) ? 
                                                ilLOUserResults::TYPE_QUALIFIED :
                                                ilLOUserResults::TYPE_INITIAL
                        );
                        
                        include_once './Modules/Course/classes/Objectives/class.ilLOUtils.php';
                        
                        $limit = ilLOUtils::lookupObjectiveRequiredPercentage(
                                        $this->container_id, 
                                        $run->getObjectiveId(),
                                        ($this->getSettings()->getQualifiedTest() == $session->getRefId()) ?
                                                ilLOSettings::TYPE_TEST_QUALIFIED :
                                                ilLOSettings::TYPE_TEST_INITIAL,
                                        $run->getMaxPoints()
                        );
 
                        $max_attempts = ilLOUtils::lookupMaxAttempts($this->container_id, $run->getObjectiveId());
                        if($max_attempts)
                        {
                                // check if current test is start object and fullfilled
                                // if yes => do not increase tries.
                                $GLOBALS['ilLog']->write(__METHOD__.': check for qualified...');
                                if(!$is_qualified_run)
                                {
                                        $GLOBALS['ilLog']->write(__METHOD__.': and increase 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->getSettings()->getQualifiedTest() == $session->getRefId()) ?
                                                ilLOUserResults::TYPE_QUALIFIED :
                                                ilLOUserResults::TYPE_INITIAL,
                                        $old_result['status'],
                                        $old_result['result_perc'],
                                        $limit,
                                        $old_result['tries'], 
                                        $old_result['is_final']
                        );
                }
        }

References $GLOBALS, ilTestSession\getRefId(), isQualifiedStartRun(), ilLOUtils\lookupMaxAttempts(), ilLOUtils\lookupObjectiveRequiredPercentage(), ilLOUserResults\lookupResult(), ilLOUserResults\TYPE_INITIAL, ilLOUserResults\TYPE_QUALIFIED, ilLOSettings\TYPE_TEST_INITIAL, and ilLOSettings\TYPE_TEST_QUALIFIED.

Here is the call graph for this function:

isInRun()

ilLOTestQuestionAdapter::isInRun (   $a_qid )

protected

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

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

Referenced by hideQuestions().

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 191 of file class.ilLOTestQuestionAdapter.php.

        {
                if($session->getRefId() == $this->getSettings()->getInitialTest())
                {
                        $GLOBALS['ilLog']->write(__METHOD__.': is intial');
                        return false;
                }
                if($session->getRefId() != $this->getSettings()->getQualifiedTest())
                {
                        $GLOBALS['ilLog']->write(__METHOD__.': is not qualified');
                        return false;
                }
                include_once './Services/Container/classes/class.ilContainerStartObjects.php';
                if(!ilContainerStartObjects::isStartObject($this->getContainerId(), $session->getRefId()))
                {
                        $GLOBALS['ilLog']->write(__METHOD__.': 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()))
                {
                        $GLOBALS['ilLog']->write(__METHOD__.': is fullfilled');
 
                        return false;
                }
                $GLOBALS['ilLog']->write(__METHOD__.': is not fullfilled');
                return true;
        }

References $GLOBALS, ilObject\_getAllReferences(), getContainerId(), ilTestSession\getRefId(), and ilContainerStartObjects\isStartObject().

Referenced by initUserResult().

Here is the call graph for this function:

Here is the caller graph for this function:

storeTestRun()

ilLOTestQuestionAdapter::storeTestRun ( )

protected

Store test run in DB.

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

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

updateFixedQuestions()

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

protected

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

        {
                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()
                        );
                        $GLOBALS['ilLog']->write(__METHOD__.': '.print_r($qst,true));
                        $points = 0;
                        foreach($qst as $id)
                        {
                                $tst_run->addQuestion($id);
                                $points += ilCourseObjectiveQuestion::_lookupMaximumPointsOfQuestion($id);
                        }
                        $tst_run->setMaxPoints($points);
                }
        }

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

Referenced by updateQuestions().

Here is the call graph for this function:

Here is the caller graph for this function:

updateObjectiveStatus()

static ilLOTestQuestionAdapter::updateObjectiveStatus ( ilTestSession  $a_test_session, ilTestSequence  $a_test_sequence, assQuestion  $a_question  )

static

Store result and update objective status.

Parameters

ilTestSession	$a_test_session
ilTestSequence	$a_test_sequence
assQuestion	$a_question

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

        {
                $adapter = new self(
                                $a_test_session->getUserId(),
                                $a_test_session->getObjectiveOrientedContainerId()
                );
                $adapter->initTestRun($a_test_session);
                $adapter->updateQuestionResult($a_test_session,$a_question);
                return true;
                
                /*
                $usr_id = $a_test_session->getUserId();
                $crs_id = $a_test_session->getObjectiveOrientedContainerId();
                
                $question_id = $a_question->getId();
                
                $points_reached = $a_question->getReachedPoints($a_test_session->getActiveId(), $a_test_session->getPass());
                //$points_max = $a_question->getMaxPoints();
 
                if( $a_test_sequence instanceof ilTestSequenceFixedQuestionSet )
                {
                        // make some noise (with question id only)
                }
                elseif( $a_test_sequence instanceof ilTestSequenceRandomQuestionSet )
                {
                        $respSrcPoolDefId = $a_test_sequence->getResponsibleSourcePoolDefinitionId($question_id);
 
                        // make some noise (with question id and responsible source pool definition)
                }
                 */
        }

References ilTestSession\getObjectiveOrientedContainerId(), and ilTestSession\getUserId().

Referenced by ilTestOutputGUI\updateContainerObjectivesWithAnsweredQuestion().

Here is the call graph for this function:

Here is the caller graph for this function:

updateQuestionResult()

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

protected

update question result of run

Parameters

ilTestSession	$session
assQuestion	$qst

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

        {
                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->getSettings()->getQualifiedTest() == $session->getRefId()) ? 
                                                        ilLOUserResults::TYPE_QUALIFIED :
                                                        ilLOUserResults::TYPE_INITIAL
                                );
                                
                                $ur = new ilLOUserResults($this->container_id,$this->user_id);
                                $ur->saveObjectiveResult(
                                                $run->getObjectiveId(), 
                                                ($this->getSettings()->getQualifiedTest() == $session->getRefId()) ?
                                                        ilLOUserResults::TYPE_QUALIFIED :
                                                        ilLOUserResults::TYPE_INITIAL,
                                                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));
                                
                                include_once("./Services/Tracking/classes/class.ilLPStatusWrapper.php");
                                ilLPStatusWrapper::_updateStatus($this->container_id,$this->user_id);
                        }
                }
                return false;
        }

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

Here is the call graph for this function:

updateQuestions()

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

protected

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

        {
                if($seq instanceof ilTestSequenceFixedQuestionSet)
                {
                        $this->updateFixedQuestions($session, $seq);
                }
                if($seq instanceof ilTestSequenceRandomQuestionSet)
                {
                        $this->updateRandomQuestions($session, $seq);
                }
                
        }

References updateFixedQuestions(), and updateRandomQuestions().

Here is the call graph for this function:

updateRandomQuestions()

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

protected

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

        {
                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();
                        $rnd = new ilLORandomTestQuestionPools(
                                        $this->container_id, 
                                        $tst_run->getObjectiveId(),
                                        ($this->getSettings()->getQualifiedTest() == $session->getRefId() ? 
                                                ilLOSettings::TYPE_TEST_QUALIFIED : 
                                                ilLOSettings::TYPE_TEST_INITIAL)
                        );
                        $stored_sequence_id = $rnd->getQplSequence();
                        $points = 0;
                        foreach($seq->getQuestionIds() as $qst)
                        {
                                if($stored_sequence_id  == $seq->getResponsibleSourcePoolDefinitionId($qst))
                                {
                                        $tst_run->addQuestion($qst);
                                        $points += ilCourseObjectiveQuestion::_lookupMaximumPointsOfQuestion($qst);
                                }
                        }
                        $tst_run->setMaxPoints($points);
                }
        }

References ilCourseObjectiveQuestion\_lookupMaximumPointsOfQuestion(), ilTestSequence\getQuestionIds(), ilTestSession\getRefId(), ilTestSequenceRandomQuestionSet\getResponsibleSourcePoolDefinitionId(), ilLOSettings\TYPE_TEST_INITIAL, and ilLOSettings\TYPE_TEST_QUALIFIED.

Referenced by updateQuestions().

Here is the call graph for this function:

Here is the caller graph for this function:

Field Documentation

$container_id

ilLOTestQuestionAdapter::$container_id = 0

protected

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

Referenced by getContainerId().

$settings

ilLOTestQuestionAdapter::$settings = NULL

protected

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

Referenced by getSettings().

$user_id

ilLOTestQuestionAdapter::$user_id = 0

protected

Definition at line 16 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