class.ilTestScoring.php

Go to the documentation of this file.

<?php
 
class ilTestScoring
{
    protected $test;
 
    protected $preserve_manual_scores;
 
    private $recalculatedPasses;
 
    protected $questionId = 0;
 
    public function __construct(ilObjTest $test)
    {
        $this->test = $test;
        $this->preserve_manual_scores = false;
 
        $this->recalculatedPasses = array();
    }
 
    public function setPreserveManualScores($preserve_manual_scores)
    {
        $this->preserve_manual_scores = $preserve_manual_scores;
    }
 
    public function getPreserveManualScores(): bool
    {
        return $this->preserve_manual_scores;
    }
 
    public function getQuestionId(): int
    {
        return $this->questionId;
    }
 
    public function setQuestionId(int $questionId)
    {
        $this->questionId = $questionId;
    }
 
    public function recalculateSolutions()
    {
        $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);
            }
        }
    }
 
    public function recalculateSolution($active_id, $pass)
    {
        $user_data = $this
            ->test
            ->getCompleteEvaluationData(false)
            ->getParticipant($active_id)
            ->getPass($pass);
 
        $this->recalculatePass($user_data, $active_id, $pass);
        assQuestion::_updateTestResultCache($active_id);
    }
 
    public function recalculatePasses($userdata, $active_id)
    {
        $passes = $userdata->getPasses();
        foreach ($passes as $pass => $passdata) {
            if (is_object($passdata)) {
                $this->recalculatePass($passdata, $active_id, $pass);
                $this->addRecalculatedPassByActive($active_id, $pass);
            }
        }
    }
 
    public function recalculatePass($passdata, $active_id, $pass)
    {
        $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);
            }
        }
    }
 
    public function recalculateQuestionScore($question_gui, $active_id, $pass, $questiondata)
    {
        if (is_object($question_gui)) {
            $reached = $question_gui->object->calculateReachedPoints($active_id, $pass);
            $actual_reached = $question_gui->object->adjustReachedPointsByScoringOptions($reached, $active_id, $pass);
 
            if ($this->preserve_manual_scores == true && $questiondata['manual'] == '1') {
                // Do we need processing here?
            } else {
                assQuestion::setForcePassResultUpdateEnabled(true);
 
                assQuestion::_setReachedPoints(
                    $active_id,
                    $questiondata['id'],
                    $actual_reached,
                    $question_gui->object->getMaximumPoints(),
                    $pass,
                    false,
                    true
                );
 
                assQuestion::setForcePassResultUpdateEnabled(false);
            }
        }
    }
 
    public function calculateBestSolutionForTest(): string
    {
        $solution = '';
        foreach ($this->test->getAllQuestions() as $question) {
            $question_gui = $this->test->createQuestionGUI("", $question['question_id']);
            $solution .= '<h1>' . $question_gui->object->getTitleForHTMLOutput() . '</h1>';
            $solution .= $question_gui->getSolutionOutput(0, null, true, true, false, false, true, false);
        }
 
        return $solution;
    }
 
    public function resetRecalculatedPassesByActives()
    {
        $this->recalculatedPasses = array();
    }
 
    public function getRecalculatedPassesByActives(): array
    {
        return $this->recalculatedPasses;
    }
 
    public function addRecalculatedPassByActive($activeId, $pass)
    {
        if (!array_key_exists($activeId, $this->recalculatedPasses)
            || !is_array($this->recalculatedPasses[$activeId])
        ) {
            $this->recalculatedPasses[$activeId] = array();
        }
 
        $this->recalculatedPasses[$activeId][] = $pass;
    }
 
    public function removeAllQuestionResults($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));
    }
 
    public function updatePassAndTestResults($activeIds)
    {
        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);
        }
    }
 
    public function getNumManualScorings(): 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;
    }
}