Scoring class for tests. More...

Inheritance diagram for ilTestScoringGUI:

Collaboration diagram for ilTestScoringGUI:

Public Member Functions
	__construct (ilObjTest $a_object)
	ilTestScoringGUI constructor More...

	getTestAccess ()

	setTestAccess ($testAccess)

	executeCommand ()
	execute command More...

Public Member Functions inherited from ilTestServiceGUI
	isContextResultPresentation ()

	setContextResultPresentation (bool $contextResultPresentation)

	setParticipantData (ilTestParticipantData $participantData)

	getParticipantData ()

	getPassOverviewTableData (ilTestSession $testSession, $passes, $withResults)
	This method uses the data of a given test pass to create an evaluation for displaying into a table used in the ilTestEvaluationGUI. More...

	setObjectiveOrientedContainer (ilTestObjectiveOrientedContainer $objective_oriented_container)

	getObjectiveOrientedContainer ()

	executeCommand ()
	execute command More...

	getCommand ($cmd)
	Retrieves the ilCtrl command. More...

	buildPassOverviewTableGUI (ilTestEvaluationGUI $target_gui)

	getPassListOfAnswers (&$result_array, $active_id, $pass, $show_solutions=false, $only_answered_questions=false, $show_question_only=false, $show_reached_points=false, $anchorNav=false, ilTestQuestionRelatedObjectivesList $objectives_list=null, ilTestResultHeaderLabelBuilder $testResultHeaderLabelBuilder=null)
	Returns the list of answers of a users test pass. More...

	getPassListOfAnswersWithScoring (&$result_array, $active_id, $pass, $show_solutions=false)
	Returns the list of answers of a users test pass and offers a scoring option. More...

	getResultsSignature ()
	Returns HTML code for a signature field. More...

	getAdditionalUsrDataHtmlAndPopulateWindowTitle ($testSession, $active_id, $overwrite_anonymity=false)
	Returns the user data for a test results output. More...

	getCorrectSolutionOutput ($question_id, $active_id, $pass, ilTestQuestionRelatedObjectivesList $objectives_list=null)
	Returns an output of the solution to an answer compared to the correct solution. More...

	getResultsOfUserOutput (ilTestSession $testSession, int $active_id, int $pass, ilParticipantsTestResultsGUI $target_gui, bool $show_pass_details=true, bool $show_answers=true, bool $show_question_only=false, bool $show_reached_points=false)
	Output of the pass overview for a test called by a test participant. More...

	getResultsHeadUserAndPass ($active_id, $pass)
	Returns the user and pass data for a test results output. More...

	getQuestionResultForTestUsers (int $question_id, int $test_id)

	getObject ()

Data Fields
const	PART_FILTER_ALL_USERS = 3

const	PART_FILTER_MANSCORING_DONE = 4

const	PART_FILTER_MANSCORING_NONE = 5

Protected Member Functions
	buildSubTabs ($active_sub_tab='man_scoring_by_qst')

	getDefaultCommand ()

	getActiveSubTabId ()

Protected Member Functions inherited from ilTestServiceGUI
	getPassDetailsOverviewTableGUI (array $result_array, int $active_id, int $pass, ilTestServiceGUI\|ilParticipantsTestResultsGUI $target_gui, string $target_cmd, ilTestQuestionRelatedObjectivesList $objectives_list=null, bool $multiple_objectives_involved=true)

	buildPassDetailsOverviewTableGUI (ilTestServiceGUI\|ilParticipantsTestResultsGUI $target_gui, string $target_cmd)

	isGradingMessageRequired ()

	getGradingMessageBuilder (int $active_id)

	buildQuestionRelatedObjectivesList (ilLOTestQuestionAdapter $objectives_adapter, ilTestQuestionSequence $test_sequence)

	getFilteredTestResult (int $active_id, int $pass, bool $considerHiddenQuestions, bool $considerOptionalQuestions)

	populateContent ($content)

	buildUserTestResultsToolbarGUI ()

	outCorrectSolutionCmd ()

	outCorrectSolution ()
	Creates an output of the solution of an answer compared to the correct solution. More...

	populatePassFinishDate (ilTemplate $tpl, ?int $pass_finish_date)

	populateExamId (ilTemplate $tpl, int $active_id, int $pass)

Protected Attributes
	$testAccess

Protected Attributes inherited from ilTestServiceGUI
InternalRequestService	$testrequest

ILIAS TestQuestionPool QuestionInfoService	$questioninfo

ilTestService	$service = null

ilDBInterface	$db

ilLanguage	$lng

LoggingServices	$logging_services

ilHelpGUI	$help

ilRbacSystem	$rbac_system

ilGlobalTemplateInterface ilTemplate	$tpl
	sk 2023-08-01: We need this union type, even if it is wrong! To change this More...

ContentStyle	$content_style

ilErrorHandling	$error

ilAccess	$access

HTTPServices	$http

ilCtrl	$ctrl

ilToolbarGUI	$toolbar

ilTabsGUI	$tabs

ilObjectDataCache	$obj_cache

ilComponentRepository	$component_repository

ilObjUser	$user

ArrayBasedRequestWrapper	$post_wrapper

ilNavigationHistory	$navigation_history

Refinery	$refinery

UIFactory	$ui_factory

UIRenderer	$ui_renderer

SkillService	$skills_service

ilTestShuffler	$shuffler

ilTestResultsFactory	$results_factory

ilTestResultsPresentationFactory	$results_presentation_factory

ILIAS	$ilias

ilSetting	$settings

GlobalScreenServices	$global_screen

ilTree	$tree

int	$ref_id

ilTestSessionFactory	$testSessionFactory = null

ilTestSequenceFactory	$testSequenceFactory = null

ilTestParticipantData	$participantData = null

ilTestParticipantAccessFilterFactory	$participant_access_filter

Private Member Functions
	fetchActiveIdParameter ()

	fetchPassParameter (int $active_id)

	showManScoringParticipantsTable ()

	applyManScoringParticipantsFilter ()

	resetManScoringParticipantsFilter ()

	showManScoringParticipantScreen (ilPropertyFormGUI $form=null)

	saveManScoringParticipantScreen (bool $redirect=true)

	saveNextManScoringParticipantScreen ()

	saveReturnManScoringParticipantScreen ()

	buildManScoringParticipantForm (array $questionGuiList, int $active_id, int $pass, bool $initValues=false)

	sendManScoringParticipantNotification ()

	buildManScoringParticipantsTable (bool $withData=false)

Detailed Description

Scoring class for tests.

Author: Helmut Schottmüller helmu.nosp@m.t.sc.nosp@m.hottm.nosp@m.uell.nosp@m.er@ma.nosp@m.c.co.nosp@m.m; Björn Heyser bheys.nosp@m.er@d.nosp@m.ataba.nosp@m.y.de

Version: $Id$

Definition at line 30 of file class.ilTestScoringGUI.php.

Constructor & Destructor Documentation

◆ __construct()

ilTestScoringGUI::__construct ( ilObjTest $a_object )

ilTestScoringGUI constructor

The constructor takes the test object reference as parameter

Parameters

object $a_object Associated ilObjTest class public

Definition at line 50 of file class.ilTestScoringGUI.php.

References ILIAS\MetaData\Repository\Validation\Data\__construct().

     {
         parent::__construct($a_object);
     }

Here is the call graph for this function:

Member Function Documentation

◆ applyManScoringParticipantsFilter()

ilTestScoringGUI::applyManScoringParticipantsFilter ( )

private

Definition at line 156 of file class.ilTestScoringGUI.php.

References buildManScoringParticipantsTable(), and showManScoringParticipantsTable().

                                                         : void
     {
         $table = $this->buildManScoringParticipantsTable(false);
         $table->resetOffset();
         $table->writeFilterToSession();
 
         $this->showManScoringParticipantsTable();
     }

Here is the call graph for this function:

◆ buildManScoringParticipantForm()

ilTestScoringGUI::buildManScoringParticipantForm	(	array	$questionGuiList,
		int	$active_id,
		int	$pass,
		bool	$initValues = `false`
	)

private

Definition at line 362 of file class.ilTestScoringGUI.php.

References $check, assQuestion\_getReachedPoints(), ILIAS\Repository\ctrl(), ilObjTest\getSingleManualFeedback(), ilTestService\isManScoringDone(), ILIAS\Repository\lng(), and ilTextAreaInputGUI\setValue().

Referenced by saveManScoringParticipantScreen(), and showManScoringParticipantScreen().

      : ilPropertyFormGUI {
         $this->ctrl->setParameter($this, 'active_id', $active_id);
         $this->ctrl->setParameter($this, 'pass', $pass);
 
         $form = new ilPropertyFormGUI();
         $form->setFormAction($this->ctrl->getFormAction($this));
 
         $form->setTitle(sprintf($this->lng->txt('manscoring_results_pass'), $pass + 1));
         $form->setTableWidth('100%');
 
         $autosave_enabled = $this->object->getAutosave();
         $show_solutions_enabled = $this->object->getShowSolutionFeedback();
         foreach ($questionGuiList as $questionId => $questionGUI) {
             $questionHeader = sprintf($this->lng->txt('tst_manscoring_question_section_header'), $questionGUI->object->getTitleForHTMLOutput());
             $questionSolution = $questionGUI->getSolutionOutput($active_id, $pass, false, false, true, false, false, true);
             $bestSolution = $questionGUI->object->getSuggestedSolutionOutput();
 
             $feedback = $this->object->getSingleManualFeedback($active_id, $questionId, $pass);
 
             $disabled = false;
             if (isset($feedback['finalized_evaluation']) && $feedback['finalized_evaluation'] == 1) {
                 $disabled = true;
             }
 
             $sect = new ilFormSectionHeaderGUI();
             $sect->setTitle($questionHeader . ' [' . $this->lng->txt('question_id_short') . ': ' . $questionGUI->object->getId() . ']');
             $form->addItem($sect);
 
             $cust = new ilCustomInputGUI($this->lng->txt('tst_manscoring_input_question_and_user_solution'));
             $cust->setHtml($questionSolution);
             $form->addItem($cust);
 
             if ($autosave_enabled) {
                 $aresult_output = $questionGUI->getAutoSavedSolutionOutput(
                     $active_id,
                     $pass,
                     false,
                     false,
                     true,
                     $show_solutions_enabled,
                     false,
                     true,
                     false
                 );
                 if ($aresult_output) {
                     $cust = new ilCustomInputGUI($this->lng->txt('autosavecontent'));
                     $cust->setHtml($aresult_output);
                     $form->addItem($cust);
                 }
             }
 
             $number_input_gui = new \ilNumberInputGUI($this->lng->txt('tst_change_points_for_question'), "question__{$questionId}__points");
             $number_input_gui->allowDecimals(true);
             if ($initValues) {
                 $number_input_gui->setValue((string) \assQuestion::_getReachedPoints($active_id, $questionId, $pass));
             }
             if ($disabled) {
                 $number_input_gui->setDisabled($disabled);
             }
             $form->addItem($number_input_gui);
 
             $nonedit = new ilNonEditableValueGUI($this->lng->txt('tst_manscoring_input_max_points_for_question'), "question__{$questionId}__maxpoints");
             if ($initValues) {
                 $nonedit->setValue($this->questioninfo->getMaximumPoints($questionId));
             }
             $form->addItem($nonedit);
 
             $area = new ilTextAreaInputGUI($this->lng->txt('set_manual_feedback'), "question__{$questionId}__feedback");
             $area->setUseRTE(true);
             if ($initValues) {
                 $area->setValue(ilObjTest::getSingleManualFeedback((int) $active_id, (int) $questionId, (int) $pass)['feedback'] ?? '');
             }
             if ($disabled) {
                 $area->setDisabled($disabled);
             }
             $form->addItem($area);
 
             $check = new ilCheckboxInputGUI($this->lng->txt('finalized_evaluation'), "{$questionId}__evaluated");
             if ($disabled) {
                 $check->setChecked(true);
             }
             $form->addItem($check);
 
             if (strlen(trim($bestSolution))) {
                 $cust = new ilCustomInputGUI($this->lng->txt('tst_show_solution_suggested'));
                 $cust->setHtml($bestSolution);
                 $form->addItem($cust);
             }
         }
 
         $sect = new ilFormSectionHeaderGUI();
         $sect->setTitle($this->lng->txt('tst_participant'));
         $form->addItem($sect);
 
         $check = new ilCheckboxInputGUI($this->lng->txt('set_manscoring_done'), 'manscoring_done');
         if ($initValues && ilTestService::isManScoringDone($active_id)) {
             $check->setChecked(true);
         }
         $form->addItem($check);
 
         $check = new ilCheckboxInputGUI($this->lng->txt('tst_manscoring_user_notification'), 'manscoring_notify');
         $form->addItem($check);
 
         $form->addCommandButton('saveManScoringParticipantScreen', $this->lng->txt('save'));
         $form->addCommandButton('saveReturnManScoringParticipantScreen', $this->lng->txt('save_return'));
         $form->addCommandButton('saveNextManScoringParticipantScreen', $this->lng->txt('save_and_next'));
 
         return $form;
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ buildManScoringParticipantsTable()

ilTestScoringGUI::buildManScoringParticipantsTable ( bool $withData = false )

private

Definition at line 481 of file class.ilTestScoringGUI.php.

References ILIAS\Repository\lng(), ILIAS\Repository\object(), and ILIAS\Repository\user().

Referenced by applyManScoringParticipantsFilter(), resetManScoringParticipantsFilter(), saveNextManScoringParticipantScreen(), and showManScoringParticipantsTable().

                                                                              : ilTestManScoringParticipantsTableGUI
     {
         $table = new ilTestManScoringParticipantsTableGUI($this);
 
         if ($withData) {
             $participantStatusFilterValue = $table->getFilterItemByPostVar('participant_status')->getValue();
 
             $participant_list = new ilTestParticipantList($this->object, $this->user, $this->lng, $this->db);
 
             $participant_list->initializeFromDbRows(
                 $this->object->getTestParticipantsForManualScoring($participantStatusFilterValue)
             );
 
             $filtered_participant_list = $participant_list->getAccessFilteredList(
                 $this->participant_access_filter->getScoreParticipantsUserFilter($this->ref_id)
             );
 
             $table->setData($filtered_participant_list->getParticipantsTableRows());
         }
 
         return $table;
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ buildSubTabs()

ilTestScoringGUI::buildSubTabs ( $active_sub_tab = 'man_scoring_by_qst' )

protected

Parameters

string $active_sub_tab

Definition at line 74 of file class.ilTestScoringGUI.php.

References ILIAS\Repository\ctrl(), ILIAS\Repository\lng(), and ILIAS\Repository\tabs().

Referenced by executeCommand().

     {
         $this->tabs->addSubTab('man_scoring_by_qst', $this->lng->txt('tst_man_scoring_by_qst'), $this->ctrl->getLinkTargetByClass('ilTestScoringByQuestionsGUI', 'showManScoringByQuestionParticipantsTable'));
         $this->tabs->addSubTab('man_scoring', $this->lng->txt('tst_man_scoring_by_part'), $this->ctrl->getLinkTargetByClass('ilTestScoringGUI', 'showManScoringParticipantsTable'));
         $this->tabs->setSubTabActive($active_sub_tab);
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ executeCommand()

ilTestScoringGUI::executeCommand ( )

execute command

Definition at line 115 of file class.ilTestScoringGUI.php.

References ilObjAssessmentFolder\_mananuallyScoreableQuestionTypesExists(), buildSubTabs(), ILIAS\Repository\ctrl(), getActiveSubTabId(), getDefaultCommand(), getTestAccess(), ILIAS\Repository\lng(), ilTestTabsManager\TAB_ID_MANUAL_SCORING, and ILIAS\Repository\tabs().

     {
         if (!$this->getTestAccess()->checkScoreParticipantsAccess()) {
             ilObjTestGUI::accessViolationRedirect();
         }
 
         if (!ilObjAssessmentFolder::_mananuallyScoreableQuestionTypesExists()) {
             // allow only if at least one question type is marked for manual scoring
             $this->tpl->setOnScreenMessage('failure', $this->lng->txt("manscoring_not_allowed"), true);
             $this->ctrl->redirectByClass("ilobjtestgui", "infoScreen");
         }
 
         $this->tabs->activateTab(ilTestTabsManager::TAB_ID_MANUAL_SCORING);
         $this->buildSubTabs($this->getActiveSubTabId());
 
         $nextClass = $this->ctrl->getNextClass($this);
         $command = $this->ctrl->getCmd($this->getDefaultCommand());
 
         switch ($nextClass) {
             default:
                 $this->$command();
                 break;
         }
     }

Here is the call graph for this function:

◆ fetchActiveIdParameter()

ilTestScoringGUI::fetchActiveIdParameter ( )

private

Definition at line 81 of file class.ilTestScoringGUI.php.

References ILIAS\Repository\ctrl().

Referenced by saveManScoringParticipantScreen(), and showManScoringParticipantScreen().

                                              : int
     {
         if (!$this->testrequest->isset('active_id') || $this->testrequest->int('active_id') === 0) {
             $this->tpl->setOnScreenMessage('failure', 'no active id given!', true);
             $this->ctrl->redirectByClass("ilobjtestgui", "infoScreen");
         }
 
         return $this->testrequest->int('active_id');
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ fetchPassParameter()

ilTestScoringGUI::fetchPassParameter ( int $active_id )

private

Definition at line 91 of file class.ilTestScoringGUI.php.

References ILIAS\Repository\object(), and SCORE_LAST_PASS.

Referenced by saveManScoringParticipantScreen(), and showManScoringParticipantScreen().

                                                        : int
     {
         $max_pass = $this->object->_getMaxPass($active_id);
 
 
         if ($this->testrequest->isset('pass')) {
             $pass_from_request = $this->testrequest->int('pass');
             if ($pass_from_request >= 0
                 && $pass_from_request <= $max_pass
             ) {
                 return $pass_from_request;
             }
         }
 
         if ($this->object->getPassScoring() == SCORE_LAST_PASS) {
             return $max_pass;
         }
 
         return $this->object->_getResultPass($active_id);
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getActiveSubTabId()

ilTestScoringGUI::getActiveSubTabId ( )

protected

Definition at line 145 of file class.ilTestScoringGUI.php.

Referenced by executeCommand().

                                           : string
     {
         return 'man_scoring';
     }

Here is the caller graph for this function:

◆ getDefaultCommand()

ilTestScoringGUI::getDefaultCommand ( )

protected

Definition at line 140 of file class.ilTestScoringGUI.php.

Referenced by executeCommand().

                                           : string
     {
         return 'manscoring';
     }

Here is the caller graph for this function:

◆ getTestAccess()

ilTestScoringGUI::getTestAccess ( )

Returns: ilTestAccess

Definition at line 58 of file class.ilTestScoringGUI.php.

References $testAccess.

Referenced by executeCommand(), ilTestScoringByQuestionsGUI\getAnswerDetail(), ilTestScoringByQuestionsGUI\saveManScoringByQuestion(), saveManScoringParticipantScreen(), and showManScoringParticipantScreen().

                                    : ilTestAccess
     {
         return $this->testAccess;
     }

Here is the caller graph for this function:

◆ resetManScoringParticipantsFilter()

ilTestScoringGUI::resetManScoringParticipantsFilter ( )

private

Definition at line 165 of file class.ilTestScoringGUI.php.

References buildManScoringParticipantsTable(), and showManScoringParticipantsTable().

                                                         : void
     {
         $table = $this->buildManScoringParticipantsTable(false);
         $table->resetOffset();
         $table->resetFilter();
 
         $this->showManScoringParticipantsTable();
     }

Here is the call graph for this function:

◆ saveManScoringParticipantScreen()

ilTestScoringGUI::saveManScoringParticipantScreen ( bool $redirect = true )

private

Definition at line 208 of file class.ilTestScoringGUI.php.

References ilObjTestAccess\_getParticipantId(), assQuestion\_getReachedPoints(), ilObjAdvancedEditing\_getUsedHTMLTagsAsString(), ilObjUser\_lookupName(), assQuestion\_setReachedPoints(), ilLPStatusWrapper\_updateStatus(), buildManScoringParticipantForm(), ILIAS\Repository\ctrl(), fetchActiveIdParameter(), fetchPassParameter(), getTestAccess(), ILIAS\Repository\lng(), ILIAS\Repository\object(), ILIAS\Repository\refinery(), ilMailNotification\setAdditionalInformation(), ilTestService\setManScoringDone(), showManScoringParticipantScreen(), and ilUtil\stripSlashes().

Referenced by saveNextManScoringParticipantScreen(), and saveReturnManScoringParticipantScreen().

                                                                            : bool
     {
         $active_id = $this->fetchActiveIdParameter();
 
         if (!$this->getTestAccess()->checkScoreParticipantsAccessForActiveId($active_id)) {
             ilObjTestGUI::accessViolationRedirect();
         }
 
         $pass = $this->fetchPassParameter($active_id);
 
         $questionGuiList = $this->service->getManScoringQuestionGuiList($active_id, $pass);
         $form = $this->buildManScoringParticipantForm($questionGuiList, $active_id, $pass, false);
 
         $form->setValuesByPost();
 
         if (!$form->checkInput()) {
             $this->tpl->setOnScreenMessage('failure', sprintf($this->lng->txt('tst_save_manscoring_failed'), $pass + 1));
             $this->showManScoringParticipantScreen($form);
             return false;
         }
 
         $maxPointsByQuestionId = [];
         $maxPointsExceeded = false;
         foreach ($questionGuiList as $questionId => $questionGui) {
             $reachedPoints = $form->getItemByPostVar("question__{$questionId}__points")->getValue();
             $maxPoints = $this->questioninfo->getMaximumPoints($questionId);
 
             if ($reachedPoints > $maxPoints) {
                 $maxPointsExceeded = true;
 
                 $form->getItemByPostVar("question__{$questionId}__points")->setAlert(sprintf(
                     $this->lng->txt('tst_manscoring_maxpoints_exceeded_input_alert'),
                     $maxPoints
                 ));
             }
 
             $maxPointsByQuestionId[$questionId] = $maxPoints;
         }
 
         if ($maxPointsExceeded) {
             $this->tpl->setOnScreenMessage('failure', sprintf($this->lng->txt('tst_save_manscoring_failed'), $pass + 1));
             $this->showManScoringParticipantScreen($form);
             return false;
         }
 
         foreach ($questionGuiList as $questionId => $questionGui) {
             $old_points = assQuestion::_getReachedPoints($active_id, $questionId, $pass);
             $reached_points = $this->refinery->byTrying([
                 $this->refinery->kindlyTo()->float(),
                 $this->refinery->always($old_points)
             ])->transform($form->getItemByPostVar("question__{$questionId}__points")?->getValue());
 
             $finalized = (bool) $form->getItemByPostVar("{$questionId}__evaluated")?->getChecked();
             // fix #35543: save manual points only if they differ from the existing points
             // this prevents a question being set to "answered" if only feedback is entered
             if ($reached_points !== $old_points) {
                 assQuestion::_setReachedPoints(
                     $active_id,
                     $questionId,
                     $reached_points,
                     $maxPointsByQuestionId[$questionId],
                     $pass,
                     true,
                     $this->object->areObligationsEnabled(),
                     $this->getTestAccess()->getTestId()
                 );
             }
 
             $feedback = ilUtil::stripSlashes(
                 (string) $form->getItemByPostVar("question__{$questionId}__feedback")->getValue(),
                 false,
                 ilObjAdvancedEditing::_getUsedHTMLTagsAsString("assessment")
             );
 
             $this->object->saveManualFeedback($active_id, (int) $questionId, $pass, $feedback, $finalized, true);
 
             $notificationData[$questionId] = [
                 'points' => $reached_points, 'feedback' => $feedback
             ];
         }
 
         ilLPStatusWrapper::_updateStatus(
             $this->object->getId(),
             ilObjTestAccess::_getParticipantId($active_id)
         );
 
         $manScoringDone = $form->getItemByPostVar("manscoring_done")->getChecked();
         ilTestService::setManScoringDone($active_id, $manScoringDone);
 
         $manScoringNotify = $form->getItemByPostVar("manscoring_notify")->getChecked();
         if ($manScoringNotify) {
             $notification = new ilTestManScoringParticipantNotification(
                 $this->object->_getUserIdFromActiveId($active_id),
                 $this->object->getRefId()
             );
 
             $notification->setAdditionalInformation(array(
                 'test_title' => $this->object->getTitle(),
                 'test_pass' => $pass + 1,
                 'questions_gui_list' => $questionGuiList,
                 'questions_scoring_data' => $notificationData
             ));
 
             $notification->send();
         }
 
         $scorer = new ilTestScoring($this->object, $this->db);
         $scorer->setPreserveManualScores(true);
         $scorer->recalculateSolution($active_id, $pass);
 
         if ($this->object->getAnonymity() == 0) {
             $user_name = ilObjUser::_lookupName(ilObjTestAccess::_getParticipantId($active_id));
             $name_real_or_anon = $user_name['firstname'] . ' ' . $user_name['lastname'];
         } else {
             $name_real_or_anon = $this->lng->txt('anonymous');
         }
         $this->tpl->setOnScreenMessage('success', sprintf($this->lng->txt('tst_saved_manscoring_successfully'), $pass + 1, $name_real_or_anon), true);
         if ($redirect == true) {
             $this->ctrl->redirect($this, 'showManScoringParticipantScreen');
         }
         return true;
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ saveNextManScoringParticipantScreen()

ilTestScoringGUI::saveNextManScoringParticipantScreen ( )

private

Definition at line 331 of file class.ilTestScoringGUI.php.

References ilTestServiceGUI\$participantData, buildManScoringParticipantsTable(), ILIAS\Repository\ctrl(), and saveManScoringParticipantScreen().

                                                           : void
     {
         $table = $this->buildManScoringParticipantsTable(true);
 
         if ($this->saveManScoringParticipantScreen(false)) {
             $participantData = $table->getInternalyOrderedDataValues();
 
             $nextIndex = null;
             foreach ($participantData as $index => $participant) {
                 if ($participant['active_id'] == $this->testrequest->raw('active_id')) {
                     $nextIndex = $index + 1;
                     break;
                 }
             }
 
             if ($nextIndex && isset($participantData[$nextIndex])) {
                 $this->ctrl->setParameter($this, 'active_id', $participantData[$nextIndex]['active_id']);
                 $this->ctrl->redirect($this, 'showManScoringParticipantScreen');
             }
 
             $this->ctrl->redirectByClass("iltestscoringgui", "showManScoringParticipantsTable");
         }
     }

Here is the call graph for this function:

◆ saveReturnManScoringParticipantScreen()

ilTestScoringGUI::saveReturnManScoringParticipantScreen ( )

private

Definition at line 355 of file class.ilTestScoringGUI.php.

References ILIAS\Repository\ctrl(), and saveManScoringParticipantScreen().

                                                             : void
     {
         if ($this->saveManScoringParticipantScreen(false)) {
             $this->ctrl->redirectByClass("iltestscoringgui", "showManScoringParticipantsTable");
         }
     }

Here is the call graph for this function:

◆ sendManScoringParticipantNotification()

ilTestScoringGUI::sendManScoringParticipantNotification ( )

private

Definition at line 477 of file class.ilTestScoringGUI.php.

                                                             : void
     {
     }

◆ setTestAccess()

ilTestScoringGUI::setTestAccess ( $testAccess )

Parameters

ilTestAccess $testAccess

Definition at line 66 of file class.ilTestScoringGUI.php.

References $testAccess.

     {
         $this->testAccess = $testAccess;
     }

◆ showManScoringParticipantScreen()

ilTestScoringGUI::showManScoringParticipantScreen ( ilPropertyFormGUI $form = null )

private

Definition at line 174 of file class.ilTestScoringGUI.php.

References buildManScoringParticipantForm(), fetchActiveIdParameter(), fetchPassParameter(), getTestAccess(), and ILIAS\Repository\lng().

Referenced by saveManScoringParticipantScreen().

                                                                                     : void
     {
         $active_id = $this->fetchActiveIdParameter();
 
         if (!$this->getTestAccess()->checkScoreParticipantsAccessForActiveId($active_id)) {
             ilObjTestGUI::accessViolationRedirect();
         }
 
         $pass = $this->fetchPassParameter($active_id);
 
         $content_html = '';
 
         $table = new ilTestPassManualScoringOverviewTableGUI($this, 'showManScoringParticipantScreen');
 
         $user_id = $this->object->_getUserIdFromActiveId($active_id);
         $user_fullname = $this->object->userLookupFullName($user_id, false, true);
         $table_title = sprintf($this->lng->txt('tst_pass_overview_for_participant'), $user_fullname);
         $table->setTitle($table_title);
 
         $passOverviewData = $this->service->getPassOverviewData($active_id);
         $table->setData($passOverviewData['passes']);
 
         $content_html .= $table->getHTML() . '<br />';
 
         if ($form === null) {
             $question_gui_list = $this->service->getManScoringQuestionGuiList($active_id, $pass);
             $form = $this->buildManScoringParticipantForm($question_gui_list, $active_id, $pass, true);
         }
 
         $content_html .= $form->getHTML();
 
         $this->tpl->setContent($content_html);
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ showManScoringParticipantsTable()

ilTestScoringGUI::showManScoringParticipantsTable ( )

private

Definition at line 150 of file class.ilTestScoringGUI.php.

References buildManScoringParticipantsTable().

Referenced by applyManScoringParticipantsFilter(), and resetManScoringParticipantsFilter().

                                                       : void
     {
         $table = $this->buildManScoringParticipantsTable(true);
         $this->tpl->setContent($table->getHTML());
     }

Here is the call graph for this function:

Here is the caller graph for this function:

Field Documentation

◆ $testAccess

ilTestScoringGUI::$testAccess

protected

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

Referenced by getTestAccess(), and setTestAccess().

◆ PART_FILTER_ALL_USERS

const ilTestScoringGUI::PART_FILTER_ALL_USERS = 3

Definition at line 32 of file class.ilTestScoringGUI.php.

Referenced by ilTestManScoringParticipantsTableGUI\initFilter().

◆ PART_FILTER_MANSCORING_DONE

const ilTestScoringGUI::PART_FILTER_MANSCORING_DONE = 4

Definition at line 33 of file class.ilTestScoringGUI.php.

Referenced by ilTestManScoringParticipantsTableGUI\initFilter().

◆ PART_FILTER_MANSCORING_NONE

const ilTestScoringGUI::PART_FILTER_MANSCORING_NONE = 5

Definition at line 34 of file class.ilTestScoringGUI.php.

Referenced by ilTestManScoringParticipantsTableGUI\initFilter().

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

Modules/Test/classes/class.ilTestScoringGUI.php

Public Member Functions

Data Fields

Protected Member Functions

Protected Attributes

Private Member Functions

Detailed Description

Constructor & Destructor Documentation

◆ __construct()

Member Function Documentation

◆ applyManScoringParticipantsFilter()

◆ buildManScoringParticipantForm()

◆ buildManScoringParticipantsTable()

◆ buildSubTabs()

◆ executeCommand()

◆ fetchActiveIdParameter()

◆ fetchPassParameter()

◆ getActiveSubTabId()

◆ getDefaultCommand()

◆ getTestAccess()

◆ resetManScoringParticipantsFilter()

◆ saveManScoringParticipantScreen()

◆ saveNextManScoringParticipantScreen()

◆ saveReturnManScoringParticipantScreen()

◆ sendManScoringParticipantNotification()

◆ setTestAccess()

◆ showManScoringParticipantScreen()

◆ showManScoringParticipantsTable()

Field Documentation

◆ $testAccess

◆ PART_FILTER_ALL_USERS

◆ PART_FILTER_MANSCORING_DONE

◆ PART_FILTER_MANSCORING_NONE