ILIAS  release_5-2 Revision v5.2.25-18-g3f80b828510
Public Member Functions | Protected Member Functions | Protected Attributes | Private Member Functions
ilTestOutputGUI Class Reference

Output class for assessment test execution. 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 ()
 
 autosaveCmd ()
 
 toggleSideListCmd ()
 Toggle side list. More...
 
 finishTestCmd ($requires_confirmation=true)
 
 redirectBackCmd ()
 
 showFinalStatementCmd ()
 
 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...
 
 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)
 
 outQuestionSummaryCmd ($fullpage=true, $contextFinishTest=false, $obligationsNotAnswered=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)
 
 setObjectiveOrientedContainer (ilTestObjectiveOrientedContainer $objectiveOrientedContainer)
 
 getObjectiveOrientedContainer ()
 
 executeCommand ()
 execute command More...
 
 getCommand ($cmd)
 Retrieves the ilCtrl command. More...
 
 buildPassOverviewTableGUI ($targetGUI, $targetCmd='')
 
 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)
 

Protected Member Functions

 startTestCmd ()
 
 updateLearningProgressOnTestStart ()
 
 showQuestionCmd ()
 
 editSolutionCmd ()
 
 submitSolutionAndNextCmd ()
 
 submitSolutionCmd ()
 
 discardSolutionCmd ()
 
 skipQuestionCmd ()
 
 handleQuestionPostponing ($sequenceElement)
 
 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 ($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 ()
 
 isTestSignRedirectRequired ($activeId, $lastFinishedPass)
 
 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)
 
 getCurrentSequenceElement ()
 
 resetSequenceElementParameter ()
 
 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 ($questionId, $fromCache=true)
 
 getQuestionInstance ($questionId, $fromCache=true)
 
 initTestQuestionConfig (assQuestion $questionOBJ)
 
 buildQuestionAnswerShuffler ($questionId)
 
 handleTearsAndAngerQuestionIsNull ($questionId, $sequenceElement)
 
 populateMessageContent ($contentHTML)
 
 populateModals ()
 
 populateDiscardSolutionModal ()
 
 populateNavWhenChangedModal ()
 
 getQuestionsDefaultPresentationMode ($isQuestionWorkedThrough)
 
 buildFixedShufflerSeed ($questionId)
 
 registerForcedFeedbackNavUrl ($forcedFeedbackNavUrl)
 
 getRegisteredForcedFeedbackNavUrl ()
 
 isForcedFeedbackNavUrlRegistered ()
 
 unregisterForcedFeedbackNavUrl ()
 
- Protected Member Functions inherited from ilTestServiceGUI
 handleTabs ($activeTabId)
 
 isPdfDeliveryRequest ()
 
 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
 $db
 
 $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
 
- Data Fields inherited from ilTestServiceGUI
 $object = null
 
 $service = null
 
 $lng
 
 $tpl
 
 $ctrl
 
 $ilias
 
 $tree
 
 $ref_id
 

Detailed Description

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 20 of file class.ilTestOutputGUI.php.

Member Function Documentation

◆ adoptUserSolutionsFromPreviousPass()

ilTestOutputGUI::adoptUserSolutionsFromPreviousPass ( )
protected

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

846 {
847 global $ilDB, $ilUser;
848
849 $assSettings = new ilSetting('assessment');
850
851 include_once ("./Modules/Test/classes/class.ilObjAssessmentFolder.php");
852 $isAssessmentLogEnabled = ilObjAssessmentFolder::_enabledAssessmentLogging();
853
854 require_once 'Modules/TestQuestionPool/classes/class.ilAssQuestionUserSolutionAdopter.php';
855 $userSolutionAdopter = new ilAssQuestionUserSolutionAdopter($ilDB, $assSettings, $isAssessmentLogEnabled);
856
857 $userSolutionAdopter->setUserId($ilUser->getId());
858 $userSolutionAdopter->setActiveId($this->testSession->getActiveId());
859 $userSolutionAdopter->setTargetPass($this->testSequence->getPass());
860 $userSolutionAdopter->setQuestionIds($this->testSequence->getOptionalQuestions());
861
862 $userSolutionAdopter->perform();
863 }
ilObjAssessmentFolder\_enabledAssessmentLogging
static _enabledAssessmentLogging()
check wether assessment logging is enabled or not
Definition: class.ilObjAssessmentFolder.php:123
ilSetting
ILIAS Setting Class.
Definition: class.ilSetting.php:33
$ilDB
global $ilDB
Definition: storeScorm2004.php:19
$ilUser
$ilUser
Definition: imgupload.php:18

References ilTestPlayerAbstractGUI\$assSettings, $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 599 of file class.ilTestOutputGUI.php.

600 {
601 return !$this->object->endingTimeReached() && !$this->isMaxProcessingTimeReached() && !$this->isNrOfTriesReached();
602 }
ilTestPlayerAbstractGUI\isMaxProcessingTimeReached
isMaxProcessingTimeReached()
Checks wheather the maximum processing time is reached or not.
Definition: class.ilTestPlayerAbstractGUI.php:215

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 490 of file class.ilTestOutputGUI.php.

491 {
492 $currentSequenceElement = $this->getCurrentSequenceElement();
493
494 $currentQuestionOBJ = $this->getQuestionInstance(
495 $this->testSequence->getQuestionForSequence($currentSequenceElement)
496 );
497
498 $currentQuestionOBJ->resetUsersAnswer(
499 $this->testSession->getActiveId(), $this->testSession->getPass()
500 );
501
502 $this->ctrl->saveParameter($this, 'sequence');
503
504 $this->ctrl->setParameter($this, 'pmode', ilTestPlayerAbstractGUI::PRESENTATION_MODE_VIEW);
505
506 $this->ctrl->redirect($this, ilTestPlayerCommands::SHOW_QUESTION);
507 }
ilTestPlayerAbstractGUI\getQuestionInstance
getQuestionInstance($questionId, $fromCache=true)
Definition: class.ilTestPlayerAbstractGUI.php:2502

References 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 399 of file class.ilTestOutputGUI.php.

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

References ilTestPlayerAbstractGUI\PRESENTATION_MODE_EDIT, and ilTestPlayerCommands\SHOW_QUESTION.

◆ executeCommand()

ilTestOutputGUI::executeCommand ( )

Execute Command.

Reimplemented from ilTestServiceGUI.

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

31 {
32 global $ilDB, $ilPluginAdmin, $lng, $ilTabs;
33
34 $this->checkReadAccess();
35
36 $ilTabs->clearTargets();
37
38 $cmd = $this->ctrl->getCmd();
39 $next_class = $this->ctrl->getNextClass($this);
40
41 $this->ctrl->saveParameter($this, "sequence");
42 $this->ctrl->saveParameter($this, "pmode");
43 $this->ctrl->saveParameter($this, "active_id");
44
45 $this->initAssessmentSettings();
46
47 $testSessionFactory = new ilTestSessionFactory($this->object);
48 $this->testSession = $testSessionFactory->getSession($_GET['active_id']);
49
50 $this->ensureExistingTestSession($this->testSession);
51 $this->checkTestSessionUser($this->testSession);
52
53 $this->initProcessLocker($this->testSession->getActiveId());
54
55 $testSequenceFactory = new ilTestSequenceFactory($ilDB, $lng, $ilPluginAdmin, $this->object);
56 $this->testSequence = $testSequenceFactory->getSequenceByTestSession($this->testSession);
57 $this->testSequence->loadFromDb();
58 $this->testSequence->loadQuestions();
59
60 require_once 'Modules/Test/classes/class.ilTestQuestionRelatedObjectivesList.php';
61 $this->questionRelatedObjectivesList = new ilTestQuestionRelatedObjectivesList();
62
63 include_once 'Services/jQuery/classes/class.iljQueryUtil.php';
64 iljQueryUtil::initjQuery();
65 include_once "./Services/YUI/classes/class.ilYuiUtil.php";
66 ilYuiUtil::initConnectionWithAnimation();
67
68 $this->handlePasswordProtectionRedirect();
69
70 $cmd = $this->getCommand($cmd);
71
72 switch($next_class)
73 {
74 case 'ilassquestionpagegui':
75
76 $this->checkTestExecutable();
77
78 $questionId = $this->testSequence->getQuestionForSequence($this->getCurrentSequenceElement());
79
80 require_once "./Modules/TestQuestionPool/classes/class.ilAssQuestionPageGUI.php";
81 $page_gui = new ilAssQuestionPageGUI($questionId);
82 $ret = $this->ctrl->forwardCommand($page_gui);
83 break;
84
85 case 'iltestsubmissionreviewgui':
86
87 $this->checkTestExecutable();
88
89 require_once './Modules/Test/classes/class.ilTestSubmissionReviewGUI.php';
90 $gui = new ilTestSubmissionReviewGUI($this, $this->object, $this->testSession);
91 $gui->setObjectiveOrientedContainer($this->getObjectiveOrientedContainer());
92 $ret = $this->ctrl->forwardCommand($gui);
93 break;
94
95 case 'ilassquestionhintrequestgui':
96
97 $this->checkTestExecutable();
98
99 $questionGUI = $this->object->createQuestionGUI(
100 "", $this->testSequence->getQuestionForSequence($this->getCurrentSequenceElement())
101 );
102
103 require_once 'Modules/TestQuestionPool/classes/class.ilAssQuestionHintTracking.php';
104 $questionHintTracking = new ilAssQuestionHintTracking(
105 $questionGUI->object->getId(), $this->testSession->getActiveId(), $this->testSession->getPass()
106 );
107
108 require_once 'Modules/TestQuestionPool/classes/class.ilAssQuestionHintRequestGUI.php';
109 $gui = new ilAssQuestionHintRequestGUI($this, ilTestPlayerCommands::SHOW_QUESTION, $questionGUI, $questionHintTracking);
110
111// fau: testNav - save the 'answer changed' status for viewing hint requests
112 $this->setAnswerChangedParameter($this->getAnswerChangedParameter());
113// fau.
114 $ret = $this->ctrl->forwardCommand($gui);
115
116 break;
117
118 case 'iltestsignaturegui':
119
120 $this->checkTestExecutable();
121
122 require_once './Modules/Test/classes/class.ilTestSignatureGUI.php';
123 $gui = new ilTestSignatureGUI($this);
124 $ret = $this->ctrl->forwardCommand($gui);
125 break;
126
127 case 'iltestpasswordprotectiongui':
128
129 $this->checkTestExecutable();
130
131 require_once 'Modules/Test/classes/class.ilTestPasswordProtectionGUI.php';
132 $gui = new ilTestPasswordProtectionGUI($this->ctrl, $this->tpl, $this->lng, $this, $this->passwordChecker);
133 $ret = $this->ctrl->forwardCommand($gui);
134 break;
135
136 default:
137
138 if( ilTestPlayerCommands::isTestExecutionCommand($cmd) )
139 {
140 $this->checkTestExecutable();
141 }
142
143 $cmd .= 'Cmd';
144 $ret =& $this->$cmd();
145 break;
146 }
147 return $ret;
148 }
$_GET
$_GET["client_id"]
Definition: cfg.phpunit.template.php:12
ilAssQuestionPageGUI
Question page GUI class.
Definition: class.ilAssQuestionPageGUI.php:19
ilTestPlayerAbstractGUI\checkTestSessionUser
checkTestSessionUser(ilTestSession $testSession)
Definition: class.ilTestPlayerAbstractGUI.php:105
ilTestPlayerAbstractGUI\setAnswerChangedParameter
setAnswerChangedParameter($changed=true)
Set the 'answer changed' url parameter for generated links.
Definition: class.ilTestPlayerAbstractGUI.php:2421
ilTestPlayerAbstractGUI\ensureExistingTestSession
ensureExistingTestSession(ilTestSession $testSession)
Definition: class.ilTestPlayerAbstractGUI.php:115
ilTestPlayerAbstractGUI\getAnswerChangedParameter
getAnswerChangedParameter()
Get the 'answer changed' status from the current request It may be set by ilTestPlayerNavigationContr...
Definition: class.ilTestPlayerAbstractGUI.php:2412
ilTestServiceGUI\getCommand
getCommand($cmd)
Retrieves the ilCtrl command.
Definition: class.ilTestServiceGUI.php:306
ilTestSignatureGUI
Signature Plugin Class.
Definition: class.ilTestSignatureGUI.php:15
ilTestSubmissionReviewGUI
Class ilTestSubmissionReviewGUI.
Definition: class.ilTestSubmissionReviewGUI.php:15
ilYuiUtil\initConnectionWithAnimation
static initConnectionWithAnimation()
Init YUI Connection module.
Definition: class.ilYuiUtil.php:108
iljQueryUtil\initjQuery
static initjQuery($a_tpl=null)
Init jQuery.
Definition: class.iljQueryUtil.php:22
$ret
$ret
Definition: parser.php:6
$cmd
$cmd
Definition: sahs_server.php:35

References $_GET, $cmd, $ilDB, ilTestServiceGUI\$lng, $ret, ilTestServiceGUI\$testSequenceFactory, ilTestServiceGUI\$testSessionFactory, ilTestPlayerAbstractGUI\checkReadAccess(), ilTestPlayerAbstractGUI\checkTestExecutable(), ilTestPlayerAbstractGUI\checkTestSessionUser(), ilTestPlayerAbstractGUI\ensureExistingTestSession(), ilTestPlayerAbstractGUI\getAnswerChangedParameter(), ilTestServiceGUI\getCommand(), ilTestPlayerAbstractGUI\getCurrentSequenceElement(), ilTestServiceGUI\getObjectiveOrientedContainer(), ilTestPlayerAbstractGUI\handlePasswordProtectionRedirect(), ilTestPlayerAbstractGUI\initAssessmentSettings(), ilYuiUtil\initConnectionWithAnimation(), iljQueryUtil\initjQuery(), ilTestPlayerAbstractGUI\initProcessLocker(), ilTestPlayerCommands\isTestExecutionCommand(), ilTestPlayerAbstractGUI\setAnswerChangedParameter(), and ilTestPlayerCommands\SHOW_QUESTION.

+ Here is the call graph for this function:

◆ generateRandomTestPassForActiveUser()

ilTestOutputGUI::generateRandomTestPassForActiveUser ( )
protected

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

760 {
761 global $tree, $ilDB, $ilPluginAdmin;
762
763 require_once 'Modules/Test/classes/class.ilTestRandomQuestionSetConfig.php';
764 $questionSetConfig = new ilTestRandomQuestionSetConfig($tree, $ilDB, $ilPluginAdmin, $this->object);
765 $questionSetConfig->loadFromDb();
766
767 require_once 'Modules/Test/classes/class.ilTestRandomQuestionSetSourcePoolDefinitionFactory.php';
768 $sourcePoolDefinitionFactory = new ilTestRandomQuestionSetSourcePoolDefinitionFactory($ilDB, $this->object);
769
770 require_once 'Modules/Test/classes/class.ilTestRandomQuestionSetSourcePoolDefinitionList.php';
771 $sourcePoolDefinitionList = new ilTestRandomQuestionSetSourcePoolDefinitionList($ilDB, $this->object, $sourcePoolDefinitionFactory);
772 $sourcePoolDefinitionList->loadDefinitions();
773
774 $this->processLocker->executeRandomPassBuildOperation(function() use ($ilDB, $ilPluginAdmin, $questionSetConfig, $sourcePoolDefinitionList) {
775
776 if(!$this->performTearsAndAngerBrokenConfessionChecks())
777 {
778 require_once 'Modules/Test/classes/class.ilTestRandomQuestionSetStagingPoolQuestionList.php';
779 $stagingPoolQuestionList = new ilTestRandomQuestionSetStagingPoolQuestionList($ilDB, $ilPluginAdmin);
780
781 require_once 'Modules/Test/classes/class.ilTestRandomQuestionSetBuilder.php';
782 $questionSetBuilder = ilTestRandomQuestionSetBuilder::getInstance($ilDB, $this->object, $questionSetConfig, $sourcePoolDefinitionList, $stagingPoolQuestionList);
783
784 $questionSetBuilder->performBuild($this->testSession);
785 }
786
787 }, $sourcePoolDefinitionList->hasTaxonomyFilters());
788 }
ilTestRandomQuestionSetBuilder\getInstance
static getInstance(ilDBInterface $db, ilObjTest $testOBJ, ilTestRandomQuestionSetConfig $questionSetConfig, ilTestRandomQuestionSetSourcePoolDefinitionList $sourcePoolDefinitionList, ilTestRandomQuestionSetStagingPoolQuestionList $stagingPoolQuestionList)
Definition: class.ilTestRandomQuestionSetBuilder.php:187

References $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 607 of file class.ilTestOutputGUI.php.

608 {
609 return $this->testSequence->getQuestionForSequence($_GET["sequence"]);
610 }

References $_GET.

◆ handlePrimaryButton()

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

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

900 {
901 $isNextPrimary = true;
902
903 if( $this->object->isForceInstantFeedbackEnabled() )
904 {
905 $isNextPrimary = false;
906 }
907
908 $questionsMissingResult = assQuestion::getQuestionsMissingResultRecord(
909 $this->testSession->getActiveId(), $this->testSession->getPass(),
910 $this->testSequence->getOrderedSequenceQuestions()
911 );
912
913 if( !count($questionsMissingResult) )
914 {
915 $navigationToolbarGUI->setFinishTestButtonPrimary(true);
916 $isNextPrimary = false;
917 }
918 elseif( count($questionsMissingResult) == 1 )
919 {
920 $lastOpenQuestion = current($questionsMissingResult);
921
922 if($currentQuestionId == $lastOpenQuestion)
923 {
924 $navigationToolbarGUI->setFinishTestButtonPrimary(true);
925 $isNextPrimary = false;
926 }
927 }
928
929 return $isNextPrimary;
930 }
assQuestion\getQuestionsMissingResultRecord
static getQuestionsMissingResultRecord($activeId, $pass, $questionIds)
Definition: class.assQuestion.php:5411
ilTestNavigationToolbarGUI\setFinishTestButtonPrimary
setFinishTestButtonPrimary($finishTestButtonPrimary)
Definition: class.ilTestNavigationToolbarGUI.php:212

References assQuestion\getQuestionsMissingResultRecord(), 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 706 of file class.ilTestOutputGUI.php.

707 {
708 $questionId = $this->testSequence->getQuestionForSequence(
709 $this->getCurrentSequenceElement()
710 );
711
712 if( !$this->isParticipantsAnswerFixed($questionId) )
713 {
714 $this->updateWorkingTime();
715 $this->saveQuestionSolution(false);
716// fau: testNav - add changed status of the question
717 $this->setAnswerChangedParameter(true);
718// fau.
719 }
720
721 $this->ctrl->redirect($this, ilTestPlayerCommands::SHOW_QUESTION);
722 }
ilTestOutputGUI\saveQuestionSolution
saveQuestionSolution($authorized=true, $force=false)
saves the user input of a question
Definition: class.ilTestOutputGUI.php:615
ilTestPlayerAbstractGUI\updateWorkingTime
updateWorkingTime()
updates working time and stores state saveresult to see if question has to be stored or not
Definition: class.ilTestPlayerAbstractGUI.php:169

References 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 531 of file class.ilTestOutputGUI.php.

532 {
533 $questionId = $this->testSequence->getQuestionForSequence($sequenceElement);
534
535 $isQuestionWorkedThrough = assQuestion::_isWorkedThrough(
536 $this->testSession->getActiveId(), $questionId, $this->testSession->getPass()
537 );
538
539 if( !$isQuestionWorkedThrough )
540 {
541 $this->testSequence->postponeQuestion($questionId);
542 $this->testSequence->saveToDb();
543 }
544 }
assQuestion\_isWorkedThrough
static _isWorkedThrough($active_id, $question_id, $pass=NULL)
Returns true if the question was worked through in the given pass Worked through means that the user ...
Definition: class.assQuestion.php:3580

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 889 of file class.ilTestOutputGUI.php.

890 {
891 ilUtil::sendFailure(sprintf($this->lng->txt('tst_objective_oriented_test_pass_without_questions'), $this->object->getTitle()), true);
892
893 $this->backToInfoScreenCmd();
894 }
sprintf
sprintf('%.4f', $callTime)
Definition: 01pharSimple.php:87
ilUtil\sendFailure
static sendFailure($a_info="", $a_keep=false)
Send Failure Message to Screen.
Definition: class.ilUtil.php:4771

References ilTestPlayerAbstractGUI\backToInfoScreenCmd(), ilUtil\sendFailure(), and sprintf.

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 584 of file class.ilTestOutputGUI.php.

585 {
586 return $sequenceElement == $this->testSequence->getFirstSequence();
587 }

◆ isLastQuestionInSequence()

ilTestOutputGUI::isLastQuestionInSequence (   $sequenceElement)
protected

Reimplemented from ilTestPlayerAbstractGUI.

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

590 {
591 return $sequenceElement == $this->testSequence->getLastSequence();
592 }

◆ isOptionalQuestionAnsweringConfirmationRequired()

ilTestOutputGUI::isOptionalQuestionAnsweringConfirmationRequired (   $sequenceKey)
protected

Reimplemented from ilTestPlayerAbstractGUI.

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

868 {
869 if( $this->testSequence->isAnsweringOptionalQuestionsConfirmed() )
870 {
871 return false;
872 }
873
874 $questionId = $this->testSequence->getQuestionForSequence($sequenceKey);
875
876 if( !$this->testSequence->isQuestionOptional($questionId) )
877 {
878 return false;
879 }
880
881 return true;
882 }

◆ isQuestionSummaryFinishTestButtonRequired()

ilTestOutputGUI::isQuestionSummaryFinishTestButtonRequired ( )
protected

Reimplemented from ilTestPlayerAbstractGUI.

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

885 {
886 return true;
887 }

◆ isShowingPostponeStatusReguired()

ilTestOutputGUI::isShowingPostponeStatusReguired (   $questionId)
protected

Reimplemented from ilTestPlayerAbstractGUI.

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

841 {
842 return $this->testSequence->isPostponedQuestion($questionId);
843 }

◆ isValidSequenceElement()

ilTestOutputGUI::isValidSequenceElement (   $sequenceElement)
private

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

239 {
240 if( $sequenceElement === false )
241 {
242 return false;
243 }
244
245 if( $sequenceElement < 1 )
246 {
247 return false;
248 }
249
250 if( !$this->testSequence->getPositionOfSequence($sequenceElement) )
251 {
252 return false;
253 }
254
255 return true;
256 }

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 546 of file class.ilTestOutputGUI.php.

547 {
548 $lastSequenceElement = $this->getCurrentSequenceElement();
549 $nextSequenceElement = $this->testSequence->getNextSequence($lastSequenceElement);
550
551 if( $this->object->isPostponingEnabled() )
552 {
553 $this->handleQuestionPostponing($lastSequenceElement);
554 }
555
556 if(!$this->isValidSequenceElement($nextSequenceElement))
557 {
558 $nextSequenceElement = $this->testSequence->getFirstSequence();
559 }
560
561 $this->ctrl->setParameter($this, 'sequence', $nextSequenceElement);
562 $this->ctrl->setParameter($this, 'pmode', '');
563
564 $this->ctrl->redirect($this, ilTestPlayerCommands::SHOW_QUESTION);
565 }
ilTestOutputGUI\handleQuestionPostponing
handleQuestionPostponing($sequenceElement)
Definition: class.ilTestOutputGUI.php:531
ilTestOutputGUI\isValidSequenceElement
isValidSequenceElement($sequenceElement)
Definition: class.ilTestOutputGUI.php:238

References ilTestPlayerAbstractGUI\getCurrentSequenceElement(), handleQuestionPostponing(), isValidSequenceElement(), and ilTestPlayerCommands\SHOW_QUESTION.

+ Here is the call graph for this function:

◆ performTearsAndAngerBrokenConfessionChecks()

ilTestOutputGUI::performTearsAndAngerBrokenConfessionChecks ( )
protected

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

725 {
726 if ($this->testSession->getActiveId() > 0)
727 {
728 if ($this->testSequence->hasRandomQuestionsForPass($this->testSession->getActiveId(), $this->testSession->getPass()) > 0)
729 {
730 // Something went wrong. Maybe the user pressed the start button twice
731 // Questions already exist so there is no need to create new questions
732
733 global $ilLog, $ilUser;
734
735 $ilLog->write(
736 __METHOD__.' Random Questions allready exists for user '.
737 $ilUser->getId().' in test '.$this->object->getTestId()
738 );
739
740 return true;
741 }
742 }
743 else
744 {
745 // This may not happen! If it happens, raise a fatal error...
746
747 global $ilLog, $ilUser;
748
749 $ilLog->write(__METHOD__.' '.sprintf(
750 $this->lng->txt("error_random_question_generation"), $ilUser->getId(), $this->object->getTestId()
751 ));
752
753 return true;
754 };
755
756 return false;
757 }
$ilLog
$ilLog
Definition: inc.setup_header.php:130

References $ilLog, $ilUser, and sprintf.

Referenced by generateRandomTestPassForActiveUser().

+ 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 567 of file class.ilTestOutputGUI.php.

568 {
569 $sequenceElement = $this->testSequence->getPreviousSequence(
570 $this->getCurrentSequenceElement()
571 );
572
573 if(!$this->isValidSequenceElement($sequenceElement))
574 {
575 $sequenceElement = $this->testSequence->getLastSequence();
576 }
577
578 $this->ctrl->setParameter($this, 'sequence', $sequenceElement);
579 $this->ctrl->setParameter($this, 'pmode', '');
580
581 $this->ctrl->redirect($this, ilTestPlayerCommands::SHOW_QUESTION);
582 }

References ilTestPlayerAbstractGUI\getCurrentSequenceElement(), 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 793 of file class.ilTestOutputGUI.php.

794 {
795 $this->handleUserSettings();
796
797 $active_id = $this->testSession->getActiveId();
798 $this->ctrl->setParameter($this, "active_id", $active_id);
799
800 $active_time_id = $this->object->startWorkingTime($active_id, $this->testSession->getPass());
801 $_SESSION["active_time_id"] = $active_time_id;
802 $_SESSION['tst_pass_finish'] = 0;
803
804 if ($this->object->isRandomTest())
805 {
806 if (!$this->testSequence->hasRandomQuestionsForPass($active_id, $this->testSession->getPass()))
807 {
808 // create a new set of random questions
809 $this->generateRandomTestPassForActiveUser();
810 }
811 }
812
813 $shuffle = $this->object->getShuffleQuestions();
814 if ($this->object->isRandomTest())
815 {
816 $shuffle = FALSE;
817 }
818
819 assQuestion::_updateTestPassResults(
820 $active_id, $this->testSession->getPass(), $this->object->areObligationsEnabled(), null, $this->object->id
821 );
822
823 // ensure existing test sequence
824 if( !$this->testSequence->hasSequence() )
825 {
826 $this->testSequence->createNewSequence($this->object->getQuestionCount(), $shuffle);
827 $this->testSequence->saveToDb();
828 }
829
830 if ($this->object->getListOfQuestionsStart())
831 {
832 $this->ctrl->redirect($this, ilTestPlayerCommands::QUESTION_SUMMARY);
833 }
834
835 $this->ctrl->setParameter($this, 'sequence', $this->testSession->getLastSequence());
836 $this->ctrl->setParameter($this, 'pmode', '');
837 $this->ctrl->redirect($this, ilTestPlayerCommands::SHOW_QUESTION);
838 }
$_SESSION
$_SESSION["AccountId"]
Definition: cfg.phpunit.template.php:10
ilTestPlayerAbstractGUI\handleUserSettings
handleUserSettings()
Handles some form parameters on starting and resuming a test.
Definition: class.ilTestPlayerAbstractGUI.php:531

References $_SESSION, generateRandomTestPassForActiveUser(), ilTestPlayerAbstractGUI\handleUserSettings(), ilTestPlayerCommands\QUESTION_SUMMARY, 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 615 of file class.ilTestOutputGUI.php.

616 {
617 $this->updateWorkingTime();
618 $this->saveResult = FALSE;
619 if (!$force)
620 {
621 $formtimestamp = $_POST["formtimestamp"];
622 if (strlen($formtimestamp) == 0) $formtimestamp = $_GET["formtimestamp"];
623 if ($formtimestamp != $_SESSION["formtimestamp"])
624 {
625 $_SESSION["formtimestamp"] = $formtimestamp;
626 }
627 else
628 {
629 return FALSE;
630 }
631 }
632 // save question solution
633 if ($this->canSaveResult() || $force)
634 {
635 // but only if the ending time is not reached
636 $q_id = $this->testSequence->getQuestionForSequence($_GET["sequence"]);
637 if (is_numeric($q_id) && (int)$q_id)
638 {
639 $questionOBJ = $this->getQuestionInstance($q_id);
640 $pass = NULL;
641 $active_id = $this->testSession->getActiveId();
642 if ($this->object->isRandomTest())
643 {
644 $pass = ilObjTest::_getPass($active_id);
645 }
646 $this->saveResult = $questionOBJ->persistWorkingState(
647 $active_id, $pass, $this->object->areObligationsEnabled(), $authorized
648 );
649
650 if( $authorized && $this->testSession->isObjectiveOriented() )
651 {
652 require_once 'Modules/Course/classes/Objectives/class.ilLOTestQuestionAdapter.php';
653 $objectivesAdapter = ilLOTestQuestionAdapter::getInstance($this->testSession);
654 $objectivesAdapter->updateQuestionResult($this->testSession, $questionOBJ);
655 }
656
657 if( $authorized && $this->object->isSkillServiceToBeConsidered() )
658 {
659 $this->handleSkillTriggering($this->testSession);
660 }
661 }
662 }
663
664 if ($this->saveResult == FALSE)
665 {
666 $this->ctrl->setParameter($this, "save_error", "1");
667 $_SESSION["previouspost"] = $_POST;
668 }
669
670 return $this->saveResult;
671 }
$_POST
$_POST["username"]
Definition: cfg.phpunit.template.php:11
ilLOTestQuestionAdapter\getInstance
static getInstance(ilTestSession $a_test_session)
Definition: class.ilLOTestQuestionAdapter.php:654
ilObjTest\_getPass
static _getPass($active_id)
Retrieves the actual pass of a given user for a given test.
Definition: class.ilObjTest.php:8174
ilTestOutputGUI\canSaveResult
canSaveResult()
Returns TRUE if the answers of the current user could be saved.
Definition: class.ilTestOutputGUI.php:599
ilTestPlayerAbstractGUI\handleSkillTriggering
handleSkillTriggering(ilTestSession $testSession)
Definition: class.ilTestPlayerAbstractGUI.php:1918

References $_GET, $_POST, $_SESSION, $pass, ilTestPlayerAbstractGUI\$saveResult, ilObjTest\_getPass(), canSaveResult(), ilLOTestQuestionAdapter\getInstance(), ilTestPlayerAbstractGUI\getQuestionInstance(), ilTestPlayerAbstractGUI\handleSkillTriggering(), 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 673 of file class.ilTestOutputGUI.php.

674 {
675 $questionId = $this->testSequence->getQuestionForSequence(
676 $this->getCurrentSequenceElement()
677 );
678
679 if( $this->getAnswerChangedParameter() && !$this->isParticipantsAnswerFixed($questionId) )
680 {
681 if( $this->saveQuestionSolution(true) )
682 {
683 $this->removeIntermediateSolution();
684 $this->setAnswerChangedParameter(false);
685 }
686 else
687 {
688 $this->ctrl->redirect($this, ilTestPlayerCommands::SHOW_QUESTION);
689 }
690 $this->testSequence->setQuestionChecked($questionId);
691 $this->testSequence->saveToDb();
692 }
693
694 $this->ctrl->setParameter($this, 'instresp', 1);
695
696// fau: testNav - handle navigation after feedback
697 if ($this->getNavigationUrlParameter())
698 {
699 $this->saveNavigationPreventConfirmation();
700 $this->registerForcedFeedbackNavUrl($this->getNavigationUrlParameter());
701 }
702// fau.
703 $this->ctrl->redirect($this, ilTestPlayerCommands::SHOW_QUESTION);
704 }
ilTestPlayerAbstractGUI\removeIntermediateSolution
removeIntermediateSolution()
remove an auto-saved solution of the current question
Definition: class.ilTestPlayerAbstractGUI.php:186
ilTestPlayerAbstractGUI\saveNavigationPreventConfirmation
saveNavigationPreventConfirmation()
Save the save the switch to prevent the navigation confirmation.
Definition: class.ilTestPlayerAbstractGUI.php:2450
ilTestPlayerAbstractGUI\registerForcedFeedbackNavUrl
registerForcedFeedbackNavUrl($forcedFeedbackNavUrl)
Definition: class.ilTestPlayerAbstractGUI.php:2840

References ilTestPlayerAbstractGUI\getAnswerChangedParameter(), ilTestPlayerAbstractGUI\getCurrentSequenceElement(), ilTestPlayerAbstractGUI\getNavigationUrlParameter(), ilTestPlayerAbstractGUI\isParticipantsAnswerFixed(), 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 258 of file class.ilTestOutputGUI.php.

259 {
260 $_SESSION['tst_pass_finish'] = 0;
261
262 $_SESSION["active_time_id"]= $this->object->startWorkingTime(
263 $this->testSession->getActiveId(), $this->testSession->getPass()
264 );
265
266 $sequenceElement = $this->getCurrentSequenceElement();
267
268 if( !$this->isValidSequenceElement($sequenceElement) )
269 {
270 $sequenceElement = $this->testSequence->getFirstSequence();
271 }
272
273 $this->testSession->setLastSequence($sequenceElement);
274 $this->testSession->saveToDb();
275
276
277 $questionId = $this->testSequence->getQuestionForSequence($sequenceElement);
278
279 if( !(int)$questionId && $this->testSession->isObjectiveOriented() )
280 {
281 $this->handleTearsAndAngerNoObjectiveOrientedQuestion();
282 }
283
284 $isQuestionWorkedThrough = assQuestion::_isWorkedThrough(
285 $this->testSession->getActiveId(), $questionId, $this->testSession->getPass()
286 );
287
288// fau: testNav - always use edit mode, except for fixed answer
289 if( $this->isParticipantsAnswerFixed($questionId) )
290 {
291 $presentationMode = ilTestPlayerAbstractGUI::PRESENTATION_MODE_VIEW;
292 $instantResponse = true;
293 }
294 else
295 {
296 $presentationMode = ilTestPlayerAbstractGUI::PRESENTATION_MODE_EDIT;
297 $instantResponse = $this->getInstantResponseParameter();
298 }
299// fau.
300
301 $questionGui = $this->getQuestionGuiInstance($questionId);
302
303 if( !($questionGui instanceof assQuestionGUI) )
304 {
305 $this->handleTearsAndAngerQuestionIsNull($questionId, $sequenceElement);
306 }
307
308 $questionGui->setSequenceNumber($this->testSequence->getPositionOfSequence($sequenceElement));
309 $questionGui->setQuestionCount($this->testSequence->getUserQuestionCount());
310
311 require_once 'Modules/Test/classes/class.ilTestQuestionHeaderBlockBuilder.php';
312 $headerBlockBuilder = new ilTestQuestionHeaderBlockBuilder($this->lng);
313 $headerBlockBuilder->setHeaderMode($this->object->getTitleOutput());
314 $headerBlockBuilder->setQuestionTitle($questionGui->object->getTitle());
315 $headerBlockBuilder->setQuestionPoints($questionGui->object->getPoints());
316 $headerBlockBuilder->setQuestionPosition($this->testSequence->getPositionOfSequence($sequenceElement));
317 $headerBlockBuilder->setQuestionCount($this->testSequence->getUserQuestionCount());
318 $headerBlockBuilder->setQuestionPostponed($this->testSequence->isPostponedQuestion($questionId));
319 $headerBlockBuilder->setQuestionObligatory(
320 $this->object->areObligationsEnabled() && ilObjTest::isQuestionObligatory($questionGui->object->getId())
321 );
322 if( $this->testSession->isObjectiveOriented() )
323 {
324 require_once 'Modules/Course/classes/Objectives/class.ilLOTestQuestionAdapter.php';
325 $objectivesAdapter = ilLOTestQuestionAdapter::getInstance($this->testSession);
326 $objectivesAdapter->buildQuestionRelatedObjectiveList($this->testSequence, $this->questionRelatedObjectivesList);
327 $this->questionRelatedObjectivesList->loadObjectivesTitles();
328
329 $objectivesString = $this->questionRelatedObjectivesList->getQuestionRelatedObjectiveTitles($questionId);
330 $headerBlockBuilder->setQuestionRelatedObjectives($objectivesString);
331 }
332 $questionGui->setQuestionHeaderBlockBuilder($headerBlockBuilder);
333
334 $this->prepareTestPage($presentationMode, $sequenceElement, $questionId);
335
336 $navigationToolbarGUI = $this->getTestNavigationToolbarGUI();
337 $navigationToolbarGUI->setFinishTestButtonEnabled(true);
338
339 $isNextPrimary = $this->handlePrimaryButton($navigationToolbarGUI, $questionId);
340
341 $this->ctrl->setParameter($this, 'sequence', $sequenceElement);
342 $this->ctrl->setParameter($this, 'pmode', $presentationMode);
343 $formAction = $this->ctrl->getFormAction($this, ilTestPlayerCommands::SUBMIT_INTERMEDIATE_SOLUTION);
344
345 switch($presentationMode)
346 {
347 case ilTestPlayerAbstractGUI::PRESENTATION_MODE_EDIT:
348
349// fau: testNav - enable navigation toolbar in edit mode
350 $navigationToolbarGUI->setDisabledStateEnabled(false);
351// fau.
352 $this->showQuestionEditable($questionGui, $formAction, $isQuestionWorkedThrough, $instantResponse);
353
354 break;
355
356 case ilTestPlayerAbstractGUI::PRESENTATION_MODE_VIEW:
357
358 if( $this->testSequence->isQuestionOptional($questionGui->object->getId()) )
359 {
360 $this->populateQuestionOptionalMessage();
361 }
362
363 $this->showQuestionViewable($questionGui, $formAction, $isQuestionWorkedThrough, $instantResponse);
364
365 break;
366
367 default:
368
369 require_once 'Modules/Test/exceptions/class.ilTestException.php';
370 throw new ilTestException('no presentation mode given');
371 }
372
373 $navigationToolbarGUI->build();
374 $this->populateTestNavigationToolbar($navigationToolbarGUI);
375
376// fau: testNav - enable the question navigation in edit mode
377 $this->populateQuestionNavigation($sequenceElement, false, $isNextPrimary);
378// fau.
379
380 if ($instantResponse)
381 {
382// fau: testNav - always use authorized solution for instant feedback
383 $this->populateInstantResponseBlocks(
384 $questionGui, true
385 );
386// fau.
387 }
388
389// fau: testNav - add feedback modal
390 if ($this->isForcedFeedbackNavUrlRegistered())
391 {
392 $this->populateInstantResponseModal($questionGui, $this->getRegisteredForcedFeedbackNavUrl());
393 $this->unregisterForcedFeedbackNavUrl();
394 }
395// fau.
396
397 }
assQuestionGUI
Basic GUI class for assessment questions.
Definition: class.assQuestionGUI.php:21
ilObjTest\isQuestionObligatory
static isQuestionObligatory($question_id)
checks wether the question with given id is marked as obligatory or not
Definition: class.ilObjTest.php:11564
ilTestException
Base Exception for all Exceptions relating to Modules/Test.
Definition: class.ilTestException.php:15
ilTestOutputGUI\handlePrimaryButton
handlePrimaryButton(ilTestNavigationToolbarGUI $navigationToolbarGUI, $currentQuestionId)
Definition: class.ilTestOutputGUI.php:899
ilTestOutputGUI\populateQuestionOptionalMessage
populateQuestionOptionalMessage()
ilTestPlayerAbstractGUI\prepareTestPage
prepareTestPage($presentationMode, $sequenceElement, $questionId)
Definition: class.ilTestPlayerAbstractGUI.php:1104
ilTestPlayerAbstractGUI\handleTearsAndAngerQuestionIsNull
handleTearsAndAngerQuestionIsNull($questionId, $sequenceElement)
Definition: class.ilTestPlayerAbstractGUI.php:2561
ilTestPlayerAbstractGUI\populateInstantResponseModal
populateInstantResponseModal(assQuestionGUI $questionGui, $navUrl)
Definition: class.ilTestPlayerAbstractGUI.php:2218
ilTestPlayerAbstractGUI\showQuestionEditable
showQuestionEditable(assQuestionGUI $questionGui, $formAction, $isQuestionWorkedThrough, $instantResponse)
Definition: class.ilTestPlayerAbstractGUI.php:1216
ilTestPlayerAbstractGUI\getQuestionGuiInstance
getQuestionGuiInstance($questionId, $fromCache=true)
Definition: class.ilTestPlayerAbstractGUI.php:2469
ilTestPlayerAbstractGUI\populateInstantResponseBlocks
populateInstantResponseBlocks(assQuestionGUI $questionGui, $authorizedSolution)
Definition: class.ilTestPlayerAbstractGUI.php:2278
ilTestPlayerAbstractGUI\populateTestNavigationToolbar
populateTestNavigationToolbar(ilTestNavigationToolbarGUI $toolbarGUI)
Definition: class.ilTestPlayerAbstractGUI.php:241
ilTestPlayerAbstractGUI\populateQuestionNavigation
populateQuestionNavigation($sequenceElement, $disabled, $primaryNext)
Definition: class.ilTestPlayerAbstractGUI.php:248
ilTestPlayerAbstractGUI\showQuestionViewable
showQuestionViewable(assQuestionGUI $questionGui, $formAction, $isQuestionWorkedThrough, $instantResponse)
Definition: class.ilTestPlayerAbstractGUI.php:1172

References $_SESSION, assQuestion\_isWorkedThrough(), ilTestPlayerAbstractGUI\getCurrentSequenceElement(), ilLOTestQuestionAdapter\getInstance(), ilTestPlayerAbstractGUI\getInstantResponseParameter(), ilTestPlayerAbstractGUI\getQuestionGuiInstance(), ilTestPlayerAbstractGUI\getRegisteredForcedFeedbackNavUrl(), ilTestPlayerAbstractGUI\getTestNavigationToolbarGUI(), handlePrimaryButton(), handleTearsAndAngerNoObjectiveOrientedQuestion(), ilTestPlayerAbstractGUI\handleTearsAndAngerQuestionIsNull(), ilTestPlayerAbstractGUI\isForcedFeedbackNavUrlRegistered(), ilTestPlayerAbstractGUI\isParticipantsAnswerFixed(), ilObjTest\isQuestionObligatory(), isValidSequenceElement(), ilTestPlayerAbstractGUI\populateInstantResponseBlocks(), ilTestPlayerAbstractGUI\populateInstantResponseModal(), ilTestPlayerAbstractGUI\populateQuestionNavigation(), populateQuestionOptionalMessage(), ilTestPlayerAbstractGUI\populateTestNavigationToolbar(), ilTestPlayerAbstractGUI\prepareTestPage(), ilTestPlayerAbstractGUI\PRESENTATION_MODE_EDIT, ilTestPlayerAbstractGUI\PRESENTATION_MODE_VIEW, ilTestPlayerAbstractGUI\showQuestionEditable(), ilTestPlayerAbstractGUI\showQuestionViewable(), ilTestPlayerCommands\SUBMIT_INTERMEDIATE_SOLUTION, and ilTestPlayerAbstractGUI\unregisterForcedFeedbackNavUrl().

+ Here is the call graph for this function:

◆ skipQuestionCmd()

ilTestOutputGUI::skipQuestionCmd ( )
protected

Reimplemented from ilTestPlayerAbstractGUI.

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

510 {
511 $curSequenceElement = $this->getCurrentSequenceElement();
512 $nextSequenceElement = $this->testSequence->getNextSequence($curSequenceElement);
513
514 if(!$this->isValidSequenceElement($nextSequenceElement))
515 {
516 $nextSequenceElement = $this->testSequence->getFirstSequence();
517 }
518
519 if( $this->object->isPostponingEnabled() )
520 {
521 $this->testSequence->postponeSequence($curSequenceElement);
522 $this->testSequence->saveToDb();
523 }
524
525 $this->ctrl->setParameter($this, 'sequence', $nextSequenceElement);
526 $this->ctrl->setParameter($this, 'pmode', '');
527
528 $this->ctrl->redirect($this, ilTestPlayerCommands::SHOW_QUESTION);
529 }

References ilTestPlayerAbstractGUI\getCurrentSequenceElement(), isValidSequenceElement(), and ilTestPlayerCommands\SHOW_QUESTION.

+ Here is the call graph for this function:

◆ startTestCmd()

ilTestOutputGUI::startTestCmd ( )
protected

Reimplemented from ilTestPlayerAbstractGUI.

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

151 {
152 global $ilUser;
153
154 $_SESSION['tst_pass_finish'] = 0;
155
156 // ensure existing test session
157 $this->testSession->setUserId($ilUser->getId());
158 $this->testSession->setAnonymousId($_SESSION["tst_access_code"][$this->object->getTestId()]);
159 $this->testSession->setObjectiveOrientedContainerId($this->getObjectiveOrientedContainer()->getObjId());
160 $this->testSession->saveToDb();
161
162 $active_id = $this->testSession->getActiveId();
163 $this->ctrl->setParameter($this, "active_id", $active_id);
164
165 $shuffle = $this->object->getShuffleQuestions();
166 if ($this->object->isRandomTest())
167 {
168 $this->generateRandomTestPassForActiveUser();
169
170 $this->object->loadQuestions();
171 $shuffle = FALSE; // shuffle is already done during the creation of the random questions
172 }
173
174 assQuestion::_updateTestPassResults(
175 $active_id, $this->testSession->getPass(), $this->object->areObligationsEnabled(), null, $this->object->id
176 );
177
178 // ensure existing test sequence
179 if( !$this->testSequence->hasSequence() )
180 {
181 $this->testSequence->createNewSequence($this->object->getQuestionCount(), $shuffle);
182 $this->testSequence->saveToDb();
183 }
184
185 $this->testSequence->loadFromDb();
186 $this->testSequence->loadQuestions();
187
188 if( $this->testSession->isObjectiveOriented() )
189 {
190 require_once 'Modules/Course/classes/Objectives/class.ilLOTestQuestionAdapter.php';
191 $objectivesAdapter = ilLOTestQuestionAdapter::getInstance($this->testSession);
192
193 $objectivesAdapter->notifyTestStart($this->testSession, $this->object->getId());
194 $objectivesAdapter->prepareTestPass($this->testSession, $this->testSequence);
195
196 $objectivesAdapter->buildQuestionRelatedObjectiveList(
197 $this->testSequence, $this->questionRelatedObjectivesList
198 );
199
200 if( $this->testSequence->hasOptionalQuestions() )
201 {
202 $this->adoptUserSolutionsFromPreviousPass();
203
204 $this->testSequence->reorderOptionalQuestionsToSequenceEnd();
205 $this->testSequence->saveToDb();
206 }
207 }
208
209 $active_time_id = $this->object->startWorkingTime(
210 $this->testSession->getActiveId(), $this->testSession->getPass()
211 );
212 $_SESSION["active_time_id"] = $active_time_id;
213
214 $this->updateLearningProgressOnTestStart();
215
216 $sequenceElement = $this->testSequence->getFirstSequence();
217
218 $this->ctrl->setParameter($this, 'sequence', $sequenceElement);
219 $this->ctrl->setParameter($this, 'pmode', '');
220
221 if ($this->object->getListOfQuestionsStart())
222 {
223 $this->ctrl->redirect($this, ilTestPlayerCommands::QUESTION_SUMMARY);
224 }
225
226 $this->ctrl->redirect($this, ilTestPlayerCommands::SHOW_QUESTION);
227 }

References $_SESSION, $ilUser, adoptUserSolutionsFromPreviousPass(), generateRandomTestPassForActiveUser(), ilLOTestQuestionAdapter\getInstance(), ilTestServiceGUI\getObjectiveOrientedContainer(), ilTestPlayerCommands\QUESTION_SUMMARY, ilTestPlayerCommands\SHOW_QUESTION, and updateLearningProgressOnTestStart().

+ Here is the call graph for this function:

◆ submitSolutionAndNextCmd()

ilTestOutputGUI::submitSolutionAndNextCmd ( )
protected

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

406 {
407 if( $this->object->isForceInstantFeedbackEnabled() )
408 {
409 return $this->submitSolutionCmd();
410 }
411
412 if( $this->saveQuestionSolution(true, false) )
413 {
414 $questionId = $this->testSequence->getQuestionForSequence(
415 $this->getCurrentSequenceElement()
416 );
417
418 $this->removeIntermediateSolution();
419
420 $nextSequenceElement = $this->testSequence->getNextSequence($this->getCurrentSequenceElement());
421
422 if(!$this->isValidSequenceElement($nextSequenceElement))
423 {
424 $nextSequenceElement = $this->testSequence->getFirstSequence();
425 }
426
427 $this->testSession->setLastSequence($nextSequenceElement);
428 $this->testSession->saveToDb();
429
430 $this->ctrl->setParameter($this, 'sequence', $nextSequenceElement);
431 $this->ctrl->setParameter($this, 'pmode', '');
432 }
433
434 $this->ctrl->redirect($this, ilTestPlayerCommands::SHOW_QUESTION);
435 }

References ilTestPlayerAbstractGUI\getCurrentSequenceElement(), isValidSequenceElement(), 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 437 of file class.ilTestOutputGUI.php.

438 {
439 if( $this->saveQuestionSolution(true, false) )
440 {
441 $questionId = $this->testSequence->getQuestionForSequence(
442 $this->getCurrentSequenceElement()
443 );
444
445 $this->removeIntermediateSolution();
446
447 if( $this->object->isForceInstantFeedbackEnabled() )
448 {
449 $this->ctrl->setParameter($this, 'instresp', 1);
450
451 $this->testSequence->setQuestionChecked($questionId);
452 $this->testSequence->saveToDb();
453 }
454
455 if( $this->getNextCommandParameter() )
456 {
457 if( $this->getNextSequenceParameter() )
458 {
459 $this->ctrl->setParameter($this, 'sequence', $this->getNextSequenceParameter());
460 $this->ctrl->setParameter($this, 'pmode', '');
461 }
462
463 $this->ctrl->redirect($this, $this->getNextCommandParameter());
464 }
465
466 $this->ctrl->setParameter($this, 'pmode', ilTestPlayerAbstractGUI::PRESENTATION_MODE_VIEW);
467 }
468 else
469 {
470 $this->ctrl->redirect($this, ilTestPlayerCommands::SHOW_QUESTION);
471 }
472
473// fau: testNav - remember to prevent the navigation confirmation
474 $this->saveNavigationPreventConfirmation();
475// fau.
476
477// fau: testNav - handle navigation after saving
478 if ($this->getNavigationUrlParameter())
479 {
480 ilUtil::redirect($this->getNavigationUrlParameter());
481 }
482 else
483 {
484 $this->ctrl->saveParameter($this, 'sequence');
485 }
486// fau.
487 $this->ctrl->redirect($this, ilTestPlayerCommands::SHOW_QUESTION);
488 }
ilUtil\redirect
static redirect($a_script)
http redirect to other script
Definition: class.ilUtil.php:3567

References ilTestPlayerAbstractGUI\getCurrentSequenceElement(), ilTestPlayerAbstractGUI\getNavigationUrlParameter(), ilTestPlayerAbstractGUI\getNextCommandParameter(), ilTestPlayerAbstractGUI\getNextSequenceParameter(), 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 229 of file class.ilTestOutputGUI.php.

230 {
231 global $ilUser;
232
233 require_once ('./Modules/Test/classes/class.ilObjTestAccess.php');
234 require_once('./Services/Tracking/classes/class.ilLPStatusWrapper.php');
235 ilLPStatusWrapper::_updateStatus($this->object->getId(), $ilUser->getId());
236 }
ilLPStatusWrapper\_updateStatus
static _updateStatus($a_obj_id, $a_usr_id, $a_obj=null, $a_percentage=false, $a_force_raise=false)
Update status.
Definition: class.ilLPStatusWrapper.php:276

References $ilUser, and ilLPStatusWrapper\_updateStatus().

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 25 of file class.ilTestOutputGUI.php.

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