Inheritance diagram for ilTestScoringByQuestionsGUI:

Collaboration diagram for ilTestScoringByQuestionsGUI:

Public Member Functions
	__construct (ilObjTest $a_object)

	checkConstraintsBeforeSaving ()

Public Member Functions inherited from ilTestScoringGUI
	__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	EXCEPT_FINALIZED = '1'

const	ONLY_FINALIZED = '2'

Data Fields inherited from ilTestScoringGUI
const	PART_FILTER_ALL_USERS = 3

const	PART_FILTER_MANSCORING_DONE = 4

const	PART_FILTER_MANSCORING_NONE = 5

Protected Member Functions
	getDefaultCommand ()

	getActiveSubTabId ()

	showManScoringByQuestionParticipantsTable (array $manPointsPost=[])

	saveManScoringByQuestion (bool $ajax=false)

	applyManScoringByQuestionFilter ()

	resetManScoringByQuestionFilter ()

	getAnswerDetail ()

	retrieveFeedback (int $active_id, int $qst_id, int $pass)

Protected Member Functions inherited from ilTestScoringGUI
	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)

Private Member Functions
	appendUserNameToModal (ilTemplate $tmp_tpl, ilTestEvaluationUserData $participant_data)

	appendQuestionTitleToModal (ilTemplate $tmp_tpl, int $question_id, float $max_points, string $title)

	appendFormToModal (ilTemplate $tmp_tpl, int $pass, int $active_id, int $question_id, float $max_points)

	appendSolutionAndPointsToModal (ilTemplate $tmp_tpl, $result_output, $reached_points, $max_points)

	saveFinalization (array $finalization, int $active_id, int $qst_id, int $pass, ?string $feedback, bool $is_single_feedback)

	doesValueExistsInPostArray (array $finalization, int $active_id, int $qst_id, int $pass)

Additional Inherited Members
Protected Attributes inherited from ilTestScoringGUI
	$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

Detailed Description

Definition at line 23 of file class.ilTestScoringByQuestionsGUI.php.

Constructor & Destructor Documentation

◆ __construct()

ilTestScoringByQuestionsGUI::__construct ( ilObjTest $a_object )

Definition at line 28 of file class.ilTestScoringByQuestionsGUI.php.

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

     {
         parent::__construct($a_object);
     }

Here is the call graph for this function:

Member Function Documentation

◆ appendFormToModal()

ilTestScoringByQuestionsGUI::appendFormToModal	(	ilTemplate	$tmp_tpl,
		int	$pass,
		int	$active_id,
		int	$question_id,
		float	$max_points
	)

private

Definition at line 565 of file class.ilTestScoringByQuestionsGUI.php.

References assQuestion\_getReachedPoints(), ilObjAdvancedEditing\_getRichTextEditor(), ILIAS\Repository\ctrl(), ilObjTest\getSingleManualFeedback(), ILIAS\Repository\int(), ILIAS\Repository\lng(), ilTextAreaInputGUI\setValue(), and HTML_Template_IT\setVariable().

Referenced by getAnswerDetail().

                                                                                                                            : void
     {
         $post_var = '[' . $pass . '][' . $active_id . '][' . $question_id . ']';
         $scoring_post_var = 'scoring' . $post_var;
         $reached_points = assQuestion::_getReachedPoints($active_id, $question_id, $pass);
         $form = new ilPropertyFormGUI();
         $feedback = ilObjTest::getSingleManualFeedback((int) $active_id, (int) $question_id, (int) $pass);
         $disable = false;
         $form->setFormAction($this->ctrl->getFormAction($this, 'showManScoringByQuestionParticipantsTable'));
         $form->setTitle($this->lng->txt('manscoring'));
 
         if (isset($feedback['finalized_evaluation']) && $feedback['finalized_evaluation'] == 1) {
             $disable = true;
             $hidden_points = new ilHiddenInputGUI($scoring_post_var);
             $scoring_post_var = $scoring_post_var . '_disabled';
             $hidden_points->setValue((string) $reached_points);
             $form->addItem($hidden_points);
         }
 
         $feedback_text = '';
         if (array_key_exists('feedback', $feedback)) {
             $feedback_text = $feedback['feedback'];
         }
 
         if ($disable) {
             $feedback_input = new ilNonEditableValueGUI(
                 $this->lng->txt('set_manual_feedback'),
                 'm_feedback' . $post_var,
                 true
             );
         } else {
             $tmp_tpl->setVariable('TINYMCE_ACTIVE', ilObjAdvancedEditing::_getRichTextEditor());
             $feedback_input = new ilTextAreaInputGUI($this->lng->txt('set_manual_feedback'), 'm_feedback' . $post_var);
         }
         $feedback_input->setValue($feedback_text);
         $form->addItem($feedback_input);
 
         $reached_points_form = new ilNumberInputGUI(
             $this->lng->txt('tst_change_points_for_question'),
             $scoring_post_var
         );
         $reached_points_form->allowDecimals(true);
         $reached_points_form->setSize(5);
         $reached_points_form->setMaxValue($max_points, true);
         $reached_points_form->setMinValue(0);
         $reached_points_form->setDisabled($disable);
         $reached_points_form->setValue((string) $reached_points);
         $reached_points_form->setClientSideValidation(true);
         $form->addItem($reached_points_form);
 
         $hidden_points = new ilHiddenInputGUI('qst_max_points');
         $hidden_points->setValue((string) $max_points);
         $form->addItem($hidden_points);
 
         $hidden_points_name = new ilHiddenInputGUI('qst_hidden_points_name');
         $hidden_points_name->setValue('scoring' . $post_var);
         $form->addItem($hidden_points_name);
 
         $hidden_feedback_name = new ilHiddenInputGUI('qst_hidden_feedback_name');
         $hidden_feedback_name->setValue('m_feedback' . $post_var);
         $form->addItem($hidden_feedback_name);
 
         $hidden_feedback_id = new ilHiddenInputGUI('qst_hidden_feedback_id');
         $post_id = '__' . $pass . '____' . $active_id . '____' . $question_id . '__';
         $hidden_feedback_id->setValue('m_feedback' . $post_id);
         $form->addItem($hidden_feedback_id);
 
         $evaluated = new ilCheckboxInputGUI($this->lng->txt('finalized_evaluation'), 'evaluated' . $post_var);
         if (isset($feedback['finalized_evaluation']) && (int) $feedback['finalized_evaluation'] === 1) {
             $evaluated->setChecked(true);
         }
         $form->addItem($evaluated);
 
         $form->addCommandButton('checkConstraintsBeforeSaving', $this->lng->txt('save'));
 
         $tmp_tpl->setVariable(
             'MANUAL_FEEDBACK',
             $form->getHTML()
         );
         $tmp_tpl->setVariable(
             'MODAL_AJAX_URL',
             $this->ctrl->getLinkTarget($this, 'checkConstraintsBeforeSaving', '', true, false)
         );
         $tmp_tpl->setVariable(
             'INFO_TEXT_MAX_POINTS_EXCEEDS',
             sprintf($this->lng->txt('tst_manscoring_maxpoints_exceeded_input_alert'), $max_points)
         );
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ appendQuestionTitleToModal()

ilTestScoringByQuestionsGUI::appendQuestionTitleToModal	(	ilTemplate	$tmp_tpl,
		int	$question_id,
		float	$max_points,
		string	$title
	)

private

Definition at line 550 of file class.ilTestScoringByQuestionsGUI.php.

References ilTestServiceGUI\$lng, ILIAS\Repository\lng(), and HTML_Template_IT\setVariable().

Referenced by getAnswerDetail().

                                                                                                                         : void
     {
         $add_title = ' [' . $this->lng->txt('question_id_short') . ': ' . $question_id . ']';
         $question_title = $this->object->getQuestionTitle($title);
         $lng = $this->lng->txt('points');
         if ($max_points == 1) {
             $lng = $this->lng->txt('point');
         }
 
         $tmp_tpl->setVariable(
             'QUESTION_TITLE',
             $question_title . ' (' . $max_points . ' ' . $lng . ')' . $add_title
         );
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ appendSolutionAndPointsToModal()

ilTestScoringByQuestionsGUI::appendSolutionAndPointsToModal	(	ilTemplate	$tmp_tpl,
			$result_output,
			$reached_points,
			$max_points
	)

private

Parameters

ilTemplate	$tmp_tpl
	$result_output
	$reached_points
	$max_points

Definition at line 660 of file class.ilTestScoringByQuestionsGUI.php.

References ILIAS\Repository\lng(), and HTML_Template_IT\setVariable().

Referenced by getAnswerDetail().

      : void {
         $tmp_tpl->setVariable(
             'SOLUTION_OUTPUT',
             $result_output
         );
         $tmp_tpl->setVariable(
             'RECEIVED_POINTS',
             sprintf(
                 $this->lng->txt('part_received_a_of_b_points'),
                 $reached_points,
                 $max_points
             )
         );
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ appendUserNameToModal()

ilTestScoringByQuestionsGUI::appendUserNameToModal	(	ilTemplate	$tmp_tpl,
		ilTestEvaluationUserData	$participant_data
	)

private

Definition at line 532 of file class.ilTestScoringByQuestionsGUI.php.

References ILIAS\Repository\access(), ilTestEvaluationUserData\getName(), ILIAS\Repository\lng(), ILIAS\Repository\object(), and HTML_Template_IT\setVariable().

Referenced by getAnswerDetail().

                                                                                                            : void
     {
         $tmp_tpl->setVariable(
             'TEXT_YOUR_SOLUTION',
             $this->lng->txt('answers_of') . ' ' . $participant_data->getName()
         );
 
         if (
             $this->object->getAnonymity() == 1 ||
             ($this->object->getAnonymity() == 2 && !$this->access->checkAccess('write', '', $this->object->getRefId()))
         ) {
             $tmp_tpl->setVariable(
                 'TEXT_YOUR_SOLUTION',
                 $this->lng->txt('answers_of') . ' ' . $this->lng->txt('anonymous')
             );
         }
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ applyManScoringByQuestionFilter()

ilTestScoringByQuestionsGUI::applyManScoringByQuestionFilter ( )

protected

Definition at line 419 of file class.ilTestScoringByQuestionsGUI.php.

References ILIAS\Repository\access(), and showManScoringByQuestionParticipantsTable().

                                                         : void
     {
         $table = new ilTestManScoringParticipantsBySelectedQuestionAndPassTableGUI($this, $this->access);
         $table->resetOffset();
         $table->writeFilterToSession();
         $this->showManScoringByQuestionParticipantsTable();
     }

Here is the call graph for this function:

◆ checkConstraintsBeforeSaving()

ilTestScoringByQuestionsGUI::checkConstraintsBeforeSaving ( )

Definition at line 527 of file class.ilTestScoringByQuestionsGUI.php.

References saveManScoringByQuestion().

                                                   : void
     {
         $this->saveManScoringByQuestion(true);
     }

Here is the call graph for this function:

◆ doesValueExistsInPostArray()

ilTestScoringByQuestionsGUI::doesValueExistsInPostArray	(	array	$finalization,
		int	$active_id,
		int	$qst_id,
		int	$pass
	)

private

Parameters

array<numeric-string|int,array<numeric-string|int,array<numeric-string|int,bool>>> $finalization

Definition at line 727 of file class.ilTestScoringByQuestionsGUI.php.

Referenced by saveFinalization().

                                                                                                             : bool
     {
         return isset($finalization[$pass][$active_id][$qst_id]);
     }

Here is the caller graph for this function:

◆ getActiveSubTabId()

ilTestScoringByQuestionsGUI::getActiveSubTabId ( )

protected

Definition at line 38 of file class.ilTestScoringByQuestionsGUI.php.

                                           : string
     {
         return 'man_scoring_by_qst';
     }

◆ getAnswerDetail()

ilTestScoringByQuestionsGUI::getAnswerDetail ( )

protected

Definition at line 435 of file class.ilTestScoringByQuestionsGUI.php.

References $data, ilTestServiceGUI\$lng, assQuestion\_getSuggestedSolutionOutput(), appendFormToModal(), appendQuestionTitleToModal(), appendSolutionAndPointsToModal(), appendUserNameToModal(), ilTestScoringGUI\getTestAccess(), ILIAS\FileDelivery\http(), ILIAS\Repository\int(), ILIAS\Repository\lng(), and ILIAS\Repository\object().

                                         : void
     {
         $active_id = $this->testrequest->getActiveId();
         $pass = $this->testrequest->getPassId();
         $question_id = (int) $this->testrequest->raw('qst_id');
 
         if (!$this->getTestAccess()->checkScoreParticipantsAccessForActiveId($active_id)) {
             $this->http->close(); // illegal ajax call
         }
 
         $data = $this->object->getCompleteEvaluationData(false);
         $participant = $data->getParticipant($active_id);
         $question_gui = $this->object->createQuestionGUI('', $question_id);
         $tmp_tpl = new ilTemplate('tpl.il_as_tst_correct_solution_output.html', true, true, 'Modules/Test');
         if ($this->object->getAutosave()) {
             $aresult_output = $question_gui->getAutoSavedSolutionOutput(
                 $active_id,
                 $pass,
                 false,
                 false,
                 false,
                 $this->object->getShowSolutionFeedback(),
                 false,
                 true,
                 false
             );
             if ($aresult_output) {
                 $tmp_tpl->setVariable('TEXT_ASOLUTION_OUTPUT', $this->lng->txt('autosavecontent'));
                 $tmp_tpl->setVariable('ASOLUTION_OUTPUT', $aresult_output);
             }
         }
         $result_output = $question_gui->getSolutionOutput(
             $active_id,
             $pass,
             false,
             false,
             false,
             $this->object->getShowSolutionFeedback(),
             false,
             true
         );
         $max_points = $question_gui->object->getMaximumPoints();
 
         $this->appendUserNameToModal($tmp_tpl, $participant);
         $this->appendQuestionTitleToModal($tmp_tpl, $question_id, $max_points, $question_gui->object->getTitleForHTMLOutput());
         $this->appendSolutionAndPointsToModal(
             $tmp_tpl,
             $result_output,
             $question_gui->object->getReachedPoints($active_id, $pass),
             $max_points
         );
         $this->appendFormToModal($tmp_tpl, $pass, $active_id, $question_id, $max_points);
         $tmp_tpl->setVariable('TEXT_YOUR_SOLUTION', $this->lng->txt('answers_of') . ' ' . $participant->getName());
         $suggested_solution = assQuestion::_getSuggestedSolutionOutput($question_id);
         if ($this->object->getShowSolutionSuggested() && strlen($suggested_solution) > 0) {
             $tmp_tpl->setVariable('TEXT_SOLUTION_HINT', $this->lng->txt("solution_hint"));
             $tmp_tpl->setVariable("SOLUTION_HINT", assQuestion::_getSuggestedSolutionOutput($question_id));
         }
 
         $tmp_tpl->setVariable('TEXT_SOLUTION_OUTPUT', $this->lng->txt('question'));
         $tmp_tpl->setVariable('TEXT_RECEIVED_POINTS', $this->lng->txt('scoring'));
         $add_title = ' [' . $this->lng->txt('question_id_short') . ': ' . $question_id . ']';
         $question_title = $this->object->getQuestionTitle($question_gui->object->getTitleForHTMLOutput());
         $lng = $this->lng->txt('points');
         if ($max_points == 1) {
             $lng = $this->lng->txt('point');
         }
 
         $tmp_tpl->setVariable(
             'QUESTION_TITLE',
             $question_title . ' (' . $max_points . ' ' . $lng . ')' . $add_title
         );
         $tmp_tpl->setVariable('SOLUTION_OUTPUT', $result_output);
 
         $tmp_tpl->setVariable(
             'RECEIVED_POINTS',
             sprintf(
                 $this->lng->txt('part_received_a_of_b_points'),
                 $question_gui->object->getReachedPoints($active_id, $pass),
                 $max_points
             )
         );
 
         $this->http->saveResponse(
             $this->http->response()->withBody(
                 \ILIAS\Filesystem\Stream\Streams::ofString($tmp_tpl->get())
             )->withHeader(\ILIAS\HTTP\Response\ResponseHeader::CONTENT_TYPE, 'text/html')
         );
         $this->http->sendResponse();
         $this->http->close();
     }

Here is the call graph for this function:

◆ getDefaultCommand()

ilTestScoringByQuestionsGUI::getDefaultCommand ( )

protected

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

                                           : string
     {
         return 'showManScoringByQuestionParticipantsTable';
     }

◆ resetManScoringByQuestionFilter()

ilTestScoringByQuestionsGUI::resetManScoringByQuestionFilter ( )

protected

Definition at line 427 of file class.ilTestScoringByQuestionsGUI.php.

References ILIAS\Repository\access(), and showManScoringByQuestionParticipantsTable().

                                                         : void
     {
         $table = new ilTestManScoringParticipantsBySelectedQuestionAndPassTableGUI($this, $this->access);
         $table->resetOffset();
         $table->resetFilter();
         $this->showManScoringByQuestionParticipantsTable();
     }

Here is the call graph for this function:

◆ retrieveFeedback()

ilTestScoringByQuestionsGUI::retrieveFeedback	(	int	$active_id,
		int	$qst_id,
		int	$pass
	)

protected

Definition at line 680 of file class.ilTestScoringByQuestionsGUI.php.

References ilObjAdvancedEditing\_getUsedHTMLTagsAsString(), and ilUtil\stripSlashes().

Referenced by saveManScoringByQuestion().

                                                                                : ?string
     {
         $feedback = $this->testrequest->raw('feedback');
         if ($feedback === null || $feedback === '') {
             $feedback = $this->testrequest->raw('m_feedback');
         }
 
         if ($feedback === null || $feedback === '') {
             return null;
         }
 
         return ilUtil::stripSlashes(
             $feedback[$pass][$active_id][$qst_id],
             false,
             ilObjAdvancedEditing::_getUsedHTMLTagsAsString('assessment')
         );
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ saveFinalization()

ilTestScoringByQuestionsGUI::saveFinalization	(	array	$finalization,
		int	$active_id,
		int	$qst_id,
		int	$pass,
		?string	$feedback,
		bool	$is_single_feedback
	)

private

Parameters

array<numeric-string|int,array<numeric-string|int,array<numeric-string|int,bool>>> $finalization

Definition at line 701 of file class.ilTestScoringByQuestionsGUI.php.

References doesValueExistsInPostArray().

Referenced by saveManScoringByQuestion().

      : void {
         $finalized = false;
         if ($this->doesValueExistsInPostArray($finalization, $active_id, $qst_id, $pass)) {
             $finalized = $finalization[$pass][$active_id][$qst_id] ?? false;
         }
 
         $this->object->saveManualFeedback(
             $active_id,
             $qst_id,
             $pass,
             $feedback,
             $finalized,
             $is_single_feedback
         );
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ saveManScoringByQuestion()

ilTestScoringByQuestionsGUI::saveManScoringByQuestion ( bool $ajax = false )

protected

26.09.23 sk: Ok, this is a hack, but to do this right we need to go through the whole flow here. It is very convoluted and I'm unsure what would happen if I would really change something. This feature is in urgent need of refactoring and a repo.

Definition at line 154 of file class.ilTestScoringByQuestionsGUI.php.

References ILIAS\LTI\ToolProvider\$key, ilTestServiceGUI\$participantData, ilObjTestAccess\_getParticipantId(), assQuestion\_getReachedPoints(), ilObjUser\_lookupFullname(), assQuestion\_setReachedPoints(), ilLPStatusWrapper\_updateStatus(), ILIAS\Repository\ctrl(), ilTestParticipantData\getActiveIds(), ilObjTest\getSingleManualFeedback(), ilTestScoringGUI\getTestAccess(), ILIAS\FileDelivery\http(), IL_CAL_DATETIME, IL_CAL_UNIX, assQuestion\instantiateQuestion(), ILIAS\Repository\lng(), ilTestParticipantData\load(), ILIAS\Repository\object(), ILIAS\Repository\refinery(), retrieveFeedback(), saveFinalization(), ilTestParticipantData\setActiveIdsFilter(), ilTestParticipantData\setParticipantAccessFilter(), showManScoringByQuestionParticipantsTable(), and ILIAS\Repository\user().

Referenced by checkConstraintsBeforeSaving().

                                                                    : void
     {
         $transform_scoring = $this->refinery->custom()->transformation(function ($value) use (&$transform_scoring) {
             if (is_array($value)) {
                 foreach ($value as $key => $val) {
                     $value[$key] = $transform_scoring->transform($val);
                 }
             } elseif (is_string($value)) {
                 $value = $this->refinery->byTrying([
                     $this->refinery->kindlyTo()->float(),
                     $this->refinery->always(0.0)
                 ])->transform($value);
             } else {
                 throw new \ILIAS\Refinery\ConstraintViolationException(
                     sprintf('The value "%s" is no array or string.', var_export($value, true)),
                     'value_is_no_array_or_string',
                     var_export($value, true)
                 );
             }
 
             return $value;
         });
 
         $transform_finalization = $this->refinery->custom()->transformation(
             function ($value) use (&$transform_finalization) {
                 if (is_array($value)) {
                     foreach ($value as $key => $val) {
                         $value[$key] = $transform_finalization->transform($val);
                     }
                 } elseif (is_string($value)) {
                     $value = $this->refinery->byTrying([
                         $this->refinery->kindlyTo()->bool(),
                         $this->refinery->always(false)
                     ])->transform($value);
                 } else {
                     throw new \ILIAS\Refinery\ConstraintViolationException(
                         sprintf('The value "%s" is no array or string.', var_export($value, true)),
                         'value_is_no_array_or_string',
                         var_export($value, true)
                     );
                 }
 
                 return $value;
             }
         );
 
         $scoring = $this->http->wrapper()->post()->retrieve(
             'scoring',
             $this->refinery->byTrying([
                 $transform_scoring,
                 $this->refinery->always([])
             ])
         );
         $finalization = $this->http->wrapper()->post()->retrieve(
             'evaluated',
             $this->refinery->byTrying([
                 $transform_finalization,
                 $this->refinery->always([])
             ])
         );
 
         $pass = key($scoring);
         $active_data = current($scoring);
         $active_ids = array_keys($active_data);
 
         if (!$this->testAccess->checkScoreParticipantsAccessForActiveId(current($active_ids))) {
             if ($ajax) {
                 $this->http->saveResponse(
                     $this->http->response()->withBody(
                         \ILIAS\Filesystem\Stream\Streams::ofString($this->lng->txt('cannot_edit_test'))
                     )
                 );
                 $this->http->sendResponse();
                 $this->http->close();
             }
 
             $this->tpl->setOnScreenMessage('info', $this->lng->txt('cannot_edit_test'), true);
             $this->ctrl->redirectByClass('ilobjtestgui', 'infoScreen');
         }
 
         if ($scoring === []) {
             $this->tpl->setOnScreenMessage('failure', $this->lng->txt('tst_save_manscoring_failed_unknown'));
             $this->showManScoringByQuestionParticipantsTable();
             return;
         }
 
         $participantData = new ilTestParticipantData($this->db, $this->lng);
         $manPointsPost = [];
         $maxPointsByQuestionId = [];
 
         $participantData->setActiveIdsFilter($active_ids);
         $participantData->setParticipantAccessFilter(
             $this->participant_access_filter->getScoreParticipantsUserFilter($this->ref_id)
         );
         $participantData->load($this->object->getTestId());
 
         $changed_one = false;
         $lastAndHopefullyCurrentQuestionId = null;
 
         foreach ($participantData->getActiveIds() as $active_id) {
             $questions = $active_data[$active_id];
             if (!is_array($questions)) {
                 continue;
             }
 
             // check for existing test result data
             if (!$this->object->getTestResult($active_id, $pass)) {
                 continue;
             }
 
             $update_participant = false;
             $qst_id = null;
 
             foreach ($questions as $qst_id => $reached_points_string) {
                 $reached_points = $this->refinery->kindlyTo()->float()
                     ->transform($reached_points_string);
                 if (!isset($manPointsPost[$pass])) {
                     $manPointsPost[$pass] = [];
                 }
                 if (!isset($manPointsPost[$pass][$active_id])) {
                     $manPointsPost[$pass][$active_id] = [];
                 }
 
                 $feedback_text = $this->retrieveFeedback($active_id, $qst_id, $pass);
 
                 $current_feedback_info = ilObjTest::getSingleManualFeedback($active_id, $qst_id, $pass);
                 if (isset($current_feedback_info['finalized_evaluation']) && $current_feedback_info['finalized_evaluation'] === 1) {
                     $reached_points = assQuestion::_getReachedPoints($active_id, $qst_id, $pass);
                     $feedback_text = $current_feedback_info['feedback'];
                 }
 
                 $maxPointsByQuestionId[$qst_id] = $this->questioninfo->getMaximumPoints($qst_id);
                 $manPointsPost[$pass][$active_id][$qst_id] = $reached_points;
                 if ($reached_points > $maxPointsByQuestionId[$qst_id]) {
                     $this->tpl->setOnScreenMessage(
                         'failure',
                         sprintf($this->lng->txt('tst_save_manscoring_failed'), $pass + 1),
                         false
                     );
                     $this->showManScoringByQuestionParticipantsTable($manPointsPost);
                     return;
                 }
 
                 $this->saveFinalization(
                     $finalization,
                     (int) $active_id,
                     (int) $qst_id,
                     (int) $pass,
                     $feedback_text,
                     $ajax
                 );
                 // 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
                 $old_points = assQuestion::_getReachedPoints($active_id, $qst_id, $pass);
                 if ($reached_points !== $old_points) {
                     $update_participant = assQuestion::_setReachedPoints(
                         $active_id,
                         $qst_id,
                         $reached_points,
                         $maxPointsByQuestionId[$qst_id],
                         $pass,
                         true,
                         $this->object->areObligationsEnabled(),
                         $this->getTestAccess()->getTestId()
                     );
                 }
             }
 
             if ($update_participant) {
                 ilLPStatusWrapper::_updateStatus(
                     $this->object->getId(),
                     ilObjTestAccess::_getParticipantId($active_id)
                 );
             }
 
             $changed_one = true;
             $lastAndHopefullyCurrentQuestionId = $qst_id;
         }
 
         $correction_feedback = [];
         $correction_points = 0;
 
         if ($changed_one) {
             $qTitle = '';
 
             if ($lastAndHopefullyCurrentQuestionId) {
                 $question = assQuestion::instantiateQuestion($lastAndHopefullyCurrentQuestionId);
                 $qTitle = $question->getTitleForHTMLOutput();
             }
 
             $msg = sprintf(
                 $this->lng->txt('tst_saved_manscoring_by_question_successfully'),
                 $qTitle,
                 $pass + 1
             );
 
             $this->tpl->setOnScreenMessage('success', $msg, true);
 
             if (isset($active_id) && $lastAndHopefullyCurrentQuestionId) {
                 $correction_feedback = ilObjTest::getSingleManualFeedback(
                     $active_id,
                     $lastAndHopefullyCurrentQuestionId,
                     $pass
                 );
                 $correction_points = assQuestion::_getReachedPoints(
                     $active_id,
                     $lastAndHopefullyCurrentQuestionId,
                     $pass
                 );
             }
         }
 
         if ($ajax && is_array($correction_feedback)) {
             $finalized_by_usr_id = $correction_feedback['finalized_by_usr_id'];
             if (!$finalized_by_usr_id) {
                 $finalized_by_usr_id = $this->user->getId();
             }
             $correction_feedback['finalized_by'] = ilObjUser::_lookupFullname($finalized_by_usr_id);
             $correction_feedback['finalized_on_date'] = '';
 
             if (is_int($correction_feedback['finalized_tstamp'])) {
                 $time = new ilDateTime($correction_feedback['finalized_tstamp'], IL_CAL_UNIX);
                 $correction_feedback['finalized_on_date'] = $time->get(IL_CAL_DATETIME);
             }
 
             if (!$correction_feedback['feedback']) {
                 $correction_feedback['feedback'] = [];
             }
             if ($correction_feedback['finalized_evaluation'] == 1) {
                 $correction_feedback['finalized_evaluation'] = $this->lng->txt('yes');
             } else {
                 $correction_feedback['finalized_evaluation'] = $this->lng->txt('no');
                 $correction_feedback['finalized_by'] = '';
             }
 
             $this->http->saveResponse(
                 $this->http->response()->withBody(
                     \ILIAS\Filesystem\Stream\Streams::ofString(
                         json_encode(
                             [
                                 'feedback' => $correction_feedback,
                                 'points' => $correction_points,
                                 "translation" => [
                                     'yes' => $this->lng->txt('yes'),
                                     'no' => $this->lng->txt('no')
                                 ]
                             ],
                             JSON_THROW_ON_ERROR
                         )
                     )
                 )
             );
             $this->http->sendResponse();
             $this->http->close();
         }
 
         $this->showManScoringByQuestionParticipantsTable();
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ showManScoringByQuestionParticipantsTable()

ilTestScoringByQuestionsGUI::showManScoringByQuestionParticipantsTable ( array $manPointsPost = [] )

protected

Parameters

array $manPointsPost

Definition at line 46 of file class.ilTestScoringByQuestionsGUI.php.

References $data, ilTestServiceGUI\$participantData, assQuestion\_getReachedPoints(), ILIAS\Repository\access(), ILIAS\Repository\ctrl(), ilTestParticipantData\getActiveIds(), iljQueryUtil\initjQuery(), ilYuiUtil\initOverlay(), ilYuiUtil\initPanel(), ILIAS\Repository\int(), ILIAS\Repository\lng(), ilTestParticipantData\load(), ILIAS\Repository\object(), ilTestParticipantData\setActiveIdsFilter(), ilTestParticipantData\setParticipantAccessFilter(), ilTestTabsManager\TAB_ID_MANUAL_SCORING, and ILIAS\Repository\tabs().

Referenced by applyManScoringByQuestionFilter(), resetManScoringByQuestionFilter(), and saveManScoringByQuestion().

                                                                                            : void
     {
         $this->tabs->activateTab(ilTestTabsManager::TAB_ID_MANUAL_SCORING);
 
         if (!$this->testAccess->checkScoreParticipantsAccess()) {
             $this->tpl->setOnScreenMessage('info', $this->lng->txt('cannot_edit_test'), true);
             $this->ctrl->redirectByClass('ilobjtestgui', 'infoScreen');
         }
 
         iljQueryUtil::initjQuery();
         ilYuiUtil::initPanel();
         ilYuiUtil::initOverlay();
 
         $mathJaxSetting = new ilSetting('MathJax');
 
         if ($mathJaxSetting->get("enable")) {
             $this->tpl->addJavaScript($mathJaxSetting->get("path_to_mathjax"));
         }
 
         $this->tpl->addJavaScript("./Services/JavaScript/js/Basic.js");
         $this->tpl->addJavaScript("./Services/Form/js/Form.js");
         $this->tpl->addJavascript('./Services/UIComponent/Modal/js/Modal.js');
         $this->lng->toJSMap(['answer' => $this->lng->txt('answer')]);
 
         $table = new ilTestManScoringParticipantsBySelectedQuestionAndPassTableGUI($this, $this->access);
 
         $qst_id = (int) $table->getFilterItemByPostVar('question')->getValue();
         $passNr = $table->getFilterItemByPostVar('pass')->getValue();
         $finalized_filter = $table->getFilterItemByPostVar('finalize_evaluation')->getValue();
         $answered_filter = $table->getFilterItemByPostVar('only_answered')->getChecked();
         $table_data = [];
         $selected_questionData = null;
         $complete_feedback = $this->object->getCompleteManualFeedback($qst_id);
 
         if (is_numeric($qst_id)) {
             $info = $this->questioninfo->getQuestionInfo($qst_id);
             $selected_questionData = $info;
         }
 
         if ($selected_questionData && is_numeric($passNr)) {
             $data = $this->object->getCompleteEvaluationData(false);
             $participants = $data->getParticipants();
             $participantData = new ilTestParticipantData($this->db, $this->lng);
             $participantData->setActiveIdsFilter(array_keys($data->getParticipants()));
             $participantData->setParticipantAccessFilter(
                 $this->participant_access_filter->getScoreParticipantsUserFilter($this->ref_id)
             );
             $participantData->load($this->object->getTestId());
 
             foreach ($participantData->getActiveIds() as $active_id) {
                 $participant = $participants[$active_id];
                 $testResultData = $this->object->getTestResult($active_id, $passNr - 1);
 
                 foreach ($testResultData as $questionData) {
                     $feedback = [];
                     $is_answered = (bool) ($questionData['answered'] ?? false);
                     $finalized_evaluation = (bool) ($questionData['finalized_evaluation'] ?? false);
 
                     if (isset($complete_feedback[$active_id][$passNr - 1][$qst_id])) {
                         $feedback = $complete_feedback[$active_id][$passNr - 1][$qst_id];
                     }
 
                     if (!isset($questionData['qid'])
                         || $questionData['qid'] !== $selected_questionData['question_id']
                         || $finalized_filter === self::ONLY_FINALIZED && !$finalized_evaluation
                         || $finalized_filter === self::EXCEPT_FINALIZED && $finalized_evaluation
                         || $answered_filter === true && !$is_answered) {
                         continue;
                     }
 
                     $table_data[] = [
                         'pass_id' => $passNr - 1,
                         'active_id' => $active_id,
                         'qst_id' => $questionData['qid'],
                         'reached_points' => assQuestion::_getReachedPoints(
                             $active_id,
                             (int) $questionData['qid'],
                             $passNr - 1
                         ),
                         'maximum_points' => $this->questioninfo->getMaximumPoints((int) $questionData['qid']),
                         'name' => $participant->getName()
                     ] + $feedback;
                 }
             }
         } else {
             $table->disable('header');
         }
 
         $table->setTitle($this->lng->txt('tst_man_scoring_by_qst'));
 
         if ($selected_questionData) {
             $maxpoints = $this->questioninfo->getMaximumPoints((int) $selected_questionData['question_id']);
             $table->setCurQuestionMaxPoints($maxpoints);
             $maxpoints_txt = ' (' . $maxpoints . ' ' . $this->lng->txt('points') . ')';
             if ($maxpoints == 1) {
                 $maxpoints_txt = ' (' . $maxpoints . ' ' . $this->lng->txt('point') . ')';
             }
 
             $table->setTitle(
                 $this->lng->txt('tst_man_scoring_by_qst') . ': ' . $selected_questionData['title'] . $maxpoints_txt .
                 ' [' . $this->lng->txt('question_id_short') . ': ' . $selected_questionData['question_id'] . ']'
             );
         }
 
         $table->setData($table_data);
         $this->tpl->setContent($table->getHTML());
     }