Manages resources for skills. More...

Inheritance diagram for ILIAS\Skill\Resource\SkillResourcesManager:

Collaboration diagram for ILIAS\Skill\Resource\SkillResourcesManager:

Public Member Functions
	__construct (SkillResourceDBRepository $skill_res_repo=null, \ilSkillLevelRepository $level_repo=null)

	getResources (int $skill_id, int $tref_id)

	getResourcesOfLevel (int $skill_id, int $tref_id, int $level_id)

	setResource (int $skill_id, int $tref_id, int $level_id, int $rep_ref_id, bool $imparting, bool $trigger)

	setResourceAsSuggested (int $skill_id, int $tref_id, int $level_id, int $rep_ref_id)

	setResourceAsNotSuggested (int $skill_id, int $tref_id, int $level_id, int $rep_ref_id)

	setResourceAsTrigger (int $skill_id, int $tref_id, int $level_id, int $rep_ref_id)

	setResourceAsNoTrigger (int $skill_id, int $tref_id, int $level_id, int $rep_ref_id)

	removeResource (int $skill_id, int $tref_id, int $level_id, int $rep_ref_id)

	removeResourcesForSkill (int $skill_node_id, bool $is_reference=false)

	isLevelTooLow (int $tref_id, array $skill_levels, array $profile_levels, array $actual_levels)

	determineCurrentTargetLevel (array $skill_levels, array $profile_levels)

	getSuggestedResources (int $skill_id, int $tref_id, array $skill_levels, array $profile_levels)

	getTriggerLevelsForRefId (int $rep_ref_id)

Static Public Member Functions

static getUsageInfo (array $a_cskill_ids)

Get title of an assigned item.

Parameters

array{skill_id int, tref_id: int}[] $a_cskill_ids array of common skill ids

Returns: array<string, array<string, array{key: string}[]>>

More...

Protected Attributes
SkillResourceDBRepository	$skill_res_repo

ilSkillLevelRepository	$level_repo

Detailed Description

Manages resources for skills.

This is not about user assigned materials, it is about resources that are assigned to skill levels in the competence management administration of ILIAS.

This can be either triggers (e.g. a course that triggers a competence level) or resources that impart the knowledge of a competence level. Imparting does not necessarily mean that it triggers a competence level.

Author: Thomas Famula famul.nosp@m.a@le.nosp@m.ifos..nosp@m.de

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

Constructor & Destructor Documentation

◆ __construct()

ILIAS\Skill\Resource\SkillResourcesManager::__construct	(	SkillResourceDBRepository	$skill_res_repo = `null`,
		\ilSkillLevelRepository	$level_repo = `null`
	)

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

References $DIC, ILIAS\Skill\Resource\SkillResourcesManager\$level_repo, and ILIAS\Skill\Resource\SkillResourcesManager\$skill_res_repo.

       {
         global $DIC;
 
         $this->skill_res_repo = ($skill_res_repo)
             ?: $DIC->skills()->internal()->repo()->getResourceRepo();
         $this->level_repo = ($level_repo)
             ?: $DIC->skills()->internal()->repo()->getLevelRepo();
     }

Member Function Documentation

◆ determineCurrentTargetLevel()

ILIAS\Skill\Resource\SkillResourcesManager::determineCurrentTargetLevel	(	array	$skill_levels,
		array	$profile_levels
	)

Parameters

Definition at line 170 of file class.SkillResourcesManager.php.

References ILIAS\Repository\int().

Referenced by ILIAS\Skill\Resource\SkillResourcesManager\getSuggestedResources().

                                                                                            : int
     {
         $target_level = 0;
         foreach ($skill_levels as $l) {
             $l["id"] = (int) $l["id"];
             $l["skill_id"] = (int) $l["skill_id"];
             foreach ($profile_levels as $pl) {
                 if ($pl->getLevelId() === $l["id"] &&
                     $pl->getBaseSkillId() === $l["skill_id"]) {
                     $target_level = $l["id"];
                 }
             }
         }
 
         return $target_level;
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getResources()

ILIAS\Skill\Resource\SkillResourcesManager::getResources	(	int	$skill_id,
		int	$tref_id
	)

Returns: array<int, SkillResource[]>

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

Referenced by ILIAS\Skill\Resource\SkillResourcesManager\getSuggestedResources().

                                                              : array
     {
         return $this->skill_res_repo->getAll($skill_id, $tref_id);
     }

Here is the caller graph for this function:

◆ getResourcesOfLevel()

ILIAS\Skill\Resource\SkillResourcesManager::getResourcesOfLevel	(	int	$skill_id,
		int	$tref_id,
		int	$level_id
	)

Returns: SkillResource[]

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

                                                                                    : array
     {
         $all_resources = $this->skill_res_repo->getAll($skill_id, $tref_id);
         $resources_of_level = [];
         foreach ($all_resources as $lid => $level) {
             foreach ($level as $resource) {
                 if ($lid == $level_id) {
                     $resources_of_level[] = $resource;
                 }
             }
         }
 
         return $resources_of_level;
     }

◆ getSuggestedResources()

ILIAS\Skill\Resource\SkillResourcesManager::getSuggestedResources	(	int	$skill_id,
		int	$tref_id,
		array	$skill_levels,
		array	$profile_levels
	)

Parameters

Definition at line 191 of file class.SkillResourcesManager.php.

References $r, $resources, ILIAS\Skill\Resource\SkillResourcesManager\determineCurrentTargetLevel(), and ILIAS\Skill\Resource\SkillResourcesManager\getResources().

                                                                                                                   : array
     {
         $target_level = $this->determineCurrentTargetLevel($skill_levels, $profile_levels);
         $target_level_order_nr = $this->level_repo->lookupLevelNumber($target_level);
         $resources = $this->getResources($skill_id, $tref_id);
         $imp_resources = [];
         foreach ($resources as $level) {
             foreach ($level as $r) {
                 $res_level_order_nr = $this->level_repo->lookupLevelNumber($r->getLevelId());
                 if ($r->getImparting() &&
                     $target_level_order_nr >= $res_level_order_nr) {
                     $imp_resources[$res_level_order_nr . "_" . $r->getLevelId()][] = $r;
                 }
             }
         }
 
         ksort($imp_resources);
         return $imp_resources;
     }

Here is the call graph for this function:

◆ getTriggerLevelsForRefId()

ILIAS\Skill\Resource\SkillResourcesManager::getTriggerLevelsForRefId ( int $rep_ref_id )

Returns: SkillResourceLevel[]

Definition at line 214 of file class.SkillResourcesManager.php.

                                                              : array
     {
         return $this->skill_res_repo->getTriggerLevelsForRefId($rep_ref_id);
     }

◆ getUsageInfo()

static ILIAS\Skill\Resource\SkillResourcesManager::getUsageInfo ( array $a_cskill_ids )

static

Get title of an assigned item.

Parameters

array{skill_id int, tref_id: int}[] $a_cskill_ids array of common skill ids

Returns: array<string, array<string, array{key: string}[]>>

Implements ILIAS\Skill\Usage\SkillUsageInfo.

Definition at line 222 of file class.SkillResourcesManager.php.

References $DIC, and ILIAS\Skill\Usage\SkillUsageManager\RESOURCE.

                                                             : array
     {
         global $DIC;
 
         $usage_manager = $DIC->skills()->internal()->manager()->getUsageManager();
 
         return $usage_manager->getUsageInfoGeneric(
             $a_cskill_ids,
             Usage\SkillUsageManager::RESOURCE,
             "skl_skill_resource",
             "rep_ref_id",
             "base_skill_id"
         );
     }

◆ isLevelTooLow()

ILIAS\Skill\Resource\SkillResourcesManager::isLevelTooLow	(	int	$tref_id,
		array	$skill_levels,
		array	$profile_levels,
		array	$actual_levels
	)

Definition at line 146 of file class.SkillResourcesManager.php.

References ILIAS\Repository\int().

                                                                                                                  : bool
     {
         $too_low = true;
 
         foreach ($skill_levels as $v) {
             $v["id"] = (int) $v["id"];
             $v["skill_id"] = (int) $v["skill_id"];
             foreach ($profile_levels as $pl) {
                 if ($pl->getLevelId() === $v["id"] &&
                     $pl->getBaseSkillId() === $v["skill_id"]) {
                     $too_low = true;
                 }
             }
 
             if ($actual_levels[$v["skill_id"]][$tref_id] == $v["id"]) {
                 $too_low = false;
             }
         }
         return $too_low;
     }

Here is the call graph for this function:

◆ removeResource()

ILIAS\Skill\Resource\SkillResourcesManager::removeResource	(	int	$skill_id,
		int	$tref_id,
		int	$level_id,
		int	$rep_ref_id
	)

Definition at line 132 of file class.SkillResourcesManager.php.

      : void {
         $this->skill_res_repo->remove($skill_id, $tref_id, $level_id, $rep_ref_id);
     }

◆ removeResourcesForSkill()

ILIAS\Skill\Resource\SkillResourcesManager::removeResourcesForSkill	(	int	$skill_node_id,
		bool	$is_reference = `false`
	)

Definition at line 141 of file class.SkillResourcesManager.php.

                                                                                            : void
     {
         $this->skill_res_repo->removeForSkill($skill_node_id, $is_reference);
     }

◆ setResource()

ILIAS\Skill\Resource\SkillResourcesManager::setResource	(	int	$skill_id,
		int	$tref_id,
		int	$level_id,
		int	$rep_ref_id,
		bool	$imparting,
		bool	$trigger
	)

Definition at line 80 of file class.SkillResourcesManager.php.

      : void {
         $this->skill_res_repo->addOrUpdate($skill_id, $tref_id, $level_id, $rep_ref_id, $imparting, $trigger);
     }

◆ setResourceAsNoTrigger()

ILIAS\Skill\Resource\SkillResourcesManager::setResourceAsNoTrigger	(	int	$skill_id,
		int	$tref_id,
		int	$level_id,
		int	$rep_ref_id
	)

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

      : void {
         $this->skill_res_repo->updateTrigger($skill_id, $tref_id, $level_id, $rep_ref_id, false);
     }

◆ setResourceAsNotSuggested()

ILIAS\Skill\Resource\SkillResourcesManager::setResourceAsNotSuggested	(	int	$skill_id,
		int	$tref_id,
		int	$level_id,
		int	$rep_ref_id
	)

Definition at line 100 of file class.SkillResourcesManager.php.

      : void {
         $this->skill_res_repo->updateImparting($skill_id, $tref_id, $level_id, $rep_ref_id, false);
     }

◆ setResourceAsSuggested()

ILIAS\Skill\Resource\SkillResourcesManager::setResourceAsSuggested	(	int	$skill_id,
		int	$tref_id,
		int	$level_id,
		int	$rep_ref_id
	)

Definition at line 91 of file class.SkillResourcesManager.php.

      : void {
         $this->skill_res_repo->updateImparting($skill_id, $tref_id, $level_id, $rep_ref_id, true);
     }

◆ setResourceAsTrigger()

ILIAS\Skill\Resource\SkillResourcesManager::setResourceAsTrigger	(	int	$skill_id,
		int	$tref_id,
		int	$level_id,
		int	$rep_ref_id
	)

Definition at line 109 of file class.SkillResourcesManager.php.

References ilObject\_lookupObjId(), ilObject\_lookupType(), and ilObjectLP\isSupportedObjectType().

      : void {
         $obj_id = \ilObject::_lookupObjId($rep_ref_id);
         $obj_type = \ilObject::_lookupType($obj_id);
         if (!\ilObjectLP::isSupportedObjectType($obj_type)) {
             return;
         }
         $this->skill_res_repo->updateTrigger($skill_id, $tref_id, $level_id, $rep_ref_id, true);
     }