ilTestServiceGUI Class Reference

Service GUI class for tests. More...

Inheritance diagram for ilTestServiceGUI:

Collaboration diagram for ilTestServiceGUI:

Public Member Functions
	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 ()

Protected Member Functions
	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
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 Attributes
ilTestObjectiveOrientedContainer	$objective_oriented_container
bool	$contextResultPresentation = true

Detailed Description

Service GUI class for tests.

This class is the parent class for all service classes which are called from ilObjTestGUI. This is mainly done to reduce the size of ilObjTestGUI to put command service functions into classes that could be called by ilCtrl.

ilTestServiceGUI: ilObjTestGUI

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 48 of file class.ilTestServiceGUI.php.

Member Function Documentation

buildPassDetailsOverviewTableGUI()

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

protected

Definition at line 969 of file class.ilTestServiceGUI.php.

References ILIAS\Repository\ctrl().

Referenced by getFilteredTestResult(), ilTestEvaluationGUI\getFilteredTestResult(), getPassDetailsOverviewTableGUI(), ilTestEvalObjectiveOrientedGUI\showVirtualPassResetTableFilterCmd(), and ilTestEvalObjectiveOrientedGUI\showVirtualPassSetTableFilterCmd().

     : ilTestPassDetailsOverviewTableGUI {
        return new ilTestPassDetailsOverviewTableGUI($this->ctrl, $target_gui, $target_cmd);
    }

Here is the call graph for this function:

Here is the caller graph for this function:

buildPassOverviewTableGUI()

ilTestServiceGUI::buildPassOverviewTableGUI

(

ilTestEvaluationGUI

$target_gui

)

Definition at line 315 of file class.ilTestServiceGUI.php.

References getObjectiveOrientedContainer().

Referenced by ilTestEvaluationGUI\outParticipantsResultsOverview(), ilTestEvaluationGUI\outUserListOfAnswerPasses(), and ilTestEvaluationGUI\outUserResultsOverview().

                                                                              : ilTestPassOverviewTableGUI
    {
        $table = new ilTestPassOverviewTableGUI($target_gui, '');

        $table->setPdfPresentationEnabled(
            $this->testrequest->isset('pdf') && $this->testrequest->raw('pdf') == 1
        );

        $table->setObjectiveOrientedPresentationEnabled(
            $this->getObjectiveOrientedContainer()->isObjectiveOrientedPresentationRequired()
        );

        return $table;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

buildQuestionRelatedObjectivesList()

ilTestServiceGUI::buildQuestionRelatedObjectivesList ( ilLOTestQuestionAdapter  $objectives_adapter, ilTestQuestionSequence  $test_sequence  )

protected

Definition at line 1002 of file class.ilTestServiceGUI.php.

References ilLOTestQuestionAdapter\buildQuestionRelatedObjectiveList().

Referenced by ilTestSubmissionReviewGUI\buildUserReviewOutput(), getPassOverviewTableData(), getResultsOfUserOutput(), outCorrectSolution(), ilTestEvaluationGUI\outUserListOfAnswerPasses(), ilTestEvaluationGUI\outUserPassDetails(), and ilTestEvalObjectiveOrientedGUI\showVirtualPassCmd().

     : ilTestQuestionRelatedObjectivesList {
        $questionRelatedObjectivesList = new ilTestQuestionRelatedObjectivesList();

        $objectives_adapter->buildQuestionRelatedObjectiveList($test_sequence, $questionRelatedObjectivesList);

        return $questionRelatedObjectivesList;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

buildUserTestResultsToolbarGUI()

ilTestServiceGUI::buildUserTestResultsToolbarGUI ( )

protected

Returns

ilTestResultsToolbarGUI

Definition at line 1076 of file class.ilTestServiceGUI.php.

References $toolbar, ILIAS\Repository\ctrl(), and ILIAS\Repository\lng().

Referenced by ilTestEvaluationGUI\multiParticipantsPassDetails(), ilTestEvaluationGUI\outParticipantsPassDetails(), ilTestEvaluationGUI\outParticipantsResultsOverview(), ilTestEvaluationGUI\outUserPassDetails(), ilTestEvaluationGUI\outUserResultsOverview(), and ilTestEvalObjectiveOrientedGUI\showVirtualPassCmd().

                                                       : ilTestResultsToolbarGUI
    {
        $toolbar = new ilTestResultsToolbarGUI($this->ctrl, $this->tpl, $this->lng);

        return $toolbar;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

executeCommand()

ilTestServiceGUI::executeCommand

(

)

execute command

Definition at line 291 of file class.ilTestServiceGUI.php.

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

    {
        $cmd = $this->ctrl->getCmd();
        $next_class = $this->ctrl->getNextClass($this);

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

Here is the call graph for this function:

getAdditionalUsrDataHtmlAndPopulateWindowTitle()

ilTestServiceGUI::getAdditionalUsrDataHtmlAndPopulateWindowTitle	(		$testSession,
			$active_id,
			$overwrite_anonymity = false
	)

Returns the user data for a test results output.

Parameters

	ilTestSession
integer	$user_id	The user ID of the user
boolean	$overwrite_anonymity	TRUE if the anonymity status should be overwritten, FALSE otherwise

Returns

string HTML code of the user data for the test results public

Definition at line 628 of file class.ilTestServiceGUI.php.

References ilObjUser\_lookupLogin(), ilObjUser\getMatriculation(), getObjectiveOrientedContainer(), ILIAS\Repository\lng(), ILIAS\Repository\object(), and ilObjUser\setLastname().

Referenced by getResultsOfUserOutput(), ilTestEvaluationGUI\outParticipantsResultsOverview(), ilTestEvaluationGUI\outUserListOfAnswerPasses(), ilTestEvaluationGUI\outUserResultsOverview(), and ilTestPlayerAbstractGUI\showListOfAnswers().

                                                                                                                          : string
    {
        if (!is_object($testSession)) {
            throw new InvalidArgumentException('Not an object, expected ilTestSession');
        }
        $template = new ilTemplate("tpl.il_as_tst_results_userdata.html", true, true, "Modules/Test");
        $user_id = $this->object->_getUserIdFromActiveId($active_id);
        if (strlen(ilObjUser::_lookupLogin($user_id)) > 0) {
            $user = new ilObjUser($user_id);
        } else {
            $user = new ilObjUser();
            $user->setLastname($this->lng->txt("deleted_user"));
        }
        $t = $testSession->getSubmittedTimestamp();
        if (!$t) {
            $t = $this->object->_getLastAccess($testSession->getActiveId());
        }

        if ($this->getObjectiveOrientedContainer()->isObjectiveOrientedPresentationRequired()) {
            $uname = $this->object->userLookupFullName($user_id, $overwrite_anonymity);
            $template->setCurrentBlock("name");
            $template->setVariable('TXT_USR_NAME', $this->lng->txt("name"));
            $template->setVariable('VALUE_USR_NAME', $uname);
            $template->parseCurrentBlock();
        }

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

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

        $template->setVariable("TXT_TEST_TITLE", $this->lng->txt("title"));
        $template->setVariable("VALUE_TEST_TITLE", $this->object->getTitle());

        // change the pagetitle (tab title or title in title bar of window)
        $pagetitle = $this->object->getTitle() . $title_matric . $title_client;
        $this->tpl->setHeaderPageTitle($pagetitle);

        return $template->get();
    }

Here is the call graph for this function:

Here is the caller graph for this function:

getCommand()

ilTestServiceGUI::getCommand

(

$cmd

)

Retrieves the ilCtrl command.

public

Definition at line 310 of file class.ilTestServiceGUI.php.

Referenced by ilTestOutputGUI\executeCommand(), and executeCommand().

    {
        return $cmd;
    }

Here is the caller graph for this function:

getCorrectSolutionOutput()

ilTestServiceGUI::getCorrectSolutionOutput	(		$question_id,
			$active_id,
			$pass,
		ilTestQuestionRelatedObjectivesList	$objectives_list = null
	)

Returns an output of the solution to an answer compared to the correct solution.

Parameters

integer	$question_id	Database ID of the question
integer	$active_id	Active ID of the active user
integer	$pass	Test pass

Returns

string HTML code of the correct solution comparison public

Definition at line 696 of file class.ilTestServiceGUI.php.

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

Referenced by outCorrectSolution(), and ilTestPlayerAbstractGUI\outCorrectSolution().

                                                                                                                                          : string
    {
        $ilUser = $this->user;

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

        $template = new ilTemplate("tpl.il_as_tst_correct_solution_output.html", true, true, "Modules/Test");
        $show_question_only = ($this->object->getShowSolutionAnswersOnly()) ? true : false;
        $result_output = $question_gui->getSolutionOutput($active_id, $pass, true, false, $show_question_only, $this->object->getShowSolutionFeedback(), false, false, true);
        $best_output = $question_gui->getSolutionOutput($active_id, $pass, false, false, $show_question_only, false, true, false, false);
        if ($this->object->getShowSolutionFeedback() && $this->testrequest->raw('cmd') != 'outCorrectSolution') {
            $specificAnswerFeedback = $question_gui->getSpecificFeedbackOutput(
                $question_gui->object->fetchIndexedValuesFromValuePairs(
                    $question_gui->object->getSolutionValues($active_id, $pass)
                )
            );
            if (strlen($specificAnswerFeedback)) {
                $template->setCurrentBlock("outline_specific_feedback");
                $template->setVariable("OUTLINE_SPECIFIC_FEEDBACK", $specificAnswerFeedback);
                $template->parseCurrentBlock();
            }
        }
        $template->setVariable("TEXT_YOUR_SOLUTION", $this->lng->txt("tst_your_answer_was"));
        $template->setVariable("TEXT_SOLUTION_OUTPUT", $this->lng->txt("tst_your_answer_was")); // Mantis 28646. I don't really know why Ingmar renamed the placeholder, so
        // I set both old and new since the old one is set as well in several places.
        $maxpoints = $question_gui->object->getMaximumPoints();
        if ($maxpoints == 1) {
            $template->setVariable("QUESTION_TITLE", $this->object->getQuestionTitle($question_gui->object->getTitleForHTMLOutput()) . " (" . $maxpoints . " " . $this->lng->txt("point") . ")");
        } else {
            $template->setVariable("QUESTION_TITLE", $this->object->getQuestionTitle($question_gui->object->getTitleForHTMLOutput()) . " (" . $maxpoints . " " . $this->lng->txt("points") . ")");
        }
        if ($objectives_list !== null) {
            $objectives = $this->lng->txt('tst_res_lo_objectives_header') . ': ';
            $objectives .= $objectives_list->getQuestionRelatedObjectiveTitles($question_gui->object->getId());
            $template->setVariable('OBJECTIVES', $objectives);
        }
        $template->setVariable("SOLUTION_OUTPUT", $result_output);
        $template->setVariable("RECEIVED_POINTS", sprintf($this->lng->txt("you_received_a_of_b_points"), $question_gui->object->getReachedPoints($active_id, $pass), $maxpoints));
        $template->setVariable("FORMACTION", $this->ctrl->getFormAction($this));
        $template->setVariable("BACKLINK_TEXT", "<< " . $this->lng->txt("back"));
        return $template->get();
    }

Here is the call graph for this function:

Here is the caller graph for this function:

getFilteredTestResult()

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

protected

Definition at line 1013 of file class.ilTestServiceGUI.php.

References $component_repository, $db, $ilDB, buildPassDetailsOverviewTableGUI(), ILIAS\Repository\lng(), ILIAS\Repository\object(), ilAssQuestionList\QUESTION_INSTANCE_TYPE_DUPLICATES, and ILIAS\Repository\refinery().

     : array {
        $ilDB = $this->db;
        $component_repository = $this->component_repository;

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

        $questionList = new ilAssQuestionList($ilDB, $this->lng, $this->refinery, $component_repository);

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

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

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

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

        $questionList->load();

        $filteredTestResult = [];

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

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

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

            $filteredTestResult[] = $resultItemValue;
        }

        return $filteredTestResult;
    }

Here is the call graph for this function:

getGradingMessageBuilder()

ilTestServiceGUI::getGradingMessageBuilder ( int  $active_id )

protected

Definition at line 993 of file class.ilTestServiceGUI.php.

References ILIAS\Repository\lng().

Referenced by getResultsOfUserOutput(), ilTestEvaluationGUI\outParticipantsPassDetails(), ilTestEvaluationGUI\outParticipantsResultsOverview(), ilTestEvaluationGUI\outUserPassDetails(), and ilTestEvaluationGUI\outUserResultsOverview().

                                                               : ilTestGradingMessageBuilder
    {
        $gradingMessageBuilder = new ilTestGradingMessageBuilder($this->lng, $this->tpl, $this->object);

        $gradingMessageBuilder->setActiveId($active_id);

        return $gradingMessageBuilder;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

getObject()

ilTestServiceGUI::getObject

(

)

Definition at line 1187 of file class.ilTestServiceGUI.php.

Referenced by ilTestManScoringParticipantsBySelectedQuestionAndPassTableGUI\__construct(), ilTestPlayerAbstractGUI\checkReadAccess(), ilTestOutputGUI\discardSolutionCmd(), ilTestPlayerAbstractGUI\outProcessingTime(), ilTestPlayerAbstractGUI\outQuestionSummaryCmd(), and ilTestSubmissionReviewGUI\show().

    {
        return $this->object;
    }

Here is the caller graph for this function:

getObjectiveOrientedContainer()

ilTestServiceGUI::getObjectiveOrientedContainer

(

)

Returns

ilTestObjectiveOrientedContainer

Definition at line 283 of file class.ilTestServiceGUI.php.

References $objective_oriented_container.

Referenced by buildPassOverviewTableGUI(), ilTestSubmissionReviewGUI\buildUserReviewOutput(), ilTestOutputGUI\executeCommand(), getAdditionalUsrDataHtmlAndPopulateWindowTitle(), getPassOverviewTableData(), getResultsOfUserOutput(), isGradingMessageRequired(), outCorrectSolution(), ilTestEvaluationGUI\outParticipantsResultsOverview(), ilTestEvaluationGUI\outUserListOfAnswerPasses(), ilTestEvaluationGUI\outUserPassDetails(), ilTestEvaluationGUI\outUserResultsOverview(), ilTestPlayerAbstractGUI\redirectBackCmd(), ilTestPlayerAbstractGUI\showListOfAnswers(), ilTestEvalObjectiveOrientedGUI\showVirtualPassCmd(), and ilTestOutputGUI\startTestCmd().

                                                   : ?ilTestObjectiveOrientedContainer
    {
        return $this->objective_oriented_container;
    }

Here is the caller graph for this function:

getParticipantData()

ilTestServiceGUI::getParticipantData

(

)

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

References $participantData.

                                        : ilTestParticipantData
    {
        return $this->participantData;
    }

getPassDetailsOverviewTableGUI()

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  )

protected

Definition at line 543 of file class.ilTestServiceGUI.php.

References ILIAS\LTI\ToolProvider\$key, buildPassDetailsOverviewTableGUI(), ILIAS\Repository\ctrl(), and ILIAS\Repository\object().

Referenced by getResultsOfUserOutput(), and ilTestEvalObjectiveOrientedGUI\showVirtualPassCmd().

     : ilTestPassDetailsOverviewTableGUI {
        $this->ctrl->setParameter($target_gui, 'active_id', $active_id);
        $this->ctrl->setParameter($target_gui, 'pass', $pass);

        $table_gui = $this->buildPassDetailsOverviewTableGUI($target_gui, $target_cmd);
        $table_gui->setShowHintCount($this->object->isOfferingQuestionHintsEnabled());

        if ($objectives_list !== null) {
            $table_gui->setQuestionRelatedObjectivesList($objectives_list);
            $table_gui->setObjectiveOrientedPresentationEnabled(true);
        }

        $table_gui->setMultipleObjectivesInvolved($multiple_objectives_involved);

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

        $users_question_solutions = [];

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

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

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

            $users_question_solutions[$key] = $val;
        }

        $table_gui->initColumns();

        $table_gui->setFilterCommand($target_cmd . 'SetTableFilter');
        $table_gui->setResetCommand($target_cmd . 'ResetTableFilter');

        $table_gui->setData($users_question_solutions);

        return $table_gui;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

getPassListOfAnswers()

ilTestServiceGUI::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.

Parameters

array	$result_array	An array containing the results of the users test pass (generated by ilObjTest::getTestResult)
integer	$active_id	Active ID of the active user
integer	$pass	Test pass
boolean	$show_solutions	TRUE, if the solution output should be shown in the answers, FALSE otherwise

Returns

string HTML code of the list of answers public

Definition at line 340 of file class.ilTestServiceGUI.php.

References $objectives, isContextResultPresentation(), ILIAS\Repository\lng(), and ILIAS\Repository\object().

Referenced by getResultsOfUserOutput(), and ilTestEvaluationGUI\outUserListOfAnswerPasses().

     : string {
        $maintemplate = new ilTemplate("tpl.il_as_tst_list_of_answers.html", true, true, "Modules/Test");

        $counter = 1;
        // output of questions with solutions
        foreach ($result_array as $question_data) {
            if (!array_key_exists('workedthrough', $question_data)) {
                $question_data['workedthrough'] = 0;
            }
            if (!array_key_exists('qid', $question_data)) {
                $question_data['qid'] = -1;
            }

            if (($question_data["workedthrough"] == 1) || ($only_answered_questions == false)) {
                $template = new ilTemplate("tpl.il_as_qpl_question_printview.html", true, true, "Modules/TestQuestionPool");
                $question_id = $question_data["qid"] ?? null;
                if ($question_id !== null
                    && $question_id !== -1
                    && is_numeric($question_id)) {
                    $maintemplate->setCurrentBlock("printview_question");
                    $question_gui = $this->object->createQuestionGUI("", $question_id);

                    $question_gui->object->setShuffler($this->shuffler->getAnswerShuffleFor(
                        (int) $question_id,
                        (int) $active_id,
                        (int) $pass
                    ));
                    if (is_object($question_gui)) {
                        if ($anchorNav) {
                            $template->setCurrentBlock('block_id');
                            $template->setVariable('BLOCK_ID', "detailed_answer_block_act_{$active_id}_qst_{$question_id}");
                            $template->parseCurrentBlock();

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

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

                        if ($objectives_list !== null) {
                            $objectives = $this->lng->txt('tst_res_lo_objectives_header') . ': ';
                            $objectives .= $objectives_list->getQuestionRelatedObjectiveTitles($question_gui->object->getId());
                            $template->setVariable("OBJECTIVES", $objectives);
                        }

                        $show_question_only = ($this->object->getShowSolutionAnswersOnly()) ? true : false;

                        $show_feedback = $this->isContextResultPresentation() && $this->object->getShowSolutionFeedback();
                        $show_best_solution = $this->isContextResultPresentation() && $show_solutions;
                        $show_graphical_output = $this->isContextResultPresentation();

                        if ($show_best_solution) {
                            $compare_template = new ilTemplate('tpl.il_as_tst_answers_compare.html', true, true, 'Modules/Test');
                            $test_session = $this->testSessionFactory->getSession($active_id);
                            if ($pass <= $test_session->getLastFinishedPass()) {
                                $compare_template->setVariable("HEADER_PARTICIPANT", $this->lng->txt('tst_header_participant'));
                            } else {
                                $compare_template->setVariable("HEADER_PARTICIPANT", $this->lng->txt('tst_header_participant_no_answer'));
                            }

                            $compare_template->setVariable("HEADER_SOLUTION", $this->lng->txt('tst_header_solution'));
                            $result_output = $question_gui->getSolutionOutput($active_id, $pass, $show_graphical_output, false, $show_question_only, $show_feedback);
                            $best_output = $question_gui->getSolutionOutput($active_id, $pass, false, false, $show_question_only, false, true);

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

                        $maintemplate->setCurrentBlock("printview_question");
                        $maintemplate->setVariable("QUESTION_PRINTVIEW", $template->get());
                        $maintemplate->parseCurrentBlock();
                        $counter++;
                    }
                }
            }
        }

        if ($testResultHeaderLabelBuilder !== null) {
            if ($pass !== null) {
                $headerText = $testResultHeaderLabelBuilder->getListOfAnswersHeaderLabel($pass + 1);
            } else {
                $headerText = $testResultHeaderLabelBuilder->getVirtualListOfAnswersHeaderLabel();
            }
        } else {
            $headerText = '';
        }

        $maintemplate->setVariable("RESULTS_OVERVIEW", $headerText);
        return $maintemplate->get();
    }

Here is the call graph for this function:

Here is the caller graph for this function:

getPassListOfAnswersWithScoring()

ilTestServiceGUI::getPassListOfAnswersWithScoring	(	&	$result_array,
			$active_id,
			$pass,
			$show_solutions = false
	)

Returns the list of answers of a users test pass and offers a scoring option.

Parameters

array	$result_array	An array containing the results of the users test pass (generated by ilObjTest::getTestResult)
integer	$active_id	Active ID of the active user
integer	$pass	Test pass
boolean	$show_solutions	TRUE, if the solution output should be shown in the answers, FALSE otherwise

Returns

string HTML code of the list of answers public

Deprecated:

Definition at line 468 of file class.ilTestServiceGUI.php.

References ilObjAssessmentFolder\_getManualScoring(), assQuestion\_getReachedPoints(), ILIAS\Repository\ctrl(), ilObjTest\getSingleManualFeedback(), ilYuiUtil\initDomEvent(), ILIAS\Repository\lng(), ILIAS\Repository\object(), and ilLegacyFormElementsUtil\prepareFormOutput().

                                                                                                               : string
    {
        $maintemplate = new ilTemplate("tpl.il_as_tst_list_of_answers.html", true, true, "Modules/Test");
        $scoring = ilObjAssessmentFolder::_getManualScoring();

        $counter = 1;
        // output of questions with solutions
        foreach ($result_array as $question_data) {
            $question = $question_data["qid"];
            if (is_numeric($question)) {
                $question_gui = $this->object->createQuestionGUI("", $question);
                if (in_array($question_gui->object->getQuestionTypeID(), $scoring)) {
                    $template = new ilTemplate("tpl.il_as_qpl_question_printview.html", true, true, "Modules/TestQuestionPool");
                    $scoretemplate = new ilTemplate("tpl.il_as_tst_manual_scoring_points.html", true, true, "Modules/Test");
                    #mbecker: No such block. $this->tpl->setCurrentBlock("printview_question");
                    $template->setVariable("COUNTER_QUESTION", $counter . ". ");
                    $template->setVariable("QUESTION_TITLE", $this->object->getQuestionTitle($question_gui->object->getTitleForHTMLOutput()));
                    $points = $question_gui->object->getMaximumPoints();
                    if ($points == 1) {
                        $template->setVariable("QUESTION_POINTS", $points . " " . $this->lng->txt("point"));
                    } else {
                        $template->setVariable("QUESTION_POINTS", $points . " " . $this->lng->txt("points"));
                    }

                    $show_question_only = ($this->object->getShowSolutionAnswersOnly()) ? true : false;
                    $result_output = $question_gui->getSolutionOutput($active_id, $pass, $show_solutions, false, $show_question_only, $this->object->getShowSolutionFeedback(), false, true);

                    $solout = $question_gui->object->getSuggestedSolutionOutput();
                    if (strlen($solout)) {
                        $scoretemplate->setCurrentBlock("suggested_solution");
                        $scoretemplate->setVariable("TEXT_SUGGESTED_SOLUTION", $this->lng->txt("solution_hint"));
                        $scoretemplate->setVariable("VALUE_SUGGESTED_SOLUTION", $solout);
                        $scoretemplate->parseCurrentBlock();
                    }

                    $scoretemplate->setCurrentBlock("feedback");
                    $scoretemplate->setVariable("FEEDBACK_NAME_INPUT", $question);
                    $feedback = ilObjTest::getSingleManualFeedback((int) $active_id, (int) $question, (int) $pass)['feedback'] ?? '';
                    $scoretemplate->setVariable(
                        "VALUE_FEEDBACK",
                        ilLegacyFormElementsUtil::prepareFormOutput(
                            $this->object->prepareTextareaOutput($feedback, true)
                        )
                    );
                    $scoretemplate->setVariable("TEXT_MANUAL_FEEDBACK", $this->lng->txt("set_manual_feedback"));
                    $scoretemplate->parseCurrentBlock();

                    $scoretemplate->setVariable("NAME_INPUT", $question);
                    $this->ctrl->setParameter($this, "active_id", $active_id);
                    $this->ctrl->setParameter($this, "pass", $pass);
                    $scoretemplate->setVariable("FORMACTION", $this->ctrl->getFormAction($this, "manscoring"));
                    $scoretemplate->setVariable("LABEL_INPUT", $this->lng->txt("tst_change_points_for_question"));
                    $scoretemplate->setVariable("VALUE_INPUT", " value=\"" . assQuestion::_getReachedPoints($active_id, $question_data["qid"], $pass) . "\"");
                    $scoretemplate->setVariable("VALUE_SAVE", $this->lng->txt("save"));

                    $template->setVariable("SOLUTION_OUTPUT", $result_output);
                    $maintemplate->setCurrentBlock("printview_question");
                    $maintemplate->setVariable("QUESTION_PRINTVIEW", $template->get());
                    $maintemplate->setVariable("QUESTION_SCORING", $scoretemplate->get());
                    $maintemplate->parseCurrentBlock();
                }
                $counter++;
            }
        }
        if ($counter == 1) {
            // no scorable questions found
            $maintemplate->setVariable("NO_QUESTIONS_FOUND", $this->lng->txt("manscoring_questions_not_found"));
        }
        $maintemplate->setVariable("RESULTS_OVERVIEW", sprintf($this->lng->txt("manscoring_results_pass"), $pass + 1));

        ilYuiUtil::initDomEvent();

        return $maintemplate->get();
    }

Here is the call graph for this function:

getPassOverviewTableData()

ilTestServiceGUI::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.

Parameters

ilTestSession	$testSession	the current test session
array	$passes	An integer array of test runs
boolean	$withResults	$withResults tells the method to include all scoring data into the returned row

Returns

array The array contains the date of the requested row

Definition at line 187 of file class.ilTestServiceGUI.php.

References $data, buildQuestionRelatedObjectivesList(), ilTestSession\getActiveId(), ilLOTestQuestionAdapter\getInstance(), getObjectiveOrientedContainer(), ilAssQuestionHintTracking\getRequestRequestStatisticDataRegisterByActiveId(), and ILIAS\Repository\object().

Referenced by ilTestEvaluationGUI\outParticipantsResultsOverview(), ilTestEvaluationGUI\outUserListOfAnswerPasses(), and ilTestEvaluationGUI\outUserResultsOverview().

                                                                                               : array
    {
        $data = [];

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

            $objectives_adapter = ilLOTestQuestionAdapter::getInstance($testSession);
        } else {
            $considerHiddenQuestions = true;
        }

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

        $questionHintRequestRegister = ilAssQuestionHintTracking::getRequestRequestStatisticDataRegisterByActiveId(
            $testSession->getActiveId()
        );

        foreach ($passes as $pass) {
            $row = [
                'scored' => false,
                'pass' => $pass,
                'date' => ilObjTest::lookupLastTestPassAccess($testSession->getActiveId(), $pass)
            ];
            $considerOptionalQuestions = true;

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

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

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

                $objectives_list = $this->buildQuestionRelatedObjectivesList($objectives_adapter, $test_sequence);
                $objectives_list->loadObjectivesTitles();

                $row['objectives'] = $objectives_list->getUniqueObjectivesStringForQuestions($test_sequence->getUserSequenceQuestions());
            }

            if ($withResults) {
                $result_array = $this->object->getTestResult($testSession->getActiveId(), $pass, false, $considerHiddenQuestions, $considerOptionalQuestions);

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

                    $requestData = $questionHintRequestRegister->getRequestByTestPassIndexAndQuestionId($pass, $question['qid']);

                    if ($requestData instanceof ilAssQuestionHintRequestStatisticData && $result_array[$resultStructKEY]['requested_hints'] === null) {
                        $result_array['pass']['total_requested_hints'] += $requestData->getRequestsCount();

                        $result_array[$resultStructKEY]['requested_hints'] = $requestData->getRequestsCount();
                        $result_array[$resultStructKEY]['hint_points'] = $requestData->getRequestsPoints();
                    }
                }

                if (!$result_array['pass']['total_max_points']) {
                    $row['percentage'] = 0;
                } else {
                    $row['percentage'] = ($result_array['pass']['total_reached_points'] / $result_array['pass']['total_max_points']) * 100;
                }

                $row['max_points'] = $result_array['pass']['total_max_points'];
                $row['reached_points'] = $result_array['pass']['total_reached_points'];
                $row['scored'] = ($pass == $scoredPass);
                $row['num_workedthrough_questions'] = $result_array['pass']['num_workedthrough'];
                $row['num_questions_total'] = $result_array['pass']['num_questions_total'];

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

            $data[] = $row;
        }

        return $data;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

getQuestionResultForTestUsers()

ilTestServiceGUI::getQuestionResultForTestUsers	(	int	$question_id,
		int	$test_id
	)

Definition at line 933 of file class.ilTestServiceGUI.php.

References getResultsHeadUserAndPass(), ILIAS\Repository\object(), and assQuestionGUI\RENDER_PURPOSE_PRINT_PDF.

Referenced by ilTestEvaluationGUI\exportQuestionForAllParticipants().

                                                                                 : string
    {
        $question_gui = $this->object->createQuestionGUI("", $question_id);

        $this->object->setAccessFilteredParticipantList(
            $this->object->buildStatisticsAccessFilteredParticipantList()
        );

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

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

Here is the call graph for this function:

Here is the caller graph for this function:

getResultsHeadUserAndPass()

ilTestServiceGUI::getResultsHeadUserAndPass	(		$active_id,
			$pass
	)

Returns the user and pass data for a test results output.

Parameters

integer

$active_id

The active ID of the user

Returns

string HTML code of the user data for the test results public

Definition at line 894 of file class.ilTestServiceGUI.php.

References ilObjUser\_lookupLogin(), ilObjUser\getMatriculation(), ILIAS\Repository\lng(), ILIAS\Repository\object(), and ilObjUser\setLastname().

Referenced by getQuestionResultForTestUsers().

                                                                : string
    {
        $template = new ilTemplate("tpl.il_as_tst_results_head_user_pass.html", true, true, "Modules/Test");
        $user_id = $this->object->_getUserIdFromActiveId($active_id);
        if (strlen(ilObjUser::_lookupLogin($user_id)) > 0) {
            $user = new ilObjUser($user_id);
        } else {
            $user = new ilObjUser();
            $user->setLastname($this->lng->txt("deleted_user"));
        }
        if (strlen($user->getMatriculation()) && (($this->object->getAnonymity() == false))) {
            $template->setCurrentBlock("user_matric");
            $template->setVariable("TXT_USR_MATRIC", $this->lng->txt("matriculation"));
            $template->parseCurrentBlock();
            $template->setCurrentBlock("user_matric_value");
            $template->setVariable("VALUE_USR_MATRIC", $user->getMatriculation());
            $template->parseCurrentBlock();
            $template->touchBlock("user_matric_separator");
        }

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

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

Here is the call graph for this function:

Here is the caller graph for this function:

getResultsOfUserOutput()

ilTestServiceGUI::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.

Parameters

ilTestSession	$testSession
integer	$active_id
integer	$pass
boolean	$show_pass_details
boolean	$show_answers
boolean	$show_question_only
boolean	$show_reached_points	public

Definition at line 752 of file class.ilTestServiceGUI.php.

References buildQuestionRelatedObjectivesList(), ilSession\get(), ilTestSession\getActiveId(), getAdditionalUsrDataHtmlAndPopulateWindowTitle(), getGradingMessageBuilder(), ilLOTestQuestionAdapter\getInstance(), getObjectiveOrientedContainer(), ilTestSession\getObjectiveOrientedContainerId(), getPassDetailsOverviewTableGUI(), getPassListOfAnswers(), getResultsSignature(), ilTestSession\getUserId(), isGradingMessageRequired(), ILIAS\Repository\lng(), ilObjTest\lookupExamId(), ILIAS\Repository\object(), populateExamId(), and populatePassFinishDate().

     : string {
        $template = new ilTemplate("tpl.il_as_tst_results_participant.html", true, true, "Modules/Test");

        if ($this->participantData instanceof ilTestParticipantData) {
            $user_id = $this->participantData->getUserIdByActiveId($active_id);
            $uname = $this->participantData->getConcatedFullnameByActiveId($active_id, false);
        } else {
            $user_id = $this->object->_getUserIdFromActiveId($active_id);
            $uname = $this->object->userLookupFullName($user_id, true);
        }

        if ($this->object->getAnonymity()) {
            $uname = $this->lng->txt('anonymous');
        }

        if ((($this->testrequest->isset('pass')) && (strlen($this->testrequest->raw("pass")) > 0)) || (!is_null($pass))) {
            if (is_null($pass)) {
                $pass = $this->testrequest->raw("pass");
            }
        }

        if (!is_null($pass)) {
            $testResultHeaderLabelBuilder = new ilTestResultHeaderLabelBuilder($this->lng, $this->obj_cache);
            $objectives_list = null;

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

                $objectives_adapter = ilLOTestQuestionAdapter::getInstance($testSession);

                $objectives_list = $this->buildQuestionRelatedObjectivesList($objectives_adapter, $test_sequence);
                $objectives_list->loadObjectivesTitles();

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

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

            $user_id = $this->object->_getUserIdFromActiveId($active_id);
            $showAllAnswers = true;
            if ($this->object->isExecutable($testSession, $user_id)) {
                $showAllAnswers = false;
            }
            if ($show_answers) {
                $list_of_answers = $this->getPassListOfAnswers(
                    $result_array,
                    $active_id,
                    $pass,
                    ilSession::get('tst_results_show_best_solutions'),
                    $showAllAnswers,
                    $show_question_only,
                    $show_reached_points,
                    $show_pass_details,
                    $objectives_list,
                    $testResultHeaderLabelBuilder
                );
                $template->setVariable("LIST_OF_ANSWERS", $list_of_answers);
            }

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

            $signature = $this->getResultsSignature();
            $template->setVariable("SIGNATURE", $signature);

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

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

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

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

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


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

        $this->populateExamId($template, (int) $active_id, (int) $pass);
        $this->populatePassFinishDate($template, ilObjTest::lookupLastTestPassAccess($active_id, $pass));

        return $template->get();
    }

Here is the call graph for this function:

getResultsSignature()

ilTestServiceGUI::getResultsSignature

(

)

Returns HTML code for a signature field.

Returns

string HTML code of the date and signature field for the test results public

Definition at line 602 of file class.ilTestServiceGUI.php.

References ilDatePresentation\formatDate(), ilUtil\getImagePath(), IL_CAL_UNIX, ILIAS\Repository\lng(), ILIAS\Repository\object(), ilDatePresentation\setUseRelativeDates(), and ilDatePresentation\useRelativeDates().

Referenced by getResultsOfUserOutput(), ilTestEvaluationGUI\outUserListOfAnswerPasses(), ilTestEvaluationGUI\outUserPassDetails(), and ilTestPlayerAbstractGUI\showListOfAnswers().

                                         : string
    {
        if ($this->object->getShowSolutionSignature() && !$this->object->getAnonymity()) {
            $template = new ilTemplate("tpl.il_as_tst_results_userdata_signature.html", true, true, "Modules/Test");
            $template->setVariable("TXT_DATE", $this->lng->txt("date"));
            $old_value = ilDatePresentation::useRelativeDates();
            ilDatePresentation::setUseRelativeDates(false);
            $template->setVariable("VALUE_DATE", ilDatePresentation::formatDate(new ilDate(time(), IL_CAL_UNIX)));
            ilDatePresentation::setUseRelativeDates($old_value);
            $template->setVariable("TXT_SIGNATURE", $this->lng->txt("tst_signature"));
            $template->setVariable("IMG_SPACER", ilUtil::getImagePath("media/spacer.png"));
            return $template->get();
        } else {
            return "";
        }
    }

Here is the call graph for this function:

Here is the caller graph for this function:

isContextResultPresentation()

ilTestServiceGUI::isContextResultPresentation

(

)

Definition at line 101 of file class.ilTestServiceGUI.php.

References $contextResultPresentation.

Referenced by getPassListOfAnswers().

                                                 : bool
    {
        return $this->contextResultPresentation;
    }

Here is the caller graph for this function:

isGradingMessageRequired()

ilTestServiceGUI::isGradingMessageRequired ( )

protected

Definition at line 976 of file class.ilTestServiceGUI.php.

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

Referenced by getResultsOfUserOutput(), ilTestEvaluationGUI\outParticipantsPassDetails(), ilTestEvaluationGUI\outParticipantsResultsOverview(), ilTestEvaluationGUI\outUserPassDetails(), and ilTestEvaluationGUI\outUserResultsOverview().

                                                 : bool
    {
        $session = $this->testSessionFactory->getSession();
        if ($this->getObjectiveOrientedContainer()->isObjectiveOrientedPresentationRequired()
            || $this->object->getScoreSettings()->getScoringSettings()->getPassScoring() === SCORE_LAST_PASS
                && $session->getLastFinishedPass() < $session->getLastStartedPass()) {
            return false;
        }

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

        return false;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

outCorrectSolution()

ilTestServiceGUI::outCorrectSolution ( )

protected

Creates an output of the solution of an answer compared to the correct solution.

Definition at line 1091 of file class.ilTestServiceGUI.php.

References $tabs, buildQuestionRelatedObjectivesList(), ILIAS\Repository\ctrl(), ilObjStyleSheet\getContentStylePath(), getCorrectSolutionOutput(), ilLOTestQuestionAdapter\getInstance(), getObjectiveOrientedContainer(), ilUtil\getStyleSheetLocation(), ilObjStyleSheet\getSyntaxStylePath(), ILIAS\Repository\int(), ILIAS\Repository\lng(), ILIAS\Repository\object(), and ilTabsGUI\setBackTarget().

Referenced by outCorrectSolutionCmd().

                                           : void
    {
        if (!$this->object->getShowSolutionDetails()) {
            $this->tpl->setOnScreenMessage('info', $this->lng->txt("no_permission"), true);
            $this->ctrl->redirectByClass("ilobjtestgui", "infoScreen");
        }

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

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

        $this->ctrl->saveParameter($this, "pass");
        $pass = (int) $this->testrequest->raw("pass");

        $active_id = (int) $this->testrequest->raw('evaluation');

        $test_sequence = $this->testSequenceFactory->getSequenceByActiveIdAndPass($active_id, $pass);
        $test_sequence->loadFromDb();
        $test_sequence->loadQuestions();

        if (!$test_sequence->questionExists($active_id)) {
            ilObjTestGUI::accessViolationRedirect();
        }

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

            $objectives_adapter = ilLOTestQuestionAdapter::getInstance($testSession);
            $objectives_list = $this->buildQuestionRelatedObjectivesList($objectives_adapter, $test_sequence);
            $objectives_list->loadObjectivesTitles();
        } else {
            $objectives_list = null;
        }

        $ilTabs = $this->tabs;

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

        $this->tpl->setCurrentBlock("ContentStyle");
        $this->tpl->setVariable("LOCATION_CONTENT_STYLESHEET", ilObjStyleSheet::getContentStylePath(0));
        $this->tpl->parseCurrentBlock();

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

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

        $solution = $this->getCorrectSolutionOutput($active_id, $active_id, $pass, $objectives_list);

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

Here is the call graph for this function:

Here is the caller graph for this function:

outCorrectSolutionCmd()

ilTestServiceGUI::outCorrectSolutionCmd ( )

protected

Definition at line 1083 of file class.ilTestServiceGUI.php.

References outCorrectSolution().

    {
        $this->outCorrectSolution(); // cannot be named xxxCmd, because it's also called from context without Cmd in names
    }

Here is the call graph for this function:

populateContent()

ilTestServiceGUI::populateContent (   $content )

protected

Parameters

string

$content

Definition at line 1068 of file class.ilTestServiceGUI.php.

Referenced by ilTestEvalObjectiveOrientedGUI\showVirtualPassCmd().

    {
        $this->tpl->setContent($content);
    }

Here is the caller graph for this function:

populateExamId()

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

protected

Definition at line 1176 of file class.ilTestServiceGUI.php.

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

Referenced by getResultsOfUserOutput(), ilTestEvaluationGUI\multiParticipantsPassDetails(), ilTestEvaluationGUI\outParticipantsPassDetails(), and ilTestEvaluationGUI\outUserPassDetails().

                                                                                 : void
    {
        if ($this->object->isShowExamIdInTestResultsEnabled()) {
            $tpl->setVariable('EXAM_ID_TXT', $this->lng->txt('exam_id'));
            $tpl->setVariable('EXAM_ID', ilObjTest::lookupExamId(
                $active_id,
                $pass
            ));
        }
    }

Here is the call graph for this function:

Here is the caller graph for this function:

populatePassFinishDate()

ilTestServiceGUI::populatePassFinishDate ( ilTemplate  $tpl, ?int  $pass_finish_date  )

protected

Definition at line 1163 of file class.ilTestServiceGUI.php.

References ilDatePresentation\formatDate(), IL_CAL_UNIX, ILIAS\Repository\lng(), ilDatePresentation\setUseRelativeDates(), HTML_Template_IT\setVariable(), and ilDatePresentation\useRelativeDates().

Referenced by getResultsOfUserOutput(), ilTestEvaluationGUI\multiParticipantsPassDetails(), ilTestEvaluationGUI\outParticipantsPassDetails(), and ilTestEvaluationGUI\outUserPassDetails().

                                                                                      : void
    {
        if ($pass_finish_date === null) {
            return;
        }
        $old_value = ilDatePresentation::useRelativeDates();
        ilDatePresentation::setUseRelativeDates(false);
        $pass_finish_date_string = ilDatePresentation::formatDate(new ilDateTime($pass_finish_date, IL_CAL_UNIX));
        ilDatePresentation::setUseRelativeDates($old_value);
        $tpl->setVariable("PASS_FINISH_DATE_LABEL", $this->lng->txt('tst_pass_finished_on'));
        $tpl->setVariable("PASS_FINISH_DATE_VALUE", $pass_finish_date_string);
    }

Here is the call graph for this function:

Here is the caller graph for this function:

setContextResultPresentation()

ilTestServiceGUI::setContextResultPresentation

(

bool

$contextResultPresentation

)

Definition at line 106 of file class.ilTestServiceGUI.php.

References $contextResultPresentation, $DIC, ILIAS\MetaData\Repository\Validation\Data\__construct(), ILIAS\Repository\access(), ILIAS\Repository\ctrl(), ilObjTest\getLocalDIC(), ILIAS\Repository\help(), ILIAS\FileDelivery\http(), ILIAS\Repository\lng(), ILIAS\Repository\refinery(), ILIAS\Repository\settings(), ILIAS\Repository\tabs(), ILIAS\Repository\toolbar(), and ILIAS\Repository\user().

Referenced by ilTestEvaluationGUI\outUserListOfAnswerPasses().

    {
        $this->contextResultPresentation = $contextResultPresentation;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

setObjectiveOrientedContainer()

ilTestServiceGUI::setObjectiveOrientedContainer

(

ilTestObjectiveOrientedContainer

$objective_oriented_container

)

Parameters

ilTestObjectiveOrientedContainer

$objective_oriented_container

Definition at line 275 of file class.ilTestServiceGUI.php.

References $objective_oriented_container.

    {
        $this->objective_oriented_container = $objective_oriented_container;
    }

setParticipantData()

ilTestServiceGUI::setParticipantData

(

ilTestParticipantData

$participantData

)

Definition at line 169 of file class.ilTestServiceGUI.php.

References $participantData.

                                                                              : void
    {
        $this->participantData = $participantData;
    }

Field Documentation

$access

ilAccess ilTestServiceGUI::$access

protected

Definition at line 67 of file class.ilTestServiceGUI.php.

$component_repository

ilComponentRepository ilTestServiceGUI::$component_repository

protected

Definition at line 73 of file class.ilTestServiceGUI.php.

Referenced by ilTestOutputGUI\generateRandomTestPassForActiveUser(), getFilteredTestResult(), and ilTestEvaluationGUI\getFilteredTestResult().

$content_style

ContentStyle ilTestServiceGUI::$content_style

protected

Definition at line 65 of file class.ilTestServiceGUI.php.

$contextResultPresentation

bool ilTestServiceGUI::$contextResultPresentation = true

private

Definition at line 99 of file class.ilTestServiceGUI.php.

Referenced by isContextResultPresentation(), and setContextResultPresentation().

$ctrl

ilCtrl ilTestServiceGUI::$ctrl

protected

Definition at line 69 of file class.ilTestServiceGUI.php.

$db

ilDBInterface ilTestServiceGUI::$db

protected

Definition at line 53 of file class.ilTestServiceGUI.php.

Referenced by ilTestEvaluationGUI\exportCertificateArchive(), getFilteredTestResult(), ilTestEvaluationGUI\getFilteredTestResult(), ilTestPlayerAbstractGUI\initProcessLocker(), and ilTestEvaluationGUI\performDeletePass().

$error

ilErrorHandling ilTestServiceGUI::$error

protected

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

$global_screen

GlobalScreenServices ilTestServiceGUI::$global_screen

protected

Definition at line 87 of file class.ilTestServiceGUI.php.

$help

ilHelpGUI ilTestServiceGUI::$help

protected

Definition at line 56 of file class.ilTestServiceGUI.php.

$http

HTTPServices ilTestServiceGUI::$http

protected

Definition at line 68 of file class.ilTestServiceGUI.php.

$ilias

ILIAS ilTestServiceGUI::$ilias

protected

Definition at line 85 of file class.ilTestServiceGUI.php.

$lng

ilLanguage ilTestServiceGUI::$lng

protected

Definition at line 54 of file class.ilTestServiceGUI.php.

Referenced by ilTestScoringByQuestionsGUI\appendQuestionTitleToModal(), and ilTestScoringByQuestionsGUI\getAnswerDetail().

$logging_services

LoggingServices ilTestServiceGUI::$logging_services

protected

Definition at line 55 of file class.ilTestServiceGUI.php.

$navigation_history

ilNavigationHistory ilTestServiceGUI::$navigation_history

protected

Definition at line 76 of file class.ilTestServiceGUI.php.

$obj_cache

ilObjectDataCache ilTestServiceGUI::$obj_cache

protected

Definition at line 72 of file class.ilTestServiceGUI.php.

Referenced by ilTestEvaluationGUI\outParticipantsResultsOverview().

$objective_oriented_container

ilTestObjectiveOrientedContainer ilTestServiceGUI::$objective_oriented_container

private

Definition at line 97 of file class.ilTestServiceGUI.php.

Referenced by getObjectiveOrientedContainer(), and setObjectiveOrientedContainer().

$participant_access_filter

ilTestParticipantAccessFilterFactory ilTestServiceGUI::$participant_access_filter

protected

Definition at line 95 of file class.ilTestServiceGUI.php.

$participantData

ilTestParticipantData ilTestServiceGUI::$participantData = null

protected

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

Referenced by getParticipantData(), ilTestEvaluationGUI\resetfilterEvaluation(), ilTestScoringByQuestionsGUI\saveManScoringByQuestion(), ilTestScoringGUI\saveNextManScoringParticipantScreen(), setParticipantData(), and ilTestScoringByQuestionsGUI\showManScoringByQuestionParticipantsTable().

$post_wrapper

ArrayBasedRequestWrapper ilTestServiceGUI::$post_wrapper

protected

Definition at line 75 of file class.ilTestServiceGUI.php.

$questioninfo

ILIAS TestQuestionPool QuestionInfoService ilTestServiceGUI::$questioninfo

protected

Definition at line 51 of file class.ilTestServiceGUI.php.

Referenced by ilTestOutputGUI\generateRandomTestPassForActiveUser().

$rbac_system

ilRbacSystem ilTestServiceGUI::$rbac_system

protected

Definition at line 57 of file class.ilTestServiceGUI.php.

$ref_id

int ilTestServiceGUI::$ref_id

protected

Definition at line 89 of file class.ilTestServiceGUI.php.

$refinery

Refinery ilTestServiceGUI::$refinery

protected

Definition at line 77 of file class.ilTestServiceGUI.php.

$results_factory

ilTestResultsFactory ilTestServiceGUI::$results_factory

protected

Definition at line 82 of file class.ilTestServiceGUI.php.

$results_presentation_factory

ilTestResultsPresentationFactory ilTestServiceGUI::$results_presentation_factory

protected

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

$service

ilTestService ilTestServiceGUI::$service = null

protected

Definition at line 52 of file class.ilTestServiceGUI.php.

$settings

ilSetting ilTestServiceGUI::$settings

protected

Definition at line 86 of file class.ilTestServiceGUI.php.

$shuffler

ilTestShuffler ilTestServiceGUI::$shuffler

protected

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

$skills_service

SkillService ilTestServiceGUI::$skills_service

protected

Definition at line 80 of file class.ilTestServiceGUI.php.

$tabs

ilTabsGUI ilTestServiceGUI::$tabs

protected

Definition at line 71 of file class.ilTestServiceGUI.php.

Referenced by outCorrectSolution(), ilTestEvaluationGUI\outParticipantsPassDetails(), and ilTestEvaluationGUI\outParticipantsResultsOverview().

$testrequest

InternalRequestService ilTestServiceGUI::$testrequest

protected

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

$testSequenceFactory

ilTestSequenceFactory ilTestServiceGUI::$testSequenceFactory = null

protected

Definition at line 92 of file class.ilTestServiceGUI.php.

$testSessionFactory

ilTestSessionFactory ilTestServiceGUI::$testSessionFactory = null

protected

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

Referenced by ilTestOutputGUI\executeCommand().

$toolbar

ilToolbarGUI ilTestServiceGUI::$toolbar

protected

Definition at line 70 of file class.ilTestServiceGUI.php.

Referenced by ilTestSubmissionReviewGUI\buildToolbar(), buildUserTestResultsToolbarGUI(), ilTestEvaluationGUI\multiParticipantsPassDetails(), ilTestEvaluationGUI\outParticipantsPassDetails(), ilTestEvaluationGUI\outParticipantsResultsOverview(), ilTestEvaluationGUI\outUserPassDetails(), ilTestEvaluationGUI\outUserResultsOverview(), ilTestEvaluationGUI\resetfilterEvaluation(), and ilTestEvalObjectiveOrientedGUI\showVirtualPassCmd().

$tpl

ilGlobalTemplateInterface ilTemplate ilTestServiceGUI::$tpl

protected

sk 2023-08-01: We need this union type, even if it is wrong! To change this

Todo:

we have to fix the rendering of the feedback modal in ilTestPlayerAbstractGUI::populateIntantResponseModal().

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

Referenced by ilTestPlayerAbstractGUI\getQuestionGuiInstance(), ilTestEvaluationGUI\outUserPassDetails(), ilTestPlayerAbstractGUI\populateDiscardSolutionModal(), ilTestPlayerAbstractGUI\populateInstantResponseModal(), ilTestPlayerAbstractGUI\populateNavWhenChangedModal(), ilTestEvaluationGUI\prepareContentForPrint(), and ilTestEvalObjectiveOrientedGUI\showVirtualPassCmd().

$tree

ilTree ilTestServiceGUI::$tree

protected

Definition at line 88 of file class.ilTestServiceGUI.php.

$ui_factory

UIFactory ilTestServiceGUI::$ui_factory

protected

Definition at line 78 of file class.ilTestServiceGUI.php.

$ui_renderer

UIRenderer ilTestServiceGUI::$ui_renderer

protected

Definition at line 79 of file class.ilTestServiceGUI.php.

$user

ilObjUser ilTestServiceGUI::$user

protected

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

Referenced by getCorrectSolutionOutput().

---

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

• Modules/Test/classes/class.ilTestServiceGUI.php