ilTestSkillEvaluation Class Reference

Collaboration diagram for ilTestSkillEvaluation:

Public Member Functions
	__construct (ilDBInterface $db, $testId, $refId)
	getUserId ()
	setUserId ($userId)
	getActiveId ()
	setActiveId ($activeId)
	getPass ()
	setPass ($pass)
	getNumRequiredBookingsForSkillTriggering ()
	setNumRequiredBookingsForSkillTriggering ($numRequiredBookingsForSkillTriggering)
	init (ilAssQuestionList $questionList)
	evaluate ($testResults)
	getReachedSkillLevels ()
	handleSkillTriggering ()
	getSkillsMatchingNumAnswersBarrier ()
	getSkillsInvolvedByAssignment ()
	isAssignedSkill ($skillBaseId, $skillTrefId)
	getAssignedSkillMatchingSkillProfiles ()
	noProfileMatchingAssignedSkillExists ($availableSkillProfiles)

Private Member Functions
	reset ()
	initTestQuestionData (ilAssQuestionList $questionList)
	initTestResultData ($testResults)
	drawUpSkillPointAccounts ()
	isAnsweredQuestion ($questionId)
	determineReachedSkillPointsWithSolutionCompare (ilAssQuestionSolutionComparisonExpressionList $expressionList)
	calculateReachedSkillPointsFromTestPoints ($skillPoints, $maxTestPoints, $reachedTestPoints)
	bookToSkillPointAccount ($skillBaseId, $skillTrefId, $maxSkillPoints, $reachedSkillPoints)
	evaluateSkillPointAccounts ()
	doesNumBookingsExceedRequiredBookingsBarrier (ilTestSkillPointAccount $skillPointAccount)
	invokeSkillLevelTrigger ($skillLevelId, $skillTrefId)

Private Attributes
	$db
	$refId
	$skillQuestionAssignmentList
	$skillLevelThresholdList
	$questions
	$maxPointsByQuestion
	$reachedPointsByQuestion
	$skillPointAccounts
	$reachedSkillLevels
	$userId
	$activeId
	$pass
	$numRequiredBookingsForSkillTriggering

Detailed Description

Definition at line 17 of file class.ilTestSkillEvaluation.php.

Constructor & Destructor Documentation

__construct()

ilTestSkillEvaluation::__construct	(	ilDBInterface	$db,
			$testId,
			$refId
	)

Definition at line 84 of file class.ilTestSkillEvaluation.php.

References $db, and $refId.

    {
        $this->db = $db;
        $this->refId = $refId;

        $this->skillQuestionAssignmentList = new ilAssQuestionSkillAssignmentList($this->db);

        $this->skillLevelThresholdList = new ilTestSkillLevelThresholdList($this->db);
        $this->skillLevelThresholdList->setTestId($testId);

        $this->questions = array();
        $this->maxPointsByQuestion = array();
    }

Member Function Documentation

bookToSkillPointAccount()

ilTestSkillEvaluation::bookToSkillPointAccount (   $skillBaseId,   $skillTrefId,   $maxSkillPoints,   $reachedSkillPoints  )

private

Definition at line 280 of file class.ilTestSkillEvaluation.php.

Referenced by drawUpSkillPointAccounts().

    {
        $skillKey = $skillBaseId . ':' . $skillTrefId;

        if (!isset($this->skillPointAccounts[$skillKey])) {
            $this->skillPointAccounts[$skillKey] = new ilTestSkillPointAccount();
        }

        $this->skillPointAccounts[$skillKey]->addBooking($maxSkillPoints, $reachedSkillPoints);
    }

Here is the caller graph for this function:

calculateReachedSkillPointsFromTestPoints()

ilTestSkillEvaluation::calculateReachedSkillPointsFromTestPoints (   $skillPoints,   $maxTestPoints,   $reachedTestPoints  )

private

Definition at line 265 of file class.ilTestSkillEvaluation.php.

Referenced by drawUpSkillPointAccounts().

    {
        if ($reachedTestPoints < 0) {
            $reachedTestPoints = 0;
        }

        $factor = 0;

        if ($maxTestPoints > 0) {
            $factor = $reachedTestPoints / $maxTestPoints;
        }

        return ($skillPoints * $factor);
    }

Here is the caller graph for this function:

determineReachedSkillPointsWithSolutionCompare()

ilTestSkillEvaluation::determineReachedSkillPointsWithSolutionCompare ( ilAssQuestionSolutionComparisonExpressionList  $expressionList )

private

Definition at line 240 of file class.ilTestSkillEvaluation.php.

References ilAssQuestionSolutionComparisonExpressionList\get(), getActiveId(), getPass(), and ilAssQuestionSolutionComparisonExpressionList\getQuestionId().

Referenced by drawUpSkillPointAccounts().

    {
        $questionProvider = new ilAssLacQuestionProvider();
        $questionProvider->setQuestionId($expressionList->getQuestionId());

        foreach ($expressionList->get() as $expression) {
            /* @var ilAssQuestionSolutionComparisonExpression $expression */
            
            $conditionParser = new ilAssLacConditionParser();
            $conditionComposite = $conditionParser->parse($expression->getExpression());
            
            $compositeEvaluator = new ilAssLacCompositeEvaluator(
                $questionProvider,
                $this->getActiveId(),
                $this->getPass()
            );

            if ($compositeEvaluator->evaluate($conditionComposite)) {
                return $expression->getPoints();
            }
        }
        
        return 0;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

doesNumBookingsExceedRequiredBookingsBarrier()

ilTestSkillEvaluation::doesNumBookingsExceedRequiredBookingsBarrier ( ilTestSkillPointAccount  $skillPointAccount )

private

Definition at line 329 of file class.ilTestSkillEvaluation.php.

References ilTestSkillPointAccount\getNumBookings(), and getNumRequiredBookingsForSkillTriggering().

Referenced by evaluateSkillPointAccounts(), and getSkillsMatchingNumAnswersBarrier().

    {
        return $skillPointAccount->getNumBookings() >= $this->getNumRequiredBookingsForSkillTriggering();
    }

Here is the call graph for this function:

Here is the caller graph for this function:

drawUpSkillPointAccounts()

ilTestSkillEvaluation::drawUpSkillPointAccounts ( )

private

Definition at line 200 of file class.ilTestSkillEvaluation.php.

References bookToSkillPointAccount(), calculateReachedSkillPointsFromTestPoints(), determineReachedSkillPointsWithSolutionCompare(), and isAnsweredQuestion().

Referenced by evaluate().

    {
        foreach ($this->questions as $questionId) {
            if (!$this->isAnsweredQuestion($questionId)) {
                continue;
            }

            $assignments = $this->skillQuestionAssignmentList->getAssignmentsByQuestionId($questionId);

            foreach ($assignments as $assignment) {
                if ($assignment->hasEvalModeBySolution()) {
                    $reachedSkillPoints = $this->determineReachedSkillPointsWithSolutionCompare(
                        $assignment->getSolutionComparisonExpressionList()
                    );
                } else {
                    $maxTestPoints = $this->maxPointsByQuestion[$questionId];
                    $reachedTestPoints = $this->reachedPointsByQuestion[$questionId];

                    $reachedSkillPoints = $this->calculateReachedSkillPointsFromTestPoints(
                        $assignment->getSkillPoints(),
                        $maxTestPoints,
                        $reachedTestPoints
                    );
                }

                $this->bookToSkillPointAccount(
                    $assignment->getSkillBaseId(),
                    $assignment->getSkillTrefId(),
                    $assignment->getMaxSkillPoints(),
                    $reachedSkillPoints
                );
            }
        }
    }

Here is the call graph for this function:

Here is the caller graph for this function:

evaluate()

ilTestSkillEvaluation::evaluate

(

$testResults

)

Parameters

array

$testResults

An array containing the test results for a given user

Definition at line 151 of file class.ilTestSkillEvaluation.php.

References drawUpSkillPointAccounts(), evaluateSkillPointAccounts(), initTestResultData(), and reset().

    {
        $this->reset();

        $this->initTestResultData($testResults);

        $this->drawUpSkillPointAccounts();
        $this->evaluateSkillPointAccounts();
    }

Here is the call graph for this function:

evaluateSkillPointAccounts()

ilTestSkillEvaluation::evaluateSkillPointAccounts ( )

private

Definition at line 291 of file class.ilTestSkillEvaluation.php.

References doesNumBookingsExceedRequiredBookingsBarrier().

Referenced by evaluate().

    {
        foreach ($this->skillPointAccounts as $skillKey => $skillPointAccount) {
            /* @var ilTestSkillPointAccount $skillPointAccount */

            if (!$this->doesNumBookingsExceedRequiredBookingsBarrier($skillPointAccount)) {
                continue;
            }
            
            list($skillBaseId, $skillTrefId) = explode(':', $skillKey);

            $skill = new ilBasicSkill($skillBaseId);
            $levels = $skill->getLevelData();

            $reachedLevelId = null;

            foreach ($levels as $level) {
                $threshold = $this->skillLevelThresholdList->getThreshold($skillBaseId, $skillTrefId, $level['id']);

                if (!($threshold instanceof ilTestSkillLevelThreshold) || !$threshold->getThreshold()) {
                    continue;
                }

                $reachedLevelId = $level['id'];
                
                if ($skillPointAccount->getTotalReachedSkillPercent() <= $threshold->getThreshold()) {
                    break;
                }
            }

            if ($reachedLevelId) {
                $this->reachedSkillLevels[] = array(
                    'sklBaseId' => $skillBaseId, 'sklTrefId' => $skillTrefId, 'sklLevelId' => $reachedLevelId
                );
            }
        }
    }

Here is the call graph for this function:

Here is the caller graph for this function:

getActiveId()

ilTestSkillEvaluation::getActiveId

(

)

Definition at line 108 of file class.ilTestSkillEvaluation.php.

References $activeId.

Referenced by determineReachedSkillPointsWithSolutionCompare().

    {
        return $this->activeId;
    }

Here is the caller graph for this function:

getAssignedSkillMatchingSkillProfiles()

ilTestSkillEvaluation::getAssignedSkillMatchingSkillProfiles

(

)

Definition at line 408 of file class.ilTestSkillEvaluation.php.

References ilSkillProfile\getProfilesOfUser(), and getUserId().

    {
        $matchingSkillProfiles = array();

        $usersProfiles = ilSkillProfile::getProfilesOfUser($this->getUserId());

        foreach ($usersProfiles as $profileData) {
            $profile = new ilSkillProfile($profileData['id']);
            $assignedSkillLevels = $profile->getSkillLevels();

            foreach ($assignedSkillLevels as $assignedSkillLevel) {
                $skillBaseId = $assignedSkillLevel['base_skill_id'];
                $skillTrefId = $assignedSkillLevel['tref_id'];

                if ($this->skillQuestionAssignmentList->isAssignedSkill($skillBaseId, $skillTrefId)) {
                    $matchingSkillProfiles[$profileData['id']] = $profile->getTitle();
                }
            }
        }

        return $matchingSkillProfiles;
    }

Here is the call graph for this function:

getNumRequiredBookingsForSkillTriggering()

ilTestSkillEvaluation::getNumRequiredBookingsForSkillTriggering

(

)

Definition at line 128 of file class.ilTestSkillEvaluation.php.

References $numRequiredBookingsForSkillTriggering.

Referenced by doesNumBookingsExceedRequiredBookingsBarrier().

    {
        return $this->numRequiredBookingsForSkillTriggering;
    }

Here is the caller graph for this function:

getPass()

ilTestSkillEvaluation::getPass

(

)

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

References $pass.

Referenced by determineReachedSkillPointsWithSolutionCompare(), and invokeSkillLevelTrigger().

    {
        return $this->pass;
    }

Here is the caller graph for this function:

getReachedSkillLevels()

ilTestSkillEvaluation::getReachedSkillLevels

(

)

Definition at line 161 of file class.ilTestSkillEvaluation.php.

References $reachedSkillLevels.

Referenced by handleSkillTriggering().

    {
        return $this->reachedSkillLevels;
    }

Here is the caller graph for this function:

getSkillsInvolvedByAssignment()

ilTestSkillEvaluation::getSkillsInvolvedByAssignment

(

)

Definition at line 387 of file class.ilTestSkillEvaluation.php.

    {
        $uniqueSkills = array();
        
        foreach ($this->skillQuestionAssignmentList->getUniqueAssignedSkills() as $skill) {
            $skillKey = $skill['skill_base_id'] . ':' . $skill['skill_tref_id'];
            
            $uniqueSkills[$skillKey] = array(
                'base_skill_id' => (int) $skill['skill_base_id'],
                'tref_id' => (int) $skill['skill_tref_id']
            );
        }

        return $uniqueSkills;
    }

getSkillsMatchingNumAnswersBarrier()

ilTestSkillEvaluation::getSkillsMatchingNumAnswersBarrier

(

)

Definition at line 369 of file class.ilTestSkillEvaluation.php.

References doesNumBookingsExceedRequiredBookingsBarrier().

    {
        $skillsMatchingNumAnswersBarrier = array();
        
        foreach ($this->skillPointAccounts as $skillKey => $skillPointAccount) {
            if ($this->doesNumBookingsExceedRequiredBookingsBarrier($skillPointAccount)) {
                list($skillBaseId, $skillTrefId) = explode(':', $skillKey);
                
                $skillsMatchingNumAnswersBarrier[$skillKey] = array(
                    'base_skill_id' => (int) $skillBaseId,
                    'tref_id' => (int) $skillTrefId
                );
            }
        }
        
        return $skillsMatchingNumAnswersBarrier;
    }

Here is the call graph for this function:

getUserId()

ilTestSkillEvaluation::getUserId

(

)

Definition at line 98 of file class.ilTestSkillEvaluation.php.

References $userId.

Referenced by getAssignedSkillMatchingSkillProfiles(), handleSkillTriggering(), and invokeSkillLevelTrigger().

    {
        return $this->userId;
    }

Here is the caller graph for this function:

handleSkillTriggering()

ilTestSkillEvaluation::handleSkillTriggering

(

)

Definition at line 334 of file class.ilTestSkillEvaluation.php.

References ilPersonalSkill\addPersonalSkill(), getReachedSkillLevels(), getUserId(), and invokeSkillLevelTrigger().

    {
        foreach ($this->getReachedSkillLevels() as $reachedSkillLevel) {
            $this->invokeSkillLevelTrigger($reachedSkillLevel['sklLevelId'], $reachedSkillLevel['sklTrefId']);

            if ($reachedSkillLevel['sklTrefId'] > 0) {
                ilPersonalSkill::addPersonalSkill($this->getUserId(), $reachedSkillLevel['sklTrefId']);
            } else {
                ilPersonalSkill::addPersonalSkill($this->getUserId(), $reachedSkillLevel['sklBaseId']);
            }
        }
    }

Here is the call graph for this function:

init()

ilTestSkillEvaluation::init

(

ilAssQuestionList

$questionList

)

Definition at line 138 of file class.ilTestSkillEvaluation.php.

References ilAssQuestionList\getParentObjId(), and initTestQuestionData().

    {
        $this->skillQuestionAssignmentList->setParentObjId($questionList->getParentObjId());
        $this->skillQuestionAssignmentList->loadFromDb();
        
        $this->skillLevelThresholdList->loadFromDb();
        
        $this->initTestQuestionData($questionList);
    }

Here is the call graph for this function:

initTestQuestionData()

ilTestSkillEvaluation::initTestQuestionData ( ilAssQuestionList  $questionList )

private

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

References ilAssQuestionList\getQuestionDataArray().

Referenced by init().

    {
        foreach ($questionList->getQuestionDataArray() as $questionData) {
            $this->questions[] = $questionData['question_id'];

            $this->maxPointsByQuestion[ $questionData['question_id'] ] = $questionData['points'];
        }
    }

Here is the call graph for this function:

Here is the caller graph for this function:

initTestResultData()

ilTestSkillEvaluation::initTestResultData (   $testResults )

private

Parameters

array

$testResults

Definition at line 185 of file class.ilTestSkillEvaluation.php.

References $result.

Referenced by evaluate().

    {
        foreach ($testResults as $key => $result) {
            if ($key === 'pass' || $key === 'test') { // note: key int 0 IS == 'pass' or 'buxtehude'
                continue;
            }

            if (!$result['workedthrough']) {
                continue;
            }
            
            $this->reachedPointsByQuestion[ $result['qid'] ] = $result['reached'];
        }
    }

Here is the caller graph for this function:

invokeSkillLevelTrigger()

ilTestSkillEvaluation::invokeSkillLevelTrigger (   $skillLevelId,   $skillTrefId  )

private

Definition at line 347 of file class.ilTestSkillEvaluation.php.

References $DIC, ilBasicSkill\ACHIEVED, getPass(), getUserId(), and ilBasicSkill\writeUserSkillLevelStatus().

Referenced by handleSkillTriggering().

    {
        ilBasicSkill::writeUserSkillLevelStatus(
            $skillLevelId,
            $this->getUserId(),
            $this->refId,
            $skillTrefId,
            ilBasicSkill::ACHIEVED,
            true,
            0,
            $this->getPass()
        );
        
        /* @var ILIAS\DI\Container $DIC */ global $DIC;
        
        $DIC->logger()->root()->info(
            "refId={$this->refId} / usrId={$this->getUserId()} / levelId={$skillLevelId} / trefId={$skillTrefId}"
        );

        //mail('bheyser@databay.de', "trigger skill level $skillLevelId for user {$this->getUserId()}", '');
    }

Here is the call graph for this function:

Here is the caller graph for this function:

isAnsweredQuestion()

ilTestSkillEvaluation::isAnsweredQuestion (   $questionId )

private

Definition at line 235 of file class.ilTestSkillEvaluation.php.

Referenced by drawUpSkillPointAccounts().

    {
        return isset($this->reachedPointsByQuestion[$questionId]);
    }

Here is the caller graph for this function:

isAssignedSkill()

ilTestSkillEvaluation::isAssignedSkill	(		$skillBaseId,
			$skillTrefId
	)

Definition at line 403 of file class.ilTestSkillEvaluation.php.

    {
        $this->skillQuestionAssignmentList->isAssignedSkill($skillBaseId, $skillTrefId);
    }

noProfileMatchingAssignedSkillExists()

ilTestSkillEvaluation::noProfileMatchingAssignedSkillExists

(

$availableSkillProfiles

)

Definition at line 431 of file class.ilTestSkillEvaluation.php.

    {
        $noProfileMatchingSkills = $this->skillQuestionAssignmentList->getUniqueAssignedSkills();

        foreach ($availableSkillProfiles as $skillProfileId => $skillProfileTitle) {
            $profile = new ilSkillProfile($skillProfileId);
            $assignedSkillLevels = $profile->getSkillLevels();

            foreach ($assignedSkillLevels as $assignedSkillLevel) {
                $skillBaseId = $assignedSkillLevel['base_skill_id'];
                $skillTrefId = $assignedSkillLevel['tref_id'];

                if ($this->skillQuestionAssignmentList->isAssignedSkill($skillBaseId, $skillTrefId)) {
                    unset($noProfileMatchingSkills["{$skillBaseId}:{$skillTrefId}"]);
                }
            }
        }

        return count($noProfileMatchingSkills);
    }

reset()

ilTestSkillEvaluation::reset ( )

private

Definition at line 166 of file class.ilTestSkillEvaluation.php.

Referenced by evaluate().

    {
        $this->reachedPointsByQuestion = array();
        $this->skillPointAccounts = array();
        $this->reachedSkillLevels = array();
    }

Here is the caller graph for this function:

setActiveId()

ilTestSkillEvaluation::setActiveId

(

$activeId

)

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

References $activeId.

    {
        $this->activeId = $activeId;
    }

setNumRequiredBookingsForSkillTriggering()

ilTestSkillEvaluation::setNumRequiredBookingsForSkillTriggering

(

$numRequiredBookingsForSkillTriggering

)

Definition at line 133 of file class.ilTestSkillEvaluation.php.

References $numRequiredBookingsForSkillTriggering.

    {
        $this->numRequiredBookingsForSkillTriggering = $numRequiredBookingsForSkillTriggering;
    }

setPass()

ilTestSkillEvaluation::setPass

(

$pass

)

Definition at line 123 of file class.ilTestSkillEvaluation.php.

References $pass.

    {
        $this->pass = $pass;
    }

setUserId()

ilTestSkillEvaluation::setUserId

(

$userId

)

Definition at line 103 of file class.ilTestSkillEvaluation.php.

References $userId.

Referenced by ilTestPlayerAbstractGUI\handleSkillTriggering(), and ilTestSkillEvaluationGUI\init().

    {
        $this->userId = $userId;
    }

Here is the caller graph for this function:

Field Documentation

$activeId

ilTestSkillEvaluation::$activeId

private

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

Referenced by getActiveId(), and setActiveId().

$db

ilTestSkillEvaluation::$db

private

Definition at line 22 of file class.ilTestSkillEvaluation.php.

Referenced by __construct().

$maxPointsByQuestion

ilTestSkillEvaluation::$maxPointsByQuestion

private

Definition at line 47 of file class.ilTestSkillEvaluation.php.

$numRequiredBookingsForSkillTriggering

ilTestSkillEvaluation::$numRequiredBookingsForSkillTriggering

private

Definition at line 82 of file class.ilTestSkillEvaluation.php.

Referenced by getNumRequiredBookingsForSkillTriggering(), and setNumRequiredBookingsForSkillTriggering().

$pass

ilTestSkillEvaluation::$pass

private

Definition at line 77 of file class.ilTestSkillEvaluation.php.

Referenced by getPass(), and setPass().

$questions

ilTestSkillEvaluation::$questions

private

Definition at line 42 of file class.ilTestSkillEvaluation.php.

$reachedPointsByQuestion

ilTestSkillEvaluation::$reachedPointsByQuestion

private

Definition at line 52 of file class.ilTestSkillEvaluation.php.

$reachedSkillLevels

ilTestSkillEvaluation::$reachedSkillLevels

private

Definition at line 62 of file class.ilTestSkillEvaluation.php.

Referenced by getReachedSkillLevels().

$refId

ilTestSkillEvaluation::$refId

private

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

Referenced by __construct().

$skillLevelThresholdList

ilTestSkillEvaluation::$skillLevelThresholdList

private

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

$skillPointAccounts

ilTestSkillEvaluation::$skillPointAccounts

private

Definition at line 57 of file class.ilTestSkillEvaluation.php.

$skillQuestionAssignmentList

ilTestSkillEvaluation::$skillQuestionAssignmentList

private

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

$userId

ilTestSkillEvaluation::$userId

private

Definition at line 67 of file class.ilTestSkillEvaluation.php.

Referenced by getUserId(), and setUserId().

---

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

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