This file is part of ILIAS, a powerful learning management system published by ILIAS open source e-Learning e.V. More...

Collaboration diagram for ilTestScoring:

Public Member Functions
	__construct (ilObjTest $test)

	setPreserveManualScores ($preserve_manual_scores)

	getPreserveManualScores ()

	getQuestionId ()

	setQuestionId (int $questionId)

	recalculateSolutions ()

	recalculateSolution ($active_id, $pass)
	Updates passed status of the Test. More...

	recalculatePasses ($userdata, $active_id)

	recalculatePass ($passdata, $active_id, $pass)

	resetRecalculatedPassesByActives ()

	getRecalculatedPassesByActives ()

	addRecalculatedPassByActive ($activeId, $pass)

	removeAllQuestionResults ($questionId)

	updatePassAndTestResults ($activeIds)

	getNumManualScorings ()

Protected Attributes
	$test

	$preserve_manual_scores

	$questionId = 0

Private Attributes
	$recalculatedPasses

Detailed Description

This file is part of ILIAS, a powerful learning management system published by ILIAS open source e-Learning e.V.

ILIAS is licensed with the GPL-3.0, see https://www.gnu.org/licenses/gpl-3.0.en.html You should have received a copy of said license along with the source code, too.

If this is not the case or you just want to try ILIAS, you'll find us at: https://www.ilias.de https://github.com/ILIAS-eLearning Class ilTestScoring

This class holds a mechanism to get the scoring for

a test,
a user in a test,
a pass in a users passes in a test, or
a question in a pass in a users passes in a test.

Warning: Please use carefully, this is one of the classes that may cause funny spikes on your servers load graph on large datasets in the test.

Author: Maximilian Becker mbeck.nosp@m.er@d.nosp@m.ataba.nosp@m.y.de

Version: $Id$

Definition at line 38 of file class.ilTestScoring.php.

Constructor & Destructor Documentation

◆ __construct()

ilTestScoring::__construct ( ilObjTest $test )

Definition at line 53 of file class.ilTestScoring.php.

    {
        $this->test = $test;
        $this->preserve_manual_scores = false;
 
        $this->recalculatedPasses = array();
    }

References $test.

Member Function Documentation

◆ addRecalculatedPassByActive()

ilTestScoring::addRecalculatedPassByActive	(	$activeId,
		$pass
	)

Definition at line 219 of file class.ilTestScoring.php.

    {
        if (!array_key_exists($activeId, $this->recalculatedPasses)
            || !is_array($this->recalculatedPasses[$activeId])
        ) {
            $this->recalculatedPasses[$activeId] = array();
        }
 
        $this->recalculatedPasses[$activeId][] = $pass;
    }

Referenced by recalculatePasses().

Here is the caller graph for this function:

◆ getNumManualScorings()

ilTestScoring::getNumManualScorings ( )

Returns: int

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

                                          : int
    {
        global $DIC; /* @var ILIAS\DI\Container $DIC */
 
        $query = "
                        SELECT COUNT(*) num_manual_scorings
                        FROM tst_test_result tres
 
                        INNER JOIN tst_active tact
                        ON tact.active_id = tres.active_fi
                        AND tact.test_fi = %s
 
                        WHERE tres.manual = 1
                ";
 
        $types = array('integer');
        $values = array($this->test->getTestId());
 
        if ($this->getQuestionId()) {
            $query .= "
                                AND tres.question_fi = %s
                        ";
 
            $types[] = 'integer';
            $values[] = $this->getQuestionId();
        }
 
        $res = $DIC->database()->queryF($query, $types, $values);
 
        while ($row = $DIC->database()->fetchAssoc($res)) {
            return (int) $row['num_manual_scorings'];
        }
 
        return 0;
    }

References $DIC, $query, $res, and getQuestionId().

Here is the call graph for this function:

◆ getPreserveManualScores()

ilTestScoring::getPreserveManualScores ( )

Returns: boolean

Definition at line 72 of file class.ilTestScoring.php.

                                             : bool
    {
        return $this->preserve_manual_scores;
    }

References $preserve_manual_scores.

◆ getQuestionId()

ilTestScoring::getQuestionId ( )

Returns: int

Definition at line 80 of file class.ilTestScoring.php.

                                   : int
    {
        return $this->questionId;
    }

References $questionId.

Referenced by getNumManualScorings(), and recalculatePass().

Here is the caller graph for this function:

◆ getRecalculatedPassesByActives()

ilTestScoring::getRecalculatedPassesByActives ( )

Definition at line 214 of file class.ilTestScoring.php.

                                                    : array
    {
        return $this->recalculatedPasses;
    }

References $recalculatedPasses.

◆ recalculatePass()

ilTestScoring::recalculatePass	(	$passdata,
		$active_id,
		$pass
	)

Parameters

$passdata
$active_id
$pass

Definition at line 145 of file class.ilTestScoring.php.

    {
        $questions = $passdata->getAnsweredQuestions();
        if (is_array($questions)) {
            foreach ($questions as $questiondata) {
                if ($this->getQuestionId() && $this->getQuestionId() != $questiondata['id']) {
                    continue;
                }
 
                $question_gui = $this->test->createQuestionGUI("", $questiondata['id']);
                $this->recalculateQuestionScore($question_gui, $active_id, $pass, $questiondata);
            }
        }
    }

References getQuestionId().

Referenced by recalculatePasses(), and recalculateSolution().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ recalculatePasses()

ilTestScoring::recalculatePasses	(	$userdata,
		$active_id
	)

Parameters

$userdata
$active_id

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

    {
        $passes = $userdata->getPasses();
        foreach ($passes as $pass => $passdata) {
            if (is_object($passdata)) {
                $this->recalculatePass($passdata, $active_id, $pass);
                $this->addRecalculatedPassByActive($active_id, $pass);
            }
        }
    }

References addRecalculatedPassByActive(), and recalculatePass().

Referenced by recalculateSolutions().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ recalculateSolution()

ilTestScoring::recalculateSolution	(	$active_id,
		$pass
	)

Updates passed status of the Test.

Parameters

$active_id
$pass

Definition at line 113 of file class.ilTestScoring.php.

    {
        $user_data = $this
            ->test
            ->getCompleteEvaluationData(false)
            ->getParticipant($active_id)
            ->getPass($pass);
 
        $this->recalculatePass($user_data, $active_id, $pass);
        assQuestion::_updateTestResultCache($active_id);
    }

References assQuestion\_updateTestResultCache(), and recalculatePass().

Here is the call graph for this function:

◆ recalculateSolutions()

ilTestScoring::recalculateSolutions ( )

Definition at line 93 of file class.ilTestScoring.php.

    {
        $participants = $this->test->getCompleteEvaluationData(false)->getParticipants();
        if (is_array($participants)) {
            require_once "./Modules/TestQuestionPool/classes/class.assQuestion.php";
            foreach ($participants as $active_id => $userdata) {
                if (is_object($userdata) && is_array($userdata->getPasses())) {
                    $this->recalculatePasses($userdata, $active_id);
                }
                assQuestion::_updateTestResultCache($active_id);
            }
        }
    }

References assQuestion\_updateTestResultCache(), and recalculatePasses().

Here is the call graph for this function:

◆ removeAllQuestionResults()

ilTestScoring::removeAllQuestionResults ( $questionId )

Definition at line 230 of file class.ilTestScoring.php.

    {
        global $DIC; /* @var ILIAS\DI\Container $DIC */
 
        $query = "DELETE FROM tst_test_result WHERE question_fi = %s";
        $DIC->database()->manipulateF($query, array('integer'), array($questionId));
    }

References $DIC, $query, and $questionId.

◆ resetRecalculatedPassesByActives()

ilTestScoring::resetRecalculatedPassesByActives ( )

Definition at line 209 of file class.ilTestScoring.php.

    {
        $this->recalculatedPasses = array();
    }

◆ setPreserveManualScores()

ilTestScoring::setPreserveManualScores ( $preserve_manual_scores )

Parameters

boolean $preserve_manual_scores

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

    {
        $this->preserve_manual_scores = $preserve_manual_scores;
    }

References $preserve_manual_scores.

◆ setQuestionId()

ilTestScoring::setQuestionId ( int $questionId )

Parameters

int $questionId

Definition at line 88 of file class.ilTestScoring.php.

    {
        $this->questionId = $questionId;
    }

References $questionId.

◆ updatePassAndTestResults()

ilTestScoring::updatePassAndTestResults ( $activeIds )

Definition at line 238 of file class.ilTestScoring.php.

    {
        global $DIC; /* @var ILIAS\DI\Container $DIC */
 
        foreach ($activeIds as $activeId) {
            $passSelector = new ilTestPassesSelector($DIC->database(), $this->test);
            $passSelector->setActiveId($activeId);
 
            foreach ($passSelector->getExistingPasses() as $pass) {
                assQuestion::_updateTestPassResults($activeId, $pass, $this->test->areObligationsEnabled());
            }
 
            assQuestion::_updateTestResultCache($activeId);
        }
    }

References $DIC, and assQuestion\_updateTestResultCache().

Here is the call graph for this function:

Field Documentation

◆ $preserve_manual_scores

bool ilTestScoring::$preserve_manual_scores

protected

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

Referenced by getPreserveManualScores(), and setPreserveManualScores().

◆ $questionId

ilTestScoring::$questionId = 0

protected

Definition at line 51 of file class.ilTestScoring.php.

Referenced by getQuestionId(), removeAllQuestionResults(), and setQuestionId().

◆ $recalculatedPasses

ilTestScoring::$recalculatedPasses

private

Definition at line 46 of file class.ilTestScoring.php.

Referenced by getRecalculatedPassesByActives().

◆ $test

ilObjTest ilTestScoring::$test

protected

Definition at line 41 of file class.ilTestScoring.php.

Referenced by __construct().

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

Modules/Test/classes/class.ilTestScoring.php

Public Member Functions

Protected Attributes

Private Attributes

Detailed Description

Constructor & Destructor Documentation

◆ __construct()

Member Function Documentation

◆ addRecalculatedPassByActive()

◆ getNumManualScorings()

◆ getPreserveManualScores()

◆ getQuestionId()

◆ getRecalculatedPassesByActives()

◆ recalculatePass()

◆ recalculatePasses()

◆ recalculateSolution()

◆ recalculateSolutions()

◆ removeAllQuestionResults()

◆ resetRecalculatedPassesByActives()

◆ setPreserveManualScores()

◆ setQuestionId()

◆ updatePassAndTestResults()

Field Documentation

◆ $preserve_manual_scores

◆ $questionId

◆ $recalculatedPasses

◆ $test