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;
        }
}