ilTestService Class Reference

Service class for tests. More...

Collaboration diagram for ilTestService:

Public Member Functions
	__construct (protected ilObjTest $object, protected ilDBInterface $db, protected GeneralQuestionPropertiesRepository $questionrepository)
	public More...
	getPassOverviewData (int $active_id, bool $short=false)
	buildVirtualSequence (ilTestSession $testSession)
	getVirtualSequenceUserResults (ilTestVirtualSequence $virtualSequence)
	getQuestionSummaryData (ilTestSequenceSummaryProvider $testSequence)

Static Public Member Functions
static	isManScoringDone (int $active_id)
static	setManScoringDone (int $activeId, bool $manScoringDone)

Detailed Description

Service class for tests.

Author

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

Version

$Id$

\

Definition at line 32 of file class.ilTestService.php.

Constructor & Destructor Documentation

__construct()

ilTestService::__construct	(	protected ilObjTest	$object,
		protected ilDBInterface	$db,
		protected GeneralQuestionPropertiesRepository	$questionrepository
	)

public

Parameters

ilObjTest

$a_object

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

      {
    }

Member Function Documentation

buildVirtualSequence()

ilTestService::buildVirtualSequence

(

ilTestSession

$testSession

)

Definition at line 128 of file class.ilTestService.php.

References ilTestSession\getActiveId(), and ILIAS\Repository\object().

                                                                    : ilTestVirtualSequence
    {
        $test_sequence_factory = new ilTestSequenceFactory($this->object, $this->db, $this->questionrepository);

        if ($this->object->isRandomTest()) {
            $virtual_sequence = new ilTestVirtualSequenceRandomQuestionSet($this->db, $this->object, $test_sequence_factory);
        } else {
            $virtual_sequence = new ilTestVirtualSequence($this->db, $this->object, $test_sequence_factory);
        }

        $virtual_sequence->setActiveId($testSession->getActiveId());

        $virtual_sequence->init();

        return $virtual_sequence;
    }

Here is the call graph for this function:

getPassOverviewData()

ilTestService::getPassOverviewData	(	int	$active_id,
		bool	$short = false
	)

Definition at line 45 of file class.ilTestService.php.

References ilObjTest\_getPass(), and ilObjTest\lookupPassResultsUpdateTimestamp().

                                                                            : array
    {
        $passOverwiewData = [];

        $scoredPass = $this->object->_getResultPass($active_id);
        $lastPass = ilObjTest::_getPass($active_id);

        $testPercentage = 0;
        $testReachedPoints = 0;
        $testMaxPoints = 0;

        for ($pass = 0; $pass <= $lastPass; $pass++) {
            $passFinishDate = ilObjTest::lookupPassResultsUpdateTimestamp($active_id, $pass);

            if ($passFinishDate <= 0) {
                continue;
            }

            if (!$short) {
                $result_data = $this->object->getTestResult($active_id, $pass);

                if (!$result_data["pass"]["total_max_points"]) {
                    $passPercentage = 0;
                } else {
                    $passPercentage = ($result_data["pass"]["total_reached_points"] / $result_data["pass"]["total_max_points"]) * 100;
                }

                $passMaxPoints = $result_data["pass"]["total_max_points"];
                $passReachedPoints = $result_data["pass"]["total_reached_points"];

                $passAnsweredQuestions = $this->object->getAnsweredQuestionCount($active_id, $pass);
                $passTotalQuestions = count($result_data) - 2;

                if ($pass == $scoredPass) {
                    $isScoredPass = true;

                    if (!$result_data["test"]["total_max_points"]) {
                        $testPercentage = 0;
                    } else {
                        $testPercentage = ($result_data["test"]["total_reached_points"] / $result_data["test"]["total_max_points"]) * 100;
                    }

                    $testMaxPoints = $result_data["test"]["total_max_points"];
                    $testReachedPoints = $result_data["test"]["total_reached_points"];

                    $passOverwiewData['test'] = [
                        'active_id' => $active_id,
                        'scored_pass' => $scoredPass,
                        'max_points' => $testMaxPoints,
                        'reached_points' => $testReachedPoints,
                        'percentage' => $testPercentage
                    ];
                } else {
                    $isScoredPass = false;
                }

                $passOverwiewData['passes'][] = [
                    'active_id' => $active_id,
                    'pass' => $pass,
                    'finishdate' => $passFinishDate,
                    'max_points' => $passMaxPoints,
                    'reached_points' => $passReachedPoints,
                    'percentage' => $passPercentage,
                    'answered_questions' => $passAnsweredQuestions,
                    'total_questions' => $passTotalQuestions,
                    'is_scored_pass' => $isScoredPass
                ];
            }
        }

        return $passOverwiewData;
    }

Here is the call graph for this function:

getQuestionSummaryData()

ilTestService::getQuestionSummaryData

(

ilTestSequenceSummaryProvider

$testSequence

)

Definition at line 180 of file class.ilTestService.php.

References $data, ilObjTest\_getSolvedQuestions(), ilTestSequenceSummaryProvider\getActiveId(), ilTestSequenceSummaryProvider\getSequenceSummary(), and ILIAS\Repository\object().

                                                                                       : array
    {
        $result_array = $testSequence->getSequenceSummary();

        $marked_questions = [];

        if ($this->object->getShowMarker()) {
            $marked_questions = ilObjTest::_getSolvedQuestions($testSequence->getActiveId());
        }

        $data = [];
        $firstQuestion = true;

        foreach ($result_array as $key => $value) {
            $disableLink = (
                $this->object->isFollowupQuestionAnswerFixationEnabled()
                && !$value['presented'] && !$firstQuestion
            );

            $description = "";
            if ($this->object->getListOfQuestionsDescription()) {
                $description = $value["description"];
            }

            $points = "";
            if (!$this->object->getTitleOutput()) {
                $points = $value["points"];
            }

            $marked = false;
            if (count($marked_questions)) {
                if (array_key_exists($value["qid"], $marked_questions)) {
                    $obj = $marked_questions[$value["qid"]];
                    if ($obj["solved"] == 1) {
                        $marked = true;
                    }
                }
            }

            $data[] = [
                'order' => $value['nr'],
                'title' => $this->object->getQuestionTitle($value['title'], $value['nr'], $value['points']),
                'description' => $description,
                'disabled' => $disableLink,
                'worked_through' => $value['worked_through'],
                'postponed' => $value['postponed'],
                'points' => $points,
                'marked' => $marked,
                'sequence' => $value['sequence'],
                'isAnswered' => $value['isAnswered'],
                'has_authorized_answer' => $value['has_authorized_answer']
            ];
            $firstQuestion = false;
            // fau.
        }

        return $data;
    }

Here is the call graph for this function:

getVirtualSequenceUserResults()

ilTestService::getVirtualSequenceUserResults

(

ilTestVirtualSequence

$virtualSequence

)

Definition at line 145 of file class.ilTestService.php.

References $results, ilTestVirtualSequence\getActiveId(), ilTestVirtualSequence\getQuestionsPassMap(), and ilTestVirtualSequence\getUniquePasses().

                                                                                         : array
    {
        $resultsByPass = [];

        foreach ($virtualSequence->getUniquePasses() as $pass) {
            $results = $this->object->getTestResult(
                $virtualSequence->getActiveId(),
                $pass,
                false,
                true,
                true
            );

            $resultsByPass[$pass] = $results;
        }

        $virtualPassResults = [];

        foreach ($virtualSequence->getQuestionsPassMap() as $questionId => $pass) {
            foreach ($resultsByPass[$pass] as $key => $questionResult) {
                if ($key === 'test' || $key === 'pass') {
                    continue;
                }

                if ($questionResult['qid'] == $questionId) {
                    $questionResult['pass'] = $pass;
                    $virtualPassResults[$questionId] = $questionResult;
                    break;
                }
            }
        }

        return $virtualPassResults;
    }

Here is the call graph for this function:

isManScoringDone()

static ilTestService::isManScoringDone ( int  $active_id )

static

Definition at line 118 of file class.ilTestService.php.

Referenced by ILIAS\Test\Scoring\Manual\TestScoringByParticipantGUI\buildManScoringParticipantForm(), and ilObjTest\getManualFeedback().

                                                           : bool
    {
        return (new TestManScoringDoneHelper())->isDone($active_id);
    }

Here is the caller graph for this function:

setManScoringDone()

static ilTestService::setManScoringDone ( int  $activeId, bool  $manScoringDone  )

static

Definition at line 123 of file class.ilTestService.php.

Referenced by ILIAS\Test\Scoring\Manual\TestScoringByParticipantGUI\saveManScoringParticipantScreen().

                                                                                 : void
    {
        (new TestManScoringDoneHelper())->setDone($activeId, $manScoringDone);
    }

Here is the caller graph for this function:

---

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

• components/ILIAS/Test/classes/class.ilTestService.php