This file is part of ILIAS, a powerful learning management system published by ILIAS open source e-Learning e.V. More...

Inheritance diagram for ilTestOutputGUI:

Collaboration diagram for ilTestOutputGUI:

Public Member Functions
	executeCommand ()
	Execute Command. More...

	saveQuestionSolution ($authorized=true, $force=false)
	saves the user input of a question More...

Public Member Functions inherited from ilTestPlayerAbstractGUI
	__construct ($a_object)
	ilTestOutputGUI constructor More...

	saveTagsCmd ()
	Save tags for tagging gui. More...

	updateWorkingTime ()
	updates working time and stores state saveresult to see if question has to be stored or not More...

	removeIntermediateSolution ()
	remove an auto-saved solution of the current question More...

	saveQuestionSolution ($authorized=true, $force=false)
	saves the user input of a question More...

	suspendTestCmd ()

	isMaxProcessingTimeReached ()
	Checks wheather the maximum processing time is reached or not. More...

	setAnonymousIdCmd ()
	Sets a session variable with the test access code for an anonymous test user. More...

	getLockParameter ()

	displayAccessCodeCmd ()

	accessCodeConfirmedCmd ()

	handleUserSettings ()
	Handles some form parameters on starting and resuming a test. More...

	redirectAfterAutosaveCmd ()
	Redirect the user after an automatic save when the time limit is reached. More...

	redirectAfterDashboardCmd ()

	autosaveCmd ()
	Automatically save a user answer while working on the test (called repeatedly by asynchronous posts in configured autosave interval) More...

	autosaveOnTimeLimitCmd ()
	Automatically save a user answer when the limited duration of a test run is reached (called by synchronous form submit when the remaining time count down reaches zero) More...

	toggleSideListCmd ()
	Toggle side list. More...

	finishTestCmd ($requires_confirmation=true)

	redirectBackCmd ()

	getKioskHead ()

	checkOnlineTestAccess ()
	check access restrictions like client ip, partipating user etc. More...

	isTestAccessible ()
	test accessible returns true if the user can perform the test More...

	isNrOfTriesReached ()
	nr of tries exceeded More...

	endingTimeReached ()
	handle endingTimeReached More...

	maxProcessingTimeReached ()
	Outputs a message when the maximum processing time is reached. More...

	confirmSubmitAnswers ()
	confirm submit results if confirm then results are submitted and the screen will be redirected to the startpage of the test @access public More...

	outProcessingTime ($active_id)

	checkWorkingTimeCmd ()
	This is asynchronously called by tpl.workingtime.js to check for changes in the user's processing time for a test. More...

	outQuestionSummaryCmd ($fullpage=true, $contextFinishTest=false, $obligationsInfo=false, $obligationsFilter=false)
	Output of a summary of all test questions for test participants. More...

	outQuestionSummaryWithObligationsInfoCmd ()

	outObligationsOnlySummaryCmd ()

	showMaximumAllowedUsersReachedMessage ()

	backFromFinishingCmd ()

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

	showListOfAnswers ($active_id, $pass=null, $top_data="", $bottom_data="")
	Creates an output of the list of answers for a test participant during the test (only the actual pass will be shown) More...

	getContentBlockName ()
	Returns the name of the current content block (depends on the kiosk mode setting) More...

	outUserResultsOverviewCmd ()

Public Member Functions inherited from ilTestServiceGUI
	isContextResultPresentation ()

	setContextResultPresentation ($contextResultPresentation)

	__construct (ilObjTest $a_object)
	The constructor takes the test object reference as parameter. More...

	setParticipantData ($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 $objectiveOrientedContainer)

	getObjectiveOrientedContainer ()

	executeCommand ()
	execute command More...

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

	buildPassOverviewTableGUI ($targetGUI)

	getPassListOfAnswers (&$result_array, $active_id, $pass, $show_solutions=false, $only_answered_questions=false, $show_question_only=false, $show_reached_points=false, $anchorNav=false, ilTestQuestionRelatedObjectivesList $objectivesList=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 $objectivesList=null)
	Returns an output of the solution to an answer compared to the correct solution. More...

	getResultsOfUserOutput ($testSession, $active_id, $pass, $targetGUI, $show_pass_details=true, $show_answers=true, $show_question_only=false, $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 ($question_id, $test_id)
	Creates a HTML representation for the results of a given question in a test. More...

	populatePassFinishDate ($tpl, $passFinishDate)

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

	getObject ()

Protected Member Functions
	startTestCmd ()

	updateLearningProgressOnTestStart ()

	showQuestionCmd ()

	editSolutionCmd ()

	submitSolutionAndNextCmd ()

	submitSolutionCmd ()

	discardSolutionCmd ()

	skipQuestionCmd ()

	handleQuestionPostponing ($sequenceElement)

	handleCheckTestPassValid ()

	nextQuestionCmd ()

	previousQuestionCmd ()

	isFirstQuestionInSequence ($sequenceElement)

	isLastQuestionInSequence ($sequenceElement)

	canSaveResult ()
	Returns TRUE if the answers of the current user could be saved. More...

	getCurrentQuestionId ()

	showInstantResponseCmd ()

	handleQuestionActionCmd ()

	performTearsAndAngerBrokenConfessionChecks ()

	generateRandomTestPassForActiveUser ()

	resumePlayerCmd ()
	Resume a test at the last position. More...

	isShowingPostponeStatusReguired ($questionId)

	adoptUserSolutionsFromPreviousPass ()

	populateQuestionOptionalMessage ()

	isOptionalQuestionAnsweringConfirmationRequired ($sequenceKey)

	isQuestionSummaryFinishTestButtonRequired ()

	handleTearsAndAngerNoObjectiveOrientedQuestion ()

	handlePrimaryButton (ilTestNavigationToolbarGUI $navigationToolbarGUI, $currentQuestionId)

Protected Member Functions inherited from ilTestPlayerAbstractGUI
	checkReadAccess ()

	checkTestExecutable ()

	checkTestSessionUser (ilTestSession $testSession)

	ensureExistingTestSession (ilTestSession $testSession)

	initProcessLocker ($activeId)

	canSaveResult ()

	determineInlineScoreDisplay ()

	populateTestNavigationToolbar (ilTestNavigationToolbarGUI $toolbarGUI)

	populateQuestionNavigation ($sequenceElement, $disabled, $primaryNext)

	populatePreviousButtons ($disabled)

	populateNextButtons ($disabled, $primaryNext)

	populateLowerNextButtonBlock ($disabled, $primaryNext)

	populateUpperNextButtonBlock ($disabled, $primaryNext)

	populateLowerPreviousButtonBlock ($disabled)

	populateUpperPreviousButtonBlock ($disabled)

	populateSpecificFeedbackBlock (assQuestionGUI $question_gui)

	populateGenericFeedbackBlock (assQuestionGUI $question_gui, $solutionCorrect)

	populateScoreBlock ($reachedPoints, $maxPoints)

	populateSolutionBlock ($solutionoutput)

	populateSyntaxStyleBlock ()

	populateContentStyleBlock ()

	startPlayerCmd ()
	Start a test for the first time. More...

	resumePlayerCmd ()
	Resume a test at the last position. More...

	initTestCmd ()
	Start a test for the first time after a redirect. More...

	getCurrentQuestionId ()

	detectChangesCmd ()
	Detect changes sent in the background to the server This is called by ajax from ilTestPlayerQuestionEditControl.js It is needed by Java and Flash question and eventually plgin question vtypes. More...

	submitIntermediateSolutionCmd ()

	markQuestionAndSaveIntermediateCmd ()

	markQuestionCmd ()
	Set a question solved. More...

	unmarkQuestionAndSaveIntermediateCmd ()

	unmarkQuestionCmd ()
	Set a question unsolved. More...

	confirmFinishCmd ()
	The final submission of a test was confirmed. More...

	performTestPassFinishedTasks ($finishedPass)

	afterTestPassFinishedCmd ()

	archiveParticipantSubmission ($active, $pass)

	backToInfoScreenCmd ()

	prepareTestPage ($presentationMode, $sequenceElement, $questionId)

	isOptionalQuestionAnsweringConfirmationRequired ($sequenceElement)

	isShowingPostponeStatusReguired ($questionId)

	showQuestionViewable (assQuestionGUI $questionGui, $formAction, $isQuestionWorkedThrough, $instantResponse)

	showQuestionEditable (assQuestionGUI $questionGui, $formAction, $isQuestionWorkedThrough, $instantResponse)

	determineSolutionPassIndex (assQuestionGUI $questionGui)

	showQuestionCmd ()

	editSolutionCmd ()

	submitSolutionCmd ()

	revertChangesCmd ()

	discardSolutionCmd ()

	skipQuestionCmd ()

	startTestCmd ()

	showSideList ($presentationMode, $currentSequenceElement)

	isQuestionSummaryFinishTestButtonRequired ()

	showRequestedHintListCmd ()
	Go to requested hint list. More...

	confirmHintRequestCmd ()
	Go to hint request confirmation. More...

	isFirstQuestionInSequence ($sequenceElement)

	isLastQuestionInSequence ($sequenceElement)

	handleQuestionActionCmd ()

	showInstantResponseCmd ()

	nextQuestionCmd ()

	previousQuestionCmd ()

	prepareSummaryPage ()

	initTestPageTemplate ()

	populateKioskHead ()

	handlePasswordProtectionRedirect ()

	isParticipantsAnswerFixed ($questionId)

	getIntroductionPageButtonLabel ()

	initAssessmentSettings ()

	handleSkillTriggering (ilTestSession $testSession)

	buildTestPassQuestionList ()

	showAnswerOptionalQuestionsConfirmation ()

	confirmAnswerOptionalQuestionsCmd ()

	cancelAnswerOptionalQuestionsCmd ()

	populateHelperGuiContent ($helperGui)

	populateCharSelectorIfRequired ()

	getTestNavigationToolbarGUI ()

	buildReadOnlyStateQuestionNavigationGUI ($questionId)

	buildEditableStateQuestionNavigationGUI ($questionId, $charSelectorAvailable)

	getFinishTestCommand ()

	populateInstantResponseModal (assQuestionGUI $questionGui, $navUrl)

	populateInstantResponseBlocks (assQuestionGUI $questionGui, $authorizedSolution)

	populateFeedbackBlockHeader ($withFocusAnchor)

	populateFeedbackBlockMessage (string $a_message)

	getCurrentSequenceElement ()

	getSequenceElementParameter ()

	getPresentationModeParameter ()

	getInstantResponseParameter ()

	getNextCommandParameter ()

	getNextSequenceParameter ()

	getNavigationUrlParameter ()

	getAnswerChangedParameter ()
	Get the 'answer changed' status from the current request It may be set by ilTestPlayerNavigationControl.js or by a previousRequest. More...

	setAnswerChangedParameter ($changed=true)
	Set the 'answer changed' url parameter for generated links. More...

	handleIntermediateSubmit ()
	Check the 'answer changed' parameter when a question form is intermediately submitted. More...

	saveNavigationPreventConfirmation ()
	Save the save the switch to prevent the navigation confirmation. More...

	getQuestionGuiInstance ($question_id, $fromCache=true)

	getQuestionInstance ($questionId, $fromCache=true)

	initTestQuestionConfig (assQuestion $questionOBJ)

	handleTearsAndAngerQuestionIsNull ($questionId, $sequenceElement)

	populateMessageContent ($contentHTML)

	populateModals ()

	populateDiscardSolutionModal ()

	populateNavWhenChangedModal ()

	populateNextLocksUnchangedModal ()

	populateNextLocksChangedModal ()

	setFollowUpQuestionLocksConfirmationPrevented ()

	isFollowUpQuestionLocksConfirmationPrevented ()

	getQuestionsDefaultPresentationMode ($isQuestionWorkedThrough)

	registerForcedFeedbackNavUrl ($forcedFeedbackNavUrl)

	getRegisteredForcedFeedbackNavUrl ()

	isForcedFeedbackNavUrlRegistered ()

	unregisterForcedFeedbackNavUrl ()

	handleFileUploadCmd ()

Protected Member Functions inherited from ilTestServiceGUI
	isPdfDeliveryRequest ()

	buildQuestionAnswerShuffler (int $question_id, int $active_id, int $pass_id)

	buildFixedShufflerSeed (int $question_id, int $pass_id, int $active_id)

	getPassDetailsOverviewTableGUI ( $result_array, $active_id, $pass, $targetGUI, $targetCMD, $questionDetailsCMD, $questionAnchorNav, ilTestQuestionRelatedObjectivesList $objectivesList=null, $multipleObjectivesInvolved=true)

	buildPassDetailsOverviewTableGUI ($targetGUI, $targetCMD)

	isGradingMessageRequired ()

	getGradingMessageBuilder ($activeId)

	buildQuestionRelatedObjectivesList (ilLOTestQuestionAdapter $objectivesAdapter, ilTestQuestionSequence $testSequence)

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

	populateContent ($content)

	buildUserTestResultsToolbarGUI ()

	outCorrectSolutionCmd ()

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

Protected Attributes
	$questionRelatedObjectivesList

Protected Attributes inherited from ilTestPlayerAbstractGUI
	$passwordChecker

	$processLocker

	$testSession

	$assSettings

	$testSequence = null

Protected Attributes inherited from ilTestServiceGUI
ILIAS Test InternalRequestService	$testrequest

	$db

Refinery	$refinery

	$tabs

	$objCache

	$testSessionFactory = null

	$testSequenceFactory = null

	$participantData

Private Member Functions
	isValidSequenceElement ($sequenceElement)

Additional Inherited Members
Data Fields inherited from ilTestPlayerAbstractGUI
const	PRESENTATION_MODE_VIEW = 'view'

const	PRESENTATION_MODE_EDIT = 'edit'

const	FIXED_SHUFFLER_SEED_MIN_LENGTH = 8

	$ref_id

	$saveResult

	$sequence

	$cmdCtrl

	$maxProcessingTimeReached

	$endingTimeReached

const	FOLLOWUP_QST_LOCKS_PREVENT_CONFIRMATION_PARAM = 'followup_qst_locks_prevent_confirmation'

Data Fields inherited from ilTestServiceGUI
	$object = null

	$service = null

	$lng

	$tpl

	$ctrl

	$ilias

	$tree

	$ref_id

Detailed Description

This file is part of ILIAS, a powerful learning management system published by ILIAS open source e-Learning e.V.

ILIAS is licensed with the GPL-3.0, see https://www.gnu.org/licenses/gpl-3.0.en.html You should have received a copy of said license along with the source code, too.

If this is not the case or you just want to try ILIAS, you'll find us at: https://www.ilias.de https://github.com/ILIAS-eLearning Output class for assessment test execution

The ilTestOutputGUI class creates the output for the ilObjTestGUI class when learners execute a test. This saves some heap space because the ilObjTestGUI class will be much smaller then

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; Maximilian Becker mbeck.nosp@m.er@d.nosp@m.ataba.nosp@m.y.de

Version: $Id$

@inGroup ModulesTest

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

Member Function Documentation

◆ adoptUserSolutionsFromPreviousPass()

ilTestOutputGUI::adoptUserSolutionsFromPreviousPass ( )

protected

Definition at line 892 of file class.ilTestOutputGUI.php.

    {
        global $DIC;
        $ilDB = $DIC['ilDB'];
        $ilUser = $DIC['ilUser'];
 
        $assSettings = new ilSetting('assessment');
 
        $isAssessmentLogEnabled = ilObjAssessmentFolder::_enabledAssessmentLogging();
 
        $userSolutionAdopter = new ilAssQuestionUserSolutionAdopter($ilDB, $assSettings, $isAssessmentLogEnabled);
 
        $userSolutionAdopter->setUserId($ilUser->getId());
        $userSolutionAdopter->setActiveId($this->testSession->getActiveId());
        $userSolutionAdopter->setTargetPass($this->testSequence->getPass());
        $userSolutionAdopter->setQuestionIds($this->testSequence->getOptionalQuestions());
 
        $userSolutionAdopter->perform();
    }

References ilTestPlayerAbstractGUI\$assSettings, $DIC, $ilDB, $ilUser, and ilObjAssessmentFolder\_enabledAssessmentLogging().

Referenced by startTestCmd().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ canSaveResult()

ilTestOutputGUI::canSaveResult ( )

protected

Returns TRUE if the answers of the current user could be saved.

Returns: boolean TRUE if the answers could be saved, FALSE otherwise

Reimplemented from ilTestPlayerAbstractGUI.

Definition at line 645 of file class.ilTestOutputGUI.php.

                                      : bool
    {
        return !$this->object->endingTimeReached() && !$this->isMaxProcessingTimeReached() && !$this->isNrOfTriesReached();
    }

References ilTestPlayerAbstractGUI\isMaxProcessingTimeReached(), and ilTestPlayerAbstractGUI\isNrOfTriesReached().

Referenced by saveQuestionSolution().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ discardSolutionCmd()

ilTestOutputGUI::discardSolutionCmd ( )

protected

Reimplemented from ilTestPlayerAbstractGUI.

Definition at line 524 of file class.ilTestOutputGUI.php.

    {
        $currentSequenceElement = $this->getCurrentSequenceElement();
 
        $currentQuestionOBJ = $this->getQuestionInstance(
            $this->testSequence->getQuestionForSequence($currentSequenceElement)
        );
 
        $currentQuestionOBJ->resetUsersAnswer(
            $this->testSession->getActiveId(),
            $this->testSession->getPass()
        );
 
        $this->ctrl->saveParameter($this, 'sequence');
 
        $this->ctrl->setParameter($this, 'pmode', ilTestPlayerAbstractGUI::PRESENTATION_MODE_VIEW);
 
        $this->ctrl->redirect($this, ilTestPlayerCommands::SHOW_QUESTION);
    }

References ILIAS\Repository\ctrl(), ilTestPlayerAbstractGUI\getCurrentSequenceElement(), ilTestPlayerAbstractGUI\getQuestionInstance(), ilTestPlayerAbstractGUI\PRESENTATION_MODE_VIEW, and ilTestPlayerCommands\SHOW_QUESTION.

Here is the call graph for this function:

◆ editSolutionCmd()

ilTestOutputGUI::editSolutionCmd ( )

protected

Reimplemented from ilTestPlayerAbstractGUI.

Definition at line 444 of file class.ilTestOutputGUI.php.

    {
        $this->ctrl->setParameter($this, 'pmode', ilTestPlayerAbstractGUI::PRESENTATION_MODE_EDIT);
        $this->ctrl->redirect($this, ilTestPlayerCommands::SHOW_QUESTION);
    }

References ILIAS\Repository\ctrl(), ilTestPlayerAbstractGUI\PRESENTATION_MODE_EDIT, and ilTestPlayerCommands\SHOW_QUESTION.

Here is the call graph for this function:

◆ executeCommand()

ilTestOutputGUI::executeCommand ( )

Execute Command.

Reimplemented from ilTestServiceGUI.

Definition at line 43 of file class.ilTestOutputGUI.php.

    {
        global $DIC;
        $ilDB = $DIC['ilDB'];
        $component_repository = $DIC['component.repository'];
        $lng = $DIC['lng'];
        $refinery = $DIC['refinery'];
        $ilTabs = $DIC['ilTabs'];
 
        $this->checkReadAccess();
 
        $ilTabs->clearTargets();
 
        $cmd = $this->ctrl->getCmd();
        $next_class = $this->ctrl->getNextClass($this);
 
        $this->ctrl->saveParameter($this, "sequence");
        $this->ctrl->saveParameter($this, "pmode");
        $this->ctrl->saveParameter($this, "active_id");
 
        $this->initAssessmentSettings();
 
        $testSessionFactory = new ilTestSessionFactory($this->object);
        $this->testSession = $testSessionFactory->getSession($this->testrequest->raw('active_id'));
 
        $this->ensureExistingTestSession($this->testSession);
        $this->checkTestSessionUser($this->testSession);
 
        $this->initProcessLocker($this->testSession->getActiveId());
 
        $testSequenceFactory = new ilTestSequenceFactory($ilDB, $lng, $refinery, $component_repository, $this->object);
        $this->testSequence = $testSequenceFactory->getSequenceByTestSession($this->testSession);
        $this->testSequence->loadFromDb();
        $this->testSequence->loadQuestions();
 
        $DIC->globalScreen()->tool()->context()->current()->addAdditionalData(
            ilTestPlayerLayoutProvider::TEST_PLAYER_KIOSK_MODE_ENABLED,
            $this->object->getKioskMode()
        );
        $title = $this->object->getTitle();
        if (($sequence_index = $this->getSequenceElementParameter()) !== null) {
            $title .= ' - ' . $this->lng->txt('question') . $sequence_index;
        }
        $DIC->globalScreen()->tool()->context()->current()->addAdditionalData(
            ilTestPlayerLayoutProvider::TEST_PLAYER_TITLE,
            $title
        );
        $instance_name =  $DIC['ilSetting']->get('short_inst_name');
        if (trim($instance_name) === '') {
            $instance_name = 'ILIAS';
        }
        $DIC->globalScreen()->tool()->context()->current()->addAdditionalData(
            ilTestPlayerLayoutProvider::TEST_PLAYER_SHORT_TITLE,
            $instance_name
        );
 
        $this->questionRelatedObjectivesList = new ilTestQuestionRelatedObjectivesList();
 
        iljQueryUtil::initjQuery();
        ilYuiUtil::initConnectionWithAnimation();
 
        $this->handlePasswordProtectionRedirect();
 
        $cmd = $this->getCommand($cmd);
 
        switch ($next_class) {
            case 'ilassquestionpagegui':
                $this->checkTestExecutable();
 
                $questionId = $this->testSequence->getQuestionForSequence($this->getCurrentSequenceElement());
 
                $page_gui = new ilAssQuestionPageGUI($questionId);
                $ret = $this->ctrl->forwardCommand($page_gui);
                break;
 
            case 'iltestsubmissionreviewgui':
                $this->checkTestExecutable();
 
                $gui = new ilTestSubmissionReviewGUI($this, $this->object, $this->testSession);
                $gui->setObjectiveOrientedContainer($this->getObjectiveOrientedContainer());
                $ret = $this->ctrl->forwardCommand($gui);
                break;
 
            case 'ilassquestionhintrequestgui':
                $this->checkTestExecutable();
 
                $questionGUI = $this->object->createQuestionGUI(
                    "",
                    $this->testSequence->getQuestionForSequence($this->getCurrentSequenceElement())
                );
 
                $questionHintTracking = new ilAssQuestionHintTracking(
                    $questionGUI->object->getId(),
                    $this->testSession->getActiveId(),
                    $this->testSession->getPass()
                );
 
                $gui = new ilAssQuestionHintRequestGUI($this, ilTestPlayerCommands::SHOW_QUESTION, $questionGUI, $questionHintTracking);
 
                // fau: testNav - save the 'answer changed' status for viewing hint requests
                $this->setAnswerChangedParameter($this->getAnswerChangedParameter());
                // fau.
                $ret = $this->ctrl->forwardCommand($gui);
 
                break;
 
            case 'iltestsignaturegui':
                $this->checkTestExecutable();
 
                $gui = new ilTestSignatureGUI($this);
                $ret = $this->ctrl->forwardCommand($gui);
                break;
 
            case 'iltestpasswordprotectiongui':
                $this->checkTestExecutable();
 
                $gui = new ilTestPasswordProtectionGUI($this->ctrl, $this->tpl, $this->lng, $this, $this->passwordChecker);
                $ret = $this->ctrl->forwardCommand($gui);
                break;
 
            default:
                if (ilTestPlayerCommands::isTestExecutionCommand($cmd)) {
                    $this->checkTestExecutable();
                }
 
                if (strtolower($cmd) === 'showquestion') {
                    $testPassesSelector = new ilTestPassesSelector($this->db, $this->object);
                    $testPassesSelector->setActiveId($this->testSession->getActiveId());
                    $testPassesSelector->setLastFinishedPass($this->testSession->getLastFinishedPass());
 
                    if (!$testPassesSelector->openPassExists()) {
                        $this->tpl->setOnScreenMessage('info', $this->lng->txt('tst_pass_finished'), true);
                        $this->ctrl->redirectByClass("ilobjtestgui", "infoScreen");
                    }
                }
 
                $cmd .= 'Cmd';
                $ret = $this->$cmd();
                break;
        }
        return $ret;
    }

Here is the call graph for this function:

◆ generateRandomTestPassForActiveUser()

ilTestOutputGUI::generateRandomTestPassForActiveUser ( )

protected

Definition at line 812 of file class.ilTestOutputGUI.php.

    {
        global $DIC;
        $tree = $DIC['tree'];
        $ilDB = $DIC['ilDB'];
        $component_repository = $DIC['component.repository'];
 
        $questionSetConfig = new ilTestRandomQuestionSetConfig($tree, $ilDB, $component_repository, $this->object);
        $questionSetConfig->loadFromDb();
 
        $sourcePoolDefinitionFactory = new ilTestRandomQuestionSetSourcePoolDefinitionFactory($ilDB, $this->object);
 
        $sourcePoolDefinitionList = new ilTestRandomQuestionSetSourcePoolDefinitionList($ilDB, $this->object, $sourcePoolDefinitionFactory);
        $sourcePoolDefinitionList->loadDefinitions();
 
        $this->processLocker->executeRandomPassBuildOperation(function () use ($ilDB, $component_repository, $questionSetConfig, $sourcePoolDefinitionList) {
            if (!$this->performTearsAndAngerBrokenConfessionChecks()) {
                $stagingPoolQuestionList = new ilTestRandomQuestionSetStagingPoolQuestionList($ilDB, $component_repository);
 
                $questionSetBuilder = ilTestRandomQuestionSetBuilder::getInstance($ilDB, $this->object, $questionSetConfig, $sourcePoolDefinitionList, $stagingPoolQuestionList);
 
                $questionSetBuilder->performBuild($this->testSession);
            }
        }, $sourcePoolDefinitionList->hasTaxonomyFilters());
    }

References $DIC, $ilDB, ilTestServiceGUI\$tree, ilTestRandomQuestionSetBuilder\getInstance(), and performTearsAndAngerBrokenConfessionChecks().

Referenced by resumePlayerCmd(), and startTestCmd().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getCurrentQuestionId()

ilTestOutputGUI::getCurrentQuestionId ( )

protected

Returns: integer

Reimplemented from ilTestPlayerAbstractGUI.

Definition at line 653 of file class.ilTestOutputGUI.php.

                                             : int
    {
        return $this->testSequence->getQuestionForSequence($this->testrequest->raw("sequence"));
    }

◆ handleCheckTestPassValid()

ilTestOutputGUI::handleCheckTestPassValid ( )

protected

Definition at line 580 of file class.ilTestOutputGUI.php.

                                                 : void
    {
        $testObj = new ilObjTest($this->ref_id, true);
 
        $participants = $testObj->getActiveParticipantList();
        $participant = $participants->getParticipantByActiveId($this->testrequest->getActiveId());
        if (!$participant || !$participant->hasUnfinishedPasses()) {
            $this->tpl->setOnScreenMessage('failure', $this->lng->txt("tst_current_run_no_longer_valid"), true);
            $this->backToInfoScreenCmd();
        }
    }

References ilTestPlayerAbstractGUI\backToInfoScreenCmd(), and ILIAS\Repository\lng().

Referenced by nextQuestionCmd(), and previousQuestionCmd().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ handlePrimaryButton()

ilTestOutputGUI::handlePrimaryButton	(	ilTestNavigationToolbarGUI	$navigationToolbarGUI,
			$currentQuestionId
	)

protected

Parameters

ilTestNavigationToolbarGUI	$navigationToolbarGUI
	$currentQuestionId

Returns: bool

Definition at line 946 of file class.ilTestOutputGUI.php.

                                                                                                                : bool
    {
        $isNextPrimary = true;
 
        if ($this->object->isForceInstantFeedbackEnabled()) {
            $isNextPrimary = false;
        }
 
        $questionsMissingResult = assQuestion::getQuestionsMissingResultRecord(
            $this->testSession->getActiveId(),
            $this->testSession->getPass(),
            $this->testSequence->getOrderedSequenceQuestions()
        );
 
        if (!count($questionsMissingResult)) {
            $navigationToolbarGUI->setFinishTestButtonPrimary(true);
            $isNextPrimary = false;
        } elseif (count($questionsMissingResult) == 1) {
            $lastOpenQuestion = current($questionsMissingResult);
 
            if ($currentQuestionId == $lastOpenQuestion) {
                $navigationToolbarGUI->setFinishTestButtonPrimary(true);
                $isNextPrimary = false;
            }
        }
 
        return $isNextPrimary;
    }

References assQuestion\getQuestionsMissingResultRecord(), ILIAS\Repository\object(), and ilTestNavigationToolbarGUI\setFinishTestButtonPrimary().

Referenced by showQuestionCmd().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ handleQuestionActionCmd()

ilTestOutputGUI::handleQuestionActionCmd ( )

protected

Reimplemented from ilTestPlayerAbstractGUI.

Definition at line 758 of file class.ilTestOutputGUI.php.

    {
        $questionId = $this->testSequence->getQuestionForSequence(
            $this->getCurrentSequenceElement()
        );
 
        if (!$this->isParticipantsAnswerFixed($questionId)) {
            $this->updateWorkingTime();
            $this->saveQuestionSolution(false);
            // fau: testNav - add changed status of the question
            $this->setAnswerChangedParameter(true);
            // fau.
        }
 
        $this->ctrl->redirect($this, ilTestPlayerCommands::SHOW_QUESTION);
    }

References ILIAS\Repository\ctrl(), ilTestPlayerAbstractGUI\getCurrentSequenceElement(), ilTestPlayerAbstractGUI\isParticipantsAnswerFixed(), saveQuestionSolution(), ilTestPlayerAbstractGUI\setAnswerChangedParameter(), ilTestPlayerCommands\SHOW_QUESTION, and ilTestPlayerAbstractGUI\updateWorkingTime().

Here is the call graph for this function:

◆ handleQuestionPostponing()

ilTestOutputGUI::handleQuestionPostponing ( $sequenceElement )

protected

Definition at line 564 of file class.ilTestOutputGUI.php.

    {
        $questionId = $this->testSequence->getQuestionForSequence($sequenceElement);
 
        $isQuestionWorkedThrough = assQuestion::_isWorkedThrough(
            $this->testSession->getActiveId(),
            $questionId,
            $this->testSession->getPass()
        );
 
        if (!$isQuestionWorkedThrough) {
            $this->testSequence->postponeQuestion($questionId);
            $this->testSequence->saveToDb();
        }
    }

References assQuestion\_isWorkedThrough().

Referenced by nextQuestionCmd().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ handleTearsAndAngerNoObjectiveOrientedQuestion()

ilTestOutputGUI::handleTearsAndAngerNoObjectiveOrientedQuestion ( )

protected

Definition at line 934 of file class.ilTestOutputGUI.php.

    {
        $this->tpl->setOnScreenMessage('failure', sprintf($this->lng->txt('tst_objective_oriented_test_pass_without_questions'), $this->object->getTitle()), true);
 
        $this->backToInfoScreenCmd();
    }

References ilTestPlayerAbstractGUI\backToInfoScreenCmd(), and ILIAS\Repository\lng().

Referenced by showQuestionCmd().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ isFirstQuestionInSequence()

ilTestOutputGUI::isFirstQuestionInSequence ( $sequenceElement )

protected

Reimplemented from ilTestPlayerAbstractGUI.

Definition at line 630 of file class.ilTestOutputGUI.php.

                                                                  : bool
    {
        return $sequenceElement == $this->testSequence->getFirstSequence();
    }

◆ isLastQuestionInSequence()

ilTestOutputGUI::isLastQuestionInSequence ( $sequenceElement )

protected

Reimplemented from ilTestPlayerAbstractGUI.

Definition at line 635 of file class.ilTestOutputGUI.php.

                                                                 : bool
    {
        return $sequenceElement == $this->testSequence->getLastSequence();
    }

◆ isOptionalQuestionAnsweringConfirmationRequired()

ilTestOutputGUI::isOptionalQuestionAnsweringConfirmationRequired ( $sequenceKey )

protected

Reimplemented from ilTestPlayerAbstractGUI.

Definition at line 914 of file class.ilTestOutputGUI.php.

                                                                                    : bool
    {
        if ($this->testSequence->isAnsweringOptionalQuestionsConfirmed()) {
            return false;
        }
 
        $questionId = $this->testSequence->getQuestionForSequence($sequenceKey);
 
        if (!$this->testSequence->isQuestionOptional($questionId)) {
            return false;
        }
 
        return true;
    }

◆ isQuestionSummaryFinishTestButtonRequired()

ilTestOutputGUI::isQuestionSummaryFinishTestButtonRequired ( )

protected

Reimplemented from ilTestPlayerAbstractGUI.

Definition at line 929 of file class.ilTestOutputGUI.php.

                                                                  : bool
    {
        return true;
    }

◆ isShowingPostponeStatusReguired()

ilTestOutputGUI::isShowingPostponeStatusReguired ( $questionId )

protected

Reimplemented from ilTestPlayerAbstractGUI.

Definition at line 887 of file class.ilTestOutputGUI.php.

                                                                   : bool
    {
        return $this->testSequence->isPostponedQuestion($questionId);
    }

◆ isValidSequenceElement()

ilTestOutputGUI::isValidSequenceElement ( $sequenceElement )

private

Definition at line 279 of file class.ilTestOutputGUI.php.

                                                             : bool
    {
        if ($sequenceElement === false) {
            return false;
        }
 
        if ($sequenceElement < 1) {
            return false;
        }
 
        if (!$this->testSequence->getPositionOfSequence($sequenceElement)) {
            return false;
        }
 
        return true;
    }

Referenced by nextQuestionCmd(), previousQuestionCmd(), showQuestionCmd(), skipQuestionCmd(), and submitSolutionAndNextCmd().

Here is the caller graph for this function:

◆ nextQuestionCmd()

ilTestOutputGUI::nextQuestionCmd ( )

protected

Reimplemented from ilTestPlayerAbstractGUI.

Definition at line 592 of file class.ilTestOutputGUI.php.

    {
        $this->handleCheckTestPassValid();
        $lastSequenceElement = $this->getCurrentSequenceElement();
        $nextSequenceElement = $this->testSequence->getNextSequence($lastSequenceElement);
 
        if ($this->object->isPostponingEnabled()) {
            $this->handleQuestionPostponing($lastSequenceElement);
        }
 
        if (!$this->isValidSequenceElement($nextSequenceElement)) {
            $nextSequenceElement = $this->testSequence->getFirstSequence();
        }
 
        $this->ctrl->setParameter($this, 'sequence', $nextSequenceElement);
        $this->ctrl->setParameter($this, 'pmode', '');
 
        $this->ctrl->redirect($this, ilTestPlayerCommands::SHOW_QUESTION);
    }

References ILIAS\Repository\ctrl(), ilTestPlayerAbstractGUI\getCurrentSequenceElement(), handleCheckTestPassValid(), handleQuestionPostponing(), isValidSequenceElement(), ILIAS\Repository\object(), and ilTestPlayerCommands\SHOW_QUESTION.

Here is the call graph for this function:

◆ performTearsAndAngerBrokenConfessionChecks()

ilTestOutputGUI::performTearsAndAngerBrokenConfessionChecks ( )

protected

Definition at line 775 of file class.ilTestOutputGUI.php.

                                                                   : bool
    {
        if ($this->testSession->getActiveId() > 0) {
            if ($this->testSequence->hasRandomQuestionsForPass($this->testSession->getActiveId(), $this->testSession->getPass()) > 0) {
                // Something went wrong. Maybe the user pressed the start button twice
                // Questions already exist so there is no need to create new questions
 
                global $DIC;
                $ilLog = $DIC['ilLog'];
                $ilUser = $DIC['ilUser'];
 
                $ilLog->write(
                    __METHOD__ . ' Random Questions allready exists for user ' .
                    $ilUser->getId() . ' in test ' . $this->object->getTestId()
                );
 
                return true;
            }
        } else {
            // This may not happen! If it happens, raise a fatal error...
 
            global $DIC;
            $ilLog = $DIC['ilLog'];
            $ilUser = $DIC['ilUser'];
 
            $ilLog->write(__METHOD__ . ' ' . sprintf(
                $this->lng->txt("error_random_question_generation"),
                $ilUser->getId(),
                $this->object->getTestId()
            ));
 
            return true;
        };
 
        return false;
    }

References $DIC, $ilUser, and ILIAS\Repository\lng().

Referenced by generateRandomTestPassForActiveUser().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ populateQuestionOptionalMessage()

ilTestOutputGUI::populateQuestionOptionalMessage ( )

abstractprotected

Reimplemented in ilTestPlayerFixedQuestionSetGUI, and ilTestPlayerRandomQuestionSetGUI.

Referenced by showQuestionCmd().

Here is the caller graph for this function:

◆ previousQuestionCmd()

ilTestOutputGUI::previousQuestionCmd ( )

protected

Reimplemented from ilTestPlayerAbstractGUI.

Definition at line 612 of file class.ilTestOutputGUI.php.

    {
        $this->handleCheckTestPassValid();
 
        $sequenceElement = $this->testSequence->getPreviousSequence(
            $this->getCurrentSequenceElement()
        );
 
        if (!$this->isValidSequenceElement($sequenceElement)) {
            $sequenceElement = $this->testSequence->getLastSequence();
        }
 
        $this->ctrl->setParameter($this, 'sequence', $sequenceElement);
        $this->ctrl->setParameter($this, 'pmode', '');
 
        $this->ctrl->redirect($this, ilTestPlayerCommands::SHOW_QUESTION);
    }

References ILIAS\Repository\ctrl(), ilTestPlayerAbstractGUI\getCurrentSequenceElement(), handleCheckTestPassValid(), isValidSequenceElement(), and ilTestPlayerCommands\SHOW_QUESTION.

Here is the call graph for this function:

◆ resumePlayerCmd()

ilTestOutputGUI::resumePlayerCmd ( )

protected

Resume a test at the last position.

Reimplemented from ilTestPlayerAbstractGUI.

Definition at line 841 of file class.ilTestOutputGUI.php.

    {
        $this->handleUserSettings();
 
        $active_id = $this->testSession->getActiveId();
        $this->ctrl->setParameter($this, "active_id", $active_id);
 
        $active_time_id = $this->object->startWorkingTime($active_id, $this->testSession->getPass());
        ilSession::set("active_time_id", $active_time_id);
        ilSession::set('tst_pass_finish', 0);
 
        if ($this->object->isRandomTest()) {
            if (!$this->testSequence->hasRandomQuestionsForPass($active_id, $this->testSession->getPass())) {
                // create a new set of random questions
                $this->generateRandomTestPassForActiveUser();
            }
        }
 
        $shuffle = $this->object->getShuffleQuestions();
        if ($this->object->isRandomTest()) {
            $shuffle = false;
        }
 
        assQuestion::_updateTestPassResults(
            $active_id,
            $this->testSession->getPass(),
            $this->object->areObligationsEnabled(),
            null,
            $this->object->getId()
        );
 
        // ensure existing test sequence
        if (!$this->testSequence->hasSequence()) {
            $this->testSequence->createNewSequence($this->object->getQuestionCount(), $shuffle);
            $this->testSequence->saveToDb();
        }
 
        if ($this->object->getListOfQuestionsStart()) {
            $this->ctrl->redirect($this, ilTestPlayerCommands::QUESTION_SUMMARY);
        }
 
        $this->ctrl->setParameter($this, 'sequence', $this->testSession->getLastSequence());
        $this->ctrl->setParameter($this, 'pmode', '');
        $this->ctrl->redirect($this, ilTestPlayerCommands::SHOW_QUESTION);
    }

References ILIAS\Repository\ctrl(), generateRandomTestPassForActiveUser(), ilTestPlayerAbstractGUI\handleUserSettings(), ILIAS\Repository\object(), ilTestPlayerCommands\QUESTION_SUMMARY, ilSession\set(), and ilTestPlayerCommands\SHOW_QUESTION.

Here is the call graph for this function:

◆ saveQuestionSolution()

ilTestOutputGUI::saveQuestionSolution	(	$authorized = `true`,
		$force = `false`
	)

saves the user input of a question

Reimplemented from ilTestPlayerAbstractGUI.

Definition at line 661 of file class.ilTestOutputGUI.php.

                                                                            : bool
    {
        $this->updateWorkingTime();
        $this->saveResult = false;
        if (!$force) {
            $formtimestamp = $_POST["formtimestamp"] ?? '';
            if (strlen($formtimestamp) == 0) {
                $formtimestamp = $this->testrequest->raw("formtimestamp");
            }
            if (ilSession::get('formtimestamp') == null || $formtimestamp != ilSession::get("formtimestamp")) {
                ilSession::set("formtimestamp", $formtimestamp);
            } else {
                return false;
            }
        }
 
        /*
            #21097 - exceed maximum passes
            this is a battle of conditions; e.g. ilTestPlayerAbstractGUI::autosaveOnTimeLimitCmd forces saving of results.
            However, if an admin has finished the pass in the meantime, a new pass should not be created.
        */
        if ($force && $this->isNrOfTriesReached()) {
            $force = false;
        }
 
        // save question solution
        if ($this->canSaveResult() || $force) {
            // but only if the ending time is not reached
            $q_id = $this->testSequence->getQuestionForSequence($this->testrequest->raw("sequence"));
 
            if ($this->isParticipantsAnswerFixed($q_id)) {
                // should only be reached by firebugging the disabled form in ui
                throw new ilTestException('not allowed request');
            }
 
            if (is_numeric($q_id) && (int) $q_id) {
                $questionOBJ = $this->getQuestionInstance($q_id);
 
                $active_id = (int) $this->testSession->getActiveId();
                $pass = ilObjTest::_getPass($active_id);
                $this->saveResult = $questionOBJ->persistWorkingState(
                    $active_id,
                    $pass,
                    $this->object->areObligationsEnabled(),
                    $authorized
                );
 
                if ($authorized && $this->testSession->isObjectiveOriented()) {
                    $objectivesAdapter = ilLOTestQuestionAdapter::getInstance($this->testSession);
                    $objectivesAdapter->updateQuestionResult($this->testSession, $questionOBJ);
                }
 
                if ($authorized && $this->object->isSkillServiceToBeConsidered()) {
                    $this->handleSkillTriggering($this->testSession);
                }
            }
        }
 
        if ($this->saveResult == false || (!$questionOBJ->validateSolutionSubmit() && $questionOBJ->savePartial())) {
            $this->ctrl->setParameter($this, "save_error", "1");
            ilSession::set("previouspost", $_POST);
        }
 
        return $this->saveResult;
    }

References ilTestPlayerAbstractGUI\$saveResult, ilObjTest\_getPass(), canSaveResult(), ILIAS\Repository\ctrl(), ilSession\get(), ilLOTestQuestionAdapter\getInstance(), ilTestPlayerAbstractGUI\getQuestionInstance(), ilTestPlayerAbstractGUI\handleSkillTriggering(), ILIAS\Repository\int(), ilTestPlayerAbstractGUI\isNrOfTriesReached(), ilTestPlayerAbstractGUI\isParticipantsAnswerFixed(), ILIAS\Repository\object(), ilSession\set(), and ilTestPlayerAbstractGUI\updateWorkingTime().

Referenced by handleQuestionActionCmd(), showInstantResponseCmd(), submitSolutionAndNextCmd(), and submitSolutionCmd().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ showInstantResponseCmd()

ilTestOutputGUI::showInstantResponseCmd ( )

protected

Reimplemented from ilTestPlayerAbstractGUI.

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

    {
        $questionId = $this->testSequence->getQuestionForSequence(
            $this->getCurrentSequenceElement()
        );
 
        if (!$this->isParticipantsAnswerFixed($questionId)) {
            if ($this->saveQuestionSolution(true)) {
                $this->removeIntermediateSolution();
                $this->setAnswerChangedParameter(false);
            } else {
                $this->ctrl->redirect($this, ilTestPlayerCommands::SHOW_QUESTION);
            }
            $this->testSequence->setQuestionChecked($questionId);
            $this->testSequence->saveToDb();
        } elseif ($this->object->isForceInstantFeedbackEnabled()) {
            $this->testSequence->setQuestionChecked($questionId);
            $this->testSequence->saveToDb();
        }
 
        $this->ctrl->setParameter($this, 'instresp', 1);
 
        // fau: testNav - handle navigation after feedback
        if ($this->getNavigationUrlParameter()) {
            $this->saveNavigationPreventConfirmation();
            $this->registerForcedFeedbackNavUrl($this->getNavigationUrlParameter());
        }
        // fau.
        $this->ctrl->redirect($this, ilTestPlayerCommands::SHOW_QUESTION);
    }

References ILIAS\Repository\ctrl(), ilTestPlayerAbstractGUI\getCurrentSequenceElement(), ilTestPlayerAbstractGUI\getNavigationUrlParameter(), ilTestPlayerAbstractGUI\isParticipantsAnswerFixed(), ILIAS\Repository\object(), ilTestPlayerAbstractGUI\registerForcedFeedbackNavUrl(), ilTestPlayerAbstractGUI\removeIntermediateSolution(), ilTestPlayerAbstractGUI\saveNavigationPreventConfirmation(), saveQuestionSolution(), ilTestPlayerAbstractGUI\setAnswerChangedParameter(), and ilTestPlayerCommands\SHOW_QUESTION.

Here is the call graph for this function:

◆ showQuestionCmd()

ilTestOutputGUI::showQuestionCmd ( )

protected

Reimplemented from ilTestPlayerAbstractGUI.

Definition at line 296 of file class.ilTestOutputGUI.php.

    {
        ilSession::set('tst_pass_finish', 0);
 
        ilSession::set(
            "active_time_id",
            $this->object->startWorkingTime(
                $this->testSession->getActiveId(),
                $this->testSession->getPass()
            )
        );
 
        global $DIC;
        $help = $DIC->help();
        $help->setScreenIdComponent("tst");
        $help->setScreenId("assessment");
        $help->setSubScreenId("question");
 
        $sequenceElement = $this->getCurrentSequenceElement();
 
        if (!$this->isValidSequenceElement($sequenceElement)) {
            $sequenceElement = $this->testSequence->getFirstSequence();
        }
 
        $this->testSession->setLastSequence($sequenceElement);
        $this->testSession->saveToDb();
 
 
        $questionId = $this->testSequence->getQuestionForSequence($sequenceElement);
 
        if (!(int) $questionId && $this->testSession->isObjectiveOriented()) {
            $this->handleTearsAndAngerNoObjectiveOrientedQuestion();
        }
 
        if (!$this->testSequence->isQuestionPresented($questionId)) {
            $this->testSequence->setQuestionPresented($questionId);
            $this->testSequence->saveToDb();
        }
 
        $isQuestionWorkedThrough = assQuestion::_isWorkedThrough(
            $this->testSession->getActiveId(),
            $questionId,
            $this->testSession->getPass()
        );
 
        // fau: testNav - always use edit mode, except for fixed answer
        if ($this->isParticipantsAnswerFixed($questionId)) {
            $presentationMode = ilTestPlayerAbstractGUI::PRESENTATION_MODE_VIEW;
            $instantResponse = true;
        } else {
            $presentationMode = ilTestPlayerAbstractGUI::PRESENTATION_MODE_EDIT;
            // #37025 don't show instant response if a request for it should fix the answer and answer is not yet fixed
            if ($this->object->isInstantFeedbackAnswerFixationEnabled()) {
                $instantResponse = false;
            } else {
                $instantResponse = $this->getInstantResponseParameter();
            }
        }
        // fau.
 
        $questionGui = $this->getQuestionGuiInstance($questionId);
 
        if (!($questionGui instanceof assQuestionGUI)) {
            $this->handleTearsAndAngerQuestionIsNull($questionId, $sequenceElement);
        }
 
        $questionGui->setSequenceNumber($this->testSequence->getPositionOfSequence($sequenceElement));
        $questionGui->setQuestionCount($this->testSequence->getUserQuestionCount());
 
        $headerBlockBuilder = new ilTestQuestionHeaderBlockBuilder($this->lng);
        $headerBlockBuilder->setHeaderMode($this->object->getTitleOutput());
        $headerBlockBuilder->setQuestionTitle($questionGui->object->getTitleForHTMLOutput());
        $headerBlockBuilder->setQuestionPoints($questionGui->object->getPoints());
        $headerBlockBuilder->setQuestionPosition($this->testSequence->getPositionOfSequence($sequenceElement));
        $headerBlockBuilder->setQuestionCount($this->testSequence->getUserQuestionCount());
        $headerBlockBuilder->setQuestionPostponed($this->testSequence->isPostponedQuestion($questionId));
        $headerBlockBuilder->setQuestionObligatory(
            $this->object->areObligationsEnabled() && ilObjTest::isQuestionObligatory($questionGui->object->getId())
        );
        if ($this->testSession->isObjectiveOriented()) {
            $objectivesAdapter = ilLOTestQuestionAdapter::getInstance($this->testSession);
            $objectivesAdapter->buildQuestionRelatedObjectiveList($this->testSequence, $this->questionRelatedObjectivesList);
            $this->questionRelatedObjectivesList->loadObjectivesTitles();
 
            $objectivesString = $this->questionRelatedObjectivesList->getQuestionRelatedObjectiveTitles($questionId);
            $headerBlockBuilder->setQuestionRelatedObjectives($objectivesString);
        }
        $questionGui->setQuestionHeaderBlockBuilder($headerBlockBuilder);
 
        $this->prepareTestPage($presentationMode, $sequenceElement, $questionId);
 
        $navigationToolbarGUI = $this->getTestNavigationToolbarGUI();
        $navigationToolbarGUI->setFinishTestButtonEnabled(true);
 
        $isNextPrimary = $this->handlePrimaryButton($navigationToolbarGUI, $questionId);
 
        $this->ctrl->setParameter($this, 'sequence', $sequenceElement);
        $this->ctrl->setParameter($this, 'pmode', $presentationMode);
        $formAction = $this->ctrl->getFormAction($this, ilTestPlayerCommands::SUBMIT_INTERMEDIATE_SOLUTION);
 
        switch ($presentationMode) {
            case ilTestPlayerAbstractGUI::PRESENTATION_MODE_EDIT:
 
                // fau: testNav - enable navigation toolbar in edit mode
                $navigationToolbarGUI->setDisabledStateEnabled(false);
                // fau.
                $this->showQuestionEditable($questionGui, $formAction, $isQuestionWorkedThrough, $instantResponse);
 
                break;
 
            case ilTestPlayerAbstractGUI::PRESENTATION_MODE_VIEW:
 
                if ($this->testSequence->isQuestionOptional($questionGui->object->getId())) {
                    $this->populateQuestionOptionalMessage();
                }
 
                $this->showQuestionViewable($questionGui, $formAction, $isQuestionWorkedThrough, $instantResponse);
 
                break;
 
            default:
                throw new ilTestException('no presentation mode given');
        }
 
        $navigationToolbarGUI->build();
        $this->populateTestNavigationToolbar($navigationToolbarGUI);
 
        // fau: testNav - enable the question navigation in edit mode
        $this->populateQuestionNavigation($sequenceElement, false, $isNextPrimary);
        // fau.
 
        if ($instantResponse) {
            // fau: testNav - always use authorized solution for instant feedback
            $this->populateInstantResponseBlocks(
                $questionGui,
                true
            );
            // fau.
        }
 
        // fau: testNav - add feedback modal
        if ($this->isForcedFeedbackNavUrlRegistered()) {
            $this->populateInstantResponseModal($questionGui, $this->getRegisteredForcedFeedbackNavUrl());
            $this->unregisterForcedFeedbackNavUrl();
        }
        // fau.
    }

Here is the call graph for this function:

◆ skipQuestionCmd()

ilTestOutputGUI::skipQuestionCmd ( )

protected

Reimplemented from ilTestPlayerAbstractGUI.

Definition at line 544 of file class.ilTestOutputGUI.php.

    {
        $curSequenceElement = $this->getCurrentSequenceElement();
        $nextSequenceElement = $this->testSequence->getNextSequence($curSequenceElement);
 
        if (!$this->isValidSequenceElement($nextSequenceElement)) {
            $nextSequenceElement = $this->testSequence->getFirstSequence();
        }
 
        if ($this->object->isPostponingEnabled()) {
            $this->testSequence->postponeSequence($curSequenceElement);
            $this->testSequence->saveToDb();
        }
 
        $this->ctrl->setParameter($this, 'sequence', $nextSequenceElement);
        $this->ctrl->setParameter($this, 'pmode', '');
 
        $this->ctrl->redirect($this, ilTestPlayerCommands::SHOW_QUESTION);
    }

References ILIAS\Repository\ctrl(), ilTestPlayerAbstractGUI\getCurrentSequenceElement(), isValidSequenceElement(), ILIAS\Repository\object(), and ilTestPlayerCommands\SHOW_QUESTION.

Here is the call graph for this function:

◆ startTestCmd()

ilTestOutputGUI::startTestCmd ( )

protected

Reimplemented from ilTestPlayerAbstractGUI.

Definition at line 186 of file class.ilTestOutputGUI.php.

    {
        global $DIC;
        $ilUser = $DIC['ilUser'];
 
        ilSession::set('tst_pass_finish', 0);
 
        // ensure existing test session
        $this->testSession->setUserId($ilUser->getId());
        $access_code = ilSession::get('tst_access_code');
        if ($access_code != null && isset($access_code[$this->object->getTestId()])) {
            $this->testSession->setAnonymousId((int) $access_code[$this->object->getTestId()]);
        }
        if ($this->getObjectiveOrientedContainer()->isObjectiveOrientedPresentationRequired()) {
            $this->testSession->setObjectiveOrientedContainerId($this->getObjectiveOrientedContainer()->getObjId());
        }
        $this->testSession->saveToDb();
 
        $active_id = $this->testSession->getActiveId();
        $this->ctrl->setParameter($this, "active_id", $active_id);
 
        $shuffle = $this->object->getShuffleQuestions();
        if ($this->object->isRandomTest()) {
            $this->generateRandomTestPassForActiveUser();
 
            $this->object->loadQuestions();
            $shuffle = false; // shuffle is already done during the creation of the random questions
        }
 
        assQuestion::_updateTestPassResults(
            $active_id,
            $this->testSession->getPass(),
            $this->object->areObligationsEnabled(),
            null,
            $this->object->getId()
        );
 
        // ensure existing test sequence
        if (!$this->testSequence->hasSequence()) {
            $this->testSequence->createNewSequence($this->object->getQuestionCount(), $shuffle);
            $this->testSequence->saveToDb();
        }
 
        $this->testSequence->loadFromDb();
        $this->testSequence->loadQuestions();
 
        if ($this->testSession->isObjectiveOriented()) {
            $objectivesAdapter = ilLOTestQuestionAdapter::getInstance($this->testSession);
 
            $objectivesAdapter->notifyTestStart($this->testSession, $this->object->getId());
            $objectivesAdapter->prepareTestPass($this->testSession, $this->testSequence);
 
            $objectivesAdapter->buildQuestionRelatedObjectiveList(
                $this->testSequence,
                $this->questionRelatedObjectivesList
            );
 
            if ($this->testSequence->hasOptionalQuestions()) {
                $this->adoptUserSolutionsFromPreviousPass();
 
                $this->testSequence->reorderOptionalQuestionsToSequenceEnd();
                $this->testSequence->saveToDb();
            }
        }
 
        $active_time_id = $this->object->startWorkingTime(
            $this->testSession->getActiveId(),
            $this->testSession->getPass()
        );
        ilSession::set("active_time_id", $active_time_id);
 
        $this->updateLearningProgressOnTestStart();
 
        $sequenceElement = $this->testSequence->getFirstSequence();
 
        $this->ctrl->setParameter($this, 'sequence', $sequenceElement);
        $this->ctrl->setParameter($this, 'pmode', '');
 
        if ($this->object->getListOfQuestionsStart()) {
            $this->ctrl->redirect($this, ilTestPlayerCommands::QUESTION_SUMMARY);
        }
 
        $this->ctrl->redirect($this, ilTestPlayerCommands::SHOW_QUESTION);
    }

References $DIC, $ilUser, adoptUserSolutionsFromPreviousPass(), ILIAS\Repository\ctrl(), generateRandomTestPassForActiveUser(), ilSession\get(), ilLOTestQuestionAdapter\getInstance(), ilTestServiceGUI\getObjectiveOrientedContainer(), ILIAS\Repository\object(), ilTestPlayerCommands\QUESTION_SUMMARY, ilSession\set(), ilTestPlayerCommands\SHOW_QUESTION, and updateLearningProgressOnTestStart().

Here is the call graph for this function:

◆ submitSolutionAndNextCmd()

ilTestOutputGUI::submitSolutionAndNextCmd ( )

protected

Definition at line 450 of file class.ilTestOutputGUI.php.

    {
        if ($this->object->isForceInstantFeedbackEnabled()) {
            $this->submitSolutionCmd();
            return;
        }
 
        if ($this->saveQuestionSolution(true, false)) {
            $questionId = $this->testSequence->getQuestionForSequence(
                $this->getCurrentSequenceElement()
            );
 
            $this->removeIntermediateSolution();
 
            $nextSequenceElement = $this->testSequence->getNextSequence($this->getCurrentSequenceElement());
 
            if (!$this->isValidSequenceElement($nextSequenceElement)) {
                $nextSequenceElement = $this->testSequence->getFirstSequence();
            }
 
            $this->testSession->setLastSequence($nextSequenceElement);
            $this->testSession->saveToDb();
 
            $this->ctrl->setParameter($this, 'sequence', $nextSequenceElement);
            $this->ctrl->setParameter($this, 'pmode', '');
        }
 
        $this->ctrl->redirect($this, ilTestPlayerCommands::SHOW_QUESTION);
    }

References ILIAS\Repository\ctrl(), ilTestPlayerAbstractGUI\getCurrentSequenceElement(), isValidSequenceElement(), ILIAS\Repository\object(), ilTestPlayerAbstractGUI\removeIntermediateSolution(), saveQuestionSolution(), ilTestPlayerCommands\SHOW_QUESTION, and submitSolutionCmd().

Here is the call graph for this function:

◆ submitSolutionCmd()

ilTestOutputGUI::submitSolutionCmd ( )

protected

Reimplemented from ilTestPlayerAbstractGUI.

Definition at line 480 of file class.ilTestOutputGUI.php.

    {
        if ($this->saveQuestionSolution(true, false)) {
            $questionId = $this->testSequence->getQuestionForSequence(
                $this->getCurrentSequenceElement()
            );
 
            $this->removeIntermediateSolution();
 
            if ($this->object->isForceInstantFeedbackEnabled()) {
                $this->ctrl->setParameter($this, 'instresp', 1);
 
                $this->testSequence->setQuestionChecked($questionId);
                $this->testSequence->saveToDb();
            }
 
            if ($this->getNextCommandParameter()) {
                if ($this->getNextSequenceParameter()) {
                    $this->ctrl->setParameter($this, 'sequence', $this->getNextSequenceParameter());
                    $this->ctrl->setParameter($this, 'pmode', '');
                }
 
                $this->ctrl->redirect($this, $this->getNextCommandParameter());
            }
 
            $this->ctrl->setParameter($this, 'pmode', ilTestPlayerAbstractGUI::PRESENTATION_MODE_VIEW);
        } else {
            $this->ctrl->redirect($this, ilTestPlayerCommands::SHOW_QUESTION);
        }
 
        // fau: testNav - remember to prevent the navigation confirmation
        $this->saveNavigationPreventConfirmation();
        // fau.
 
        // fau: testNav - handle navigation after saving
        if ($this->getNavigationUrlParameter()) {
            ilUtil::redirect($this->getNavigationUrlParameter());
        } else {
            $this->ctrl->saveParameter($this, 'sequence');
        }
        // fau.
        $this->ctrl->redirect($this, ilTestPlayerCommands::SHOW_QUESTION);
    }

References ILIAS\Repository\ctrl(), ilTestPlayerAbstractGUI\getCurrentSequenceElement(), ilTestPlayerAbstractGUI\getNavigationUrlParameter(), ilTestPlayerAbstractGUI\getNextCommandParameter(), ilTestPlayerAbstractGUI\getNextSequenceParameter(), ILIAS\Repository\object(), ilTestPlayerAbstractGUI\PRESENTATION_MODE_VIEW, ilUtil\redirect(), ilTestPlayerAbstractGUI\removeIntermediateSolution(), ilTestPlayerAbstractGUI\saveNavigationPreventConfirmation(), saveQuestionSolution(), and ilTestPlayerCommands\SHOW_QUESTION.

Referenced by submitSolutionAndNextCmd().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ updateLearningProgressOnTestStart()

ilTestOutputGUI::updateLearningProgressOnTestStart ( )

protected

Definition at line 271 of file class.ilTestOutputGUI.php.

    {
        global $DIC;
        $ilUser = $DIC['ilUser'];
 
        ilLPStatusWrapper::_updateStatus($this->object->getId(), $ilUser->getId());
    }

References $DIC, $ilUser, ilLPStatusWrapper\_updateStatus(), and ILIAS\Repository\object().

Referenced by startTestCmd().

Here is the call graph for this function:

Here is the caller graph for this function:

Field Documentation

◆ $questionRelatedObjectivesList

ilTestOutputGUI::$questionRelatedObjectivesList

protected

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

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

Modules/Test/classes/class.ilTestOutputGUI.php

Public Member Functions

Protected Member Functions

Protected Attributes

Private Member Functions

Additional Inherited Members

Detailed Description

Member Function Documentation

◆ adoptUserSolutionsFromPreviousPass()

◆ canSaveResult()

◆ discardSolutionCmd()

◆ editSolutionCmd()

◆ executeCommand()

◆ generateRandomTestPassForActiveUser()

◆ getCurrentQuestionId()

◆ handleCheckTestPassValid()

◆ handlePrimaryButton()

◆ handleQuestionActionCmd()

◆ handleQuestionPostponing()

◆ handleTearsAndAngerNoObjectiveOrientedQuestion()

◆ isFirstQuestionInSequence()

◆ isLastQuestionInSequence()

◆ isOptionalQuestionAnsweringConfirmationRequired()

◆ isQuestionSummaryFinishTestButtonRequired()

◆ isShowingPostponeStatusReguired()

◆ isValidSequenceElement()

◆ nextQuestionCmd()

◆ performTearsAndAngerBrokenConfessionChecks()

◆ populateQuestionOptionalMessage()

◆ previousQuestionCmd()

◆ resumePlayerCmd()

◆ saveQuestionSolution()

◆ showInstantResponseCmd()

◆ showQuestionCmd()

◆ skipQuestionCmd()

◆ startTestCmd()

◆ submitSolutionAndNextCmd()

◆ submitSolutionCmd()

◆ updateLearningProgressOnTestStart()

Field Documentation

◆ $questionRelatedObjectivesList