class.ilTestRandomQuestionsSrcPoolDefinitionQuantitiesCalculation.php

Go to the documentation of this file.

<?php
 
declare(strict_types=1);
 
class ilTestRandomQuestionsSrcPoolDefinitionQuantitiesCalculation
{
    protected $sourcePoolDefinition;
 
    protected $intersectionQuantitySharingDefinitionList;
 
    protected $overallQuestionAmount;
 
    protected $exclusiveQuestionAmount;
 
    protected $availableSharedQuestionAmount;
 
    public function __construct(ilTestRandomQuestionSetSourcePoolDefinition $sourcePoolDefinition)
    {
        $this->sourcePoolDefinition = $sourcePoolDefinition;
    }
 
    public function getSourcePoolDefinition(): ilTestRandomQuestionSetSourcePoolDefinition
    {
        return $this->sourcePoolDefinition;
    }
 
    public function getIntersectionQuantitySharingDefinitionList(): ilTestRandomQuestionSetSourcePoolDefinitionList
    {
        return $this->intersectionQuantitySharingDefinitionList;
    }
 
    public function setIntersectionQuantitySharingDefinitionList($intersectionQuantitySharingDefinitionList)
    {
        $this->intersectionQuantitySharingDefinitionList = $intersectionQuantitySharingDefinitionList;
    }
 
    public function getOverallQuestionAmount(): int
    {
        return $this->overallQuestionAmount;
    }
 
    public function setOverallQuestionAmount($overallQuestionAmount)
    {
        $this->overallQuestionAmount = $overallQuestionAmount;
    }
 
    public function getExclusiveQuestionAmount(): int
    {
        return $this->exclusiveQuestionAmount;
    }
 
    public function setExclusiveQuestionAmount($exclusiveQuestionAmount)
    {
        $this->exclusiveQuestionAmount = $exclusiveQuestionAmount;
    }
 
    public function getAvailableSharedQuestionAmount(): int
    {
        return $this->availableSharedQuestionAmount;
    }
 
    public function setAvailableSharedQuestionAmount($availableSharedQuestionAmount)
    {
        $this->availableSharedQuestionAmount = $availableSharedQuestionAmount;
    }
 
    protected function getReservedSharedQuestionAmount(): int
    {
        return $this->getOverallQuestionAmount() - (
            $this->getExclusiveQuestionAmount() + $this->getAvailableSharedQuestionAmount()
        );
    }
 
    protected function getRemainingRequiredQuestionAmount(): int
    {
        $requiredQuestionAmount = $this->getSourcePoolDefinition()->getQuestionAmount();
        $exclusiveQuestionAmount = $this->getExclusiveQuestionAmount();
 
        return $requiredQuestionAmount - $exclusiveQuestionAmount;
    }
 
    protected function isRequiredQuestionAmountSatisfiedByOverallQuestionQuantity(): bool
    {
        $requiredQuestionAmount = $this->getSourcePoolDefinition()->getQuestionAmount();
        $overallQuestionAmount = $this->getOverallQuestionAmount();
 
        return $overallQuestionAmount >= $requiredQuestionAmount;
    }
 
    protected function isRequiredQuestionAmountSatisfiedByExclusiveQuestionQuantity(): bool
    {
        $requiredQuestionAmount = $this->getSourcePoolDefinition()->getQuestionAmount();
        $exclusiveQuestionAmount = $this->getExclusiveQuestionAmount();
 
        return $exclusiveQuestionAmount >= $requiredQuestionAmount;
    }
 
    protected function isRemainingRequiredQuestionAmountSatisfiedBySharedQuestionQuantity(): bool
    {
        $remainingRequiredQuestionAmount = $this->getRemainingRequiredQuestionAmount();
        $availableSharedQuestionAmount = $this->getAvailableSharedQuestionAmount();
 
        return $availableSharedQuestionAmount >= $remainingRequiredQuestionAmount;
    }
 
    protected function sourcePoolDefinitionIntersectionsExist(): bool
    {
        if ($this->getIntersectionQuantitySharingDefinitionList()->getDefinitionCount() > 0) {
            return true;
        }
 
        return false;
    }
 
    public function isRequiredAmountGuaranteedAvailable(): bool
    {
        if ($this->isRequiredQuestionAmountSatisfiedByExclusiveQuestionQuantity()) {
            return true;
        }
 
        if ($this->isRemainingRequiredQuestionAmountSatisfiedBySharedQuestionQuantity()) {
            return true;
        }
 
        return false;
    }
 
    public function getDistributionReport(ilLanguage $lng): string
    {
        $report = $this->getRuleSatisfactionResultMessage($lng);
 
        if ($this->sourcePoolDefinitionIntersectionsExist()) {
            $report .= ' ' . $this->getConcurrentRuleConflictMessage($lng);
        }
 
        return $report;
    }
 
    protected function getRuleSatisfactionResultMessage(ilLanguage $lng): string
    {
        if ($this->isRequiredQuestionAmountSatisfiedByOverallQuestionQuantity()) {
            return sprintf(
                $lng->txt('tst_msg_rand_quest_set_rule_not_satisfied_reserved'),
                $this->getSourcePoolDefinition()->getSequencePosition(),
                $this->getSourcePoolDefinition()->getQuestionAmount(),
                $this->getOverallQuestionAmount()
            );
        }
 
        return sprintf(
            $lng->txt('tst_msg_rand_quest_set_rule_not_satisfied_missing'),
            $this->getSourcePoolDefinition()->getSequencePosition(),
            $this->getSourcePoolDefinition()->getQuestionAmount(),
            $this->getOverallQuestionAmount()
        );
    }
 
    protected function getConcurrentRuleConflictMessage(ilLanguage $lng): string
    {
        $definitionsString = '<br />' . $this->buildIntersectionQuestionSharingDefinitionsString($lng);
 
        if ($this->isRequiredQuestionAmountSatisfiedByOverallQuestionQuantity()) {
            return sprintf(
                $lng->txt('tst_msg_rand_quest_set_rule_not_satisfied_reserved_shared'),
                $this->getAvailableSharedQuestionAmount(),
                $definitionsString
            );
        }
 
        return sprintf(
            $lng->txt('tst_msg_rand_quest_set_rule_not_satisfied_missing_shared'),
            $this->getReservedSharedQuestionAmount(),
            $definitionsString
        );
    }
 
    protected function buildIntersectionQuestionSharingDefinitionsString(ilLanguage $lng): string
    {
        $definitionsString = [];
 
        foreach ($this->getIntersectionQuantitySharingDefinitionList() as $definition) {
            $definitionsString[] = sprintf(
                $lng->txt('tst_msg_rand_quest_set_rule_label'),
                $definition->getSequencePosition()
            );
        }
 
        $definitionsString = '<ul><li>' . implode('</li><li>', $definitionsString) . '</li></ul>';
        return $definitionsString;
    }
}