Collaboration diagram for ilTestSkillEvaluation:

Public Member Functions
	__construct (private ilDBInterface $db, private TestLogger $logger, int $test_id, private int $refId, private SkillProfileService $skill_profile_service, private SkillPersonalService $skill_personal_service)

	getUserId ()

	setUserId (int $user_id)

	getActiveId ()

	setActiveId (int $active_id)

	getPass ()

	setPass ($pass)

	getNumRequiredBookingsForSkillTriggering ()

	setNumRequiredBookingsForSkillTriggering (int $num_required_bookings_for_skill_triggering)

	init (ilAssQuestionList $question_list)

	evaluate (array $test_results)

	getReachedSkillLevels ()

	handleSkillTriggering ()

	getSkillsMatchingNumAnswersBarrier ()

	getSkillsInvolvedByAssignment ()

	isAssignedSkill ($skill_base_id, $skill_tref_id)

	getAssignedSkillMatchingSkillProfiles ()

	noProfileMatchingAssignedSkillExists (array $available_skill_profiles)

Private Member Functions
	reset ()

	initTestQuestionData (ilAssQuestionList $question_list)

	initTestResultData (array $test_results)

	drawUpSkillPointAccounts ()

	isAnsweredQuestion (int $question_id)

	determineReachedSkillPointsWithSolutionCompare (ilAssQuestionSolutionComparisonExpressionList $expression_list)

	calculateReachedSkillPointsFromTestPoints (int $skill_points, float $max_test_points, float $reached_test_points)

	bookToSkillPointAccount (int $skill_base_id, int $skill_tref_id, int $max_skill_points, float $reached_skill_points)

	evaluateSkillPointAccounts ()

	doesNumBookingsExceedRequiredBookingsBarrier (ilTestSkillPointAccount $skillPointAccount)

	invokeSkillLevelTrigger (int $skill_level_id, int $skill_tref_id)

Private Attributes
ilAssQuestionSkillAssignmentList	$skill_question_assignment_list

ilTestSkillLevelThresholdList	$skill_level_threshold_list

array	$questions = []

array	$max_points_by_question = []

array	$reached_points_by_question

array	$skill_point_accounts

array	$reached_skill_levels

int	$user_id

int	$active_id

int	$pass

int	$num_required_bookings_for_skill_triggering

Detailed Description

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

Constructor & Destructor Documentation

◆ __construct()

ilTestSkillEvaluation::__construct	(	private ilDBInterface	$db,
		private TestLogger	$logger,
		int	$test_id,
		private int	$refId,
		private SkillProfileService	$skill_profile_service,
		private SkillPersonalService	$skill_personal_service
	)

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

      {
        $this->skill_question_assignment_list = new ilAssQuestionSkillAssignmentList($this->db);
 
        $this->skill_level_threshold_list = new ilTestSkillLevelThresholdList($this->db);
        $this->skill_level_threshold_list->setTestId($test_id);
    }

Member Function Documentation

◆ bookToSkillPointAccount()

ilTestSkillEvaluation::bookToSkillPointAccount	(	int	$skill_base_id,
		int	$skill_tref_id,
		int	$max_skill_points,
		float	$reached_skill_points
	)

private

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

     : void {
        $skill_key = $skill_base_id . ':' . $skill_tref_id;
 
        if (!isset($this->skill_point_accounts[$skill_key])) {
            $this->skill_point_accounts[$skill_key] = new ilTestSkillPointAccount();
        }
 
        $this->skill_point_accounts[$skill_key]->addBooking($max_skill_points, $reached_skill_points);
    }

Referenced by drawUpSkillPointAccounts().

Here is the caller graph for this function:

◆ calculateReachedSkillPointsFromTestPoints()

ilTestSkillEvaluation::calculateReachedSkillPointsFromTestPoints	(	int	$skill_points,
		float	$max_test_points,
		float	$reached_test_points
	)

private

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

     : float {
        if ($reached_test_points < 0) {
            $reached_test_points = 0;
        }
 
        $factor = 0;
 
        if ($max_test_points > 0) {
            $factor = $reached_test_points / $max_test_points;
        }
 
        return ($skill_points * $factor);
    }

Referenced by drawUpSkillPointAccounts().

Here is the caller graph for this function:

◆ determineReachedSkillPointsWithSolutionCompare()

ilTestSkillEvaluation::determineReachedSkillPointsWithSolutionCompare ( ilAssQuestionSolutionComparisonExpressionList $expression_list )

private

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

     : ?int {
        $question_provider = new ilAssLacQuestionProvider();
        $question_provider->setQuestionId($expression_list->getQuestionId());
 
        foreach ($expression_list->get() as $expression) {
            $condition_composite = (new ilAssLacConditionParser())->parse(
                $expression->getExpression()
            );
 
            $composite_evaluator = new ilAssLacCompositeEvaluator(
                $question_provider,
                $this->getActiveId(),
                $this->getPass()
            );
            if ($composite_evaluator->evaluate($condition_composite)) {
                return $expression->getPoints();
            }
        }
 
        return 0;
    }

References getActiveId(), and getPass().

Referenced by drawUpSkillPointAccounts().

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

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

References ilTestSkillPointAccount\getNumBookings().

Here is the call graph for this function:

◆ drawUpSkillPointAccounts()

ilTestSkillEvaluation::drawUpSkillPointAccounts ( )

private

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

                                               : void
    {
        foreach ($this->questions as $question_id) {
            if (!$this->isAnsweredQuestion($question_id)) {
                continue;
            }
 
            $assignments = $this->skill_question_assignment_list->getAssignmentsByQuestionId($question_id);
 
            foreach ($assignments as $assignment) {
                if ($assignment->hasEvalModeBySolution()) {
                    $reached_skill_points = $this->determineReachedSkillPointsWithSolutionCompare(
                        $assignment->getSolutionComparisonExpressionList()
                    );
                } else {
                    $max_test_points = $this->max_points_by_question[$question_id];
                    $reached_test_points = $this->reached_points_by_question[$question_id];
                    $reached_skill_points = $this->calculateReachedSkillPointsFromTestPoints(
                        $assignment->getSkillPoints(),
                        $max_test_points,
                        $reached_test_points
                    );
                }
 
                $this->bookToSkillPointAccount(
                    $assignment->getSkillBaseId(),
                    $assignment->getSkillTrefId(),
                    $assignment->getMaxSkillPoints(),
                    $reached_skill_points
                );
            }
        }
    }

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

Referenced by evaluate().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ evaluate()

ilTestSkillEvaluation::evaluate ( array $test_results )

Parameters

array $test_results An array containing the test results for a given user

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

                                                 : void
    {
        $this->reset();
 
        $this->initTestResultData($test_results);
 
        $this->drawUpSkillPointAccounts();
        $this->evaluateSkillPointAccounts();
    }

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

Here is the call graph for this function:

◆ evaluateSkillPointAccounts()

ilTestSkillEvaluation::evaluateSkillPointAccounts ( )

private

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

                                                 : void
    {
        foreach ($this->skill_point_accounts as $skill_key => $skill_point_account) {
            if (!$this->doesNumBookingsExceedRequiredBookingsBarrier($skill_point_account)) {
                continue;
            }
 
            list($skill_base_id, $skill_tref_id) = explode(':', $skill_key);
 
            $skill = new ilBasicSkill((int) $skill_base_id);
            $levels = $skill->getLevelData();
 
            $reached_level_id = null;
            foreach ($levels as $level) {
                $threshold = $this->skill_level_threshold_list->getThreshold($skill_base_id, $skill_tref_id, $level['id']);
 
                if (!($threshold instanceof ilTestSkillLevelThreshold) || $threshold->getThreshold() === null) {
                    continue;
                }
 
                if ($skill_point_account->getTotalReachedSkillPercent() < $threshold->getThreshold()) {
                    break;
                }
 
                $reached_level_id = $level['id'];
            }
 
            $this->reached_skill_levels[] = [
                'sklBaseId' => $skill_base_id, 'sklTrefId' => $skill_tref_id, 'sklLevelId' => $reached_level_id
            ];
        }
    }

Referenced by evaluate().

Here is the caller graph for this function:

◆ getActiveId()

ilTestSkillEvaluation::getActiveId ( )

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

                                 : int
    {
        return $this->active_id;
    }

References $active_id.

Referenced by determineReachedSkillPointsWithSolutionCompare().

Here is the caller graph for this function:

◆ getAssignedSkillMatchingSkillProfiles()

ilTestSkillEvaluation::getAssignedSkillMatchingSkillProfiles ( )

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

                                                           : array
    {
        $matching_skill_profiles = [];
        $users_profiles = $this->skill_profile_service->getProfilesOfUser($this->getUserId());
        foreach ($users_profiles as $profile_data) {
            $assigned_skill_levels = $this->skill_profile_service->getSkillLevels($profile_data->getId());
 
            foreach ($assigned_skill_levels as $assigned_skill_level) {
                $skill_base_id = $assigned_skill_level->getBaseSkillId();
                $skill_tref_id = $assigned_skill_level->getTrefId();
 
                if ($this->skill_question_assignment_list->isAssignedSkill($skill_base_id, $skill_tref_id)) {
                    $matching_skill_profiles[$profile_data->getId()] = $profile_data->getTitle();
                }
            }
        }
 
        return $matching_skill_profiles;
    }

◆ getNumRequiredBookingsForSkillTriggering()

ilTestSkillEvaluation::getNumRequiredBookingsForSkillTriggering ( )

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

                                                              : int
    {
        return $this->num_required_bookings_for_skill_triggering;
    }

References $num_required_bookings_for_skill_triggering.

◆ getPass()

ilTestSkillEvaluation::getPass ( )

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

                             : int
    {
        return $this->pass;
    }

References $pass.

Referenced by determineReachedSkillPointsWithSolutionCompare().

Here is the caller graph for this function:

◆ getReachedSkillLevels()

ilTestSkillEvaluation::getReachedSkillLevels ( )

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

                                           : array
    {
        return $this->reached_skill_levels;
    }

References $reached_skill_levels.

◆ getSkillsInvolvedByAssignment()

ilTestSkillEvaluation::getSkillsInvolvedByAssignment ( )

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

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

References ILIAS\Repository\int().

Here is the call graph for this function:

◆ getSkillsMatchingNumAnswersBarrier()

ilTestSkillEvaluation::getSkillsMatchingNumAnswersBarrier ( )

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

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

References ILIAS\Repository\int().

Here is the call graph for this function:

◆ getUserId()

ilTestSkillEvaluation::getUserId ( )

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

                               : int
    {
        return $this->user_id;
    }

References $user_id.

◆ handleSkillTriggering()

ilTestSkillEvaluation::handleSkillTriggering ( )

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

                                           : void
    {
        foreach ($this->getReachedSkillLevels() as $reached_skill_level) {
            $this->invokeSkillLevelTrigger((int) $reached_skill_level['sklLevelId'], (int) $reached_skill_level['sklTrefId']);
 
            if ($reached_skill_level['sklTrefId'] > 0) {
                $this->skill_personal_service->addPersonalSkill($this->getUserId(), (int) $reached_skill_level['sklTrefId']);
            } else {
                $this->skill_personal_service->addPersonalSkill($this->getUserId(), (int) $reached_skill_level['sklBaseId']);
            }
        }
        //write profile completion entries if fulfilment status has changed
        $this->skill_profile_service->writeCompletionEntryForAllProfiles($this->getUserId());
    }

◆ init()

ilTestSkillEvaluation::init ( ilAssQuestionList $question_list )

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

                                                          : void
    {
        $this->skill_question_assignment_list->setParentObjId($question_list->getParentObjId());
        $this->skill_question_assignment_list->loadFromDb();
 
        $this->skill_level_threshold_list->loadFromDb();
 
        $this->initTestQuestionData($question_list);
    }

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

Here is the call graph for this function:

◆ initTestQuestionData()

ilTestSkillEvaluation::initTestQuestionData ( ilAssQuestionList $question_list )

private

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

                                                                           : void
    {
        foreach ($question_list->getQuestionDataArray() as $question_data) {
            $this->questions[] = $question_data['question_id'];
            $this->max_points_by_question[ $question_data['question_id'] ] = $question_data['points'];
        }
    }

References ilAssQuestionList\getQuestionDataArray().

Referenced by init().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ initTestResultData()

ilTestSkillEvaluation::initTestResultData ( array $test_results )

private

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

                                                            : void
    {
        foreach ($test_results as $key => $result) {
            if ($key === 'pass' || $key === 'test') { // note: key int 0 IS == 'pass' or 'buxtehude'
                continue;
            }
 
            $this->reached_points_by_question[ $result['qid'] ] = $result['reached'];
        }
    }

Referenced by evaluate().

Here is the caller graph for this function:

◆ invokeSkillLevelTrigger()

ilTestSkillEvaluation::invokeSkillLevelTrigger	(	int	$skill_level_id,
		int	$skill_tref_id
	)

private

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

                                                                                     : void
    {
        ilBasicSkill::writeUserSkillLevelStatus(
            $skill_level_id,
            $this->getUserId(),
            $this->refId,
            $skill_tref_id,
            ilBasicSkill::ACHIEVED,
            true,
            false,
            (string) $this->getPass()
        );
 
        $this->logger->info(
            "refId={$this->refId} / usrId={$this->getUserId()} / levelId={$skill_level_id} / trefId={$skill_tref_id}"
        );
    }

References ilBasicSkill\ACHIEVED, ILIAS\Repository\logger(), and ilBasicSkill\writeUserSkillLevelStatus().

Here is the call graph for this function:

◆ isAnsweredQuestion()

ilTestSkillEvaluation::isAnsweredQuestion ( int $question_id )

private

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

                                                         : bool
    {
        return isset($this->reached_points_by_question[$question_id]);
    }

Referenced by drawUpSkillPointAccounts().

Here is the caller graph for this function:

◆ isAssignedSkill()

ilTestSkillEvaluation::isAssignedSkill	(	$skill_base_id,
		$skill_tref_id
	)

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

                                                                   : void
    {
        $this->skill_question_assignment_list->isAssignedSkill($skill_base_id, $skill_tref_id);
    }

◆ noProfileMatchingAssignedSkillExists()

ilTestSkillEvaluation::noProfileMatchingAssignedSkillExists ( array $available_skill_profiles )

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

                                                                                         : bool
    {
        $no_profile_matching_skills = $this->skill_question_assignment_list->getUniqueAssignedSkills();
 
        foreach (array_keys($available_skill_profiles) as $skill_profile_id) {
            $assigned_skill_levels = $this->skill_profile_service->getSkillLevels(
                $this->skill_profile_service->getProfile($skill_profile_id)->getId()
            );
 
            foreach ($assigned_skill_levels as $assigned_skill_level) {
                $skill_base_id = $assigned_skill_level->getBaseSkillId();
                $skill_tref_id = $assigned_skill_level->getTrefId();
 
                if ($this->skill_question_assignment_list->isAssignedSkill($skill_base_id, $skill_tref_id)) {
                    unset($no_profile_matching_skills["{$skill_base_id}:{$skill_tref_id}"]);
                }
            }
        }
 
        return $no_profile_matching_skills !== [];
    }

◆ reset()

ilTestSkillEvaluation::reset ( )

private

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

                            : void
    {
        $this->reached_points_by_question = [];
        $this->skill_point_accounts = [];
        $this->reached_skill_levels = [];
    }

Referenced by evaluate().

Here is the caller graph for this function:

◆ setActiveId()

ilTestSkillEvaluation::setActiveId ( int $active_id )

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

                                               : void
    {
        $this->active_id = $active_id;
    }

References $active_id.

◆ setNumRequiredBookingsForSkillTriggering()

ilTestSkillEvaluation::setNumRequiredBookingsForSkillTriggering ( int $num_required_bookings_for_skill_triggering )

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

                                                                                                             : void
    {
        $this->num_required_bookings_for_skill_triggering = $num_required_bookings_for_skill_triggering;
    }

References $num_required_bookings_for_skill_triggering.

◆ setPass()

ilTestSkillEvaluation::setPass ( $pass )

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

                                  : void
    {
        $this->pass = $pass;
    }

References $pass.

◆ setUserId()

ilTestSkillEvaluation::setUserId ( int $user_id )

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

                                           : void
    {
        $this->user_id = $user_id;
    }

References $user_id.

Field Documentation

◆ $active_id

int ilTestSkillEvaluation::$active_id

private

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

Referenced by getActiveId(), and setActiveId().

◆ $max_points_by_question

array ilTestSkillEvaluation::$max_points_by_question = []

private

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

◆ $num_required_bookings_for_skill_triggering

int ilTestSkillEvaluation::$num_required_bookings_for_skill_triggering

private

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

Referenced by getNumRequiredBookingsForSkillTriggering(), and setNumRequiredBookingsForSkillTriggering().

◆ $pass

int ilTestSkillEvaluation::$pass

private

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

Referenced by getPass(), and setPass().

◆ $questions

array ilTestSkillEvaluation::$questions = []

private

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

◆ $reached_points_by_question

array ilTestSkillEvaluation::$reached_points_by_question

private

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

◆ $reached_skill_levels

array ilTestSkillEvaluation::$reached_skill_levels

private

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

Referenced by getReachedSkillLevels().

◆ $skill_level_threshold_list

ilTestSkillLevelThresholdList ilTestSkillEvaluation::$skill_level_threshold_list

private

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

◆ $skill_point_accounts

array ilTestSkillEvaluation::$skill_point_accounts

private

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

◆ $skill_question_assignment_list

ilAssQuestionSkillAssignmentList ilTestSkillEvaluation::$skill_question_assignment_list

private

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

◆ $user_id

int ilTestSkillEvaluation::$user_id

private

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

Referenced by getUserId(), and setUserId().

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

components/ILIAS/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()

◆ getSkillsInvolvedByAssignment()

◆ getSkillsMatchingNumAnswersBarrier()

◆ getUserId()

◆ handleSkillTriggering()

◆ init()

◆ initTestQuestionData()

◆ initTestResultData()

◆ invokeSkillLevelTrigger()

◆ isAnsweredQuestion()

◆ isAssignedSkill()

◆ noProfileMatchingAssignedSkillExists()

◆ reset()

◆ setActiveId()

◆ setNumRequiredBookingsForSkillTriggering()

◆ setPass()

◆ setUserId()

Field Documentation

◆ $active_id

◆ $max_points_by_question

◆ $num_required_bookings_for_skill_triggering

◆ $pass

◆ $questions

◆ $reached_points_by_question

◆ $reached_skill_levels

◆ $skill_level_threshold_list

◆ $skill_point_accounts

◆ $skill_question_assignment_list

◆ $user_id