class.ilTestService.php

Go to the documentation of this file.

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

class ilTestService
{
        protected $object = null;
        
        public function __construct(ilObjTest $a_object)
        {
                $this->object = $a_object;
        }

        public function getPassOverviewData($active_id, $short = false)
        {
                $passOverwiewData = array();
                
                global $ilUser;

                $scoredPass = $this->object->_getResultPass($active_id);
                $lastPass = ilObjTest::_getPass($active_id);

                $testPercentage = 0;
                $testReachedPoints = 0;
                $testMaxPoints = 0;

                for( $pass = 0; $pass <= $lastPass; $pass++)
                {
                        $passFinishDate = $this->object->getPassFinishDate($active_id, $pass);
                        
                        if( $passFinishDate <= 0 )
                        {
                                continue;
                        }

                        if( !$short )
                        {
                                $resultData =& $this->object->getTestResult($active_id, $pass);

                                if (!$resultData["pass"]["total_max_points"])
                                {
                                        $passPercentage = 0;
                                }
                                else
                                {
                                        $passPercentage = ($resultData["pass"]["total_reached_points"]/$resultData["pass"]["total_max_points"])*100;
                                }

                                $passMaxPoints = $resultData["pass"]["total_max_points"];
                                $passReachedPoints = $resultData["pass"]["total_reached_points"];
                                
                                $passAnsweredQuestions = $this->object->getAnsweredQuestionCount($active_id, $pass);
                                $passTotalQuestions = count($resultData) - 2;

                                if( $pass == $scoredPass )
                                {
                                        $isScoredPass = true;
                                        
                                        if (!$resultData["test"]["total_max_points"])
                                        {
                                                $testPercentage = 0;
                                        }
                                        else
                                        {
                                                $testPercentage = ($resultData["test"]["total_reached_points"]/$resultData["test"]["total_max_points"])*100;
                                        }
                                        
                                        $testMaxPoints = $resultData["test"]["total_max_points"];
                                        $testReachedPoints = $resultData["test"]["total_reached_points"];
                                        
                                        $passOverwiewData['test'] = array(
                                                'active_id' => $active_id,
                                                'scored_pass' => $scoredPass,
                                                'max_points' => $testMaxPoints,
                                                'reached_points' => $testReachedPoints,
                                                'percentage' => $testPercentage
                                        );
                                }
                                else $isScoredPass = false;
                                
                                $passOverwiewData['passes'][] = array(
                                        'active_id' => $active_id,
                                        'pass' => $pass,
                                        'finishdate' => $passFinishDate,
                                        'max_points' => $passMaxPoints,
                                        'reached_points' => $passReachedPoints,
                                        'percentage' => $passPercentage,
                                        'answered_questions' => $passAnsweredQuestions,
                                        'total_questions' => $passTotalQuestions,
                                        'is_scored_pass' => $isScoredPass
                                );
                        }
                }

                return $passOverwiewData;
        }
        
        public function getManScoringQuestionGuiList($activeId, $pass)
        {
                include_once "./Modules/Test/classes/class.ilObjAssessmentFolder.php";
                $manScoringQuestionTypes = ilObjAssessmentFolder::_getManualScoring();

                $testResultData = $this->object->getTestResult($activeId, $pass);
                
                $manScoringQuestionGuiList = array();
                
                foreach($testResultData as $questionData)
                {
                        if( !isset($questionData['qid']) )
                        {
                                continue;
                        }
                        
                        if( !isset($questionData['type']) )
                        {
                                throw new ilTestException('no question type given!');
                        }

                        $questionGUI = $this->object->createQuestionGUI("", $questionData['qid']);
                        
                        if( !in_array($questionGUI->object->getQuestionTypeID(), $manScoringQuestionTypes) )
                        {
                                continue;
                        }
                        
                        $manScoringQuestionGuiList[ $questionData['qid'] ] = $questionGUI;
                }
                
                return $manScoringQuestionGuiList;
        }
        
        public static function isManScoringDone($activeId)
        {
                $assessmentSetting = new ilSetting("assessment");
                return $assessmentSetting->get("manscoring_done_" . $activeId, false);
        }
        
        public static function setManScoringDone($activeId, $manScoringDone)
        {
                $assessmentSetting = new ilSetting("assessment");
                $assessmentSetting->set("manscoring_done_" . $activeId, (bool)$manScoringDone);
        }
        
        public function buildVirtualSequence(ilTestSession $testSession)
        {
                global $ilDB, $lng, $ilPluginAdmin;

                require_once 'Modules/Test/classes/class.ilTestVirtualSequence.php';
                $testSequenceFactory = new ilTestSequenceFactory($ilDB, $lng, $ilPluginAdmin, $this->object);

                if( $this->object->isRandomTest() )
                {
                        require_once 'Modules/Test/classes/class.ilTestVirtualSequenceRandomQuestionSet.php';
                        $virtualSequence = new ilTestVirtualSequenceRandomQuestionSet($ilDB, $this->object, $testSequenceFactory);
                }
                else
                {
                        require_once 'Modules/Test/classes/class.ilTestVirtualSequence.php';
                        $virtualSequence = new ilTestVirtualSequence($ilDB, $this->object, $testSequenceFactory);
                }

                $virtualSequence->setActiveId($testSession->getActiveId());

                $virtualSequence->init();
                
                return $virtualSequence;
        }
        
        public function getVirtualSequenceUserResults(ilTestVirtualSequence $virtualSequence)
        {
                $resultsByPass = array();
                
                foreach($virtualSequence->getUniquePasses() as $pass)
                {
                        $results = $this->object->getTestResult(
                                $virtualSequence->getActiveId(), $pass, false, true, true
                        );

                        $resultsByPass[$pass] = $results;
                }
                
                $virtualPassResults = array();
                
                foreach($virtualSequence->getQuestionsPassMap() as $questionId => $pass)
                {
                        foreach($resultsByPass[$pass] as $key => $questionResult)
                        {
                                if($key === 'test' || $key === 'pass')
                                {
                                        continue;
                                }
                                
                                if($questionResult['qid'] == $questionId)
                                {
                                        $questionResult['pass'] = $pass;
                                        $virtualPassResults[$questionId] = $questionResult;
                                        break;
                                }
                        }
                }
                
                return $virtualPassResults;
        }

        public function getQuestionSummaryData(ilTestSequenceSummaryProvider $testSequence, $obligationsFilterEnabled)
        {
                $result_array = $testSequence->getSequenceSummary($obligationsFilterEnabled);

                $marked_questions = array();

                if($this->object->getShowMarker())
                {
                        include_once "./Modules/Test/classes/class.ilObjTest.php";
                        $marked_questions = ilObjTest::_getSolvedQuestions($testSequence->getActiveId());
                }

                $data = array();

                foreach($result_array as $key => $value)
                {
                        $description = "";
                        if($this->object->getListOfQuestionsDescription())
                        {
                                $description = $value["description"];
                        }

                        $points = "";
                        if(!$this->object->getTitleOutput())
                        {
                                $points = $value["points"];
                        }

                        $marked = false;
                        if(count($marked_questions))
                        {
                                if(array_key_exists($value["qid"], $marked_questions))
                                {
                                        $obj = $marked_questions[$value["qid"]];
                                        if($obj["solved"] == 1)
                                        {
                                                $marked = true;
                                        }
                                }
                        }

// fau: testNav - add number parameter for getQuestionTitle()
                        $data[] = array('order' => $value["nr"], 'title' => $this->object->getQuestionTitle($value["title"], $value["nr"]), 'description' => $description, 'worked_through' => $value["worked_through"], 'postponed' => $value["postponed"], 'points' => $points, 'marked' => $marked, 'sequence' => $value["sequence"], 'obligatory' => $value['obligatory'], 'isAnswered' => $value['isAnswered']);
// fau.
                }

                return $data;
        }
}