ilTestScoring Class Reference

Class ilTestScoring. 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

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 23 of file class.ilTestScoring.php.

Constructor & Destructor Documentation

__construct()

ilTestScoring::__construct

(

ilObjTest

$test

)

Definition at line 38 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 203 of file class.ilTestScoring.php.

References $pass.

Referenced by recalculatePasses().

    {
        if (!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 239 of file class.ilTestScoring.php.

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

    {
        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 57 of file class.ilTestScoring.php.

References $preserve_manual_scores.

    {
        return $this->preserve_manual_scores;
    }

getQuestionId()

ilTestScoring::getQuestionId

(

)

Returns

int

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

References $questionId.

Referenced by getNumManualScorings(), and recalculatePass().

    {
        return $this->questionId;
    }

Here is the caller graph for this function:

getRecalculatedPassesByActives()

ilTestScoring::getRecalculatedPassesByActives

(

)

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

References $recalculatedPasses.

    {
        return $this->recalculatedPasses;
    }

recalculatePass()

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

Parameters

$passdata
$active_id
$pass

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

References $pass, 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 114 of file class.ilTestScoring.php.

References $pass, 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 98 of file class.ilTestScoring.php.

References $pass, 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 78 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 212 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 193 of file class.ilTestScoring.php.

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

setPreserveManualScores()

ilTestScoring::setPreserveManualScores

(

$preserve_manual_scores

)

Parameters

boolean

$preserve_manual_scores

Definition at line 49 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 73 of file class.ilTestScoring.php.

References $questionId.

    {
        $this->questionId = $questionId;
    }

updatePassAndTestResults()

ilTestScoring::updatePassAndTestResults

(

$activeIds

)

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

References $DIC, $pass, $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 29 of file class.ilTestScoring.php.

Referenced by getPreserveManualScores(), and setPreserveManualScores().

$questionId

ilTestScoring::$questionId = 0

protected

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

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

$recalculatedPasses

ilTestScoring::$recalculatedPasses

private

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

Referenced by getRecalculatedPassesByActives().

$test

ilTestScoring::$test

protected

Definition at line 26 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