ilAssQuestionSkillAssignmentList Class Reference

Collaboration diagram for ilAssQuestionSkillAssignmentList:

Public Member Functions
	__construct (private readonly ilDBInterface $db)
	setParentObjId (?int $parent_obj_id)
	getParentObjId ()
	getQuestionIdFilter ()
	setQuestionIdFilter (?int $question_id_filter)
	reset ()
	addAssignment (ilAssQuestionSkillAssignment $assignment)
	loadFromDb ()
	loadAdditionalSkillData ()
	getAssignmentsByQuestionId (int $question_id)
	isAssignedToQuestionId (int $skill_base_id, int $skill_tref_id, int $question_id)
	getUniqueAssignedSkills ()
	isAssignedSkill (int $skill_base_id, int $skill_tref_id)
	getNumAssignsBySkill (int $skill_base_id, int $skill_tref_id)
	getMaxPointsBySkill (int $skill_base_id, int $skill_tref_id)
	hasSkillsAssignedLowerThanBarrier ()

Private Member Functions
	incrementNumAssignsBySkill (ilAssQuestionSkillAssignment $assignment)
	incrementMaxPointsBySkill (ilAssQuestionSkillAssignment $assignment)
	getWhereConditions ()
	buildSkillQuestionAssignmentByArray (array $data)
	buildSkillKey (int $skill_base_id, int $skill_tref_id)

Private Attributes
int	$parent_obj_id = null
array	$assignments = []
array	$num_assigns_by_skill = []
array	$max_points_by_skill = []
int	$question_id_filter = null

Detailed Description

Definition at line 21 of file class.ilAssQuestionSkillAssignmentList.php.

Constructor & Destructor Documentation

__construct()

ilAssQuestionSkillAssignmentList::__construct

(

private readonly ilDBInterface

$db

)

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

      {
    }

Member Function Documentation

addAssignment()

ilAssQuestionSkillAssignmentList::addAssignment

(

ilAssQuestionSkillAssignment

$assignment

)

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

                                                                           : void
    {
        $this->assignments[$assignment->getQuestionId()] ??= [];
        $this->assignments[$assignment->getQuestionId()][] = $assignment;
    }

References ilAssQuestionSkillAssignment\getQuestionId().

Referenced by loadFromDb().

Here is the call graph for this function:

Here is the caller graph for this function:

buildSkillKey()

ilAssQuestionSkillAssignmentList::buildSkillKey ( int  $skill_base_id, int  $skill_tref_id  )

private

Definition at line 135 of file class.ilAssQuestionSkillAssignmentList.php.

                                                                          : string
    {
        return "{$skill_base_id}:{$skill_tref_id}";
    }

Referenced by getMaxPointsBySkill(), getNumAssignsBySkill(), getUniqueAssignedSkills(), incrementMaxPointsBySkill(), and incrementNumAssignsBySkill().

Here is the caller graph for this function:

buildSkillQuestionAssignmentByArray()

ilAssQuestionSkillAssignmentList::buildSkillQuestionAssignmentByArray ( array  $data )

private

Definition at line 121 of file class.ilAssQuestionSkillAssignmentList.php.

                                                                     : ilAssQuestionSkillAssignment
    {
        $assignment = new ilAssQuestionSkillAssignment($this->db);
 
        $assignment->setParentObjId($data['obj_fi']);
        $assignment->setQuestionId($data['question_fi']);
        $assignment->setSkillBaseId($data['skill_base_fi']);
        $assignment->setSkillTrefId($data['skill_tref_fi']);
        $assignment->setSkillPoints($data['skill_points']);
        $assignment->setEvalMode($data['eval_mode']);
 
        return $assignment;
    }

References $data.

Referenced by loadFromDb().

Here is the caller graph for this function:

getAssignmentsByQuestionId()

ilAssQuestionSkillAssignmentList::getAssignmentsByQuestionId

(

int

$question_id

)

Returns

ilAssQuestionSkillAssignment[]

Definition at line 152 of file class.ilAssQuestionSkillAssignmentList.php.

                                                                : array
    {
        return $this->assignments[$question_id] ?? [];
    }

getMaxPointsBySkill()

ilAssQuestionSkillAssignmentList::getMaxPointsBySkill	(	int	$skill_base_id,
		int	$skill_tref_id
	)

Definition at line 226 of file class.ilAssQuestionSkillAssignmentList.php.

    {
        return $this->max_points_by_skill[$this->buildSkillKey($skill_base_id, $skill_tref_id)] ?? null;
    }

References buildSkillKey().

Referenced by getUniqueAssignedSkills().

Here is the call graph for this function:

Here is the caller graph for this function:

getNumAssignsBySkill()

ilAssQuestionSkillAssignmentList::getNumAssignsBySkill	(	int	$skill_base_id,
		int	$skill_tref_id
	)

Definition at line 221 of file class.ilAssQuestionSkillAssignmentList.php.

    {
        return $this->num_assigns_by_skill[$this->buildSkillKey($skill_base_id, $skill_tref_id)] ?? null;
    }

References buildSkillKey().

Referenced by getUniqueAssignedSkills().

Here is the call graph for this function:

Here is the caller graph for this function:

getParentObjId()

ilAssQuestionSkillAssignmentList::getParentObjId

(

)

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

                                    : ?int
    {
        return $this->parent_obj_id;
    }

References $parent_obj_id.

getQuestionIdFilter()

ilAssQuestionSkillAssignmentList::getQuestionIdFilter

(

)

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

                                         : ?int
    {
        return $this->question_id_filter;
    }

References $question_id_filter.

Referenced by getWhereConditions().

Here is the caller graph for this function:

getUniqueAssignedSkills()

ilAssQuestionSkillAssignmentList::getUniqueAssignedSkills

(

)

Definition at line 178 of file class.ilAssQuestionSkillAssignmentList.php.

                                             : array
    {
        $skills = [];
 
        foreach ($this->assignments as $assignments_by_question) {
            foreach ($assignments_by_question as $assignment) {
                $key = $this->buildSkillKey($assignment->getSkillBaseId(), $assignment->getSkillTrefId());
                $skills[$key] ??= [
                    'skill' => new ilBasicSkill($assignment->getSkillBaseId()),
                    'skill_base_id' => $assignment->getSkillBaseId(),
                    'skill_tref_id' => $assignment->getSkillTrefId(),
                    'skill_title' => $assignment->getSkillTitle(),
                    'skill_path' => $assignment->getSkillPath(),
                    'num_assigns' => $this->getNumAssignsBySkill(
                        $assignment->getSkillBaseId(),
                        $assignment->getSkillTrefId()
                    ),
                    'max_points' => $this->getMaxPointsBySkill(
                        $assignment->getSkillBaseId(),
                        $assignment->getSkillTrefId()
                    )
                ];
            }
        }
 
        return $skills;
    }

References buildSkillKey(), getMaxPointsBySkill(), and getNumAssignsBySkill().

Referenced by hasSkillsAssignedLowerThanBarrier(), and isAssignedSkill().

Here is the call graph for this function:

Here is the caller graph for this function:

getWhereConditions()

ilAssQuestionSkillAssignmentList::getWhereConditions ( )

private

Definition at line 110 of file class.ilAssQuestionSkillAssignmentList.php.

                                         : string
    {
        $conditions = ["obj_fi = {$this->db->quote($this->getParentObjId(), ilDBConstants::T_INTEGER)}"];
 
        if ($this->getQuestionIdFilter()) {
            $conditions[] = "question_fi = {$this->db->quote($this->getQuestionIdFilter(), ilDBConstants::T_INTEGER)}";
        }
 
        return implode(' AND ', $conditions);
    }

References getQuestionIdFilter().

Here is the call graph for this function:

hasSkillsAssignedLowerThanBarrier()

ilAssQuestionSkillAssignmentList::hasSkillsAssignedLowerThanBarrier

(

)

Definition at line 231 of file class.ilAssQuestionSkillAssignmentList.php.

                                                       : bool
    {
        $global_barrier = (new ilObjTestFolder())
            ->getGlobalSettingsRepository()
            ->getGlobalSettings()
            ->getSkillTriggeringNumberOfAnswers();
 
        foreach ($this->getUniqueAssignedSkills() as $skill_data) {
            if ($skill_data['num_assigns'] < $global_barrier) {
                return true;
            }
        }
 
        return false;
    }

References getUniqueAssignedSkills().

Here is the call graph for this function:

incrementMaxPointsBySkill()

ilAssQuestionSkillAssignmentList::incrementMaxPointsBySkill ( ilAssQuestionSkillAssignment  $assignment )

private

Definition at line 79 of file class.ilAssQuestionSkillAssignmentList.php.

                                                                                        : void
    {
        $key = $this->buildSkillKey($assignment->getSkillBaseId(), $assignment->getSkillTrefId());
 
        $this->max_points_by_skill[$key] ??= 0;
        $this->max_points_by_skill[$key] += $assignment->getMaxSkillPoints();
    }

References buildSkillKey(), ilAssQuestionSkillAssignment\getMaxSkillPoints(), ilAssQuestionSkillAssignment\getSkillBaseId(), and ilAssQuestionSkillAssignment\getSkillTrefId().

Referenced by loadFromDb().

Here is the call graph for this function:

Here is the caller graph for this function:

incrementNumAssignsBySkill()

ilAssQuestionSkillAssignmentList::incrementNumAssignsBySkill ( ilAssQuestionSkillAssignment  $assignment )

private

Definition at line 71 of file class.ilAssQuestionSkillAssignmentList.php.

                                                                                         : void
    {
        $key = $this->buildSkillKey($assignment->getSkillBaseId(), $assignment->getSkillTrefId());
 
        $this->num_assigns_by_skill[$key] ??= 0;
        $this->num_assigns_by_skill[$key]++;
    }

References buildSkillKey(), ilAssQuestionSkillAssignment\getSkillBaseId(), and ilAssQuestionSkillAssignment\getSkillTrefId().

Referenced by loadFromDb().

Here is the call graph for this function:

Here is the caller graph for this function:

isAssignedSkill()

ilAssQuestionSkillAssignmentList::isAssignedSkill	(	int	$skill_base_id,
		int	$skill_tref_id
	)

Definition at line 206 of file class.ilAssQuestionSkillAssignmentList.php.

                                                                           : bool
    {
        foreach ($this->getUniqueAssignedSkills() as $assignedSkill) {
            if ($assignedSkill['skill_base_id'] !== $skill_base_id) {
                continue;
            }
 
            if ($assignedSkill['skill_tref_id'] === $skill_tref_id) {
                return true;
            }
        }
 
        return false;
    }

References getUniqueAssignedSkills().

Here is the call graph for this function:

isAssignedToQuestionId()

ilAssQuestionSkillAssignmentList::isAssignedToQuestionId	(	int	$skill_base_id,
		int	$skill_tref_id,
		int	$question_id
	)

Definition at line 157 of file class.ilAssQuestionSkillAssignmentList.php.

                                                                                                    : bool
    {
        if (!isset($this->assignments[$question_id])) {
            return false;
        }
 
        foreach ($this->assignments[$question_id] as $assignment) {
            if ($assignment->getSkillBaseId() !== $skill_base_id) {
                continue;
            }
 
            if ($assignment->getSkillTrefId() !== $skill_tref_id) {
                continue;
            }
 
            return true;
        }
 
        return false;
    }

loadAdditionalSkillData()

ilAssQuestionSkillAssignmentList::loadAdditionalSkillData

(

)

Definition at line 140 of file class.ilAssQuestionSkillAssignmentList.php.

                                             : void
    {
        foreach ($this->assignments as $assignments_by_question) {
            foreach ($assignments_by_question as $assignment) {
                $assignment->loadAdditionalSkillData();
            }
        }
    }

loadFromDb()

ilAssQuestionSkillAssignmentList::loadFromDb

(

)

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

                                : void
    {
        $this->reset();
 
        $res = $this->db->query("
                        SELECT obj_fi, question_fi, skill_base_fi, skill_tref_fi, skill_points, eval_mode
                        FROM qpl_qst_skl_assigns
                        WHERE {$this->getWhereConditions()}
                ");
 
        while ($row = $this->db->fetchAssoc($res)) {
            $assignment = $this->buildSkillQuestionAssignmentByArray($row);
 
            if ($assignment->hasEvalModeBySolution()) {
                $assignment->loadComparisonExpressions();
            }
 
            $this->addAssignment($assignment);
            $this->incrementNumAssignsBySkill($assignment);
            $this->incrementMaxPointsBySkill($assignment);
        }
    }

References $res, addAssignment(), buildSkillQuestionAssignmentByArray(), incrementMaxPointsBySkill(), incrementNumAssignsBySkill(), and reset().

Here is the call graph for this function:

reset()

ilAssQuestionSkillAssignmentList::reset

(

)

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

                           : void
    {
        $this->assignments = [];
        $this->num_assigns_by_skill = [];
        $this->max_points_by_skill = [];
    }

Referenced by loadFromDb().

Here is the caller graph for this function:

setParentObjId()

ilAssQuestionSkillAssignmentList::setParentObjId

(

?int

$parent_obj_id

)

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

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

References $parent_obj_id.

setQuestionIdFilter()

ilAssQuestionSkillAssignmentList::setQuestionIdFilter

(

?int

$question_id_filter

)

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

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

References $question_id_filter.

Field Documentation

$assignments

array ilAssQuestionSkillAssignmentList::$assignments = []

private

Definition at line 25 of file class.ilAssQuestionSkillAssignmentList.php.

$max_points_by_skill

array ilAssQuestionSkillAssignmentList::$max_points_by_skill = []

private

Definition at line 29 of file class.ilAssQuestionSkillAssignmentList.php.

$num_assigns_by_skill

array ilAssQuestionSkillAssignmentList::$num_assigns_by_skill = []

private

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

$parent_obj_id

int ilAssQuestionSkillAssignmentList::$parent_obj_id = null

private

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

Referenced by getParentObjId(), and setParentObjId().

$question_id_filter

int ilAssQuestionSkillAssignmentList::$question_id_filter = null

private

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

Referenced by getQuestionIdFilter(), and setQuestionIdFilter().

---

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

• components/ILIAS/TestQuestionPool/classes/class.ilAssQuestionSkillAssignmentList.php