Collaboration diagram for ilTestCorrectionsGUI:

Public Member Functions
	__construct (private readonly ilDBInterface $database, private readonly ilCtrlInterface $ctrl, private readonly ilLanguage $language, private readonly ilTabsGUI $tabs, private readonly ilHelpGUI $help, private readonly UIFactory $ui_factory, private readonly ilGlobalTemplateInterface $main_tpl, private readonly RefineryFactory $refinery, private readonly TestLogger $logger, private readonly RequestDataCollector $testrequest, private readonly ilObjTest $test_obj, private readonly ilObjUser $scorer, private readonly TestResultRepository $test_result_repository,)

	executeCommand ()

	getRefId ()

Protected Member Functions
	showQuestion (?ilPropertyFormGUI $form=null)

	buildQuestionCorrectionForm (assQuestionGUI $question_gui)

	confirmManualScoringReset ()

	saveQuestion ()

	showSolution ()

	showAnswerStatistic (?array $participant_results=null)

	addAnswer ()

	addHiddenItemsFromArray (ilConfirmationGUI $gui, $array, $curPath=[])

	setCorrectionTabsContext (assQuestionGUI $question_gui, string $active_tab_id)

	populatePageTitleAndDescription (assQuestionGUI $question_gui)

	checkQuestion ()

	getQuestionGUI (int $question_id)

	getSolutions (assQuestion $question)

	getQuestions ()

Private Member Functions
	getSolutionsByParticipantResults (assQuestion $question, array $participant_results)

Private Attributes
assQuestionGUI	$question_gui = null

ilTestAccess	$test_access

Detailed Description

Definition at line 37 of file class.ilTestCorrectionsGUI.php.

Constructor & Destructor Documentation

◆ __construct()

ilTestCorrectionsGUI::__construct	(	private readonly ilDBInterface	$database,
		private readonly ilCtrlInterface	$ctrl,
		private readonly ilLanguage	$language,
		private readonly ilTabsGUI	$tabs,
		private readonly ilHelpGUI	$help,
		private readonly UIFactory	$ui_factory,
		private readonly ilGlobalTemplateInterface	$main_tpl,
		private readonly RefineryFactory	$refinery,
		private readonly TestLogger	$logger,
		private readonly RequestDataCollector	$testrequest,
		private readonly ilObjTest	$test_obj,
		private readonly ilObjUser	$scorer,
		private readonly TestResultRepository	$test_result_repository
	)

Definition at line 42 of file class.ilTestCorrectionsGUI.php.

      {
        $question_id = $this->testrequest->getQuestionId();
        if ($question_id !== 0) {
            $this->question_gui = $this->getQuestionGUI($question_id);
        }
        $this->test_access = new ilTestAccess($test_obj->getRefId());
    }

References getQuestionGUI().

Here is the call graph for this function:

Member Function Documentation

◆ addAnswer()

ilTestCorrectionsGUI::addAnswer ( )

protected

Definition at line 272 of file class.ilTestCorrectionsGUI.php.

    {
        $form = (new ilAddAnswerFormBuilder(
            $this->ui_factory,
            $this->refinery,
            $this->language,
            $this->ctrl
        ))->buildAddAnswerModal('')
            ->withRequest($this->testrequest->getRequest());
 
        $data = $form->getData();
 
        $question_index = $data['question_index'];
        $answer_value = $data['answer_value'];
        $points = $data['points'];
 
        if (!$points) {
            $this->main_tpl->setOnScreenMessage('failure', $this->language->txt('err_no_numeric_value'));
            $this->showAnswerStatistic();
            return;
        }
 
        $question = $this->question_gui->getObject();
        if ($question->isAddableAnswerOptionValue($question_index, $answer_value)) {
            $question->addAnswerOptionValue($question_index, $answer_value, $points);
            $question->saveToDb();
        }
 
        $participant_results = (new TestScoring(
            $this->test_obj,
            $this->scorer,
            $this->database,
            $this->test_result_repository
        ))->recalculateSolutions(true, $question->getId());
 
        if ($this->logger->isLoggingEnabled()) {
            $this->logger->logQuestionAdministrationInteraction(
                $question->toQuestionAdministrationInteraction(
                    $this->logger->getAdditionalInformationGenerator(),
                    $this->test_obj->getRefId(),
                    TestQuestionAdministrationInteractionTypes::QUESTION_MODIFIED_IN_CORRECTIONS
                )
            );
        }
 
        $this->main_tpl->setOnScreenMessage('success', $this->language->txt('saved_successfully'));
        $this->showAnswerStatistic($participant_results);
    }

References $data, ILIAS\Repository\ctrl(), ILIAS\Repository\database(), ILIAS\UI\examples\Symbol\Glyph\Language\language(), ILIAS\Repository\logger(), ILIAS\Test\Logging\QUESTION_MODIFIED_IN_CORRECTIONS, ILIAS\Repository\refinery(), and showAnswerStatistic().

Here is the call graph for this function:

◆ addHiddenItemsFromArray()

ilTestCorrectionsGUI::addHiddenItemsFromArray	(	ilConfirmationGUI	$gui,
			$array,
			$curPath = `[]`
	)

protected

Definition at line 321 of file class.ilTestCorrectionsGUI.php.

    {
        foreach ($array as $name => $value) {
            if ($name == 'cmd' && !count($curPath)) {
                continue;
            }
 
            if (count($curPath)) {
                $name = "[{$name}]";
            }
 
            if (is_array($value)) {
                $nextPath = array_merge($curPath, [$name]);
                $this->addHiddenItemsFromArray($gui, $value, $nextPath);
            } else {
                $postVar = implode('', $curPath) . $name;
                $gui->addHiddenItem($postVar, $value);
            }
        }
    }

References ilConfirmationGUI\addHiddenItem(), and addHiddenItemsFromArray().

Referenced by addHiddenItemsFromArray(), and confirmManualScoringReset().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ buildQuestionCorrectionForm()

ilTestCorrectionsGUI::buildQuestionCorrectionForm ( assQuestionGUI $question_gui )

protected

Definition at line 93 of file class.ilTestCorrectionsGUI.php.

                                                                                : ilPropertyFormGUI
    {
        $form = new ilPropertyFormGUI();
        $form->setFormAction($this->ctrl->getFormAction($this));
        $form->setId('tst_question_correction');
 
        $form->setTitle($this->language->txt('tst_corrections_qst_form'));
 
        $question_gui->populateCorrectionsFormProperties($form);
 
        $scoring = new TestScoring(
            $this->test_obj,
            $this->scorer,
            $this->database,
            $this->test_result_repository
        );
 
        if ($scoring->getNumManualScorings(
            $question_gui->getObject()->getId()
        )) {
            $form->addCommandButton('confirmManualScoringReset', $this->language->txt('save'));
        } else {
            $form->addCommandButton('saveQuestion', $this->language->txt('save'));
        }
 
        return $form;
    }

References $question_gui, ILIAS\Repository\ctrl(), ILIAS\Repository\database(), assQuestionGUI\getObject(), ILIAS\UI\examples\Symbol\Glyph\Language\language(), and assQuestionGUI\populateCorrectionsFormProperties().

Referenced by saveQuestion(), and showQuestion().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ checkQuestion()

ilTestCorrectionsGUI::checkQuestion ( )

protected

Definition at line 386 of file class.ilTestCorrectionsGUI.php.

                                      : bool
    {
        if (!$this->test_obj->isTestQuestion($this->question_gui->getObject()->getId())) {
            return false;
        }
 
        if (!$this->question_gui?->supportsAdjustment()) {
            return false;
        }
 
        return true;
    }

◆ confirmManualScoringReset()

ilTestCorrectionsGUI::confirmManualScoringReset ( )

protected

Definition at line 121 of file class.ilTestCorrectionsGUI.php.

    {
        $this->setCorrectionTabsContext($this->question_gui, 'question');
 
        $scoring = new TestScoring(
            $this->test_obj,
            $this->scorer,
            $this->database,
            $this->test_result_repository
        );
 
        $confirmation = sprintf(
            $this->language->txt('tst_corrections_manscore_reset_warning'),
            $scoring->getNumManualScorings(
                $this->question_gui->getObject()->getId()
            ),
            $this->question_gui->getObject()->getTitleForHTMLOutput(),
            $this->question_gui->getObject()->getId()
        );
 
        $gui = new ilConfirmationGUI();
        $gui->setHeaderText($confirmation);
        $gui->setFormAction($this->ctrl->getFormAction($this));
        $gui->setCancel($this->language->txt('cancel'), 'showQuestion');
        $gui->setConfirm($this->language->txt('confirm'), 'saveQuestion');
 
        $this->addHiddenItemsFromArray($gui, $this->testrequest->getParsedBody());
 
        $this->main_tpl->setContent($gui->getHTML());
    }

References addHiddenItemsFromArray(), ILIAS\Repository\ctrl(), ILIAS\Repository\database(), ILIAS\UI\examples\Symbol\Glyph\Language\language(), and setCorrectionTabsContext().

Here is the call graph for this function:

◆ executeCommand()

ilTestCorrectionsGUI::executeCommand ( )

Definition at line 64 of file class.ilTestCorrectionsGUI.php.

    {
        if (!$this->test_obj->getGlobalSettings()->isAdjustingQuestionsWithResultsAllowed()
            || !$this->test_access->checkCorrectionsAccess()
            || $this->question_gui !== null
                && !$this->checkQuestion()) {
            ilObjTestGUI::accessViolationRedirect();
        }
 
        if ($this->testrequest->isset('removeQid') && (int) $this->testrequest->raw('removeQid')) {
            $this->confirmQuestionRemoval();
            return;
        }
 
        $this->ctrl->saveParameterByClass(self::class, 'q_id');
        $command = $this->ctrl->getCmd('showQuestionList');
        $this->{$command}();
    }

References ILIAS\Repository\ctrl().

Here is the call graph for this function:

◆ getQuestionGUI()

ilTestCorrectionsGUI::getQuestionGUI ( int $question_id )

protected

Definition at line 404 of file class.ilTestCorrectionsGUI.php.

                                                       : ?assQuestionGUI
    {
        $question_gui = assQuestion::instantiateQuestionGUI($question_id);
        if ($question_gui === null) {
            return null;
        }
        $question = $question_gui->getObject();
        $question->setPoints($question_gui->getObject()->getMaximumPoints());
        $question_gui->setObject($question);
        return $question_gui;
    }

References $question_gui, assQuestionGUI\getObject(), and assQuestionGUI\setObject().

Referenced by __construct(), and getQuestions().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getQuestions()

ilTestCorrectionsGUI::getQuestions ( )

protected

Definition at line 453 of file class.ilTestCorrectionsGUI.php.

                                     : array
    {
 
        if (!$this->test_obj->getGlobalSettings()->isAdjustingQuestionsWithResultsAllowed()) {
            return [];
        }
 
        return array_reduce(
            $this->test_obj->getTestQuestions(),
            function (array $c, array $v): array {
                if (!$this->getQuestionGUI($v['question_id'])?->supportsAdjustment()) {
                    return $c;
                }
 
                $c[] = $v;
                return $c;
            },
            []
        );
    }

References Vendor\Package\$c, and getQuestionGUI().

Here is the call graph for this function:

◆ getRefId()

ilTestCorrectionsGUI::getRefId ( )

Definition at line 399 of file class.ilTestCorrectionsGUI.php.

                              : int
    {
        return $this->test_obj->getRefId();
    }

◆ getSolutions()

ilTestCorrectionsGUI::getSolutions ( assQuestion $question )

protected

Definition at line 416 of file class.ilTestCorrectionsGUI.php.

                                                          : array
    {
        $solution_rows = [];
 
        foreach (array_keys($this->test_obj->getParticipants()) as $active_id) {
            $passes_selector = new ilTestPassesSelector($this->database, $this->test_obj);
            $passes_selector->setActiveId($active_id);
            $passes_selector->loadLastFinishedPass();
 
            foreach ($passes_selector->getClosedPasses() as $pass) {
                foreach ($question->getSolutionValues($active_id, $pass) as $row) {
                    $solution_rows[] = $row;
                }
            }
        }
 
        return $solution_rows;
    }

References ILIAS\Repository\database(), and assQuestion\getSolutionValues().

Referenced by showAnswerStatistic().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getSolutionsByParticipantResults()

ilTestCorrectionsGUI::getSolutionsByParticipantResults	(	assQuestion	$question,
		array	$participant_results
	)

private

Parameters

list<ilTestEvaluationUserData> $participant_results

Definition at line 438 of file class.ilTestCorrectionsGUI.php.

                                                                                                        : array
    {
        $solutions = [];
 
        foreach ($participant_results as $active_id => $result) {
            foreach ($result->getPasses() as $pass) {
                foreach ($question->getSolutionValues($active_id, $pass->getPass()) as $row) {
                    $solutions[] = $row;
                }
            }
        }
 
        return $solutions;
    }

References assQuestion\getSolutionValues().

Referenced by showAnswerStatistic().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ populatePageTitleAndDescription()

ilTestCorrectionsGUI::populatePageTitleAndDescription ( assQuestionGUI $question_gui )

protected

Definition at line 380 of file class.ilTestCorrectionsGUI.php.

                                                                                    : void
    {
        $this->main_tpl->setTitle($question_gui->getObject()->getTitleForHTMLOutput());
        $this->main_tpl->setDescription($question_gui->outQuestionType());
    }

References $question_gui, assQuestionGUI\getObject(), and assQuestionGUI\outQuestionType().

Referenced by showAnswerStatistic(), showQuestion(), and showSolution().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ saveQuestion()

ilTestCorrectionsGUI::saveQuestion ( )

protected

Definition at line 152 of file class.ilTestCorrectionsGUI.php.

    {
        $question_gui = $this->question_gui;
        $form = $this->buildQuestionCorrectionForm($question_gui);
        $form->setValuesByPost();
 
        if (!$form->checkInput()) {
            $question_gui->prepareReprintableCorrectionsForm($form);
 
            $this->showQuestion($form);
            return;
        }
 
        $question_gui->saveCorrectionsFormProperties($form);
        $question = $question_gui->getObject();
        $question->setPoints($question_gui->getObject()->getMaximumPoints());
        $question_gui->setObject($question);
        $question_gui->getObject()->saveToDb();
 
        (new TestScoring(
            $this->test_obj,
            $this->scorer,
            $this->database,
            $this->test_result_repository
        ))->recalculateSolutions(
            false,
            $question_gui->getObject()->getId()
        );
 
        if ($this->logger->isLoggingEnabled()) {
            $this->logger->logQuestionAdministrationInteraction(
                $question_gui->getObject()->toQuestionAdministrationInteraction(
                    $this->logger->getAdditionalInformationGenerator(),
                    $this->test_obj->getRefId(),
                    TestQuestionAdministrationInteractionTypes::QUESTION_MODIFIED_IN_CORRECTIONS
                )
            );
        }
 
        $this->main_tpl->setOnScreenMessage('success', $this->language->txt('saved_successfully'), true);
        $this->ctrl->redirectByClass([ilObjTestGUI::class, self::class], 'showQuestion');
    }

References $question_gui, buildQuestionCorrectionForm(), ILIAS\Repository\ctrl(), ILIAS\Repository\database(), assQuestionGUI\getObject(), ILIAS\UI\examples\Symbol\Glyph\Language\language(), ILIAS\Repository\logger(), assQuestionGUI\prepareReprintableCorrectionsForm(), ILIAS\Test\Logging\QUESTION_MODIFIED_IN_CORRECTIONS, assQuestionGUI\saveCorrectionsFormProperties(), assQuestionGUI\setObject(), and showQuestion().

Here is the call graph for this function:

◆ setCorrectionTabsContext()

ilTestCorrectionsGUI::setCorrectionTabsContext	(	assQuestionGUI	$question_gui,
		string	$active_tab_id
	)

protected

Definition at line 342 of file class.ilTestCorrectionsGUI.php.

                                                                                                    : void
    {
        $this->tabs->clearTargets();
        $this->tabs->clearSubTabs();
 
        $this->help->setScreenIdComponent('tst');
        $this->help->setScreenId('scoringadjust');
        $this->help->setSubScreenId($active_tab_id);
 
        $this->ctrl->setParameterByClass(self::class, 'q_id', $question_gui->getObject()->getId());
        $this->tabs->addTab(
            'question',
            $this->language->txt('tst_corrections_tab_question'),
            $this->ctrl->getLinkTargetByClass([ilObjTestGUI::class, self::class], 'showQuestion')
        );
 
        $this->tabs->addTab(
            'solution',
            $this->language->txt('tst_corrections_tab_solution'),
            $this->ctrl->getLinkTargetByClass([ilObjTestGUI::class, self::class], 'showSolution')
        );
 
        if ($question_gui->isAnswerFrequencyStatisticSupported()) {
            $this->tabs->addTab(
                'answers',
                $this->language->txt('tst_corrections_tab_statistics'),
                $this->ctrl->getLinkTargetByClass([ilObjTestGUI::class, self::class], 'showAnswerStatistic')
            );
        }
 
        $this->tabs->setBackTarget(
            $this->language->txt('back'),
            $this->ctrl->getLinkTargetByClass(ilObjTestGUI::class, 'showQuestions')
        );
 
        $this->tabs->activateTab($active_tab_id);
    }

References $question_gui, ILIAS\Repository\ctrl(), assQuestionGUI\getObject(), ILIAS\Repository\help(), assQuestionGUI\isAnswerFrequencyStatisticSupported(), ILIAS\UI\examples\Symbol\Glyph\Language\language(), and ILIAS\Repository\tabs().

Referenced by confirmManualScoringReset(), showAnswerStatistic(), showQuestion(), and showSolution().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ showAnswerStatistic()

ilTestCorrectionsGUI::showAnswerStatistic ( ?array $participant_results = null )

protected

Parameters

null|list<ilTestEvaluationUserData> $participant_results

Definition at line 247 of file class.ilTestCorrectionsGUI.php.

                                                                              : void
    {
        $solutions = $participant_results
            ? $this->getSolutionsByParticipantResults($this->question_gui->getObject(), $participant_results)
            : $this->getSolutions($this->question_gui->getObject());
 
        $this->setCorrectionTabsContext($this->question_gui, 'answers');
 
        $tablesHtml = '';
 
        foreach ($this->question_gui->getSubQuestionsIndex() as $subQuestionIndex) {
            $table = $this->question_gui->getAnswerFrequencyTableGUI(
                $this,
                'showAnswerStatistic',
                $solutions,
                $subQuestionIndex
            );
 
            $tablesHtml .= $table->getHTML() . $table->getAdditionalHtml();
        }
 
        $this->populatePageTitleAndDescription($this->question_gui);
        $this->main_tpl->setContent($tablesHtml);
    }

References getSolutions(), getSolutionsByParticipantResults(), populatePageTitleAndDescription(), and setCorrectionTabsContext().

Referenced by addAnswer().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ showQuestion()

ilTestCorrectionsGUI::showQuestion ( ?ilPropertyFormGUI $form = null )

protected

Definition at line 83 of file class.ilTestCorrectionsGUI.php.

    {
        $this->setCorrectionTabsContext($this->question_gui, 'question');
 
        $form ??= $this->buildQuestionCorrectionForm($this->question_gui);
 
        $this->populatePageTitleAndDescription($this->question_gui);
        $this->main_tpl->setContent($form->getHTML());
    }

References buildQuestionCorrectionForm(), populatePageTitleAndDescription(), and setCorrectionTabsContext().

Referenced by saveQuestion().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ showSolution()

ilTestCorrectionsGUI::showSolution ( )

protected

Definition at line 195 of file class.ilTestCorrectionsGUI.php.

    {
        $question_gui = $this->question_gui;
        $page_gui = new ilAssQuestionPageGUI($question_gui->getObject()->getId());
        $page_gui->setFileDownloadLink(
            $this->ctrl->getLinkTargetByClass(ilObjTestGUI::class, 'downloadFile')
        );
        $page_gui->setRenderPageContainer(false);
        $page_gui->setEditPreview(true);
        $page_gui->setEnabledTabs(false);
 
        $solution_html = $question_gui->getSolutionOutput(
            0,
            null,
            false,
            false,
            true,
            false,
            true,
            false,
            true
        );
 
        $page_gui->setQuestionHTML([$question_gui->getObject()->getId() => $solution_html]);
        $page_gui->setPresentationTitle($question_gui->getObject()->getTitle());
 
        $tpl = new ilTemplate('tpl.tst_corrections_solution_presentation.html', true, true, 'components/ILIAS/Test');
        $tpl->setVariable('SOLUTION_PRESENTATION', $page_gui->preview());
 
        $this->setCorrectionTabsContext($question_gui, 'solution');
        $this->populatePageTitleAndDescription($question_gui);
 
        $this->main_tpl->setContent($tpl->get());
 
        $this->main_tpl->setCurrentBlock("ContentStyle");
        $this->main_tpl->setVariable(
            "LOCATION_CONTENT_STYLESHEET",
            ilObjStyleSheet::getContentStylePath(0)
        );
        $this->main_tpl->parseCurrentBlock();
 
        $this->main_tpl->setCurrentBlock("SyntaxStyle");
        $this->main_tpl->setVariable(
            "LOCATION_SYNTAX_STYLESHEET",
            ilObjStyleSheet::getSyntaxStylePath()
        );
        $this->main_tpl->parseCurrentBlock();
    }

References $question_gui, ILIAS\News\Common\Table\$tpl, ILIAS\Repository\ctrl(), ILIAS\UICore\GlobalTemplate\get(), ilObjStyleSheet\getContentStylePath(), assQuestionGUI\getObject(), assQuestionGUI\getSolutionOutput(), ilObjStyleSheet\getSyntaxStylePath(), populatePageTitleAndDescription(), setCorrectionTabsContext(), and ILIAS\UICore\GlobalTemplate\setVariable().

Here is the call graph for this function:

Field Documentation

◆ $question_gui

assQuestionGUI ilTestCorrectionsGUI::$question_gui = null

private

Definition at line 39 of file class.ilTestCorrectionsGUI.php.

Referenced by buildQuestionCorrectionForm(), getQuestionGUI(), populatePageTitleAndDescription(), saveQuestion(), setCorrectionTabsContext(), and showSolution().

◆ $test_access

ilTestAccess ilTestCorrectionsGUI::$test_access

private

Definition at line 40 of file class.ilTestCorrectionsGUI.php.

The documentation for this class was generated from the following file:

components/ILIAS/Test/classes/class.ilTestCorrectionsGUI.php

Public Member Functions

Protected Member Functions

Private Member Functions

Private Attributes

Detailed Description

Constructor & Destructor Documentation

◆ __construct()

Member Function Documentation

◆ addAnswer()

◆ addHiddenItemsFromArray()

◆ buildQuestionCorrectionForm()

◆ checkQuestion()

◆ confirmManualScoringReset()

◆ executeCommand()

◆ getQuestionGUI()

◆ getQuestions()

◆ getRefId()

◆ getSolutions()

◆ getSolutionsByParticipantResults()

◆ populatePageTitleAndDescription()

◆ saveQuestion()

◆ setCorrectionTabsContext()

◆ showAnswerStatistic()

◆ showQuestion()

◆ showSolution()

Field Documentation

◆ $question_gui

◆ $test_access