class.ilTestEvaluationUserData.php

Go to the documentation of this file.

<?php
include_once "./Services/Object/classes/class.ilObject.php";
include_once "./Modules/Test/classes/inc.AssessmentConstants.php";

class ilTestEvaluationUserData
{
    public $name;

    public $login;

    public $user_id;

    protected $submitted;

    public $reached;

    public $maxpoints;

    public $mark;

    public $mark_official;

    public $markECTS;

    public $questionsWorkedThrough;

    public $numberOfQuestions;

    public $timeOfWork;

    public $firstVisit;

    public $lastVisit;

    public $passed;

    public $passes;


    public $lastFinishedPass;

    public $questions;

    private $passScoring;

    public function __sleep()
    {
        return array('questions', 'passes', 'passed', 'lastVisit', 'firstVisit', 'timeOfWork', 'numberOfQuestions',
        'questionsWorkedThrough', 'markECTS', 'mark_official', 'mark', 'maxpoints', 'reached', 'user_id', 'login',
        'name', 'passScoring');
    }

    public function __construct($passScoring)
    {
        $this->passes = array();
        $this->questions = array();
        $this->passed = false;
        $this->passScoring = $passScoring;
    }

    public function getPassScoring()
    {
        return $this->passScoring;
    }

    public function setPassScoring($passScoring): void
    {
        $this->passScoring = $passScoring;
    }

    public function getPassed(): bool
    {
        return $this->passed;
    }

    public function setPassed($a_passed): void
    {
        $this->passed = ($a_passed ? true : false);
    }

    public function getName(): string
    {
        return $this->name;
    }

    public function setName($a_name): void
    {
        $this->name = $a_name;
    }

    public function getLogin(): string
    {
        return $this->login ?? '';
    }

    public function setLogin($a_login): void
    {
        $this->login = $a_login;
    }

    public function isSubmitted(): bool
    {
        return $this->submitted;
    }

    public function setSubmitted($submitted): void
    {
        $this->submitted = $submitted;
    }

    public function getReached(): float
    {
        return $this->getReachedPoints($this->getScoredPass());
    }

    public function setReached($a_reached)
    {
        $this->reached = $a_reached;
    }

    public function getMaxpoints()
    {
        return $this->getAvailablePoints($this->getScoredPass());
    }

    public function setMaxpoints($a_max_points): void
    {
        $this->maxpoints = $a_max_points;
    }

    public function getReachedPointsInPercent()
    {
        return $this->getMaxPoints() ? $this->getReached() / $this->getMaxPoints() * 100.0 : 0;
    }

    public function getMark(): string
    {
        return $this->mark;
    }

    public function setMark($a_mark): void
    {
        $this->mark = $a_mark;
    }

    public function getECTSMark(): ?string
    {
        return $this->markECTS;
    }

    public function setECTSMark($a_mark_ects): void
    {
        $this->markECTS = $a_mark_ects;
    }

    public function getQuestionsWorkedThrough(): int
    {
        $questionpass = $this->getScoredPass();
        if (!is_object($this->passes[$questionpass])) {
            $questionpass = 0;
        }
        if (is_object($this->passes[$questionpass])) {
            return $this->passes[$questionpass]->getNrOfAnsweredQuestions();
        }
        return 0;
    }

    public function setQuestionsWorkedThrough($a_nr)
    {
        $this->questionsWorkedThrough = $a_nr;
    }

    public function getNumberOfQuestions(): int
    {
        $questionpass = $this->getScoredPass();
        if (!is_object($this->passes[$questionpass])) {
            $questionpass = 0;
        }
        if (is_object($this->passes[$questionpass])) {
            return $this->passes[$questionpass]->getQuestionCount();
        }
        return 0;
        //              return $this->numberOfQuestions;
    }

    public function setNumberOfQuestions($a_nr)
    {
        $this->numberOfQuestions = $a_nr;
    }

    public function getQuestionsWorkedThroughInPercent()
    {
        return $this->getNumberOfQuestions() ? $this->getQuestionsWorkedThrough() / $this->getNumberOfQuestions() * 100.0 : 0;
    }

    public function getTimeOfWork(): int
    {
        $time = 0;
        foreach ($this->passes as $pass) {
            $time += $pass->getWorkingTime();
        }
        return $time;
    }

    public function setTimeOfWork($a_time_of_work)
    {
        $this->timeOfWork = $a_time_of_work;
    }

    public function getFirstVisit(): string
    {
        return $this->firstVisit;
    }

    public function setFirstVisit($a_time)
    {
        $this->firstVisit = $a_time;
    }

    public function getLastVisit(): string
    {
        return $this->lastVisit;
    }

    public function setLastVisit($a_time)
    {
        $this->lastVisit = $a_time;
    }

    public function getPasses(): array
    {
        return $this->passes;
    }

    public function addPass($pass_nr, $pass)
    {
        $this->passes[$pass_nr] = $pass;
    }

    public function getPass($pass_nr): ?ilTestEvaluationPassData
    {
        if (array_key_exists($pass_nr, $this->passes)) {
            return $this->passes[$pass_nr];
        } else {
            return null;
        }
    }

    public function getPassCount(): int
    {
        return count($this->passes);
    }

    public function getScoredPass()
    {
        if ($this->getPassScoring() == 1) {
            return $this->getBestPass();
        } else {
            return $this->getLastPass();
        }
    }
    public function getBestPass()
    {
        $bestpoints = 0;
        $bestpass = null;
        
        $obligationsAnsweredPassExists = $this->doesObligationsAnsweredPassExist();

        foreach ($this->passes as $pass) {
            $reached = $this->getReachedPointsInPercentForPass($pass->getPass());

            if (($reached > $bestpoints
                && ($pass->areObligationsAnswered() || !$obligationsAnsweredPassExists))
                || !isset($bestpass)) {
                $bestpoints = $reached;
                $bestpass = $pass->getPass();
            }
        }
        
        return (int) $bestpass;
    }

    public function getLastPass()
    {
        $lastpass = 0;
        foreach (array_keys($this->passes) as $pass) {
            if ($pass > $lastpass) {
                $lastpass = $pass;
            }
        }
        return $lastpass;
    }
    public function getFinishedPasses()
    {
        return $this->getLastFinishedPass() === null ? 0 : $this->getLastFinishedPass() + 1;
    }

    public function getLastFinishedPass()
    {
        return $this->lastFinishedPass;
    }

    public function setLastFinishedPass($pass = null)
    {
        $this->lastFinishedPass = $pass;
    }
    public function addQuestionTitle($question_id, $question_title)
    {
        $this->questionTitles[$question_id] = $question_title;
    }

    public function getQuestionTitles()
    {
        return $this->questionTitles;
    }

    public function getQuestions($pass = 0)
    {
        if (array_key_exists($pass, $this->questions)) {
            return $this->questions[$pass];
        } else {
            return null;
        }
    }

    public function addQuestion($original_id, $question_id, $max_points, $sequence = null, $pass = 0)
    {
        if (!isset($this->questions[$pass])) {
            $this->questions[$pass] = array();
        }

        $this->questions[$pass][] = array(
            "id" => $question_id, // the so called "aid" from any historical time
            "o_id" => $original_id, // when the "aid" was valid this was the "id"
            "points" => $max_points,
            "sequence" => $sequence
        );
    }

    public function getQuestion($index, $pass = 0)
    {
        if (array_key_exists($index, $this->questions[$pass])) {
            return $this->questions[$pass][$index];
        } else {
            return null;
        }
    }

    public function getQuestionCount($pass = 0): int
    {
        $count = 0;
        if (array_key_exists($pass, $this->passes)) {
            $count = $this->passes[$pass]->getQuestionCount();
        }
        return $count;
    }

    public function getReachedPoints($pass = 0): float
    {
        $reached = 0;
        if (array_key_exists($pass, $this->passes)) {
            $reached = $this->passes[$pass]->getReachedPoints();
        }
        $reached = ($reached < 0) ? 0 : $reached;
        $reached = round($reached, 2);
        return $reached;
    }

    public function getAvailablePoints($pass = 0)
    {
        $available = 0;
        if (!is_object($this->passes[$pass])) {
            $pass = 0;
        }
        if (!is_object($this->passes[$pass])) {
            return 0;
        }
        $available = $this->passes[$pass]->getMaxPoints();
        $available = round($available, 2);
        return $available;
    }

    public function getReachedPointsInPercentForPass($pass = 0)
    {
        $reached = $this->getReachedPoints($pass);
        $available = $this->getAvailablePoints($pass);
        $percent = ($available > 0) ? $reached / $available : 0;
        return $percent;
    }

    public function setUserID($a_usr_id)
    {
        $this->user_id = $a_usr_id;
    }

    public function getUserID(): ?int
    {
        return $this->user_id;
    }

    public function setMarkOfficial($a_mark_official)
    {
        $this->mark_official = $a_mark_official;
    }

    public function getMarkOfficial(): string
    {
        return $this->mark_official;
    }

    public function getScoredPassObject()
    {
        if ($this->getPassScoring() == 1) {
            return $this->getBestPassObject();
        } else {
            return $this->getLastPassObject();
        }
    }

    public function getRequestedHintsCountFromScoredPass(): int
    {
        return $this->getRequestedHintsCount($this->getScoredPass());
    }

    public function getExamIdFromScoredPass(): string
    {
        $examId = '';
        $scoredPass = $this->getScoredPass();

        if (isset($this->passes[$scoredPass]) && $this->passes[$scoredPass] instanceof ilTestEvaluationPassData) {
            $examId = $this->passes[$scoredPass]->getExamId();
        }

        return $examId;
    }

    public function getRequestedHintsCount($pass): int
    {
        if (!isset($this->passes[$pass]) || !($this->passes[$pass] instanceof ilTestEvaluationPassData)) {
            throw new ilTestException("invalid pass index given: $pass");
        }

        $requestedHintsCount = $this->passes[$pass]->getRequestedHintsCount();

        return $requestedHintsCount;
    }

    public function getBestPassObject()
    {
        $bestpoints = 0;
        $bestpassObject = 0;

        $obligationsAnsweredPassExists = $this->doesObligationsAnsweredPassExist();

        foreach ($this->passes as $pass) {
            $reached = $this->getReachedPointsInPercentForPass($pass->getPass());

            if ($reached >= $bestpoints && ($pass->areObligationsAnswered() || !$obligationsAnsweredPassExists)) {
                $bestpoints = $reached;
                $bestpassObject = $pass;
            }
        }

        return $bestpassObject;
    }

    public function getLastPassObject(): ilTestEvaluationPassData
    {
        $lastpassIndex = 0;

        foreach (array_keys($this->passes) as $passIndex) {
            if ($passIndex > $lastpassIndex) {
                $lastpassIndex = $passIndex;
            }
        }

        $lastpassObject = $this->passes[$lastpassIndex];

        return $lastpassObject;
    }

    public function doesObligationsAnsweredPassExist(): bool
    {
        foreach ($this->passes as $pass) {
            if ($pass->areObligationsAnswered()) {
                return true;
            }
        }

        return false;
    }

    public function areObligationsAnswered(): bool
    {
        return $this->getScoredPassObject()->areObligationsAnswered();
    }
} // END ilTestEvaluationUserData