class.ilObjTestSettingsScoringResultsGUI.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/class.ilTestSettingsGUI.php';

class ilObjTestSettingsScoringResultsGUI extends ilTestSettingsGUI
{
    const CMD_SHOW_FORM                                 = 'showForm';
    const CMD_SAVE_FORM                                 = 'saveForm';
    const CMD_CONFIRMED_SAVE_FORM               = 'confirmedSaveForm';

    protected $ctrl = null;
    
    protected $access = null;
    
    protected $lng = null;
    
    protected $tpl = null;
    
    protected $tree = null;
    
    protected $db = null;

    protected $pluginAdmin = null;

    protected $testOBJ = null;

    protected $testGUI = null;
    
    private $testQuestionSetConfigFactory = null;

    protected $settingsTemplate = null;

    public function __construct(
        ilCtrl $ctrl,
        ilAccessHandler $access,
        ilLanguage $lng,
        ilTemplate $tpl,
        ilTree $tree,
        ilDBInterface $db,
        ilPluginAdmin $pluginAdmin,
        ilObjTestGUI $testGUI
    ) {
        $this->ctrl = $ctrl;
        $this->access = $access;
        $this->lng = $lng;
        $this->tpl = $tpl;
        $this->tree = $tree;
        $this->db = $db;
        $this->pluginAdmin = $pluginAdmin;

        $this->testGUI = $testGUI;
        $this->testOBJ = $testGUI->object;

        require_once 'Modules/Test/classes/class.ilTestQuestionSetConfigFactory.php';
        $this->testQuestionSetConfigFactory = new ilTestQuestionSetConfigFactory($this->tree, $this->db, $this->pluginAdmin, $this->testOBJ);
        
        $templateId = $this->testOBJ->getTemplate();

        if ($templateId) {
            include_once "Services/Administration/classes/class.ilSettingsTemplate.php";
            $this->settingsTemplate = new ilSettingsTemplate($templateId, ilObjAssessmentFolderGUI::getSettingsTemplateConfig());
        }
    }

    public function executeCommand()
    {
        // allow only write access
        
        if (!$this->access->checkAccess('write', '', $this->testGUI->ref_id)) {
            ilUtil::sendInfo($this->lng->txt('cannot_edit_test'), true);
            $this->ctrl->redirect($this->testGUI, 'infoScreen');
        }
        
        // process command
        
        $nextClass = $this->ctrl->getNextClass();
        
        switch ($nextClass) {
            default:
                $cmd = $this->ctrl->getCmd(self::CMD_SHOW_FORM) . 'Cmd';
                $this->$cmd();
        }
    }

    private function showFormCmd(ilPropertyFormGUI $form = null)
    {
        //$this->tpl->addJavascript("./Services/JavaScript/js/Basic.js");
        
        if ($form === null) {
            $form = $this->buildForm();
        }

        $this->tpl->setContent($this->ctrl->getHTML($form));
    }

    private function confirmedSaveFormCmd()
    {
        return $this->saveFormCmd(true);
    }
    
    private function saveFormCmd($isConfirmedSave = false)
    {
        $form = $this->buildForm();
        
        // form validation and initialisation
        
        $errors = !$form->checkInput(); // ALWAYS CALL BEFORE setValuesByPost()
        $form->setValuesByPost(); // NEVER CALL THIS BEFORE checkInput()

        // return to form when any form validation errors exist

        if ($errors) {
            ilUtil::sendFailure($this->lng->txt('form_input_not_valid'));
            return $this->showFormCmd($form);
        }

        // check for required confirmation and redirect if neccessary

        if (!$isConfirmedSave && $this->isScoreRecalculationRequired($form)) {
            return $this->showConfirmation($form);
        }

        // perform save

        $this->performSaveForm($form);

        if ($this->isScoreRecalculationRequired($form)) {
            $this->testOBJ->recalculateScores(true);
        }

        // redirect to form output

        ilUtil::sendSuccess($this->lng->txt("msg_obj_modified"), true);
        $this->ctrl->redirect($this, self::CMD_SHOW_FORM);
    }

    private function performSaveForm(ilPropertyFormGUI $form)
    {
        $this->saveScoringSettingsFormSection($form);
        $this->saveResultSummarySettings($form);
        $this->saveResultDetailsSettings($form);
        $this->saveResultMiscOptionsSettings($form);

        // store settings to db
        $this->testOBJ->saveToDb(true);
    }
    
    private function showConfirmation(ilPropertyFormGUI $form)
    {
        require_once 'Services/Utilities/classes/class.ilConfirmationGUI.php';
        $confirmation = new ilConfirmationGUI();
        
        $confirmation->setHeaderText($this->lng->txt('tst_trigger_result_refreshing'));
        
        $confirmation->setFormAction($this->ctrl->getFormAction($this));
        $confirmation->setCancel($this->lng->txt('cancel'), self::CMD_SHOW_FORM);
        $confirmation->setConfirm($this->lng->txt('confirm'), self::CMD_CONFIRMED_SAVE_FORM);

        foreach ($form->getInputItemsRecursive() as $key => $item) {
            //vd("$key // {$item->getType()} // ".json_encode($_POST[$item->getPostVar()]));

            switch ($item->getType()) {
                case 'section_header':
                    
                    break;
                    
                case 'datetime':

                    $datetime = $item->getDate();
                    if ($datetime instanceof ilDateTime) {
                        list($date, $time) = explode(' ', $datetime->get(IL_CAL_DATETIME));
                        if (!($date instanceof ilDate)) {
                            $confirmation->addHiddenItem($item->getPostVar(), $date . ' ' . $time);
                        } else {
                            $confirmation->addHiddenItem($item->getPostVar(), $date);
                        }
                    } else {
                        $confirmation->addHiddenItem($item->getPostVar(), '');
                    }

                    break;
                    
                case 'duration':
                    
                    $confirmation->addHiddenItem("{$item->getPostVar()}[MM]", (int) $item->getMonths());
                    $confirmation->addHiddenItem("{$item->getPostVar()}[dd]", (int) $item->getDays());
                    $confirmation->addHiddenItem("{$item->getPostVar()}[hh]", (int) $item->getHours());
                    $confirmation->addHiddenItem("{$item->getPostVar()}[mm]", (int) $item->getMinutes());
                    $confirmation->addHiddenItem("{$item->getPostVar()}[ss]", (int) $item->getSeconds());
                    
                    break;

                case 'checkboxgroup':
                    
                    if (is_array($item->getValue())) {
                        foreach ($item->getValue() as $option) {
                            $confirmation->addHiddenItem("{$item->getPostVar()}[]", $option);
                        }
                    }
                    
                    break;
                    
                case 'checkbox':
                    
                    if ($item->getChecked()) {
                        $confirmation->addHiddenItem($item->getPostVar(), 1);
                    }
                    
                    break;
                
                default:
                    
                    $confirmation->addHiddenItem($item->getPostVar(), $item->getValue());
            }
        }
        
        $this->tpl->setContent($this->ctrl->getHTML($confirmation));
    }
    
    private function buildForm()
    {
        include_once 'Services/Form/classes/class.ilPropertyFormGUI.php';
        $form = new ilPropertyFormGUI();
        $form->setFormAction($this->ctrl->getFormAction($this));
        $form->setTableWidth('100%');
        $form->setId('test_scoring_results');

        $this->addScoringSettingsFormSection($form);
        $this->addResultSummarySettingsFormSection($form);
        $this->addResultDetailsSettingsFormSection($form);
        $this->addMiscSettingsFormSection($form);

        // remove items when using template
        if ($this->settingsTemplate) {
            foreach ($this->settingsTemplate->getSettings() as $id => $item) {
                if ($item["hide"]) {
                    $form->removeItemByPostVar($id);
                }
            }
        }

        $form->addCommandButton(self::CMD_SAVE_FORM, $this->lng->txt('save'));

        return $form;
    }

    private function addScoringSettingsFormSection(ilPropertyFormGUI $form)
    {
        $fields = array(
            'count_system', 'mc_scoring', 'score_cutting', 'pass_scoring', 'pass_deletion_allowed'
        );

        if ($this->isSectionHeaderRequired($fields)) {
            // scoring settings
            $header = new ilFormSectionHeaderGUI();
            $header->setTitle($this->lng->txt('test_scoring'));
            $form->addItem($header);
        }

        // scoring system
        $count_system = new ilRadioGroupInputGUI($this->lng->txt('tst_text_count_system'), 'count_system');
        $count_system->addOption($opt = new ilRadioOption($this->lng->txt('tst_count_partial_solutions'), 0, ''));
        $opt->setInfo($this->lng->txt('tst_count_partial_solutions_desc'));
        $count_system->addOption($opt = new ilRadioOption($this->lng->txt('tst_count_correct_solutions'), 1, ''));
        $opt->setInfo($this->lng->txt('tst_count_correct_solutions_desc'));
        $count_system->setValue($this->testOBJ->getCountSystem());
        $form->addItem($count_system);

        // mc questions
        $mc_scoring = new ilRadioGroupInputGUI($this->lng->txt('tst_score_mcmr_questions'), 'mc_scoring');
        $mc_scoring->addOption($opt = new ilRadioOption($this->lng->txt('tst_score_mcmr_zero_points_when_unanswered'), 0, ''));
        $opt->setInfo($this->lng->txt('tst_score_mcmr_zero_points_when_unanswered_desc'));
        $mc_scoring->addOption($opt = new ilRadioOption($this->lng->txt('tst_score_mcmr_use_scoring_system'), 1, ''));
        $opt->setInfo($this->lng->txt('tst_score_mcmr_use_scoring_system_desc'));
        $mc_scoring->setValue($this->testOBJ->getMCScoring());
        // fau: testNav - set the deprecated mc scoring option to disabled
        $mc_scoring->setDisabled(true);
        // fau.
        $form->addItem($mc_scoring);

        // score cutting
        $score_cutting = new ilRadioGroupInputGUI($this->lng->txt('tst_score_cutting'), 'score_cutting');
        $score_cutting->addOption($opt = new ilRadioOption($this->lng->txt('tst_score_cut_question'), 0, ''));
        $opt->setInfo($this->lng->txt('tst_score_cut_question_desc'));
        $score_cutting->addOption($opt = new ilRadioOption($this->lng->txt('tst_score_cut_test'), 1, ''));
        $opt->setInfo($this->lng->txt('tst_score_cut_test_desc'));
        $score_cutting->setValue($this->testOBJ->getScoreCutting());
        $form->addItem($score_cutting);

        // pass scoring
        $pass_scoring = new ilRadioGroupInputGUI($this->lng->txt('tst_pass_scoring'), 'pass_scoring');
        $pass_scoring->addOption($opt = new ilRadioOption($this->lng->txt('tst_pass_last_pass'), 0, ''));
        $opt->setInfo($this->lng->txt('tst_pass_last_pass_desc'));
        $pass_scoring->addOption($opt = new ilRadioOption($this->lng->txt('tst_pass_best_pass'), 1, ''));
        $opt->setInfo($this->lng->txt('tst_pass_best_pass_desc'));
        $pass_scoring->setValue($this->testOBJ->getPassScoring());
        $form->addItem($pass_scoring);

        // deletion of test results
        $passDeletion = new ilRadioGroupInputGUI($this->lng->txt('tst_pass_deletion'), 'pass_deletion_allowed');
        $passDeletion->addOption(new ilRadioOption($this->lng->txt('tst_pass_deletion_not_allowed'), 0, ''));
        $passDeletion->addOption(new ilRadioOption($this->lng->txt('tst_pass_deletion_allowed'), 1, ''));
        $passDeletion->setValue($this->testOBJ->isPassDeletionAllowed());
        $form->addItem($passDeletion);

        // disable scoring settings
        if (!$this->areScoringSettingsWritable()) {
            $count_system->setDisabled(true);
            $mc_scoring->setDisabled(true);
            $score_cutting->setDisabled(true);
            $pass_scoring->setDisabled(true);
        }
    }

    private function saveScoringSettingsFormSection(ilPropertyFormGUI $form)
    {
        if ($this->areScoringSettingsWritable()) {
            if ($this->formPropertyExists($form, 'count_system')) {
                $this->testOBJ->setCountSystem($form->getItemByPostVar('count_system')->getValue());
            }

            if ($this->formPropertyExists($form, 'mc_scoring')) {
                $this->testOBJ->setMCScoring($form->getItemByPostVar('mc_scoring')->getValue());
            }

            if ($this->formPropertyExists($form, 'score_cutting')) {
                $this->testOBJ->setScoreCutting($form->getItemByPostVar('score_cutting')->getValue());
            }

            if ($this->formPropertyExists($form, 'pass_scoring')) {
                $this->testOBJ->setPassScoring($form->getItemByPostVar('pass_scoring')->getValue());
            }
        }

        if ($this->formPropertyExists($form, 'pass_deletion_allowed')) {
            $this->testOBJ->setPassDeletionAllowed((bool) $form->getItemByPostVar('pass_deletion_allowed')->getValue());
        }
    }

    private function addResultSummarySettingsFormSection(ilPropertyFormGUI $form)
    {
        // HEADER: result settings
        $header_tr = new ilFormSectionHeaderGUI();
        $header_tr->setTitle($this->lng->txt('test_results'));
        $form->addItem($header_tr);

        // access to test results
        $resultsAccessEnabled = new ilCheckboxInputGUI($this->lng->txt('tst_results_access_enabled'), 'results_access_enabled');
        $resultsAccessEnabled->setInfo($this->lng->txt('tst_results_access_enabled_desc'));
        $resultsAccessEnabled->setChecked($this->testOBJ->isScoreReportingEnabled());
        $resultsAccessSetting = new ilRadioGroupInputGUI($this->lng->txt('tst_results_access_setting'), 'results_access_setting');
        $resultsAccessSetting->setRequired(true);
        $optAlways = new ilRadioOption($this->lng->txt('tst_results_access_always'), 2, '');
        $optAlways->setInfo($this->lng->txt('tst_results_access_always_desc'));
        $resultsAccessSetting->addOption($optAlways);
        $optFinished = $opt = new ilRadioOption($this->lng->txt('tst_results_access_finished'), 1, '');
        $optFinished->setInfo($this->lng->txt('tst_results_access_finished_desc'));
        $resultsAccessSetting->addOption($optFinished);
        $optionDate = new ilRadioOption($this->lng->txt('tst_results_access_date'), 3, '');
        $optionDate->setInfo($this->lng->txt('tst_results_access_date_desc'));
        // access date
        $reportingDate = new ilDateTimeInputGUI($this->lng->txt('tst_reporting_date'), 'reporting_date');
        $reportingDate->setRequired(true);
        $reportingDate->setShowTime(true);
        if (strlen($this->testOBJ->getReportingDate())) {
            $reportingDate->setDate(new ilDateTime($this->testOBJ->getReportingDate(), IL_CAL_TIMESTAMP));
        } else {
            $reportingDate->setDate(new ilDateTime(time(), IL_CAL_UNIX));
        }
        $optionDate->addSubItem($reportingDate);
        $resultsAccessSetting->addOption($optionDate);
        $resultsAccessValue = $this->testOBJ->getScoreReporting();
        $resultsAccessSetting->setValue(
                $resultsAccessValue > 0 && $resultsAccessValue < 4 ? $resultsAccessValue : 2
            );
        $resultsAccessEnabled->addSubItem($resultsAccessSetting);
        // show pass details
        $showPassDetails = new ilCheckboxInputGUI($this->lng->txt('tst_show_pass_details'), 'pass_details');
        $showPassDetails->setInfo($this->lng->txt('tst_show_pass_details_desc'));
        $showPassDetails->setChecked($this->testOBJ->getShowPassDetails());
        $resultsAccessEnabled->addSubItem($showPassDetails);
        $form->addItem($resultsAccessEnabled);

        // grading
        $chb_only_passed_failed = new ilCheckboxInputGUI($this->lng->txt('tst_results_grading_opt_show_status'), 'grading_status');
        $chb_only_passed_failed->setInfo($this->lng->txt('tst_results_grading_opt_show_status_desc'));
        $chb_only_passed_failed->setValue(1);
        $chb_only_passed_failed->setChecked($this->testOBJ->isShowGradingStatusEnabled());
        $resultsAccessEnabled->addSubItem($chb_only_passed_failed);

        $chb_resulting_mark_only = new ilCheckboxInputGUI($this->lng->txt('tst_results_grading_opt_show_mark'), 'grading_mark');
        $chb_resulting_mark_only->setInfo($this->lng->txt('tst_results_grading_opt_show_mark_desc'));
        $chb_resulting_mark_only->setValue(1);
        $chb_resulting_mark_only->setChecked($this->testOBJ->isShowGradingMarkEnabled());
        $resultsAccessEnabled->addSubItem($chb_resulting_mark_only);
    }

    private function saveResultSummarySettings(ilPropertyFormGUI $form)
    {
        if ($this->formPropertyExists($form, 'results_access_enabled')) {
            if ($form->getItemByPostVar('results_access_enabled')->getChecked()) {
                $this->testOBJ->setScoreReporting($form->getItemByPostVar('results_access_setting')->getValue());

                if ($this->testOBJ->getScoreReporting() == REPORT_AFTER_DATE) {
                    $reporting_date = $form->getItemByPostVar('reporting_date')->getDate();
                    if ($reporting_date instanceof ilDateTime) {
                        $this->testOBJ->setReportingDate($reporting_date->get(IL_CAL_FKT_DATE, 'YmdHis'));
                    } else {
                        $this->testOBJ->setReportingDate('');
                    }
                } else {
                    $this->testOBJ->setReportingDate('');
                }

                $this->testOBJ->setShowPassDetails($form->getItemByPostVar('pass_details')->getChecked());
            } else {
                $this->testOBJ->setScoreReporting(4); // never
                $this->testOBJ->setShowPassDetails(false);
                $this->testOBJ->setReportingDate('');
            }
        }

        if ($this->formPropertyExists($form, 'grading_status')) {
            $this->testOBJ->setShowGradingStatusEnabled(
                $form->getItemByPostVar('grading_status')->getChecked()
            );
        }

        if ($this->formPropertyExists($form, 'grading_mark')) {
            $this->testOBJ->setShowGradingMarkEnabled(
                (int) $form->getItemByPostVar('grading_mark')->getChecked()
            );
        }
    }

    private function addResultDetailsSettingsFormSection(ilPropertyFormGUI $form)
    {
        // HEADER: result settings
        $header_tr = new ilFormSectionHeaderGUI();
        $header_tr->setTitle($this->lng->txt('tst_results_details_options'));
        $form->addItem($header_tr);

        // show solution details
        $showSolutionDetails = new ilCheckboxInputGUI($this->lng->txt('tst_show_solution_details'), 'solution_details');
        $showSolutionDetails->setInfo($this->lng->txt('tst_show_solution_details_desc'));
        $showSolutionDetails->setChecked($this->testOBJ->getShowSolutionDetails());
        $form->addItem($showSolutionDetails);
    
        // best solution in test results
        $results_print_best_solution = new ilCheckboxInputGUI($this->lng->txt('tst_results_print_best_solution'), 'print_bs_with_res');
        $results_print_best_solution->setInfo($this->lng->txt('tst_results_print_best_solution_info'));
        $results_print_best_solution->setChecked((bool) $this->testOBJ->isBestSolutionPrintedWithResult());
        $showSolutionDetails->addSubItem($results_print_best_solution);

        // show solution feedback ==> solution feedback in test results
        $showSolutionFeedbackOption = new ilCheckboxInputGUI($this->lng->txt('tst_show_solution_feedback'), 'solution_feedback');
        $showSolutionFeedbackOption->setInfo($this->lng->txt('tst_show_solution_feedback_desc'));
        $showSolutionFeedbackOption->setChecked($this->testOBJ->getShowSolutionFeedback());
        $form->addItem($showSolutionFeedbackOption);

        // show suggested solution
        $showSuggestedSolutionOption = new ilCheckboxInputGUI($this->lng->txt('tst_show_solution_suggested'), 'solution_suggested');
        $showSuggestedSolutionOption->setInfo($this->lng->txt('tst_show_solution_suggested_desc'));
        $showSuggestedSolutionOption->setChecked($this->testOBJ->getShowSolutionSuggested());
        $form->addItem($showSuggestedSolutionOption);

        // show solution printview ==> list of answers
        $showSolutionPrintview = new ilCheckboxInputGUI($this->lng->txt('tst_show_solution_printview'), 'solution_printview');
        $showSolutionPrintview->setInfo($this->lng->txt('tst_show_solution_printview_desc'));
        $showSolutionPrintview->setChecked($this->testOBJ->getShowSolutionPrintview());
        $form->addItem($showSolutionPrintview);

        // show best solution in list of answers
        $solutionCompareInput = new ilCheckboxInputGUI($this->lng->txt('tst_show_solution_compare'), 'solution_compare');
        $solutionCompareInput->setInfo($this->lng->txt('tst_show_solution_compare_desc'));
        $solutionCompareInput->setChecked($this->testOBJ->getShowSolutionListComparison());
        $showSolutionPrintview->addSubItem($solutionCompareInput);
    
        // solution answers only ==> printview of results (answers only)
        $solutionAnswersOnly = new ilCheckboxInputGUI($this->lng->txt('tst_show_solution_answers_only'), 'solution_answers_only');
        $solutionAnswersOnly->setInfo($this->lng->txt('tst_show_solution_answers_only_desc'));
        $solutionAnswersOnly->setChecked($this->testOBJ->getShowSolutionAnswersOnly());
        $showSolutionPrintview->addSubItem($solutionAnswersOnly);

        // high score
        $highscore = new ilCheckboxInputGUI($this->lng->txt("tst_highscore_enabled"), "highscore_enabled");
        $highscore->setValue(1);
        $highscore->setChecked($this->testOBJ->getHighscoreEnabled());
        $highscore->setInfo($this->lng->txt("tst_highscore_description"));
        $form->addItem($highscore);
        $highscore_tables = new ilRadioGroupInputGUI($this->lng->txt('tst_highscore_mode'), 'highscore_mode');
        $highscore_tables->setRequired(true);
        $highscore_tables->setValue($this->testOBJ->getHighscoreMode());
        $highscore_table_own = new ilRadioOption($this->lng->txt('tst_highscore_own_table'), ilObjTest::HIGHSCORE_SHOW_OWN_TABLE);
        $highscore_table_own->setInfo($this->lng->txt('tst_highscore_own_table_description'));
        $highscore_tables->addOption($highscore_table_own);
        $highscore_table_other = new ilRadioOption($this->lng->txt('tst_highscore_top_table'), ilObjTest::HIGHSCORE_SHOW_TOP_TABLE);
        $highscore_table_other->setInfo($this->lng->txt('tst_highscore_top_table_description'));
        $highscore_tables->addOption($highscore_table_other);
        $highscore_table_other = new ilRadioOption($this->lng->txt('tst_highscore_all_tables'), ilObjTest::HIGHSCORE_SHOW_ALL_TABLES);
        $highscore_table_other->setInfo($this->lng->txt('tst_highscore_all_tables_description'));
        $highscore_tables->addOption($highscore_table_other);
        $highscore->addSubItem($highscore_tables);
        $highscore_top_num = new ilNumberInputGUI($this->lng->txt("tst_highscore_top_num"), "highscore_top_num");
        $highscore_top_num->setSize(4);
        $highscore_top_num->setRequired(true);
        $highscore_top_num->setMinValue(1);
        $highscore_top_num->setSuffix($this->lng->txt("tst_highscore_top_num_unit"));
        $highscore_top_num->setValue($this->testOBJ->getHighscoreTopNum(null));
        $highscore_top_num->setInfo($this->lng->txt("tst_highscore_top_num_description"));
        $highscore->addSubItem($highscore_top_num);
        $highscore_anon = new ilCheckboxInputGUI($this->lng->txt("tst_highscore_anon"), "highscore_anon");
        $highscore_anon->setValue(1);
        $highscore_anon->setChecked($this->testOBJ->getHighscoreAnon());
        $highscore_anon->setInfo($this->lng->txt("tst_highscore_anon_description"));
        $highscore->addSubItem($highscore_anon);
        $highscore_achieved_ts = new ilCheckboxInputGUI($this->lng->txt("tst_highscore_achieved_ts"), "highscore_achieved_ts");
        $highscore_achieved_ts->setValue(1);
        $highscore_achieved_ts->setChecked($this->testOBJ->getHighscoreAchievedTS());
        $highscore_achieved_ts->setInfo($this->lng->txt("tst_highscore_achieved_ts_description"));
        $highscore->addSubItem($highscore_achieved_ts);
        $highscore_score = new ilCheckboxInputGUI($this->lng->txt("tst_highscore_score"), "highscore_score");
        $highscore_score->setValue(1);
        $highscore_score->setChecked($this->testOBJ->getHighscoreScore());
        $highscore_score->setInfo($this->lng->txt("tst_highscore_score_description"));
        $highscore->addSubItem($highscore_score);
        $highscore_percentage = new ilCheckboxInputGUI($this->lng->txt("tst_highscore_percentage"), "highscore_percentage");
        $highscore_percentage->setValue(1);
        $highscore_percentage->setChecked($this->testOBJ->getHighscorePercentage());
        $highscore_percentage->setInfo($this->lng->txt("tst_highscore_percentage_description"));
        $highscore->addSubItem($highscore_percentage);
        $highscore_hints = new ilCheckboxInputGUI($this->lng->txt("tst_highscore_hints"), "highscore_hints");
        $highscore_hints->setValue(1);
        $highscore_hints->setChecked($this->testOBJ->getHighscoreHints());
        $highscore_hints->setInfo($this->lng->txt("tst_highscore_hints_description"));
        $highscore->addSubItem($highscore_hints);
        $highscore_wtime = new ilCheckboxInputGUI($this->lng->txt("tst_highscore_wtime"), "highscore_wtime");
        $highscore_wtime->setValue(1);
        $highscore_wtime->setChecked($this->testOBJ->getHighscoreWTime());
        $highscore_wtime->setInfo($this->lng->txt("tst_highscore_wtime_description"));
        $highscore->addSubItem($highscore_wtime);

        // show signature placeholder
        $showSignaturePlaceholder = new ilCheckboxInputGUI($this->lng->txt('tst_show_solution_signature'), 'solution_signature');
        $showSignaturePlaceholder->setInfo($this->lng->txt('tst_show_solution_signature_desc'));
        $showSignaturePlaceholder->setChecked($this->testOBJ->getShowSolutionSignature());
        if ($this->testOBJ->getAnonymity()) {
            $showSignaturePlaceholder->setDisabled(true);
        }
        $form->addItem($showSignaturePlaceholder);

        // show signature placeholder
        $showExamId = new ilCheckboxInputGUI($this->lng->txt('examid_in_test_res'), 'examid_in_test_res');
        $showExamId->setInfo($this->lng->txt('examid_in_test_res_desc'));
        $showExamId->setChecked($this->testOBJ->isShowExamIdInTestResultsEnabled());
        $form->addItem($showExamId);
        
        // export settings
        $export_settings = new ilCheckboxInputGUI($this->lng->txt('tst_exp_sc_short'), 'exp_sc_short');
        $export_settings->setInfo($this->lng->txt('tst_exp_sc_short_desc'));
        $export_settings->setChecked($this->testOBJ->getExportSettingsSingleChoiceShort());
        $form->addItem($export_settings);
    }

    private function saveResultDetailsSettings(ilPropertyFormGUI $form)
    {
        if ($this->formPropertyExists($form, 'solution_details')) {
            if ($form->getItemByPostVar('solution_details')->getChecked()) {
                $this->testOBJ->setShowSolutionDetails(1);
                $this->testOBJ->setPrintBestSolutionWithResult(
                    (int) $form->getItemByPostVar('print_bs_with_res')->getChecked()
                );
            } else {
                $this->testOBJ->setShowSolutionDetails(0);
                $this->testOBJ->setPrintBestSolutionWithResult(0);
            }
        }

        if ($this->formPropertyExists($form, 'solution_feedback')) {
            $this->testOBJ->setShowSolutionFeedback($form->getItemByPostVar('solution_feedback')->getChecked());
        }

        if ($this->formPropertyExists($form, 'solution_suggested')) {
            $this->testOBJ->setShowSolutionSuggested($form->getItemByPostVar('solution_suggested')->getChecked());
        }

        if ($this->formPropertyExists($form, 'solution_printview')) {
            if ($form->getItemByPostVar('solution_printview')->getChecked()) {
                $this->testOBJ->setShowSolutionPrintview(1);
                $this->testOBJ->setShowSolutionListComparison(
                    (bool) $form->getItemByPostVar('solution_compare')->getChecked()
                );
                $this->testOBJ->setShowSolutionAnswersOnly(
                    (int) $form->getItemByPostVar('solution_answers_only')->getChecked()
                );
            } else {
                $this->testOBJ->setShowSolutionPrintview(0);
                $this->testOBJ->setShowSolutionListComparison(false);
                $this->testOBJ->setShowSolutionAnswersOnly(0);
            }
        }

        if ($this->formPropertyExists($form, 'highscore_enabled')) {
            // highscore settings
            $this->testOBJ->setHighscoreEnabled((bool) $form->getItemByPostVar('highscore_enabled')->getChecked());
            $this->testOBJ->setHighscoreAnon((bool) $form->getItemByPostVar('highscore_anon')->getChecked());
            $this->testOBJ->setHighscoreAchievedTS((bool) $form->getItemByPostVar('highscore_achieved_ts')->getChecked());
            $this->testOBJ->setHighscoreScore((bool) $form->getItemByPostVar('highscore_score')->getChecked());
            $this->testOBJ->setHighscorePercentage((bool) $form->getItemByPostVar('highscore_percentage')->getChecked());
            $this->testOBJ->setHighscoreHints((bool) $form->getItemByPostVar('highscore_hints')->getChecked());
            $this->testOBJ->setHighscoreWTime((bool) $form->getItemByPostVar('highscore_wtime')->getChecked());
            $this->testOBJ->setHighscoreMode((int) $form->getItemByPostVar('highscore_mode')->getValue());
            $this->testOBJ->setHighscoreTopNum((int) $form->getItemByPostVar('highscore_top_num')->getValue());
        }

        if ($this->formPropertyExists($form, 'solution_signature')) {
            $this->testOBJ->setShowSolutionSignature($form->getItemByPostVar('solution_signature')->getChecked());
        }

        if ($this->formPropertyExists($form, 'examid_in_test_res')) {
            $this->testOBJ->setShowExamIdInTestResultsEnabled($form->getItemByPostVar('examid_in_test_res')->getChecked());
        }

        if ($this->formPropertyExists($form, 'exp_sc_short')) {
            $this->testOBJ->setExportSettingsSingleChoiceShort((int) $form->getItemByPostVar('exp_sc_short')->getChecked());
        }
    }

    private function addMiscSettingsFormSection(ilPropertyFormGUI $form)
    {
        if ($this->testQuestionSetConfigFactory->getQuestionSetConfig()->isResultTaxonomyFilterSupported()) {
            // misc settings
            $header_misc = new ilFormSectionHeaderGUI();
            $header_misc->setTitle($this->lng->txt('misc'));
            $form->addItem($header_misc);
        }

        // result filter taxonomies
        if ($this->testQuestionSetConfigFactory->getQuestionSetConfig()->isResultTaxonomyFilterSupported()) {
            $availableTaxonomyIds = $this->getAvailableTaxonomyIds();

            if (count($availableTaxonomyIds)) {
                require_once 'Modules/Test/classes/class.ilTestTaxonomyFilterLabelTranslater.php';
                $labelTranslater = new ilTestTaxonomyFilterLabelTranslater($this->db);
                $labelTranslater->loadLabelsFromTaxonomyIds($availableTaxonomyIds);

                $results_presentation = new ilCheckboxGroupInputGUI($this->lng->txt('tst_results_tax_filters'), 'results_tax_filters');

                foreach ($availableTaxonomyIds as $taxonomyId) {
                    $results_presentation->addOption(new ilCheckboxOption(
                        $labelTranslater->getTaxonomyTreeLabel($taxonomyId),
                        $taxonomyId,
                        ''
                    ));
                }

                $results_presentation->setValue($this->testOBJ->getResultFilterTaxIds());

                $form->addItem($results_presentation);
            }
        }
    }

    private function saveResultMiscOptionsSettings(ilPropertyFormGUI $form)
    {
        // result filter taxonomies
        if ($this->testQuestionSetConfigFactory->getQuestionSetConfig()->isResultTaxonomyFilterSupported()) {
            if (!$this->isHiddenFormItem('results_tax_filters') && count($this->getAvailableTaxonomyIds())) {
                $taxFilters = array();
                
                if (is_array($form->getItemByPostVar('results_tax_filters')->getValue())) {
                    $taxFilters = array_intersect(
                        $this->getAvailableTaxonomyIds(),
                        $form->getItemByPostVar('results_tax_filters')->getValue()
                    );
                }

                $this->testOBJ->setResultFilterTaxIds($taxFilters);
            }
        }
    }

    private function areScoringSettingsWritable()
    {
        if (!$this->testOBJ->participantDataExist()) {
            return true;
        }

        if (!$this->testOBJ->isScoreReportingAvailable()) {
            return true;
        }

        return false;
    }

    private function isScoreRecalculationRequired(ilPropertyFormGUI $form)
    {
        if (!$this->testOBJ->participantDataExist()) {
            return false;
        }

        if (!$this->areScoringSettingsWritable()) {
            return false;
        }

        if (!$this->hasScoringSettingsChanged($form)) {
            return false;
        }

        return true;
    }

    private function hasScoringSettingsChanged(ilPropertyFormGUI $form)
    {
        $countSystem = $form->getItemByPostVar('count_system');
        if (is_object($countSystem) && $countSystem->getValue() != $this->testOBJ->getCountSystem()) {
            return true;
        }

        $mcScoring = $form->getItemByPostVar('mc_scoring');
        if (is_object($mcScoring) && $mcScoring->getValue() != $this->testOBJ->getMCScoring()) {
            return true;
        }

        $scoreCutting = $form->getItemByPostVar('score_cutting');
        if (is_object($scoreCutting) && $scoreCutting->getValue() != $this->testOBJ->getScoreCutting()) {
            return true;
        }

        $passScoring = $form->getItemByPostVar('pass_scoring');
        if (is_object($passScoring) && $passScoring->getValue() != $this->testOBJ->getPassScoring()) {
            return true;
        }

        return false;
    }

    private $availableTaxonomyIds = null;

    private function getAvailableTaxonomyIds()
    {
        if ($this->getAvailableTaxonomyIds === null) {
            require_once 'Services/Taxonomy/classes/class.ilObjTaxonomy.php';
            $this->availableTaxonomyIds = (array) ilObjTaxonomy::getUsageOfObject($this->testOBJ->getId());
        }

        return $this->availableTaxonomyIds;
    }
}