class.ilTestServiceGUI.php

Go to the documentation of this file.

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

include_once "./Modules/Test/classes/inc.AssessmentConstants.php";
include_once 'Modules/Test/classes/class.ilTestService.php';

class ilTestServiceGUI
{
        public $object = null;
        
        public $service = null;

        protected $db;

        var $lng;
        var $tpl;
        
        var $ctrl;
        
        protected $tabs;

        protected $objCache;
        
        var $ilias;
        var $tree;
        var $ref_id;
        
        protected $testSessionFactory = null;

        protected $testSequenceFactory = null;

        protected $participantData;

        private $objectiveOrientedContainer;
        
        private $contextResultPresentation = true;

        public function isContextResultPresentation()
        {
                return $this->contextResultPresentation;
        }

        public function setContextResultPresentation($contextResultPresentation)
        {
                $this->contextResultPresentation = $contextResultPresentation;
        }
        
        function ilTestServiceGUI(ilObjTest $a_object)
        {
                global $lng, $tpl, $ilCtrl, $ilias, $tree, $ilDB, $ilPluginAdmin, $ilTabs, $ilObjDataCache;

                $this->db = $ilDB;
                $this->lng =& $lng;
                $this->tpl =& $tpl;
                $this->ctrl =& $ilCtrl;
                $this->tabs = $ilTabs;
                $this->objCache = $ilObjDataCache;
                $this->ilias =& $ilias;
                $this->object =& $a_object;
                $this->tree =& $tree;
                $this->ref_id = $a_object->ref_id;

                $this->service = new ilTestService($a_object);
                
                require_once 'Modules/Test/classes/class.ilTestSessionFactory.php';
                $this->testSessionFactory = new ilTestSessionFactory($this->object);

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

                $this->objectiveOrientedContainer = null;
        }

        public function setParticipantData($participantData)
        {
                $this->participantData = $participantData;
        }

        public function getParticipantData()
        {
                return $this->participantData;
        }

        public function getPassOverviewTableData(ilTestSession $testSession, $passes, $withResults)
        {
                $data = array();

                if($this->getObjectiveOrientedContainer()->isObjectiveOrientedPresentationRequired())
                {
                        $considerHiddenQuestions = false;

                        require_once 'Modules/Course/classes/Objectives/class.ilLOTestQuestionAdapter.php';
                        $objectivesAdapter = ilLOTestQuestionAdapter::getInstance($testSession);
                }
                else
                {
                        $considerHiddenQuestions = true;
                }

                $scoredPass = $this->object->_getResultPass($testSession->getActiveId());

                foreach($passes as $pass)
                {
                        $row = array();

                        $considerOptionalQuestions = true;

                        if($this->getObjectiveOrientedContainer()->isObjectiveOrientedPresentationRequired())
                        {
                                $testSequence = $this->testSequenceFactory->getSequenceByActiveIdAndPass($testSession->getActiveId(), $pass);

                                $testSequence->loadFromDb();
                                $testSequence->loadQuestions();

                                if($this->object->isRandomTest() && !$testSequence->isAnsweringOptionalQuestionsConfirmed())
                                {
                                        $considerOptionalQuestions = false;
                                }

                                $testSequence->setConsiderHiddenQuestionsEnabled($considerHiddenQuestions);
                                $testSequence->setConsiderOptionalQuestionsEnabled($considerOptionalQuestions);

                                $objectivesList = $this->buildQuestionRelatedObjectivesList($objectivesAdapter, $testSequence);
                                $objectivesList->loadObjectivesTitles();

                                $row['objectives'] = $objectivesList->getUniqueObjectivesStringForQuestions($testSequence->getUserSequenceQuestions());
                        }

                        if($withResults)
                        {
                                $result_array = $this->object->getTestResult($testSession->getActiveId(), $pass, false, $considerHiddenQuestions, $considerOptionalQuestions);
                                if(!$result_array['pass']['total_max_points'])
                                {
                                        $percentage = 0;
                                } else
                                {
                                        $percentage = ($result_array['pass']['total_reached_points'] / $result_array['pass']['total_max_points']) * 100;
                                }
                                $total_max = $result_array['pass']['total_max_points'];
                                $total_reached = $result_array['pass']['total_reached_points'];
                                $total_requested_hints = $result_array['pass']['total_requested_hints'];
                        }

                        if($withResults)
                        {
                                $row['scored'] = ($pass == $scoredPass);
                        }

                        $row['pass'] = $pass;
                        $row['date'] = $this->object->getPassFinishDate($testSession->getActiveId(), $pass);
                        if($withResults)
                        {
                                $row['num_workedthrough_questions'] = $result_array['pass']['num_workedthrough'];
                                $row['num_questions_total'] = $result_array['pass']['num_questions_total'];

                                if($this->object->isOfferingQuestionHintsEnabled())
                                {
                                        $row['hints'] = $total_requested_hints;
                                }

                                $row['reached_points'] = $total_reached;
                                $row['max_points'] = $total_max;
                                $row['percentage'] = $percentage;
                        }

                        $data[] = $row;
                }

                return $data;
        }

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

        public function getObjectiveOrientedContainer()
        {
                return $this->objectiveOrientedContainer;
        }
        
        function &executeCommand()
        {
                $cmd = $this->ctrl->getCmd();
                $next_class = $this->ctrl->getNextClass($this);

                $cmd = $this->getCommand($cmd);
                switch($next_class)
                {
                        default:
                                $ret =& $this->$cmd();
                                break;
                }
                return $ret;
        }

        function getCommand($cmd)
        {
                return $cmd;
        }
        
        protected function handleTabs($activeTabId)
        {
                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);
                        
                        $this->tabs->addTab(
                                'results_pass_oriented', $this->lng->txt('tst_tab_results_pass_oriented'),
                                $this->ctrl->getLinkTargetByClass('ilTestEvaluationGUI', 'outUserResultsOverview')
                        );
                        
                        $this->tabs->addTab(
                                'results_objective_oriented', $this->lng->txt('tst_tab_results_objective_oriented'),
                                $this->ctrl->getLinkTargetByClass('ilTestEvalObjectiveOrientedGUI', 'showVirtualPass')
                        );
                        
                        $this->tabs->setTabActive($activeTabId);
                }
        }
        
        protected function isPdfDeliveryRequest()
        {
                if( !isset($_GET['pdf']) )
                {
                        return false;
                }

                if( !(bool)$_GET['pdf'] )
                {
                        return false;
                }

                return true;
        }
        
        public function buildPassOverviewTableGUI($targetGUI, $targetCmd = '')
        {
                require_once 'Modules/Test/classes/tables/class.ilTestPassOverviewTableGUI.php';

                $table = new ilTestPassOverviewTableGUI($targetGUI, $targetCmd);
                
                $table->setPdfPresentationEnabled(
                        isset($_GET['pdf']) && $_GET['pdf'] == 1
                );
                
                $table->setObjectiveOrientedPresentationEnabled(
                        $this->getObjectiveOrientedContainer()->isObjectiveOrientedPresentationRequired()
                );
                
                return $table;
        }

        function getPassListOfAnswers(&$result_array, $active_id, $pass, $show_solutions = FALSE, $only_answered_questions = FALSE, $show_question_only = FALSE, $show_reached_points = FALSE, $anchorNav = false, ilTestQuestionRelatedObjectivesList $objectivesList = null, ilTestResultHeaderLabelBuilder $testResultHeaderLabelBuilder = null)
        {
                $maintemplate = new ilTemplate("tpl.il_as_tst_list_of_answers.html", TRUE, TRUE, "Modules/Test");

                $counter = 1;
                // output of questions with solutions
                foreach ($result_array as $question_data)
                {
                        if (($question_data["workedthrough"] == 1) || ($only_answered_questions == FALSE))
                        {
                                $template = new ilTemplate("tpl.il_as_qpl_question_printview.html", TRUE, TRUE, "Modules/TestQuestionPool");
                                $question = $question_data["qid"];
                                if (is_numeric($question))
                                {
                                        $maintemplate->setCurrentBlock("printview_question");
                                        $question_gui = $this->object->createQuestionGUI("", $question);
                                        if (is_object($question_gui))
                                        {
                                                if( $this->isPdfDeliveryRequest() )
                                                {
                                                        $question_gui->setOutputMode(assQuestionGUI::OUTPUT_MODE_PDF);
                                                }
                                                
                                                if($anchorNav)
                                                {
                                                        $template->setCurrentBlock('block_id');
                                                        $template->setVariable('BLOCK_ID', "detailed_answer_block_act_{$active_id}_qst_{$question}");
                                                        $template->parseCurrentBlock();

                                                        $template->setCurrentBlock('back_anchor');
                                                        $template->setVariable('HREF_BACK_ANCHOR', "#pass_details_tbl_row_act_{$active_id}_qst_{$question}");
                                                        $template->setVariable('TXT_BACK_ANCHOR', $this->lng->txt('tst_back_to_question_list'));
                                                        $template->parseCurrentBlock();
                                                }

                                                if ($show_reached_points)
                                                {
                                                        $template->setCurrentBlock("result_points");
                                                        $template->setVariable("RESULT_POINTS", $this->lng->txt("tst_reached_points") . ": " . $question_gui->object->getReachedPoints($active_id, $pass) . " " . $this->lng->txt("of") . " " . $question_gui->object->getMaximumPoints());
                                                        $template->parseCurrentBlock();
                                                }
                                                $template->setVariable("COUNTER_QUESTION", $counter.". ");
                                                $template->setVariable("TXT_QUESTION_ID", $this->lng->txt('question_id_short'));
                                                $template->setVariable("QUESTION_ID", $question_gui->object->getId());
                                                $template->setVariable("QUESTION_TITLE", $this->object->getQuestionTitle($question_gui->object->getTitle()));
                                                
                                                if( $objectivesList !== null )
                                                {
                                                        $objectives = $this->lng->txt('tst_res_lo_objectives_header').': ';
                                                        $objectives .= $objectivesList->getQuestionRelatedObjectiveTitles($question_gui->object->getId());
                                                        $template->setVariable("OBJECTIVES", $objectives);
                                                }

                                                $show_question_only = ($this->object->getShowSolutionAnswersOnly()) ? TRUE : FALSE;

                                                $showFeedback = $this->isContextResultPresentation() && $this->object->getShowSolutionFeedback();
                                                $show_solutions = $this->isContextResultPresentation() && $show_solutions;
                                                
                                                if($show_solutions)
                                                {
                                                        $compare_template = new ilTemplate('tpl.il_as_tst_answers_compare.html', TRUE, TRUE, 'Modules/Test');
                                                        $compare_template->setVariable("HEADER_PARTICIPANT", $this->lng->txt('tst_header_participant'));
                                                        $compare_template->setVariable("HEADER_SOLUTION", $this->lng->txt('tst_header_solution'));
                                                        $result_output = $question_gui->getSolutionOutput($active_id, $pass, $show_solutions, FALSE, $show_question_only, $showFeedback);
                                                        $best_output   = $question_gui->getSolutionOutput($active_id, $pass, FALSE, FALSE, $show_question_only, FALSE, TRUE);

                                                        $compare_template->setVariable('PARTICIPANT', $result_output);
                                                        $compare_template->setVariable('SOLUTION', $best_output);
                                                        $template->setVariable('SOLUTION_OUTPUT', $compare_template->get());
                                                }
                                                else
                                                {
                                                        $result_output = $question_gui->getSolutionOutput($active_id, $pass, $show_solutions, FALSE, $show_question_only, $showFeedback);
                                                        $template->setVariable('SOLUTION_OUTPUT', $result_output);
                                                }

                                                $maintemplate->setCurrentBlock("printview_question");
                                                $maintemplate->setVariable("QUESTION_PRINTVIEW", $template->get());
                                                $maintemplate->parseCurrentBlock();
                                                $counter ++;
                                        }
                                }
                        }
                }
                
                if($pass !== null)
                {
                        $headerText = $testResultHeaderLabelBuilder->getListOfAnswersHeaderLabel($pass + 1);
                }
                else
                {
                        $headerText = $testResultHeaderLabelBuilder->getVirtualListOfAnswersHeaderLabel();
                }
                
                $maintemplate->setVariable("RESULTS_OVERVIEW", $headerText);
                return $maintemplate->get();
        }
        
        function getPassListOfAnswersWithScoring(&$result_array, $active_id, $pass, $show_solutions = FALSE)
        {
                include_once "./Modules/TestQuestionPool/classes/class.assQuestion.php";
                
                $maintemplate = new ilTemplate("tpl.il_as_tst_list_of_answers.html", TRUE, TRUE, "Modules/Test");

                include_once "./Modules/Test/classes/class.ilObjAssessmentFolder.php";
                $scoring = ilObjAssessmentFolder::_getManualScoring();
                
                $counter = 1;
                // output of questions with solutions
                foreach ($result_array as $question_data)
                {
                        $question = $question_data["qid"];
                        if (is_numeric($question))
                        {
                                $question_gui = $this->object->createQuestionGUI("", $question);
                                if (in_array($question_gui->object->getQuestionTypeID(), $scoring))
                                {
                                        $template = new ilTemplate("tpl.il_as_qpl_question_printview.html", TRUE, TRUE, "Modules/TestQuestionPool");
                                        $scoretemplate = new ilTemplate("tpl.il_as_tst_manual_scoring_points.html", TRUE, TRUE, "Modules/Test");
                                        #mbecker: No such block. $this->tpl->setCurrentBlock("printview_question");
                                        $template->setVariable("COUNTER_QUESTION", $counter.". ");
                                        $template->setVariable("QUESTION_TITLE", $this->object->getQuestionTitle($question_gui->object->getTitle()));
                                        $points = $question_gui->object->getMaximumPoints();
                                        if ($points == 1)
                                        {
                                                $template->setVariable("QUESTION_POINTS", $points . " " . $this->lng->txt("point"));
                                        }
                                        else
                                        {
                                                $template->setVariable("QUESTION_POINTS", $points . " " . $this->lng->txt("points"));
                                        }
                                        
                                        $show_question_only = ($this->object->getShowSolutionAnswersOnly()) ? TRUE : FALSE;
                                        $result_output = $question_gui->getSolutionOutput($active_id, $pass, $show_solutions, FALSE, $show_question_only, $this->object->getShowSolutionFeedback(), FALSE, TRUE);

                                        $solout = $question_gui->object->getSuggestedSolutionOutput();
                                        if (strlen($solout))
                                        {
                                                $scoretemplate->setCurrentBlock("suggested_solution");
                                                $scoretemplate->setVariable("TEXT_SUGGESTED_SOLUTION", $this->lng->txt("solution_hint"));
                                                $scoretemplate->setVariable("VALUE_SUGGESTED_SOLUTION", $solout);
                                                $scoretemplate->parseCurrentBlock();
                                        }
                                        
                                        $scoretemplate->setCurrentBlock("feedback");
                                        $scoretemplate->setVariable("FEEDBACK_NAME_INPUT", $question);
                                        $feedback = $this->object->getManualFeedback($active_id, $question, $pass);
                                        $scoretemplate->setVariable("VALUE_FEEDBACK", ilUtil::prepareFormOutput($this->object->prepareTextareaOutput($feedback, TRUE)));
                                        $scoretemplate->setVariable("TEXT_MANUAL_FEEDBACK", $this->lng->txt("set_manual_feedback"));
                                        $scoretemplate->parseCurrentBlock();

                                        $scoretemplate->setVariable("NAME_INPUT", $question);
                                        $this->ctrl->setParameter($this, "active_id", $active_id);
                                        $this->ctrl->setParameter($this, "pass", $pass);
                                        $scoretemplate->setVariable("FORMACTION", $this->ctrl->getFormAction($this, "manscoring"));
                                        $scoretemplate->setVariable("LABEL_INPUT", $this->lng->txt("tst_change_points_for_question"));
                                        $scoretemplate->setVariable("VALUE_INPUT", " value=\"" . assQuestion::_getReachedPoints($active_id, $question_data["qid"], $pass) . "\"");
                                        $scoretemplate->setVariable("VALUE_SAVE", $this->lng->txt("save"));
                                        
                                        $template->setVariable("SOLUTION_OUTPUT", $result_output);
                                        $maintemplate->setCurrentBlock("printview_question");
                                        $maintemplate->setVariable("QUESTION_PRINTVIEW", $template->get());
                                        $maintemplate->setVariable("QUESTION_SCORING", $scoretemplate->get());
                                        $maintemplate->parseCurrentBlock();
                                }
                                $counter ++;
                        }
                }
                if ($counter == 1)
                {
                        // no scorable questions found
                        $maintemplate->setVariable("NO_QUESTIONS_FOUND", $this->lng->txt("manscoring_questions_not_found"));
                }
                $maintemplate->setVariable("RESULTS_OVERVIEW", sprintf($this->lng->txt("manscoring_results_pass"), $pass+1));

                include_once "./Services/YUI/classes/class.ilYuiUtil.php";
                ilYuiUtil::initDomEvent();

                return $maintemplate->get();
        }

        protected function getPassDetailsOverviewTableGUI($result_array, $active_id, $pass, $targetGUI, $targetCMD, $questionDetailsCMD, $questionAnchorNav, ilTestQuestionRelatedObjectivesList $objectivesList = null)
        {
                $this->ctrl->setParameter($targetGUI, 'active_id', $active_id);
                $this->ctrl->setParameter($targetGUI, 'pass', $pass);

                $tableGUI = $this->buildPassDetailsOverviewTableGUI($targetGUI, $targetCMD);

                $tableGUI->setAnswerListAnchorEnabled($questionAnchorNav);
                $tableGUI->setSingleAnswerScreenCmd($questionDetailsCMD);
                $tableGUI->setShowHintCount($this->object->isOfferingQuestionHintsEnabled());

                if( $objectivesList !== null )
                {
                        $tableGUI->setQuestionRelatedObjectivesList($objectivesList);
                        $tableGUI->setObjectiveOrientedPresentationEnabled(true);
                }

                $tableGUI->setActiveId($active_id);
                $tableGUI->setShowSuggestedSolution(false);

                $usersQuestionSolutions = array();

                foreach($result_array as $key => $val)
                {
                        if($key === 'test' || $key === 'pass')
                        {
                                continue;
                        }

                        if( $this->object->getShowSolutionSuggested() && strlen($val['solution']) )
                        {
                                $tableGUI->setShowSuggestedSolution(true);
                        }

                        if( isset($val['pass']) )
                        {
                                $tableGUI->setPassColumnEnabled(true);
                        }

                        $usersQuestionSolutions[$key] = $val;
                }

                $tableGUI->initColumns()->initFilter();

                $tableGUI->setFilterCommand($targetCMD.'SetTableFilter');
                $tableGUI->setResetCommand($targetCMD.'ResetTableFilter');

                $tableGUI->setData($usersQuestionSolutions);

                return $tableGUI;
        }

        function getResultsSignature()
        {
                if ($this->object->getShowSolutionSignature() && !$this->object->getAnonymity())
                {
                        $template = new ilTemplate("tpl.il_as_tst_results_userdata_signature.html", TRUE, TRUE, "Modules/Test");
                        $template->setVariable("TXT_DATE", $this->lng->txt("date"));
                        $old_value = ilDatePresentation::useRelativeDates();
                        ilDatePresentation::setUseRelativeDates(false);
                        $template->setVariable("VALUE_DATE", ilDatePresentation::formatDate(new ilDate(time(), IL_CAL_UNIX)));
                        ilDatePresentation::setUseRelativeDates($old_value);
                        $template->setVariable("TXT_SIGNATURE", $this->lng->txt("tst_signature"));
                        $template->setVariable("IMG_SPACER", ilUtil::getImagePath("spacer.png"));
                        return $template->get();
                }
                else
                {
                        return "";
                }
        }
        
        function getAdditionalUsrDataHtmlAndPopulateWindowTitle($testSession, $active_id, $overwrite_anonymity = FALSE)
        {
                if(!is_object($testSession)) throw new TestException();
                $template = new ilTemplate("tpl.il_as_tst_results_userdata.html", TRUE, TRUE, "Modules/Test");
                include_once './Services/User/classes/class.ilObjUser.php';
                $user_id = $this->object->_getUserIdFromActiveId($active_id);
                if (strlen(ilObjUser::_lookupLogin($user_id)) > 0)
                {
                        $user = new ilObjUser($user_id);
                }
                else
                {
                        $user = new ilObjUser();
                        $user->setLastname($this->lng->txt("deleted_user"));
                }
                $t = $testSession->getSubmittedTimestamp();
                if (!$t)
                {
                        $t = $this->object->_getLastAccess($testSession->getActiveId());
                }
                
                if( $this->getObjectiveOrientedContainer()->isObjectiveOrientedPresentationRequired() )
                {
                        $uname = $this->object->userLookupFullName($user_id, $overwrite_anonymity);
                        $template->setCurrentBlock("name");
                        $template->setVariable('TXT_USR_NAME', $this->lng->txt("name"));
                        $template->setVariable('VALUE_USR_NAME', $uname);
                        $template->parseCurrentBlock();
                }

                $title_matric = "";
                if (strlen($user->getMatriculation()) && (($this->object->getAnonymity() == FALSE) || ($overwrite_anonymity)))
                {
                        $template->setCurrentBlock("matriculation");
                        $template->setVariable("TXT_USR_MATRIC", $this->lng->txt("matriculation"));
                        $template->setVariable("VALUE_USR_MATRIC", $user->getMatriculation());
                        $template->parseCurrentBlock();
                        $title_matric = " - " . $this->lng->txt("matriculation") . ": " . $user->getMatriculation();
                }

                $invited_user = array_pop($this->object->getInvitedUsers($user_id));
                if (strlen($invited_user["clientip"]))
                {
                        $template->setCurrentBlock("client_ip");
                        $template->setVariable("TXT_CLIENT_IP", $this->lng->txt("client_ip"));
                        $template->setVariable("VALUE_CLIENT_IP", $invited_user["clientip"]);
                        $template->parseCurrentBlock();
                        $title_client = " - " . $this->lng->txt("clientip") . ": " . $invited_user["clientip"];
                }

                $template->setVariable("TXT_TEST_TITLE", $this->lng->txt("title"));
                $template->setVariable("VALUE_TEST_TITLE", $this->object->getTitle());
                
                // change the pagetitle (tab title or title in title bar of window)
                $pagetitle = $this->object->getTitle() . $title_matric . $title_client;
                $this->tpl->setHeaderPageTitle($pagetitle);
                
                return $template->get();
        }

        function getCorrectSolutionOutput($question_id, $active_id, $pass, ilTestQuestionRelatedObjectivesList $objectivesList = null)
        {
                global $ilUser;

                $test_id = $this->object->getTestId();
                $question_gui = $this->object->createQuestionGUI("", $question_id);

                if( $this->isPdfDeliveryRequest() )
                {
                        $question_gui->setOutputMode(assQuestionGUI::OUTPUT_MODE_PDF);
                }

                $template = new ilTemplate("tpl.il_as_tst_correct_solution_output.html", TRUE, TRUE, "Modules/Test");
                $show_question_only = ($this->object->getShowSolutionAnswersOnly()) ? TRUE : FALSE;
                $result_output = $question_gui->getSolutionOutput($active_id, $pass, TRUE, FALSE, $show_question_only, $this->object->getShowSolutionFeedback(), FALSE, FALSE, TRUE);
                $best_output = $question_gui->getSolutionOutput($active_id, $pass, FALSE, FALSE, $show_question_only, FALSE, TRUE, FALSE, FALSE);
                if( $this->object->getShowSolutionFeedback() && $_GET['cmd'] != 'outCorrectSolution' )
                {
                        $specificAnswerFeedback = $question_gui->getSpecificFeedbackOutput($active_id, $pass);
                        if( strlen($specificAnswerFeedback) )
                        {
                                $template->setCurrentBlock("outline_specific_feedback");
                                $template->setVariable("OUTLINE_SPECIFIC_FEEDBACK", $specificAnswerFeedback);
                                $template->parseCurrentBlock();
                        }
                }
                if ($this->object->isBestSolutionPrintedWithResult() && strlen($best_output))
                {
                        $template->setCurrentBlock("best_solution");
                        $template->setVariable("TEXT_BEST_SOLUTION", $this->lng->txt("tst_best_solution_is"));
                        $template->setVariable("BEST_OUTPUT", $best_output);
                        $template->parseCurrentBlock();
                }
                $template->setVariable("TEXT_YOUR_SOLUTION", $this->lng->txt("tst_your_answer_was"));
                $maxpoints = $question_gui->object->getMaximumPoints();
                if ($maxpoints == 1)
                {
                        $template->setVariable("QUESTION_TITLE", $this->object->getQuestionTitle($question_gui->object->getTitle()) . " (" . $maxpoints . " " . $this->lng->txt("point") . ")");
                }
                else
                {
                        $template->setVariable("QUESTION_TITLE", $this->object->getQuestionTitle($question_gui->object->getTitle()) . " (" . $maxpoints . " " . $this->lng->txt("points") . ")");
                }
                if( $objectivesList !== null )
                {
                        $objectives = $this->lng->txt('tst_res_lo_objectives_header').': ';
                        $objectives .= $objectivesList->getQuestionRelatedObjectiveTitles($question_gui->object->getId());
                        $template->setVariable('OBJECTIVES', $objectives);
                }
                $template->setVariable("SOLUTION_OUTPUT", $result_output);
                $template->setVariable("RECEIVED_POINTS", sprintf($this->lng->txt("you_received_a_of_b_points"), $question_gui->object->getReachedPoints($active_id, $pass), $maxpoints));
                $template->setVariable("FORMACTION", $this->ctrl->getFormAction($this));
                $template->setVariable("BACKLINK_TEXT", "&lt;&lt; " . $this->lng->txt("back"));
                return $template->get();
        }

        function getResultsOfUserOutput($testSession, $active_id, $pass, $targetGUI, $show_pass_details = TRUE, $show_answers = TRUE, $show_question_only = FALSE, $show_reached_points = FALSE)
        {
                global $ilObjDataCache;

                include_once("./Services/UICore/classes/class.ilTemplate.php");
                $template = new ilTemplate("tpl.il_as_tst_results_participant.html", TRUE, TRUE, "Modules/Test");

                if( $this->participantData instanceof ilTestParticipantData )
                {
                        $user_id = $this->participantData->getUserIdByActiveId($active_id);
                        $uname = $this->participantData->getConcatedFullnameByActiveId($active_id, false);
                }
                else
                {
                        $user_id = $this->object->_getUserIdFromActiveId($active_id);
                        $uname = $this->object->userLookupFullName($user_id, TRUE);
                }
                
                if (((array_key_exists("pass", $_GET)) && (strlen($_GET["pass"]) > 0)) || (!is_null($pass)))
                {
                        if (is_null($pass))     $pass = $_GET["pass"];
                }

                if (!is_null($pass))
                {
                        require_once 'Modules/Test/classes/class.ilTestResultHeaderLabelBuilder.php';
                        $testResultHeaderLabelBuilder = new ilTestResultHeaderLabelBuilder($this->lng, $ilObjDataCache);

                        $objectivesList = null;

                        if( $this->getObjectiveOrientedContainer()->isObjectiveOrientedPresentationRequired() )
                        {
                                $testSequence = $this->testSequenceFactory->getSequenceByActiveIdAndPass($active_id, $pass);
                                $testSequence->loadFromDb();
                                $testSequence->loadQuestions();

                                require_once 'Modules/Course/classes/Objectives/class.ilLOTestQuestionAdapter.php';
                                $objectivesAdapter = ilLOTestQuestionAdapter::getInstance($testSession);

                                $objectivesList = $this->buildQuestionRelatedObjectivesList($objectivesAdapter, $testSequence);
                                $objectivesList->loadObjectivesTitles();

                                $testResultHeaderLabelBuilder->setObjectiveOrientedContainerId($testSession->getObjectiveOrientedContainerId());
                                $testResultHeaderLabelBuilder->setUserId($testSession->getUserId());
                                $testResultHeaderLabelBuilder->setTestObjId($this->object->getId());
                                $testResultHeaderLabelBuilder->setTestRefId($this->object->getRefId());
                                $testResultHeaderLabelBuilder->initObjectiveOrientedMode();
                        }

                        $result_array = $this->object->getTestResult(
                                $active_id, $pass, false, !$this->getObjectiveOrientedContainer()->isObjectiveOrientedPresentationRequired()
                        );

                        $user_id = $this->object->_getUserIdFromActiveId($active_id);
                        $showAllAnswers = TRUE;
                        if ($this->object->isExecutable($testSession, $user_id))
                        {
                                $showAllAnswers = FALSE;
                        }
                        if ($show_answers)
                        {
                                $list_of_answers = $this->getPassListOfAnswers(
                                        $result_array, $active_id, $pass, $_SESSION['tst_results_show_best_solutions'],
                                        $showAllAnswers, $show_question_only, $show_reached_points, $show_pass_details,
                                        $objectivesList, $testResultHeaderLabelBuilder
                                );
                                $template->setVariable("LIST_OF_ANSWERS", $list_of_answers);
                        }

                        if ($show_pass_details)
                        {
                                $overviewTableGUI = $this->getPassDetailsOverviewTableGUI($result_array, $active_id, $pass, $targetGUI, "getResultsOfUserOutput", '', $show_answers, $objectivesList);
                                $overviewTableGUI->setTitle($testResultHeaderLabelBuilder->getPassDetailsHeaderLabel($pass + 1));
                                $template->setVariable("PASS_DETAILS", $overviewTableGUI->getHTML());
                        }

                        $signature = $this->getResultsSignature();
                        $template->setVariable("SIGNATURE", $signature);
                        
                        if ($this->object->isShowExamIdInTestResultsEnabled())
                        {
                                $template->setCurrentBlock('exam_id_footer');
                                $template->setVariable('EXAM_ID_VAL', $this->object->lookupExamId(
                                        $testSession->getActiveId(), $pass
                                ));
                                $template->setVariable('EXAM_ID_TXT', $this->lng->txt('exam_id'));
                                $template->parseCurrentBlock();
                        }
                }

                $template->setCurrentBlock('participant_back_anchor');
                $template->setVariable("HREF_PARTICIPANT_BACK_ANCHOR", "#tst_results_toolbar");
                $template->setVariable("TXT_PARTICIPANT_BACK_ANCHOR", $this->lng->txt('tst_back_to_top'));
                $template->parseCurrentBlock();

                $template->setCurrentBlock('participant_block_id');
                $template->setVariable("PARTICIPANT_BLOCK_ID", "participant_active_{$active_id}");
                $template->parseCurrentBlock();

                if( $this->isGradingMessageRequired() )
                {
                        $gradingMessageBuilder = $this->getGradingMessageBuilder($active_id);
                        $gradingMessageBuilder->buildList();

                        $template->setCurrentBlock('grading_message');
                        $template->setVariable('GRADING_MESSAGE', $gradingMessageBuilder->getList());
                        $template->parseCurrentBlock();
                }


                $user_data = $this->getAdditionalUsrDataHtmlAndPopulateWindowTitle($testSession, $active_id, TRUE);
                $template->setVariable("TEXT_HEADING", sprintf($this->lng->txt("tst_result_user_name"), $uname));
                $template->setVariable("USER_DATA", $user_data);

                $this->populatePassFinishDate($template, $this->object->getPassFinishDate($active_id, $pass));

                return $template->get();
        }

        function getResultsHeadUserAndPass($active_id, $pass)
        {
                $template = new ilTemplate("tpl.il_as_tst_results_head_user_pass.html", TRUE, TRUE, "Modules/Test");
                include_once './Services/User/classes/class.ilObjUser.php';
                $user_id = $this->object->_getUserIdFromActiveId($active_id);
                if (strlen(ilObjUser::_lookupLogin($user_id)) > 0)
                {
                        $user = new ilObjUser($user_id);
                }
                else
                {
                        $user = new ilObjUser();
                        $user->setLastname($this->lng->txt("deleted_user"));
                }
                $title_matric = "";
                if (strlen($user->getMatriculation()) && (($this->object->getAnonymity() == FALSE)))
                {
                        $template->setCurrentBlock("user_matric");
                        $template->setVariable("TXT_USR_MATRIC", $this->lng->txt("matriculation"));
                        $template->parseCurrentBlock();
                        $template->setCurrentBlock("user_matric_value");
                        $template->setVariable("VALUE_USR_MATRIC", $user->getMatriculation());
                        $template->parseCurrentBlock();
                        $template->touchBlock("user_matric_separator");
                        $title_matric = " - " . $this->lng->txt("matriculation") . ": " . $user->getMatriculation();
                }

                $invited_user = array_pop($this->object->getInvitedUsers($user_id));
                if (strlen($invited_user["clientip"]))
                {
                        $template->setCurrentBlock("user_clientip");
                        $template->setVariable("TXT_CLIENT_IP", $this->lng->txt("client_ip"));
                        $template->parseCurrentBlock();
                        $template->setCurrentBlock("user_clientip_value");
                        $template->setVariable("VALUE_CLIENT_IP", $invited_user["clientip"]);
                        $template->parseCurrentBlock();
                        $template->touchBlock("user_clientip_separator");
                        $title_client = " - " . $this->lng->txt("clientip") . ": " . $invited_user["clientip"];
                }

                $template->setVariable("TXT_USR_NAME", $this->lng->txt("name"));
                $uname = $this->object->userLookupFullName($user_id, FALSE);
                $template->setVariable("VALUE_USR_NAME", $uname);
                $template->setVariable("TXT_PASS", $this->lng->txt("scored_pass"));
                $template->setVariable("VALUE_PASS", $pass);
                return $template->get();
        }

        public function getQuestionResultForTestUsers($question_id, $test_id)
        {
                // REQUIRED, since we call this object regardless of the loop
                $question_gui = $this->object->createQuestionGUI("", $question_id);

                $foundusers = $this->object->getParticipantsForTestAndQuestion($test_id, $question_id);
                $output     = '';
                foreach($foundusers as $active_id => $passes)
                {
                        $resultpass = $this->object->_getResultPass($active_id);
                        for($i = 0; $i < count($passes); $i++)
                        {
                                if(($resultpass !== null) && ($resultpass == $passes[$i]["pass"]))
                                {
                                        if($output)
                                        {
                                                $output .= "<br /><br /><br />";
                                        }

                                        // check if re-instantiation is really neccessary
                                        $question_gui = $this->object->createQuestionGUI("", $passes[$i]["qid"]);
                                        $output .= $this->getResultsHeadUserAndPass($active_id, $resultpass + 1);
                                        $question_gui->setOutputMode(assQuestionGUI::OUTPUT_MODE_PDF);
                                        $output .= $question_gui->getSolutionOutput(
                                                $active_id,
                                                $resultpass,
                                                $graphicalOutput = FALSE,
                                                $result_output = FALSE,
                                                $show_question_only = FALSE,
                                                $show_feedback = FALSE
                                        );
                                }
                        }
                }

                require_once './Modules/Test/classes/class.ilTestPDFGenerator.php';
                ilTestPDFGenerator::generatePDF($output, ilTestPDFGenerator::PDF_OUTPUT_DOWNLOAD, $question_gui->object->getTitle());
        }

        protected function buildPassDetailsOverviewTableGUI($targetGUI, $targetCMD)
        {
                require_once 'Modules/Test/classes/tables/class.ilTestPassDetailsOverviewTableGUI.php';
                $tableGUI = new ilTestPassDetailsOverviewTableGUI($this->ctrl, $targetGUI, $targetCMD);
                $tableGUI->setIsPdfGenerationRequest($this->isPdfDeliveryRequest());
                return $tableGUI;
        }
        
        protected function isGradingMessageRequired()
        {
                if( $this->getObjectiveOrientedContainer()->isObjectiveOrientedPresentationRequired() )
                {
                        return false;
                }

                if( $this->object->isShowGradingStatusEnabled() )
                {
                        return true;
                }

                if( $this->object->isShowGradingMarkEnabled() )
                {
                        return true;
                }

                if( $this->object->areObligationsEnabled() )
                {
                        return true;
                }
                
                return false;
        }

        protected function getGradingMessageBuilder($activeId)
        {
                require_once 'Modules/Test/classes/class.ilTestGradingMessageBuilder.php';
                $gradingMessageBuilder = new ilTestGradingMessageBuilder($this->lng, $this->object);
                
                $gradingMessageBuilder->setActiveId($activeId);
                
                return $gradingMessageBuilder;
        }
        
        protected function buildQuestionRelatedObjectivesList(ilLOTestQuestionAdapter $objectivesAdapter, ilTestQuestionSequence $testSequence)
        {
                require_once 'Modules/Test/classes/class.ilTestQuestionRelatedObjectivesList.php';
                $questionRelatedObjectivesList = new ilTestQuestionRelatedObjectivesList();
                        
                $objectivesAdapter->buildQuestionRelatedObjectiveList($testSequence, $questionRelatedObjectivesList);
                
                return $questionRelatedObjectivesList;
        }

        protected function getFilteredTestResult($active_id, $pass, $considerHiddenQuestions, $considerOptionalQuestions)
        {
                global $ilDB, $ilPluginAdmin;

                $table_gui = $this->buildPassDetailsOverviewTableGUI($this, 'outUserPassDetails');
                $table_gui->initFilter();

                require_once 'Modules/TestQuestionPool/classes/class.ilAssQuestionList.php';
                $questionList = new ilAssQuestionList($ilDB, $this->lng, $ilPluginAdmin);

                $questionList->setParentObjIdsFilter(array($this->object->getId()));
                $questionList->setQuestionInstanceTypeFilter(ilAssQuestionList::QUESTION_INSTANCE_TYPE_DUPLICATES);

                foreach ($table_gui->getFilterItems() as $item)
                {
                        if( substr($item->getPostVar(), 0, strlen('tax_')) == 'tax_' )
                        {
                                $v = $item->getValue();

                                if( is_array($v) && count($v) && !(int)$v[0] )
                                {
                                        continue;
                                }

                                $taxId = substr($item->getPostVar(), strlen('tax_'));
                                $questionList->addTaxonomyFilter($taxId, $item->getValue(), $this->object->getId(), 'tst');
                        }
                        elseif( $item->getValue() !== false )
                        {
                                $questionList->addFieldFilter($item->getPostVar(), $item->getValue());
                        }
                }

                $questionList->load();

                $filteredTestResult = array();

                $resultData = $this->object->getTestResult($active_id, $pass, false, $considerHiddenQuestions, $considerOptionalQuestions);

                foreach($resultData as $resultItemKey => $resultItemValue)
                {
                        if($resultItemKey === 'test' || $resultItemKey === 'pass')
                        {
                                continue;
                        }

                        if( !$questionList->isInList($resultItemValue['qid']) )
                        {
                                continue;
                        }

                        $filteredTestResult[] = $resultItemValue;
                }

                return $filteredTestResult;
        }

        protected function populateContent($content)
        {
                if($this->isPdfDeliveryRequest())
                {
                        require_once 'class.ilTestPDFGenerator.php';

                        ilTestPDFGenerator::generatePDF(
                                $content, ilTestPDFGenerator::PDF_OUTPUT_DOWNLOAD, $this->object->getTitle()
                        );
                }
                else
                {
                        $this->tpl->setContent($content);
                }
        }

        protected function buildUserTestResultsToolbarGUI()
        {
                require_once 'Modules/Test/classes/toolbars/class.ilTestResultsToolbarGUI.php';
                $toolbar = new ilTestResultsToolbarGUI($this->ctrl, $this->tpl, $this->lng);

                $toolbar->setSkillResultButtonEnabled($this->object->isSkillServiceToBeConsidered());

                return $toolbar;
        }

        protected function outCorrectSolutionCmd()
        {
                $this->outCorrectSolution(); // cannot be named xxxCmd, because it's also called from context without Cmd in names
        }
        
        protected function outCorrectSolution()
        {
                if( !$this->object->getShowSolutionDetails() )
                {
                        ilUtil::sendInfo($this->lng->txt("no_permission"), true);
                        $this->ctrl->redirectByClass("ilobjtestgui", "infoScreen");
                }

                $testSession = $this->testSessionFactory->getSession();
                $activeId = $testSession->getActiveId();

                if( !($activeId > 0) )
                {
                        $this->ctrl->redirectByClass("ilobjtestgui", "infoScreen");
                }

                $this->ctrl->saveParameter($this, "pass");
                $pass = (int)$_GET['pass'];

                $questionId = (int)$_GET['evaluation'];

                if( $this->getObjectiveOrientedContainer()->isObjectiveOrientedPresentationRequired() )
                {
                        $testSequence = $this->testSequenceFactory->getSequenceByActiveIdAndPass($activeId, $pass);
                        $testSequence->loadFromDb();
                        $testSequence->loadQuestions();

                        require_once 'Modules/Course/classes/Objectives/class.ilLOTestQuestionAdapter.php';
                        $objectivesAdapter = ilLOTestQuestionAdapter::getInstance($testSession);
                        $objectivesList = $this->buildQuestionRelatedObjectivesList($objectivesAdapter, $testSequence);
                        $objectivesList->loadObjectivesTitles();
                }
                else
                {
                        $objectivesList = null;
                }

                global $ilTabs;

                if($this instanceof ilTestEvalObjectiveOrientedGUI)
                {
                        $ilTabs->setBackTarget(
                                $this->lng->txt("tst_back_to_virtual_pass"), $this->ctrl->getLinkTarget($this, 'showVirtualPass')
                        );
                }
                else
                {
                        $ilTabs->setBackTarget(
                                $this->lng->txt("tst_back_to_pass_details"), $this->ctrl->getLinkTarget($this, 'outUserPassDetails')
                        );
                }

                include_once("./Services/Style/classes/class.ilObjStyleSheet.php");
                $this->tpl->setCurrentBlock("ContentStyle");
                $this->tpl->setVariable("LOCATION_CONTENT_STYLESHEET", ilObjStyleSheet::getContentStylePath(0));
                $this->tpl->parseCurrentBlock();

                $this->tpl->setCurrentBlock("SyntaxStyle");
                $this->tpl->setVariable("LOCATION_SYNTAX_STYLESHEET", ilObjStyleSheet::getSyntaxStylePath());
                $this->tpl->parseCurrentBlock();

                $this->tpl->addCss(ilUtil::getStyleSheetLocation("output", "test_print.css", "Modules/Test"), "print");
                if ($this->object->getShowSolutionAnswersOnly())
                {
                        $this->tpl->addCss(ilUtil::getStyleSheetLocation("output", "test_print_hide_content.css", "Modules/Test"), "print");
                }

                $solution = $this->getCorrectSolutionOutput($questionId, $activeId, $pass, $objectivesList);

                $this->tpl->setContent($solution);
        }

        public function populatePassFinishDate($tpl, $passFinishDate)
        {
                $oldValue = ilDatePresentation::useRelativeDates();
                ilDatePresentation::setUseRelativeDates(false);
                $passFinishDate = ilDatePresentation::formatDate(new ilDateTime($passFinishDate, IL_CAL_UNIX));
                ilDatePresentation::setUseRelativeDates($oldValue);
                $tpl->setVariable("PASS_FINISH_DATE_LABEL", $this->lng->txt('tst_pass_finished_on'));
                $tpl->setVariable("PASS_FINISH_DATE_VALUE", $passFinishDate);
        }
}

// internal sort function to sort the result array
function sortResults($a, $b)
{
        $sort = ($_GET["sort"]) ? ($_GET["sort"]) : "nr";
        $sortorder = ($_GET["sortorder"]) ? ($_GET["sortorder"]) : "asc";
        if (strcmp($sortorder, "asc")) 
        {
                $smaller = 1;
                $greater = -1;
        } 
        else 
        {
                $smaller = -1;
                $greater = 1;
        }
        if ($a[$sort] == $b[$sort]) return 0;
        return ($a[$sort] < $b[$sort]) ? $smaller : $greater;
}