class.ilTestRandomQuestionSetBuilderWithAmountPerPool.php

Go to the documentation of this file.

<?php
 
declare(strict_types=1);
 
class ilTestRandomQuestionSetBuilderWithAmountPerPool extends ilTestRandomQuestionSetBuilder
{
    public function checkBuildable(): bool
    {
        $quantitiesDistribution = new ilTestRandomQuestionsQuantitiesDistribution(
            $this->db,
            $this,
            $this->sourcePoolDefinitionList
        );
        $quantitiesDistribution->initialise();
 
        $is_buildable = true;
        foreach ($this->sourcePoolDefinitionList as $definition) {
            $quantityCalculation = $quantitiesDistribution->calculateQuantities($definition);
            if ($quantityCalculation->isRequiredAmountGuaranteedAvailable()) {
                continue;
            }
            $is_buildable = false;
            $this->checkMessages[] = $quantityCalculation->getDistributionReport($this->lng);
        }
 
        return $is_buildable;
    }
 
    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)) {
                    if (!isset($translator)) {
                        $translator = new ilTestQuestionFilterLabelTranslator($this->db, $this->lng);
                        $translator->loadLabels($this->sourcePoolDefinitionList);
                    }
                    $this->logger->info("RANDOM TEST: missing questions for: "
                        . implode(" - ", [$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);
    }
}