ilTestScoring Class Reference

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.

References $test.

    {
        $this->test = $test;
        $this->preserve_manual_scores = false;

        $this->recalculatedPasses = array();
    }

Member Function Documentation

addRecalculatedPassByActive()

ilTestScoring::addRecalculatedPassByActive	(		$activeId,
			$pass
	)

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

Referenced by recalculatePasses().

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

        $this->recalculatedPasses[$activeId][] = $pass;
    }

Here is the caller graph for this function:

getNumManualScorings()

ilTestScoring::getNumManualScorings

(

)

Returns

int

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

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

                                          : 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;
    }

Here is the call graph for this function:

getPreserveManualScores()

ilTestScoring::getPreserveManualScores

(

)

Returns

boolean

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

References $preserve_manual_scores.

                                             : bool
    {
        return $this->preserve_manual_scores;
    }

getQuestionId()

ilTestScoring::getQuestionId

(

)

Returns

int

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

References $questionId.

Referenced by getNumManualScorings(), and recalculatePass().

                                   : int
    {
        return $this->questionId;
    }

Here is the caller graph for this function:

getRecalculatedPassesByActives()

ilTestScoring::getRecalculatedPassesByActives

(

)

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

References $recalculatedPasses.

                                                    : array
    {
        return $this->recalculatedPasses;
    }

recalculatePass()

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

Parameters

$passdata
$active_id
$pass

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

References assQuestion\_setReachedPoints(), getQuestionId(), and assQuestion\setForcePassResultUpdateEnabled().

Referenced by recalculatePasses(), and recalculateSolution().

    {
        $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);
            }
        }
    }

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.

References addRecalculatedPassByActive(), and recalculatePass().

Referenced by recalculateSolutions().

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

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.

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

    {
        $user_data = $this
            ->test
            ->getCompleteEvaluationData(false)
            ->getParticipant($active_id)
            ->getPass($pass);

        $this->recalculatePass($user_data, $active_id, $pass);
        assQuestion::_updateTestResultCache($active_id);
    }

Here is the call graph for this function:

recalculateSolutions()

ilTestScoring::recalculateSolutions

(

)

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

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

    {
        $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);
            }
        }
    }

Here is the call graph for this function:

removeAllQuestionResults()

ilTestScoring::removeAllQuestionResults

(

$questionId

)

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

References $DIC, $query, and $questionId.

    {
        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));
    }

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.

References $preserve_manual_scores.

    {
        $this->preserve_manual_scores = $preserve_manual_scores;
    }

setQuestionId()

ilTestScoring::setQuestionId

(

int

$questionId

)

Parameters

int

$questionId

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

References $questionId.

    {
        $this->questionId = $questionId;
    }

updatePassAndTestResults()

ilTestScoring::updatePassAndTestResults

(

$activeIds

)

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

References $DIC, $test, assQuestion\_updateTestResultCache(), and ilTestPassesSelector\setActiveId().

    {
        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);
        }
    }

Here is the call graph for this function:

Field Documentation

$preserve_manual_scores

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

ilTestScoring::$test

protected

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

Referenced by __construct(), and updatePassAndTestResults().

---

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

• Modules/Test/classes/class.ilTestScoring.php