class.ilTestRandomQuestionSetBuilderWithAmountPerPool.php

Go to the documentation of this file.

<?php

class ilTestRandomQuestionSetBuilderWithAmountPerPool extends ilTestRandomQuestionSetBuilder
{
    public function checkBuildable(): bool
    {
        global $DIC; /* @var ILIAS\DI\Container $DIC */
        $lng = $DIC['lng'];

        require_once 'Modules/Test/classes/class.ilTestRandomQuestionsQuantitiesDistribution.php';
        $quantitiesDistribution = new ilTestRandomQuestionsQuantitiesDistribution($this);
        $quantitiesDistribution->setSourcePoolDefinitionList($this->sourcePoolDefinitionList);
        $quantitiesDistribution->initialise();

        $isBuildable = true;
        foreach ($this->sourcePoolDefinitionList as $definition) {
            $quantityCalculation = $quantitiesDistribution->calculateQuantities($definition);
            if ($quantityCalculation->isRequiredAmountGuaranteedAvailable()) {
                continue;
            }

            $isBuildable = false;
            $this->checkMessages[] = $quantityCalculation->getDistributionReport($lng);
        }

        return $isBuildable;
    }

    public function performBuild(ilTestSession $testSession)
    {
        $questionSet = new ilTestRandomQuestionSetQuestionCollection();

        foreach ($this->sourcePoolDefinitionList as $definition) {
            $requiredQuestionAmount = $definition->getQuestionAmount();

            $potentialQuestionStage = $this->getSrcPoolDefRelatedQuestCollection($definition);

            $actualQuestionStage = $potentialQuestionStage->getRelativeComplementCollection($questionSet);

            if ($actualQuestionStage->isGreaterThan($requiredQuestionAmount)) {
                $questions = $this->fetchQuestionsFromStageRandomly($actualQuestionStage, $requiredQuestionAmount);
            } else {
                // fau: fixRandomTestBuildable - log missing questions for a random test rule
                if ($actualQuestionStage->isSmallerThan($requiredQuestionAmount)) {
                    global $DIC;
                    $ilDB = $DIC['ilDB'];
                    $ilLog = $DIC['ilLog'];
                    if (!isset($translator)) {
                        require_once("./Modules/Test/classes/class.ilTestTaxonomyFilterLabelTranslater.php");
                        $translator = new ilTestTaxonomyFilterLabelTranslater($ilDB);
                        $translator->loadLabels($this->sourcePoolDefinitionList);
                    }
                    $ilLog->write("RANDOM TEST: missing questions for: "
                        . implode(" - ", array($definition->getPoolTitle(), $translator->getTaxonomyFilterLabel($definition->getMappedTaxonomyFilter()))));
                }
                // fau.
                $questions = $actualQuestionStage;
            }

            $questionSet->mergeQuestionCollection($questions);
        }

        $requiredQuestionAmount = $this->sourcePoolDefinitionList->getQuestionAmount();

        if ($questionSet->isSmallerThan($requiredQuestionAmount)) {
            $missingQuestionCount = $questionSet->getMissingCount($requiredQuestionAmount);
            // fau: fixRandomTestBuildable - avoid already chosen questions being used as fillers
            $potentialQuestionStage = $this->getSrcPoolDefListRelatedQuestUniqueCollection($this->sourcePoolDefinitionList);
            $actualQuestionStage = $potentialQuestionStage->getRelativeComplementCollection($questionSet);
            $questions = $this->fetchQuestionsFromStageRandomly($actualQuestionStage, $missingQuestionCount);
            // fau.
            $questionSet->mergeQuestionCollection($questions);
        }

        $this->handleQuestionOrdering($questionSet);

        $this->storeQuestionSet($testSession, $questionSet);
    }
}