ilTestScoringByQuestionsGUI Class Reference

ilTestScoringByQuestionsGUI More...

Inheritance diagram for ilTestScoringByQuestionsGUI:

Collaboration diagram for ilTestScoringByQuestionsGUI:

Public Member Functions
	__construct (ilObjTest $a_object)
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)
	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)
Public Member Functions inherited from ilTestScoringGUI
	__construct (ilObjTest $a_object)
	ilTestScoringGUI constructor More...
	getTestAccess ()
	setTestAccess ($testAccess)
	executeCommand ()
	execute command More...

Protected Member Functions
	getDefaultCommand ()
	getActiveSubTabId ()
	saveManScoringByQuestion ()
	applyManScoringByQuestionFilter ()
	resetManScoringByQuestionFilter ()
	getAnswerDetail ()
Protected Member Functions inherited from ilTestServiceGUI
	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 Member Functions inherited from ilTestScoringGUI
	getDefaultCommand ()
	getActiveSubTabId ()

Additional Inherited Members
Data Fields inherited from ilTestServiceGUI
	$object = null
	$service = null
	$lng
	$tpl
	$ctrl
	$ilias
	$tree
	$ref_id
Data Fields inherited from ilTestScoringGUI
const	PART_FILTER_ACTIVE_ONLY = 1
const	PART_FILTER_INACTIVE_ONLY = 2
const	PART_FILTER_ALL_USERS = 3
const	PART_FILTER_MANSCORING_DONE = 4
const	PART_FILTER_MANSCORING_NONE = 5
Protected Attributes inherited from ilTestServiceGUI
	$db
	$tabs
	$objCache
	$testSessionFactory = null
	$testSequenceFactory = null
	$participantData
Protected Attributes inherited from ilTestScoringGUI
	$testAccess

Detailed Description

ilTestScoringByQuestionsGUI

Author

Michael Jansen mjans.nosp@m.en@d.nosp@m.ataba.nosp@m.y.de

Björn Heyser bheys.nosp@m.er@d.nosp@m.ataba.nosp@m.y.de

Version

$Id$

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

Constructor & Destructor Documentation

__construct()

ilTestScoringByQuestionsGUI::__construct

(

ilObjTest

$a_object

)

Parameters

ilObjTest

$a_object

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

    {
        parent::__construct($a_object);
    }

Member Function Documentation

applyManScoringByQuestionFilter()

ilTestScoringByQuestionsGUI::applyManScoringByQuestionFilter ( )

protected

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

References $table.

    {
        require_once 'Modules/Test/classes/tables/class.ilTestManScoringParticipantsBySelectedQuestionAndPassTableGUI.php';
        $table = new ilTestManScoringParticipantsBySelectedQuestionAndPassTableGUI($this);
        $table->resetOffset();
        $table->writeFilterToSession();
        $this->showManScoringByQuestionParticipantsTable();
    }

getActiveSubTabId()

ilTestScoringByQuestionsGUI::getActiveSubTabId ( )

protected

Returns

string

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

References $data, $DIC, $info, $mathJaxSetting, ilTestServiceGUI\$participantData, $table, ilTestServiceGUI\$tpl, $type, $user, ilObjAssessmentFolder\_getManualScoring(), assQuestion\_getMaximumPoints(), assQuestion\_getQuestionInfo(), assQuestion\_getReachedPoints(), ilObjUser\_getUserData(), ilTestParticipantAccessFilter\getScoreParticipantsUserFilter(), iljQueryUtil\initjQuery(), ilYuiUtil\initOverlay(), ilYuiUtil\initPanel(), and ilTestTabsManager\TAB_ID_MANUAL_SCORING.

    {
        return 'man_scoring_by_qst';
    }

Here is the call graph for this function:

getAnswerDetail()

ilTestScoringByQuestionsGUI::getAnswerDetail ( )

protected

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

References $_GET, $data, $pass, exit, and ilTestScoringGUI\getTestAccess().

    {
        $active_id = (int) $_GET['active_id'];
        $pass = (int) $_GET['pass_id'];
        $question_id = (int) $_GET['qst_id'];
        
        if (!$this->getTestAccess()->checkScoreParticipantsAccessForActiveId($active_id)) {
            exit; // illegal ajax call
        }
        
        $data = $this->object->getCompleteEvaluationData(false);
        $participant = $data->getParticipant($active_id);

        $question_gui = $this->object->createQuestionGUI('', $question_id);

        $tmp_tpl = new ilTemplate('tpl.il_as_tst_correct_solution_output.html', true, true, 'Modules/Test');
        if ($question_gui->supportsIntermediateSolutionOutput() && $question_gui->hasIntermediateSolution($active_id, $pass)) {
            $question_gui->setUseIntermediateSolution(true);
            $aresult_output = $question_gui->getSolutionOutput($active_id, $pass, false, false, true, false, false, true);
            $question_gui->setUseIntermediateSolution(false);
            $tmp_tpl->setVariable('TEXT_ASOLUTION_OUTPUT', $this->lng->txt('autosavecontent'));
            $tmp_tpl->setVariable('ASOLUTION_OUTPUT', $aresult_output);
        }

        $result_output = $question_gui->getSolutionOutput($active_id, $pass, false, false, false, $this->object->getShowSolutionFeedback(), false, true);
        $tmp_tpl->setVariable('TEXT_YOUR_SOLUTION', $this->lng->txt('answers_of') . ' ' . $participant->getName());



        $maxpoints = $question_gui->object->getMaximumPoints();

        $add_title = ' [' . $this->lng->txt('question_id_short') . ': ' . $question_id . ']';

        if ($maxpoints == 1) {
            $tmp_tpl->setVariable('QUESTION_TITLE', $this->object->getQuestionTitle($question_gui->object->getTitle()) . ' (' . $maxpoints . ' ' . $this->lng->txt('point') . ')' . $add_title);
        } else {
            $tmp_tpl->setVariable('QUESTION_TITLE', $this->object->getQuestionTitle($question_gui->object->getTitle()) . ' (' . $maxpoints . ' ' . $this->lng->txt('points') . ')' . $add_title);
        }
        $tmp_tpl->setVariable('SOLUTION_OUTPUT', $result_output);
        $tmp_tpl->setVariable('RECEIVED_POINTS', sprintf($this->lng->txt('part_received_a_of_b_points'), $question_gui->object->getReachedPoints($active_id, $pass), $maxpoints));

        echo $tmp_tpl->get();
        exit();
    }

Here is the call graph for this function:

getDefaultCommand()

ilTestScoringByQuestionsGUI::getDefaultCommand ( )

protected

Returns

string

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

    {
        return 'showManScoringByQuestionParticipantsTable';
    }

resetManScoringByQuestionFilter()

ilTestScoringByQuestionsGUI::resetManScoringByQuestionFilter ( )

protected

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

References $table.

    {
        require_once 'Modules/Test/classes/tables/class.ilTestManScoringParticipantsBySelectedQuestionAndPassTableGUI.php';
        $table = new ilTestManScoringParticipantsBySelectedQuestionAndPassTableGUI($this);
        $table->resetOffset();
        $table->resetFilter();
        $this->showManScoringByQuestionParticipantsTable();
    }

saveManScoringByQuestion()

ilTestScoringByQuestionsGUI::saveManScoringByQuestion ( )

protected

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

References $_POST, $DIC, ilTestServiceGUI\$participantData, $pass, assQuestion\_getMaximumPoints(), ilObjTestAccess\_getParticipantId(), assQuestion\_instantiateQuestion(), assQuestion\_setReachedPoints(), ilLPStatusWrapper\_updateStatus(), ilTestParticipantAccessFilter\getScoreParticipantsUserFilter(), and ilUtil\sendFailure().

    {
        global $DIC; /* @var ILIAS\DI\Container $DIC */

        if (!isset($_POST['scoring']) || !is_array($_POST['scoring'])) {
            ilUtil::sendFailure($this->lng->txt('tst_save_manscoring_failed_unknown'));
            $this->showManScoringByQuestionParticipantsTable();
            return;
        }

        $pass = key($_POST['scoring']);
        $activeData = current($_POST['scoring']);

        require_once 'Modules/Test/classes/class.ilTestParticipantData.php';
        $participantData = new ilTestParticipantData($DIC->database(), $DIC->language());
        $participantData->setActiveIdsFilter(array_keys($activeData));

        $participantData->setParticipantAccessFilter(
            ilTestParticipantAccessFilter::getScoreParticipantsUserFilter($this->ref_id)
        );

        $participantData->load($this->object->getTestId());

        include_once 'Modules/TestQuestionPool/classes/class.assQuestion.php';
        include_once 'Modules/Test/classes/class.ilObjTestAccess.php';
        include_once 'Services/Tracking/classes/class.ilLPStatusWrapper.php';

        $oneExceededMaxPoints = false;
        $manPointsPost = array();
        $skipParticipant = array();
        $maxPointsByQuestionId = array();
        foreach ($participantData->getActiveIds() as $active_id) {
            $questions = $activeData[$active_id];
            
            // check for existing test result data
            if (!$this->object->getTestResult($active_id, $pass)) {
                if (!isset($skipParticipant[$pass])) {
                    $skipParticipant[$pass] = array();
                }

                $skipParticipant[$pass][$active_id] = true;
                
                continue;
            }
            
            foreach ((array) $questions as $qst_id => $reached_points) {
                if (!isset($manPointsPost[$pass])) {
                    $manPointsPost[$pass] = array();
                }

                if (!isset($manPointsPost[$pass][$active_id])) {
                    $manPointsPost[$pass][$active_id] = array();
                }

                $maxPointsByQuestionId[$qst_id] = assQuestion::_getMaximumPoints($qst_id);

                if ($reached_points > $maxPointsByQuestionId[$qst_id]) {
                    $oneExceededMaxPoints = true;
                }

                $manPointsPost[$pass][$active_id][$qst_id] = $reached_points;
            }
        }
        
        if ($oneExceededMaxPoints) {
            ilUtil::sendFailure(sprintf($this->lng->txt('tst_save_manscoring_failed'), $pass + 1));
            $this->showManScoringByQuestionParticipantsTable($manPointsPost);
            return;
        }
        
        $changed_one = false;
        $lastAndHopefullyCurrentQuestionId = null;
        foreach ($participantData->getActiveIds() as $active_id) {
            $questions = $activeData[$active_id];

            $update_participant = false;
            
            if ($skipParticipant[$pass][$active_id]) {
                continue;
            }

            foreach ((array) $questions as $qst_id => $reached_points) {
                $update_participant = assQuestion::_setReachedPoints(
                    $active_id,
                    $qst_id,
                    $reached_points,
                    $maxPointsByQuestionId[$qst_id],
                    $pass,
                    1,
                    $this->object->areObligationsEnabled()
                );
            }

            if ($update_participant) {
                $changed_one = true;

                $lastAndHopefullyCurrentQuestionId = $qst_id;

                ilLPStatusWrapper::_updateStatus(
                    $this->object->getId(),
                    ilObjTestAccess::_getParticipantId($active_id)
                );
            }
        }

        if ($changed_one) {
            $qTitle = '';
            if ($lastAndHopefullyCurrentQuestionId) {
                $question = assQuestion::_instantiateQuestion($lastAndHopefullyCurrentQuestionId);
                $qTitle = $question->getTitle();
            }
            $msg = sprintf(
                $this->lng->txt('tst_saved_manscoring_by_question_successfully'),
                $qTitle,
                $pass + 1
            );
            ilUtil::sendSuccess($msg, true);

            /* disabled for Mantis 25850
            require_once './Modules/Test/classes/class.ilTestScoring.php';
            $scorer = new ilTestScoring($this->object);
            $scorer->setPreserveManualScores(true);
            $scorer->recalculateSolutions();
            */
        }

        $this->showManScoringByQuestionParticipantsTable();
    }

Here is the call graph for this function:

---

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

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