class.ilTestSkillEvaluationGUI.php

Go to the documentation of this file.

<?php
/* Copyright (c) 1998-2013 ILIAS open source, Extended GPL, see docs/LICENSE */

require_once 'Modules/Test/classes/toolbars/class.ilTestSkillEvaluationToolbarGUI.php';
require_once 'Modules/Test/classes/class.ilTestPersonalSkillsGUI.php';
require_once 'Modules/Test/classes/class.ilObjAssessmentFolder.php';

class ilTestSkillEvaluationGUI
{
    const INVOLVE_SKILLS_BELOW_NUM_ANSWERS_BARRIER_FOR_GAP_ANALASYS = false;
    
    const CMD_SHOW = 'show';
    private $ctrl;

    private $tabs;

    private $tpl;

    private $lng;

    private $db;
    
    protected $testOBJ;

    private $testSession;
    
    private $objectiveOrientedContainer;

    private $questionList;
    
    protected $noSkillProfileOptionEnabled = false;
    protected $availableSkillProfiles = array();
    protected $availableSkills = array();
    
    protected $testPassesSelector = null;

    public function __construct(ilCtrl $ctrl, ilTabsGUI $tabs, ilTemplate $tpl, ilLanguage $lng, ilDBInterface $db, ilObjTest $testOBJ)
    {
        $this->ctrl = $ctrl;
        $this->tabs = $tabs;
        $this->tpl = $tpl;
        $this->lng = $lng;
        $this->db = $db;
        $this->testOBJ = $testOBJ;
    }

    public function getQuestionList()
    {
        return $this->questionList;
    }

    public function setQuestionList($questionList)
    {
        $this->questionList = $questionList;
    }

    public function getObjectiveOrientedContainer()
    {
        return $this->objectiveOrientedContainer;
    }

    public function setObjectiveOrientedContainer($objectiveOrientedContainer)
    {
        $this->objectiveOrientedContainer = $objectiveOrientedContainer;
    }

    public function executeCommand()
    {
        $cmd = $this->ctrl->getCmd(self::CMD_SHOW) . 'Cmd';

        $this->manageTabs($cmd);

        $this->$cmd();
    }

    private function isAccessDenied()
    {
        return false;
    }

    private function manageTabs($cmd)
    {
        $this->tabs->clearTargets();

        $this->tabs->setBackTarget(
            $this->lng->txt('tst_results_back_introduction'),
            $this->ctrl->getLinkTargetByClass('ilObjTestGUI', 'infoScreen')
        );

        if ($this->getObjectiveOrientedContainer()->isObjectiveOrientedPresentationRequired()) {
            require_once 'Services/Link/classes/class.ilLink.php';
            $courseLink = ilLink::_getLink($this->getObjectiveOrientedContainer()->getRefId());
            $this->tabs->setBack2Target($this->lng->txt('back_to_objective_container'), $courseLink);
        }
    }
    
    protected function init($skillProfileEnabled)
    {
        require_once 'Modules/Test/classes/class.ilTestPassesSelector.php';
        $this->testPassesSelector = new ilTestPassesSelector($this->db, $this->testOBJ);
        $this->testPassesSelector->setActiveId($this->testSession->getActiveId());
        $this->testPassesSelector->setLastFinishedPass($this->testSession->getLastFinishedPass());
        
        $assSettings = new ilSetting('assessment');
        require_once 'Modules/Test/classes/class.ilTestSkillEvaluation.php';
        $skillEvaluation = new ilTestSkillEvaluation(
            $this->db,
            $this->testOBJ->getTestId(),
            $this->testOBJ->getRefId()
        );
        
        $skillEvaluation->setUserId($this->getTestSession()->getUserId());
        $skillEvaluation->setActiveId($this->getTestSession()->getActiveId());
        
        $skillEvaluation->setNumRequiredBookingsForSkillTriggering($assSettings->get(
            'ass_skl_trig_num_answ_barrier',
            ilObjAssessmentFolder::DEFAULT_SKL_TRIG_NUM_ANSWERS_BARRIER
        ));
        
        $skillEvaluation->init($this->getQuestionList());
        
        $availableSkillProfiles = $skillEvaluation->getAssignedSkillMatchingSkillProfiles();
        $this->setNoSkillProfileOptionEnabled(
            $skillEvaluation->noProfileMatchingAssignedSkillExists($availableSkillProfiles)
        );
        $this->setAvailableSkillProfiles($availableSkillProfiles);
        
        // should be reportedPasses - yes - indeed, skill level status will not respect - avoid confuse here
        $evaluationPasses = $this->testPassesSelector->getExistingPasses();
        
        $availableSkills = array();
        
        foreach ($evaluationPasses as $evalPass) {
            $testResults = $this->testOBJ->getTestResult($this->getTestSession()->getActiveId(), $evalPass, true);
            
            $skillEvaluation->setPass($evalPass);
            $skillEvaluation->evaluate($testResults);
            
            if ($skillProfileEnabled && self::INVOLVE_SKILLS_BELOW_NUM_ANSWERS_BARRIER_FOR_GAP_ANALASYS) {
                $skills = $skillEvaluation->getSkillsInvolvedByAssignment();
            } else {
                $skills = $skillEvaluation->getSkillsMatchingNumAnswersBarrier();
            }
            
            $availableSkills = array_merge($availableSkills, $skills);
        }
        
        $this->setAvailableSkills(array_values($availableSkills));
    }

    private function showCmd()
    {
        //ilUtil::sendInfo($this->lng->txt('tst_skl_res_interpretation_hint_msg'));
        
        $selectedSkillProfile = ilTestSkillEvaluationToolbarGUI::fetchSkillProfileParam($_POST);
        
        $this->init($selectedSkillProfile);
        
        $evaluationToolbarGUI = $this->buildEvaluationToolbarGUI($selectedSkillProfile);
        
        $personalSkillsGUI = $this->buildPersonalSkillsGUI(
            $this->getTestSession()->getUserId(),
            $evaluationToolbarGUI->getSelectedEvaluationMode(),
            $this->getAvailableSkills()
        );

        $this->tpl->setContent(
            $this->ctrl->getHTML($evaluationToolbarGUI) . $this->ctrl->getHTML($personalSkillsGUI)
        );
    }

    private function buildEvaluationToolbarGUI($selectedSkillProfileId)
    {
        if (!$this->isNoSkillProfileOptionEnabled() && !$selectedSkillProfileId) {
            $selectedSkillProfileId = key($this->getAvailableSkillProfiles());
        }

        $gui = new ilTestSkillEvaluationToolbarGUI($this->ctrl, $this->lng, $this, self::CMD_SHOW);

        $gui->setAvailableSkillProfiles($this->getAvailableSkillProfiles());
        $gui->setNoSkillProfileOptionEnabled($this->isNoSkillProfileOptionEnabled());
        $gui->setSelectedEvaluationMode($selectedSkillProfileId);

        $gui->setTestResultButtonEnabled($this->isTestResultButtonRequired());

        $gui->build();

        return $gui;
    }

    private function isTestResultButtonRequired()
    {
        if (!$this->testOBJ->canShowTestResults($this->testSession)) {
            return false;
        }

        if (!count($this->testPassesSelector->getReportablePasses())) {
            return false;
        }
        
        return true;
    }

    private function buildPersonalSkillsGUI($usrId, $selectedSkillProfileId, $availableSkills)
    {
        $gui = new ilTestPersonalSkillsGUI($this->lng, $this->testOBJ->getId());

        $gui->setAvailableSkills($availableSkills);
        $gui->setSelectedSkillProfile($selectedSkillProfileId);

        $gui->setReachedSkillLevels($reachedSkillLevels);
        $gui->setUsrId($usrId);
        
        return $gui;
    }

    public function setTestSession($testSession)
    {
        $this->testSession = $testSession;
    }

    public function getTestSession()
    {
        return $this->testSession;
    }
    
    public function isNoSkillProfileOptionEnabled()
    {
        return $this->noSkillProfileOptionEnabled;
    }
    
    public function setNoSkillProfileOptionEnabled($noSkillProfileOptionEnabled)
    {
        $this->noSkillProfileOptionEnabled = $noSkillProfileOptionEnabled;
    }
    
    public function getAvailableSkillProfiles()
    {
        return $this->availableSkillProfiles;
    }
    
    public function setAvailableSkillProfiles($availableSkillProfiles)
    {
        $this->availableSkillProfiles = $availableSkillProfiles;
    }
    
    public function getAvailableSkills()
    {
        return $this->availableSkills;
    }
    
    public function setAvailableSkills($availableSkills)
    {
        $this->availableSkills = $availableSkills;
    }
}