class.ilTestEvaluationPassData.php

Go to the documentation of this file.

<?php

declare(strict_types=1);

class ilTestEvaluationPassData
{
    public array $answeredQuestions;
    private int $workingtime;
    private int $questioncount;
    private float $maxpoints;
    private float $reachedpoints;
    private int $nrOfAnsweredQuestions;
    private int $pass;
    private ?int $requestedHintsCount = null;
    private ?float $deductedHintPoints = null;
    private bool $obligationsAnswered = false;
    private string $exam_id = '';

    public function __sleep()
    {
        return array('answeredQuestions', 'pass', 'nrOfAnsweredQuestions', 'reachedpoints',
            'maxpoints', 'questioncount', 'workingtime', 'examId');
    }

    public function __construct()
    {
        $this->answeredQuestions = [];
    }

    public function getNrOfAnsweredQuestions(): int
    {
        return $this->nrOfAnsweredQuestions;
    }

    public function setNrOfAnsweredQuestions(int $nrOfAnsweredQuestions): void
    {
        $this->nrOfAnsweredQuestions = $nrOfAnsweredQuestions;
    }

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

    public function setReachedPoints(float $reachedpoints): void
    {
        $this->reachedpoints = $reachedpoints;
    }

    public function getMaxPoints(): float
    {
        return $this->maxpoints;
    }

    public function setMaxPoints(float $maxpoints): void
    {
        $this->maxpoints = $maxpoints;
    }

    public function getQuestionCount(): int
    {
        return $this->questioncount;
    }

    public function setQuestionCount(int $questioncount): void
    {
        $this->questioncount = $questioncount;
    }

    public function getWorkingTime(): int
    {
        return $this->workingtime;
    }

    public function setWorkingTime(int $workingtime): void
    {
        $this->workingtime = $workingtime;
    }

    public function getPass(): int
    {
        return $this->pass;
    }

    public function setPass(int $pass): void
    {
        $this->pass = $pass;
    }

    public function getAnsweredQuestions(): array
    {
        return $this->answeredQuestions;
    }

    public function addAnsweredQuestion(
        int $question_id,
        float $max_points,
        float $reached_points,
        bool $isAnswered,
        ?int $sequence = null,
        int $manual = 0
    ): void {
        $this->answeredQuestions[] = [
            "id" => $question_id,
            "points" => round($max_points, 2),
            "reached" => round($reached_points, 2),
            'isAnswered' => $isAnswered,
            "sequence" => $sequence,
            'manual' => $manual
        ];
    }

    public function getAnsweredQuestion(int $index): ?array
    {
        if (array_key_exists($index, $this->answeredQuestions)) {
            return $this->answeredQuestions[$index];
        }

        return null;
    }

    public function getAnsweredQuestionByQuestionId(int $question_id): ?array
    {
        foreach ($this->answeredQuestions as $question) {
            if ($question["id"] == $question_id) {
                return $question;
            }
        }
        return null;
    }

    public function getAnsweredQuestionCount(): int
    {
        return count($this->answeredQuestions);
    }

    public function getRequestedHintsCount(): ?int
    {
        return $this->requestedHintsCount;
    }

    public function setRequestedHintsCount(int $requestedHintsCount): void
    {
        $this->requestedHintsCount = $requestedHintsCount;
    }

    public function getDeductedHintPoints(): ?float
    {
        return $this->deductedHintPoints;
    }

    public function setDeductedHintPoints(float $deductedHintPoints): void
    {
        $this->deductedHintPoints = $deductedHintPoints;
    }

    public function setObligationsAnswered(bool $obligationsAnswered): void
    {
        $this->obligationsAnswered = $obligationsAnswered;
    }

    public function getExamId(): string
    {
        return $this->exam_id;
    }

    public function setExamId(string $exam_id): void
    {
        $this->exam_id = $exam_id;
    }

    public function areObligationsAnswered(): ?bool
    {
        if (!is_null($this->obligationsAnswered)) {
            return $this->obligationsAnswered;
        }

        if (is_array($this->answeredQuestions) && $this->answeredQuestions !== []) {
            foreach ($this->answeredQuestions as $question) {
                if (!$question['isAnswered']) {
                    return false;
                }
            }

            return true;
        }

        throw new ilTestEvaluationException(
            'Neither the boolean property ilTestEvaluationPassData::obligationsAnswered was set, ' .
            'nor the property array property ilTestEvaluationPassData::answeredQuestions contains elements!'
        );
    }
}