Test question filter. More...

Collaboration diagram for ilLOTestQuestionAdapter:

Public Member Functions
	__construct (int $a_user_id, int $a_course_id)

	getTestRefId ()

	setTestRefId (int $testRefId)

	notifyTestStart (ilTestSession $a_test_session, int $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 (int $a_container_id, int $a_tst_ref_id, int $a_user_id)

	buildQuestionRelatedObjectiveListByTest (ilTestQuestionSequence $a_test_sequence, ilTestQuestionRelatedObjectivesList $a_objectives_list)

	buildQuestionRelatedObjectiveListByQuestions (ilTestQuestionSequence $a_test_sequence, ilTestQuestionRelatedObjectivesList $a_objectives_list)

	lookupObjectiveIdByRandomQuestionSelectionDefinitionId (int $a_id)

	lookupObjectiveIdByFixedQuestionId (int $a_question_id)

	getRelatedObjectivesForSeparatedTest (int $testRefId)

	getUserId ()

	getContainerId ()

	getSettings ()

	getAssignments ()

	initUserResult (ilTestSession $session)

	isQualifiedStartRun (ilTestSession $session)
	Check if current run is a start object run. More...

	setQuestionsOptional (ilTestSequence $seq)

	hideQuestions (ilTestSequence $seq)

	initTestRun (ilTestSession $session)

	storeTestRun ()

	updateQuestions (ilTestSession $session, ilTestSequence $seq)

	updateSeparateTestQuestions (ilTestSession $session, ilTestSequence $seq)

	updateFixedQuestions (ilTestSession $session, ilTestSequence $seq)

	updateRandomQuestions (ilTestSession $session, ilTestSequenceRandomQuestionSet $seq)

	isInRun (int $a_qid)

Protected Attributes
ilLOSettings	$settings

ilLOTestAssignments	$assignments

array	$run = []

int	$user_id = 0

int	$container_id = 0

int	$testRefId = null

ilLogger	$logger

Detailed Description

Test question filter.

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

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

Constructor & Destructor Documentation

◆ __construct()

ilLOTestQuestionAdapter::__construct	(	int	$a_user_id,
		int	$a_course_id
	)

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

References $DIC, ilLOTestAssignments\getInstance(), ilLOSettings\getInstanceByObjId(), ILIAS\Repository\logger(), and ILIAS\Repository\settings().

     {
         global $DIC;
 
         $this->logger = $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
	)

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

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

Referenced by ilTestServiceGUI\buildQuestionRelatedObjectivesList().

      : void {
         $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 199 of file class.ilLOTestQuestionAdapter.php.

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

Referenced by buildQuestionRelatedObjectiveList().

      : void {
         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 ($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 188 of file class.ilLOTestQuestionAdapter.php.

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

Referenced by buildQuestionRelatedObjectiveList().

      : void {
         $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

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

References $assignments.

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

                                        : ilLOTestAssignments
     {
         return $this->assignments;
     }

Here is the caller graph for this function:

◆ getContainerId()

ilLOTestQuestionAdapter::getContainerId ( )

protected

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

References $container_id.

Referenced by isQualifiedStartRun(), and lookupObjectiveIdByRandomQuestionSelectionDefinitionId().

                                        : int
     {
         return $this->container_id;
     }

Here is the caller graph for this function:

◆ getInstance()

static ilLOTestQuestionAdapter::getInstance ( ilTestSession $a_test_session )

static

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

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

Referenced by ilTestSubmissionReviewGUI\buildUserReviewOutput(), ilTestServiceGUI\getPassOverviewTableData(), ilTestServiceGUI\outCorrectSolution(), ilTestEvaluationGUI\outUserListOfAnswerPasses(), ilTestEvaluationGUI\outUserPassDetails(), ilTestPlayerAbstractGUI\save(), ilTestPlayerAbstractGUI\showQuestionCmd(), ilTestEvalObjectiveOrientedGUI\showVirtualPassCmd(), and ilTestPlayerAbstractGUI\startTestCmd().

                                                                      : self
     {
         $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:

◆ getRelatedObjectivesForSeparatedTest()

ilLOTestQuestionAdapter::getRelatedObjectivesForSeparatedTest ( int $testRefId )

protected

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

References $testRefId, and getAssignments().

Referenced by buildQuestionRelatedObjectiveListByTest().

                                                                            : ?int
     {
         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

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

References $settings.

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

                                     : ilLOSettings
     {
         return $this->settings;
     }

Here is the caller graph for this function:

◆ getTestRefId()

ilLOTestQuestionAdapter::getTestRefId ( )

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

References $testRefId.

Referenced by buildQuestionRelatedObjectiveList(), and buildQuestionRelatedObjectiveListByTest().

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

Here is the caller graph for this function:

◆ getUserId()

ilLOTestQuestionAdapter::getUserId ( )

protected

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

References $user_id.

                                   : int
     {
         return $this->user_id;
     }

◆ hideQuestions()

ilLOTestQuestionAdapter::hideQuestions ( ilTestSequence $seq )

protected

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

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

Referenced by prepareTestPass().

                                                          : void
     {
         // 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 420 of file class.ilLOTestQuestionAdapter.php.

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

Referenced by notifyTestStart().

                                                           : void
     {
         $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

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

References getAssignments(), ilTestSession\getRefId(), isQualifiedStartRun(), ILIAS\Repository\logger(), ilLOUtils\lookupMaxAttempts(), ilLOUtils\lookupObjectiveRequiredPercentage(), and ilLOUserResults\lookupResult().

Referenced by prepareTestPass().

                                                              : void
     {
         // 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) {
             $old_result = ilLOUserResults::lookupResult(
                 $this->container_id,
                 $this->user_id,
                 $run->getObjectiveId(),
                 $this->getAssignments()->getTypeByTest($session->getRefId())
             );
 
             $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 ( int $a_qid )

protected

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

Referenced by hideQuestions(), and setQuestionsOptional().

                                           : bool
     {
         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.

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

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

Referenced by initUserResult().

                                                                   : bool
     {
         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;
         }
         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 ( int $a_question_id )

protected

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

References ilCourseObjectiveQuestion\lookupObjectivesOfQuestion().

Referenced by buildQuestionRelatedObjectiveListByQuestions().

                                                                              : array
     {
         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 ( int $a_id )

protected

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

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

Referenced by buildQuestionRelatedObjectiveListByQuestions().

                                                                                         : array
     {
         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	(	int	$a_container_id,
		int	$a_tst_ref_id,
		int	$a_user_id
	)

protected

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

References $results, ilCourseObjective\_getObjectiveIds(), ilLOTestAssignments\getInstance(), getSettings(), ilLOTestAssignments\getTestByObjective(), ilLOTestAssignments\getTypeByTest(), ILIAS\Repository\logger(), ilLOSettings\TYPE_TEST_INITIAL, and ilLOSettings\TYPE_TEST_QUALIFIED.

Referenced by notifyTestStart().

                                                                                                                 : array
     {
         $assignments = ilLOTestAssignments::getInstance($a_container_id);
 
         $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 ($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);
         $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,
		int	$a_test_obj_id
	)

Called from learning objective test on actual test start.

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

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

                                                                                       : void
     {
         $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
         ilLOTestRun::deleteRun(
             $a_test_session->getObjectiveOrientedContainerId(),
             $a_test_session->getUserId(),
             $a_test_obj_id
         );
 
         foreach ($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.

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

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

                                                                                                    : bool
     {
         $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

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

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

Referenced by prepareTestPass().

                                                                 : void
     {
         // 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 ( int $testRefId )

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

References $testRefId.

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

◆ storeTestRun()

ilLOTestQuestionAdapter::storeTestRun ( )

protected

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

Referenced by prepareTestPass().

                                      : void
     {
         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 464 of file class.ilLOTestQuestionAdapter.php.

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

Referenced by updateQuestions().

                                                                                         : void
     {
         foreach ($this->run as $tst_run) {
             $tst_run->clearQuestions();
             $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((int) $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

Definition at line 351 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.

                                                                                   : void
     {
         foreach ($this->run as $run) {
             if ($run->questionExists($qst->getId())) {
                 $GLOBALS['DIC']['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();
 
                 $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,
                     (float) $res['percentage'],
                     $old_result['limit_perc'],
                     $old_result['tries'],
                     $old_result['is_final']
                 );
                 ilLPStatusWrapper::_updateStatus($this->container_id, $this->user_id);
             }
         }
     }

Here is the call graph for this function:

◆ updateQuestions()

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

protected

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

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

Referenced by prepareTestPass().

                                                                                    : void
     {
         if ($this->getAssignments()->isSeparateTest($session->getRefId())) {
             $this->updateSeparateTestQuestions($session, $seq);
             return;
         }
         if ($seq instanceof ilTestSequenceFixedQuestionSet) {
             $this->updateFixedQuestions($session, $seq);
             return;
         }
         if ($seq instanceof ilTestSequenceRandomQuestionSet) {
             $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 481 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().

                                                                                                           : void
     {
         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((int) $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

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

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

Referenced by updateQuestions().

                                                                                                : void
     {
         foreach ($this->run as $tst_run) {
             $tst_run->clearQuestions();
             $points = 0;
             foreach ($seq->getQuestionIds() as $qst_id) {
                 $tst_run->addQuestion($qst_id);
                 $points += ilCourseObjectiveQuestion::_lookupMaximumPointsOfQuestion($qst_id);
             }
             $tst_run->setMaxPoints((int) $points);
         }
     }

Here is the call graph for this function:

Here is the caller graph for this function:

Field Documentation

◆ $assignments

ilLOTestAssignments ilLOTestQuestionAdapter::$assignments

protected

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

Referenced by getAssignments().

◆ $container_id

int ilLOTestQuestionAdapter::$container_id = 0

protected

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

Referenced by getContainerId().

◆ $logger

ilLogger ilLOTestQuestionAdapter::$logger

protected

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

◆ $run

array ilLOTestQuestionAdapter::$run = []

protected

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

◆ $settings

ilLOSettings ilLOTestQuestionAdapter::$settings

protected

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

Referenced by getSettings().

◆ $testRefId

int ilLOTestQuestionAdapter::$testRefId = null

protected

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

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

◆ $user_id

int ilLOTestQuestionAdapter::$user_id = 0

protected

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

Referenced by getUserId().

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

components/ILIAS/Course/classes/Objectives/class.ilLOTestQuestionAdapter.php

Public Member Functions

Static Public Member Functions

Protected Member Functions

Protected Attributes

Detailed Description

Constructor & Destructor Documentation

◆ __construct()

Member Function Documentation

◆ buildQuestionRelatedObjectiveList()

◆ buildQuestionRelatedObjectiveListByQuestions()

◆ buildQuestionRelatedObjectiveListByTest()

◆ getAssignments()

◆ getContainerId()

◆ getInstance()

◆ 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

◆ $run

◆ $settings

◆ $testRefId

◆ $user_id