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)

	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 209 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 237 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 227 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 306 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 288 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 654 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 638 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 270 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 297 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 283 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 498 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 511 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 314 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 625 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 384 of file class.ilLOTestQuestionAdapter.php.

References $start, 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 264 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 258 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 143 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 181 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 481 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 524 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 575 of file class.ilLOTestQuestionAdapter.php.

References 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 426 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 533 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

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

References ilCourseObjectiveQuestion\_lookupMaximumPointsOfQuestion(), ilTestSequence\getQuestionIds(), ilTestSession\getRefId(), ilTestSequenceRandomQuestionSet\getResponsibleSourcePoolDefinitionId(), getSettings(), 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();
                         $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);
                 }
         }

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 558 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

Public Member Functions

Static Public Member Functions

Protected Member Functions

Protected Attributes

Static Private Member Functions

Detailed Description

Constructor & Destructor Documentation

◆ __construct()

Member Function Documentation

◆ buildQuestionRelatedObjectiveList()

◆ buildQuestionRelatedObjectiveListByQuestions()

◆ buildQuestionRelatedObjectiveListByTest()

◆ getAssignments()

◆ getContainerId()

◆ getInstance()

◆ getQuestionData()

◆ getRelatedObjectivesForSeparatedTest()

◆ getSettings()

◆ getTestRefId()

◆ getUserId()

◆ hideQuestions()

◆ initTestRun()

◆ initUserResult()

◆ isInRun()

◆ isQualifiedStartRun()

◆ lookupObjectiveIdByFixedQuestionId()

◆ lookupObjectiveIdByRandomQuestionSelectionDefinitionId()

◆ lookupRelevantObjectiveIdsForTest()

◆ notifyTestStart()

◆ prepareTestPass()

◆ setQuestionsOptional()

◆ setTestRefId()

◆ storeTestRun()

◆ updateFixedQuestions()

◆ updateQuestionResult()

◆ updateQuestions()

◆ updateRandomQuestions()

◆ updateSeparateTestQuestions()

Field Documentation

◆ $assignments

◆ $container_id

◆ $logger

◆ $settings

◆ $testRefId

◆ $user_id