class.ilTestRandomQuestionsSrcPoolDefinitionQuantitiesCalculation.php

Go to the documentation of this file.

<?php
/* Copyright (c) 1998-2013 ILIAS open source, Extended GPL, see docs/LICENSE */
 
class ilTestRandomQuestionsSrcPoolDefinitionQuantitiesCalculation
{
    protected $sourcePoolDefinition;
    
    protected $intersectionQuantitySharingDefinitionList;
    
    protected $overallQuestionAmount;
    
    protected $exclusiveQuestionAmount;
    
    protected $availableSharedQuestionAmount;
    
    public function __construct(ilTestRandomQuestionSetSourcePoolDefinition $sourcePoolDefinition)
    {
        $this->setSourcePoolDefinition($sourcePoolDefinition);
    }
    
    public function getSourcePoolDefinition()
    {
        return $this->sourcePoolDefinition;
    }
    
    public function setSourcePoolDefinition($sourcePoolDefinition)
    {
        $this->sourcePoolDefinition = $sourcePoolDefinition;
    }
    
    public function getIntersectionQuantitySharingDefinitionList()
    {
        return $this->intersectionQuantitySharingDefinitionList;
    }
    
    public function setIntersectionQuantitySharingDefinitionList($intersectionQuantitySharingDefinitionList)
    {
        $this->intersectionQuantitySharingDefinitionList = $intersectionQuantitySharingDefinitionList;
    }
    
    public function getOverallQuestionAmount()
    {
        return $this->overallQuestionAmount;
    }
    
    public function setOverallQuestionAmount($overallQuestionAmount)
    {
        $this->overallQuestionAmount = $overallQuestionAmount;
    }
    
    public function getExclusiveQuestionAmount()
    {
        return $this->exclusiveQuestionAmount;
    }
    
    public function setExclusiveQuestionAmount($exclusiveQuestionAmount)
    {
        $this->exclusiveQuestionAmount = $exclusiveQuestionAmount;
    }
    
    public function getAvailableSharedQuestionAmount()
    {
        return $this->availableSharedQuestionAmount;
    }
    
    public function setAvailableSharedQuestionAmount($availableSharedQuestionAmount)
    {
        $this->availableSharedQuestionAmount = $availableSharedQuestionAmount;
    }
    
    protected function getReservedSharedQuestionAmount()
    {
        return $this->getOverallQuestionAmount() - (
            $this->getExclusiveQuestionAmount() + $this->getAvailableSharedQuestionAmount()
        );
    }
    
    protected function getRemainingRequiredQuestionAmount()
    {
        $requiredQuestionAmount = $this->getSourcePoolDefinition()->getQuestionAmount();
        $exclusiveQuestionAmount = $this->getExclusiveQuestionAmount();
        
        return $requiredQuestionAmount - $exclusiveQuestionAmount;
    }
    
    protected function isRequiredQuestionAmountSatisfiedByOverallQuestionQuantity()
    {
        $requiredQuestionAmount = $this->getSourcePoolDefinition()->getQuestionAmount();
        $overallQuestionAmount = $this->getOverallQuestionAmount();
 
        return $overallQuestionAmount >= $requiredQuestionAmount;
    }
    
    protected function isRequiredQuestionAmountSatisfiedByExclusiveQuestionQuantity()
    {
        $requiredQuestionAmount = $this->getSourcePoolDefinition()->getQuestionAmount();
        $exclusiveQuestionAmount = $this->getExclusiveQuestionAmount();
 
        return $exclusiveQuestionAmount >= $requiredQuestionAmount;
    }
    
    protected function isRemainingRequiredQuestionAmountSatisfiedBySharedQuestionQuantity()
    {
        $remainingRequiredQuestionAmount = $this->getRemainingRequiredQuestionAmount();
        $availableSharedQuestionAmount = $this->getAvailableSharedQuestionAmount();
        
        return $availableSharedQuestionAmount >= $remainingRequiredQuestionAmount;
    }
    
    protected function sourcePoolDefinitionIntersectionsExist()
    {
        if ($this->getIntersectionQuantitySharingDefinitionList()->getDefinitionCount() > 0) {
            return true;
        }
        
        return false;
    }
    
    public function isRequiredAmountGuaranteedAvailable()
    {
        if ($this->isRequiredQuestionAmountSatisfiedByExclusiveQuestionQuantity()) {
            return true;
        }
        
        if ($this->isRemainingRequiredQuestionAmountSatisfiedBySharedQuestionQuantity()) {
            return true;
        }
        
        return false;
    }
    
    public function getDistributionReport(ilLanguage $lng)
    {
        $report = $this->getRuleSatisfactionResultMessage($lng);
        
        if ($this->sourcePoolDefinitionIntersectionsExist()) {
            $report .= ' ' . $this->getConcurrentRuleConflictMessage($lng);
        }
        
        return $report;
    }
    
    protected function getRuleSatisfactionResultMessage(ilLanguage $lng)
    {
        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)
    {
        $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)
    {
        $definitionsString = array();
        
        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;
    }
}