Collaboration diagram for ilTestSkillEvaluation:

Public Member Functions
	__construct (ilDB $db, $testId, $refId)

	getUserId ()

	setUserId ($userId)

	getActiveId ()

	setActiveId ($activeId)

	getPass ()

	setPass ($pass)

	getNumRequiredBookingsForSkillTriggering ()

	setNumRequiredBookingsForSkillTriggering ($numRequiredBookingsForSkillTriggering)

	init (ilAssQuestionList $questionList)

	evaluate ($testResults)

	getReachedSkillLevels ()

	handleSkillTriggering ()

	getReachedSkillLevelsForPersonalSkillGUI ()

	getUniqueAssignedSkillsForPersonalSkillGUI ()

	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 18 of file class.ilTestSkillEvaluation.php.

Constructor & Destructor Documentation

◆ __construct()

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

Definition at line 85 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 289 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 272 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 247 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 345 of file class.ilTestSkillEvaluation.php.

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

Referenced by evaluateSkillPointAccounts().

         {
                 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 205 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 152 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 301 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 109 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 402 of file class.ilTestSkillEvaluation.php.

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

         {
                 $matchingSkillProfiles = array();
 
                 include_once("./Services/Skill/classes/class.ilSkillProfile.php");
                 $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 129 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 119 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 162 of file class.ilTestSkillEvaluation.php.

References $reachedSkillLevels.

Referenced by getReachedSkillLevelsForPersonalSkillGUI(), and handleSkillTriggering().

         {
                 return $this->reachedSkillLevels;
         }

Here is the caller graph for this function:

◆ getReachedSkillLevelsForPersonalSkillGUI()

ilTestSkillEvaluation::getReachedSkillLevelsForPersonalSkillGUI ( )

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

References getReachedSkillLevels().

         {
                 $reachedLevels = array();
 
                 foreach($this->getReachedSkillLevels() as $reachedLevel)
                 {
                         $reachedLevels[$reachedLevel['sklBaseId']] = array(
                                 $reachedLevel['sklTrefId'] => $reachedLevel['sklLevelId']
                         );
                 }
 
                 return $reachedLevels;
         }

Here is the call graph for this function:

◆ getUniqueAssignedSkillsForPersonalSkillGUI()

ilTestSkillEvaluation::getUniqueAssignedSkillsForPersonalSkillGUI ( )

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

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

◆ getUserId()

ilTestSkillEvaluation::getUserId ( )

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

References $userId.

Referenced by getAssignedSkillMatchingSkillProfiles(), and invokeSkillLevelTrigger().

         {
                 return $this->userId;
         }

Here is the caller graph for this function:

◆ handleSkillTriggering()

ilTestSkillEvaluation::handleSkillTriggering ( )

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

References getReachedSkillLevels(), and invokeSkillLevelTrigger().

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

Here is the call graph for this function:

◆ init()

ilTestSkillEvaluation::init ( ilAssQuestionList $questionList )

Definition at line 139 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 174 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 187 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 358 of file class.ilTestSkillEvaluation.php.

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

Referenced by handleSkillTriggering().

         {
                 ilBasicSkill::writeUserSkillLevelStatus(
                         $skillLevelId, $this->getUserId(), $this->refId,
                         $skillTrefId, ilBasicSkill::ACHIEVED, true, 0, $this->getPass()
                 );
 
                 //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 242 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 397 of file class.ilTestSkillEvaluation.php.

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

◆ noProfileMatchingAssignedSkillExists()

ilTestSkillEvaluation::noProfileMatchingAssignedSkillExists ( $availableSkillProfiles )

Definition at line 429 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 167 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 114 of file class.ilTestSkillEvaluation.php.

References $activeId.

         {
                 $this->activeId = $activeId;
         }

◆ setNumRequiredBookingsForSkillTriggering()

ilTestSkillEvaluation::setNumRequiredBookingsForSkillTriggering ( $numRequiredBookingsForSkillTriggering )

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

References $numRequiredBookingsForSkillTriggering.

         {
                 $this->numRequiredBookingsForSkillTriggering = $numRequiredBookingsForSkillTriggering;
         }

◆ setPass()

ilTestSkillEvaluation::setPass ( $pass )

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

References $pass.

         {
                 $this->pass = $pass;
         }

◆ setUserId()

ilTestSkillEvaluation::setUserId ( $userId )

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

References $userId.

Referenced by ilTestPlayerAbstractGUI\handleSkillTriggering().

         {
                 $this->userId = $userId;
         }

Here is the caller graph for this function:

Field Documentation

◆ $activeId

ilTestSkillEvaluation::$activeId

private

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

Referenced by getActiveId(), and setActiveId().

◆ $db

ilTestSkillEvaluation::$db

private

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

Referenced by __construct().

◆ $maxPointsByQuestion

ilTestSkillEvaluation::$maxPointsByQuestion

private

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

◆ $numRequiredBookingsForSkillTriggering

ilTestSkillEvaluation::$numRequiredBookingsForSkillTriggering

private

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

Referenced by getNumRequiredBookingsForSkillTriggering(), and setNumRequiredBookingsForSkillTriggering().

◆ $pass

ilTestSkillEvaluation::$pass

private

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

Referenced by getPass(), and setPass().

◆ $questions

ilTestSkillEvaluation::$questions

private

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

◆ $reachedPointsByQuestion

ilTestSkillEvaluation::$reachedPointsByQuestion

private

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

◆ $reachedSkillLevels

ilTestSkillEvaluation::$reachedSkillLevels

private

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

Referenced by getReachedSkillLevels().

◆ $refId

ilTestSkillEvaluation::$refId

private

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

Referenced by __construct().

◆ $skillLevelThresholdList

ilTestSkillEvaluation::$skillLevelThresholdList

private

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

◆ $skillPointAccounts

ilTestSkillEvaluation::$skillPointAccounts

private

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

◆ $skillQuestionAssignmentList

ilTestSkillEvaluation::$skillQuestionAssignmentList

private

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

◆ $userId

ilTestSkillEvaluation::$userId

private

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

Public Member Functions

Private Member Functions

Private Attributes

Detailed Description

Constructor & Destructor Documentation

◆ __construct()

Member Function Documentation

◆ bookToSkillPointAccount()

◆ calculateReachedSkillPointsFromTestPoints()

◆ determineReachedSkillPointsWithSolutionCompare()

◆ doesNumBookingsExceedRequiredBookingsBarrier()

◆ drawUpSkillPointAccounts()

◆ evaluate()

◆ evaluateSkillPointAccounts()

◆ getActiveId()

◆ getAssignedSkillMatchingSkillProfiles()

◆ getNumRequiredBookingsForSkillTriggering()

◆ getPass()

◆ getReachedSkillLevels()

◆ getReachedSkillLevelsForPersonalSkillGUI()

◆ getUniqueAssignedSkillsForPersonalSkillGUI()

◆ getUserId()

◆ handleSkillTriggering()

◆ init()

◆ initTestQuestionData()

◆ initTestResultData()

◆ invokeSkillLevelTrigger()

◆ isAnsweredQuestion()

◆ isAssignedSkill()

◆ noProfileMatchingAssignedSkillExists()

◆ reset()

◆ setActiveId()

◆ setNumRequiredBookingsForSkillTriggering()

◆ setPass()

◆ setUserId()

Field Documentation

◆ $activeId

◆ $db

◆ $maxPointsByQuestion

◆ $numRequiredBookingsForSkillTriggering

◆ $pass

◆ $questions

◆ $reachedPointsByQuestion

◆ $reachedSkillLevels

◆ $refId

◆ $skillLevelThresholdList

◆ $skillPointAccounts

◆ $skillQuestionAssignmentList

◆ $userId